Use the Prometheus remote write exporting connector to archive your Netdata metrics to the external storage provider of your choice for long-term storage and further analysis.
The remote write exporting connector does not support buffer on failures.
The configuration file name for this integration is
You can edit the configuration file using the
edit-config script from the
Netdata config directory.
cd /etc/netdata 2>/dev/null || cd /opt/netdata/etc/netdata sudo ./edit-config exporting.conf
The following options can be defined for this exporter.
|enabled||Enables or disables an exporting connector instance (yes/no).||no||True|
|destination||Accepts a space separated list of hostnames, IPs (IPv4 and IPv6) and ports to connect to. Netdata will use the first available to send the metrics.||no||True|
|username||Username for HTTP authentication||my_username||False|
|password||Password for HTTP authentication||my_password||False|
|data source||Selects the kind of data that will be sent to the external database. (as collected/average/sum)||False|
|hostname||The hostname to be used for sending data to the external database server.||[global].hostname||False|
|prefix||The prefix to add to all metrics.||netdata||False|
|update every||Frequency of sending sending data to the external database, in seconds.||10||False|
|buffer on failures||The number of iterations (
|timeout ms||The timeout in milliseconds to wait for the external database server to process the data.||20000||False|
|send hosts matching||Hosts filter. Determines which hosts will be sent to the external database. The syntax is simple patterns.||localhost *||False|
|send charts matching||One or more space separated patterns (use * as wildcard) checked against both chart id and chart name.||*||False|
|send names instead of ids||Controls the metric names Netdata should send to the external database (yes/no).||False|
|send configured labels||Controls if host labels defined in the
|send automatic labels||Controls if automatically created labels, like
The format of each item in this list, is: [PROTOCOL:]IP[:PORT].
destination = 10.11.14.2:2003 10.11.14.3:4242 10.11.14.4:2003
Example IPv6 and IPv4 together:
destination = [ffff:...:0001]:2003 10.11.12.1:2003
When multiple servers are defined, Netdata will try the next one when the previous one fails.
Netdata will add some randomness to this number, to prevent stressing the external server when many Netdata servers send data to the same database. This randomness does not affect the quality of the data, only the time they are sent.
If the server fails to receive the data after that many failures, data loss on the connector instance is expected (Netdata will also log it).
Includes one or more space separated patterns, using * as wildcard (any number of times within each pattern). The patterns are checked against the hostname (the localhost is always checked as localhost), allowing us to filter which hosts will be sent to the external database when this Netdata is a central Netdata aggregating multiple hosts.
A pattern starting with
! gives a negative match. So to match all hosts named
*db* except hosts containing
!*child* *db* (so, the order is important: the first pattern matching the hostname will be used - positive or negative).
A pattern starting with ! gives a negative match. So to match all charts named apps.* except charts ending in *reads, use !*reads apps.* (so, the order is important: the first pattern matching the chart id or the chart name will be used, positive or negative). There is also a URL parameter filter that can be used while querying allmetrics. The URL parameter has a higher priority than the configuration option.
Netdata supports names and IDs for charts and dimensions. Usually IDs are unique identifiers as read by the system and names are human friendly labels (also unique). Most charts and metrics have the same ID and name, but in several cases they are different : disks with device-mapper, interrupts, QoS classes, statsd synthetic charts, etc.
Basic example configuration for Prometheus remote write.
[prometheus_remote_write:my_instance] enabled = yes destination = 10.11.14.2:2003 remote write URL path = /receive
:https modifier to the connector type if you need to use the TLS/SSL protocol. For example:
[prometheus_remote_write:https:my_instance] enabled = yes destination = 10.11.14.2:2003 remote write URL path = /receive username = my_username password = my_password