mirror of
https://github.com/thegeeklab/prometheus-pve-sd.git
synced 2024-11-25 02:40:39 +00:00
d15a01fd6a
BREAKING CHANGE: The label `__meta_pve_ip` was removed in favor of `__meta_pve_ipv4` and `__meta_pve_ipv6`.
61 lines
1.2 KiB
Markdown
61 lines
1.2 KiB
Markdown
---
|
|
title: Usage
|
|
---
|
|
|
|
{{< toc >}}
|
|
|
|
## Start PVE SD
|
|
|
|
Create a [configuration file](/configuration/defaults/) with the required parameters to connect to your PVE server before you start the service.
|
|
|
|
```Shell
|
|
run prometheus-pve-sd -vv --loop-delay 900 -o /etc/prometheus/pve.json
|
|
```
|
|
|
|
## Available Labels
|
|
|
|
The following list of meta labels can be used to relabel your scrape results:
|
|
|
|
`__meta_pve_ipv4`
|
|
|
|
`__meta_pve_ipv6`
|
|
|
|
`__meta_pve_name`
|
|
|
|
`__meta_pve_type`
|
|
|
|
`__meta_pve_vmid`
|
|
|
|
`__meta_pve_cpu`
|
|
|
|
`__meta_pve_cores`
|
|
|
|
`__meta_pve_memory`
|
|
|
|
`__meta_pve_status`
|
|
|
|
`__meta_pve_groups`
|
|
: Groups will be discovered from the `Notes` field of a host and need to be set as JSON e.g. `{"groups":["group1","group2"]}`
|
|
|
|
## Prometheus configuration
|
|
|
|
This example configuration snippet for the Prometheus `scrape_config` Prometheus to scrape `telegraf` assuming that it is deployed on all your servers.
|
|
|
|
```YAML
|
|
- file_sd_configs:
|
|
- files:
|
|
- /opt/prometheus/conf/file_sd/proxmox.json
|
|
job_name: telegraf-pve
|
|
metrics_path: /metrics
|
|
relabel_configs:
|
|
- replacement: telegraf
|
|
target_label: job
|
|
- replacement: ${1}:9273
|
|
source_labels:
|
|
- __meta_pve_name
|
|
target_label: __address__
|
|
- source_labels:
|
|
- __meta_pve_name
|
|
target_label: instance
|
|
```
|