ansible.netdata/templates/etc/netdata/stream.conf.j2

## {{ ansible_managed }}
## From ipr-cnrs.netdata role

# 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. ON SLAVE NETDATA - THE ONE THAT WILL BE SENDING METRICS

[stream]
	# Enable this on slaves, to have them send metrics.
	{% if netdata__slave_enable -%}
	enabled = yes
	{% else %}
	enabled = no
	{%- endif %}

	# The destination to send metrics to.
	# A space separated list of:
	#         [PROTOCOL:]HOST[%INTERFACE][:PORT]
	# The first available will get the metrics.
	# PROTOCOL = tcp or udp (only tcp is supported by masters)
	# HOST = an IPv4, IPv6 IP, or a hostname.
	#        IPv6 IPs should be given with brackets [ip:address]
	# INTERFACE = the network interface to use
	# PORT = the port number or service name (/etc/services)
	# This communication is not HTTP (cannot be proxied by web proxies).
	destination = {{ netdata__slave_destination }}

	# The API_KEY to use (as the sender)
	api key = {{ netdata__slave_api_key }}

	# The timeout to connect and send metrics
	timeout seconds = 60

	# If the destination line above does specify a port, use this
	default port = 19999

	# The buffer to use for sending metrics.
	# 1MB by default is good for 2-3 seconds of data, so increase this
	# if you expect latencies.
	buffer size bytes = {{ netdata__slave_buffer_size }}

	# If the connection fails, or it disconnects,
	# retry after that many seconds.
	reconnect delay seconds = {{ netdata__slave_reconnect }}

	# Attempt to sync the clock the of the master with the clock of the
	# slave for that many iterations, when starting.
	initial clock resync iterations = 60


# -----------------------------------------------------------------------------
# 2. ON MASTER NETDATA - THE ONE THAT WILL BE RECEIVING METRICS
#
#    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.

[{{ netdata__master_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
	{% if netdata__master_enable -%}
	enabled = yes
	{% else %}
	enabled = no
	{%- endif %}

	# 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 = {{ netdata__master_history }}

	# 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 netdata.conf will be used.
	# Valid modes:
	#    save    save on exit, load on start
	#    map     like swap (continuously syncing to disks)
	#    ram     keep it in RAM, don't touch the disk
	#    none    no database (passing through this netdata)
	default memory mode = {{ netdata__master_memory_mode }}

	# 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 sending netdata is connected
	# You can also set it per host, below.
	# The default is the same as to netdata.conf
	health enabled by default = {{ netdata__master_health_alarm }}

	# postpone alarms for a short period after the sender is connected
	default postpone alarms on connect seconds = 60

	# need to route metrics differently? set these.
	# the defaults are the ones at the [stream] section
	#default proxy enabled = yes | no
	#default proxy destination = IP:PORT IP:PORT ...
	#default proxy api key = API_KEY


# -----------------------------------------------------------------------------
# 3. ON MASTER NETDATA - THE ONE THAT WILL BE RECEIVING METRICS
#
# THIS IS OPTIONAL - YOU DON'T NEED IT BY DEFAULT
# It only exists to give you finer control of the master settings for each
# slave host, when the same API key is used by many netdata slaves / proxies.
#
# 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 the host is not ephemeral,
# you can give settings for each specific host here.

[MACHINE_GUID]
	# enable this host: yes | no
	# When disabled, the master will not receive metrics for this host.
	# THIS IS NOT A SECURITY MECHANISM - AN ATTACKER CAN SET ANY OTHER GUID.
	# Use only the API key for security.
	enabled = no

	# The number of entries in the database
	history = 3600

	# The memory mode of the database: save | map | ram | none
	memory mode = save

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

	# postpone alarms when the sender connects
	postpone alarms on connect seconds = 60

	# need to route metrics differently?
	#proxy enabled = yes | no
	#proxy destination = IP:PORT IP:PORT ...
	#proxy api key = API_KEY