summaryrefslogtreecommitdiffstats
path: root/conf.d/aggregated_hosts.conf
blob: d192a55eb893b6ffef61506505b28f6f7ef50d5e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
# netdata configuration for aggregating data from remote hosts
#
# API keys authorize a pair of sending-receiving netdata servers.
# Once their communication is authorized, they can exchange metrics for any
# number of hosts.
#
# You can generate API keys, with the linux command: uuidgen
#
# -----------------------------------------------------------------------------
# 1. SLAVE NETDATA - THE ONE THAT WILL BE SENDING METRICS
#
#    In /etc/netdata/netdata.conf you have a configuration like this:
#
#    [stream]
#
#        # enable or disable sending metrics.
#        # default: no
#	     enabled = yes
#
#        # one or more netdata hosts to send metrics to.
#        # only one will get them, the first available.
#	     destination = HOST1:PORT1 HOST2:PORT2 ...
#
#        # the API key to use, to authorize ourselves
#	     api key =  API_KEY
#
# -----------------------------------------------------------------------------
# 2. MASTER NETDATA - THE ONE THAT WILL BE RECEIVING METRICS
#
#    Use this file to define the API keys is accepts.
#
#    You can have one API key per slave, or the same API key for all slaves.
#
#    All options below are used in this order:
#
#    a) MACHINE_GUID (settings for each machine)
#    b) API_KEY      (settings for the API key)
#    c) this netdata defaults (as in netdata.conf)
#
#    You can combine the above (the more specific setting will be used).
#
# -----------------------------------------------------------------------------

# API key authentication
# If the key is not listed here, it will not be able to connect.

[API_KEY]
    # Default settings for the API key

    # You can disable the API key, by setting this to: no
    # The default (for unknown API keys) is also: no
#    enabled = yes

    # The default history in entries, for all hosts using this API key.
    # You can also set it per host below.
    # If you don't set it here, the history size of the central netdata
    # will be used
#    default history = 3600

    # The default memory mode to be used for all hosts using this API key.
    # You can also set it per host below.
    # If you don't set it here, the memory mode of the central netdata
    # will be used.
    # Valid modes: save (load/save db), map (like swap), ram (no disk)
#    default memory mode = save

    # Shall we enable health monitoring for the hosts using this API key?
    # 3 values:
    #    yes     enable alarms
    #    no      do not enable alarms
    #    auto    enable alarms, only when the host is streaming metrics
    # You can also set it per host, below.
    # The default is the same as the central netdata
#    health enabled by default = auto


# -----------------------------------------------------------------------------
# Each netdata has a unique GUID - generated the first time netdata starts.
# You can find it at /var/lib/netdata/registry/netdata.public.unique.id
# The host sending data will have one. If it is static and you can find it,
# you can give settings for each specific host here.

[MACHINE_GUID]
    # This can be used to stop receiving data
    # THIS IS NOT A SECURITY MECHANISM - AN ATTACKER CAN SET ANY OTHER GUID.
    # Use only the API key for security.
#    enabled = yes

    # The number of entries in the database
#    history = 3600

    # The memory mode of the database
#    memory mode = save

    # Health / alarms control: yes | no | auto
#    health enabled = yes