5
0
mirror of git://git.proxmox.com/git/pve-docs.git synced 2025-01-06 13:17:48 +03:00
pve-docs/pve-external-metric-server.adoc
Dominik Csapak 67360d5786 document ids for status.cfg
Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
2019-04-11 10:14:43 +02:00

76 lines
1.7 KiB
Plaintext

External Metric Server
----------------------
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.
Currently supported are:
* 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
Graphite server configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The definition of a server is:
graphite: your-id
server your-server
port your-port
path your-path
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
Influxdb plugin configuration
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The definition is:
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
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 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 different.
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