]>
Commit | Line | Data |
---|---|---|
d9abb1d6 DC |
1 | External Metric Server |
2 | ---------------------- | |
d9abb1d6 DC |
3 | ifdef::wiki[] |
4 | :pve-toplevel: | |
5 | endif::wiki[] | |
6 | ||
0a3aed9c TL |
7 | Starting with {pve} 4.0, you can define external metric servers, which will |
8 | be sent various stats about your hosts, virtual machines and storages. | |
d9abb1d6 DC |
9 | |
10 | Currently supported are: | |
11 | ||
0a3aed9c TL |
12 | * Graphite (see http://graphiteapp.org ) |
13 | * InfluxDB (see https://www.influxdata.com/time-series-platform/influxdb/ ) | |
d9abb1d6 | 14 | |
0a3aed9c | 15 | The server definitions are saved in '/etc/pve/status.cfg' |
d9abb1d6 DC |
16 | |
17 | Graphite server configuration | |
18 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
19 | ||
20 | The definition of a server is: | |
21 | ||
0a3aed9c | 22 | ---- |
67360d57 | 23 | graphite: your-id |
d9abb1d6 DC |
24 | server your-server |
25 | port your-port | |
26 | path your-path | |
0a3aed9c | 27 | ---- |
d9abb1d6 | 28 | |
0a3aed9c | 29 | where your-port defaults to *2003* and your-path defaults to *proxmox* |
d9abb1d6 | 30 | |
0a3aed9c TL |
31 | {pve} sends the data over UDP, so the graphite server has to be configured |
32 | for this. | |
d9abb1d6 DC |
33 | |
34 | Influxdb plugin configuration | |
35 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
36 | ||
37 | The definition is: | |
38 | ||
0a3aed9c | 39 | ---- |
67360d57 | 40 | influxdb: your-id |
d9abb1d6 DC |
41 | server your-server |
42 | port your-port | |
0a3aed9c | 43 | ---- |
d9abb1d6 | 44 | |
0a3aed9c TL |
45 | {pve} sends the data over UDP, so the influxdb server has to be configured |
46 | for this. | |
d9abb1d6 DC |
47 | |
48 | Here is an example configuration for influxdb (on your influxdb server): | |
49 | ||
0a3aed9c | 50 | ---- |
d9abb1d6 DC |
51 | [[udp]] |
52 | enabled = true | |
53 | bind-address = "0.0.0.0:8089" | |
54 | database = "proxmox" | |
55 | batch-size = 1000 | |
56 | batch-timeout = "1s" | |
0a3aed9c | 57 | ---- |
d9abb1d6 | 58 | |
470d4313 | 59 | With this configuration, your server listens on all IP addresses on |
d9abb1d6 | 60 | port 8089, and writes the data in the *proxmox* database |
67360d57 DC |
61 | |
62 | Multiple Definitions and Example | |
63 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
64 | ||
65 | The *id* is optional, but if you want to have multiple definitions of a single | |
0a3aed9c | 66 | type, then the ids must be defined and different from each other. |
67360d57 DC |
67 | |
68 | Here is an example of a finished status.cfg | |
69 | ||
0a3aed9c | 70 | ---- |
67360d57 DC |
71 | graphite: |
72 | server 10.0.0.5 | |
73 | ||
74 | influxdb: influx1 | |
75 | server 10.0.0.6 | |
76 | port 8089 | |
77 | ||
78 | influxdb: influx2 | |
79 | server 10.0.0.7 | |
80 | port 8090 | |
0a3aed9c | 81 | ---- |