X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=blobdiff_plain;f=pve-external-metric-server.adoc;h=c9e1107fd45e0f1e205d24fd5e0fa1357bc0b658;hp=0a7c36e8579bf26de1be078b12dd52a8dca19a32;hb=dd1aa0e01624f5927fb65143c9a070672ccbeb92;hpb=a69bfc83f6d2b79e94eeb39781d89b720b4482dc diff --git a/pve-external-metric-server.adoc b/pve-external-metric-server.adoc index 0a7c36e..c9e1107 100644 --- a/pve-external-metric-server.adoc +++ b/pve-external-metric-server.adoc @@ -4,53 +4,78 @@ 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 +----