X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pve-external-metric-server.adoc;h=c9e1107fd45e0f1e205d24fd5e0fa1357bc0b658;hp=6adc95d6e8cda648c3c67c1e8a86df47b86bd05a;hb=a45c999b4586734621bbc968d67f87390739b270;hpb=d9abb1d637e36248a300a6d165b2d407995e1755 diff --git a/pve-external-metric-server.adoc b/pve-external-metric-server.adoc index 6adc95d..c9e1107 100644 --- a/pve-external-metric-server.adoc +++ b/pve-external-metric-server.adoc @@ -1,57 +1,81 @@ External Metric Server ---------------------- -include::attributes.txt[] ifdef::wiki[] :pve-toplevel: endif::wiki[] -Starting with {pve} 4.0, you can define external metric servers, -which will be sent various stats about your hosts, virtual machines and storages. +Starting with {pve} 4.0, you can define external metric servers, which will +be sent various stats about your hosts, virtual machines and storages. Currently supported are: - * graphite (see http://graphiteapp.org ) - * influxdb (see https://www.influxdata.com/time-series-platform/influxdb/ ) + * Graphite (see http://graphiteapp.org ) + * InfluxDB (see https://www.influxdata.com/time-series-platform/influxdb/ ) -The server definitions are saved in - /etc/pve/status.cfg +The server definitions are saved in '/etc/pve/status.cfg' Graphite server configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The definition of a server is: - graphite: +---- + graphite: your-id server your-server port your-port path your-path +---- -where your-port defaults to *2003* -and your-path defaults to *proxmox* +where your-port defaults to *2003* and your-path defaults to *proxmox* -{pve} sends the data over udp, so the graphite server -has to be configured for this +{pve} sends the data over UDP, so the graphite server has to be configured +for this. Influxdb plugin configuration ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The definition is: - influxdb: +---- + influxdb: your-id server your-server port your-port +---- -{pve} sends the data over udp, so the influxdb server -has to be configured for this +{pve} sends the data over UDP, so the influxdb server has to be configured +for this. Here is an example configuration for influxdb (on your influxdb server): +---- [[udp]] enabled = true bind-address = "0.0.0.0:8089" database = "proxmox" batch-size = 1000 batch-timeout = "1s" +---- -With this configuration, your server listens on all IP adresses on +With this configuration, your server listens on all IP addresses on port 8089, and writes the data in the *proxmox* database + +Multiple Definitions and Example +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +The *id* is optional, but if you want to have multiple definitions of a single +type, then the ids must be defined and different from each other. + +Here is an example of a finished status.cfg + +---- + graphite: + server 10.0.0.5 + + influxdb: influx1 + server 10.0.0.6 + port 8089 + + influxdb: influx2 + server 10.0.0.7 + port 8090 +----