pvecm: re-add "multiple cluster in same net" section

[pve-docs.git] / pve-external-metric-server.adoc

diff --git a/pve-external-metric-server.adoc b/pve-external-metric-server.adoc
index 6adc95d6e8cda648c3c67c1e8a86df47b86bd05a..c9e1107fd45e0f1e205d24fd5e0fa1357bc0b658 100644 (file)
--- 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
+----