Xonotic metrics exporter for Prometheus monitoring system.
Metrics are obtained by querying server via rcon (status 1
command).
- execute
pip install xonotic_exporter
- or run
pip install -e git+https://github.com/bacher09/xonotic_exporter#egg=xonotic_exporter
to install latest development version from github
Xonotic exporter is configured by file and CLI options. CLI options is used to specify which port or address to listen, what configuration to use and configuration file is used to specify servers from where metrics will be exported. Configuration file is YAML dictionary, where keys are server names (instance label in prometheus) and values are server connection options. Here's example configuration:
public: server: 172.16.254.1 port: 26000 rcon_password: "secretpassword" rcon_mode: 1 private: server: private.example.com rcon_password: "secret" ipv6-server: server: 2001:db8:85a3::8a2e:370:7334 port: 26001 rcon_mode: 2 rcon_password: "password"
Connection options have few required fields (server
, rcon_password
) and
also some optional fields (port
, rcon_mode
) which have default value.
server field might contain IPv4 or IPv6 address or DNS name. If you are using
DNS name, it will be resolved each time before making request to server, so if
you change DNS record you don't need to restart exporter to use new IP.
For more info about configuration file format you can check it's JSON schema.
Also, you can check correctness of configuration using --validate
CLI option.
If you edit configuration file, you can update configuration without restarting
Xonotic exporter, just send HUP
signal to process or send POST request to
/-/reload
endpoint.
For example:
$ kill -HUP 4429 # 4429 is exporters PID $ curl -XPOST http://localhost:9260/-/reload
The exporter needs server name to be passed as target parameter. It similar to blackbox and snmp exporters.
Example prometheus configuration:
scrape_configs: - job_name: 'xonotic_exporter' relabel_configs: - source_labels: [__address__] target_label: __param_target - source_labels: [__param_target] target_label: instance - target_label: __address__ replacement: 127.0.0.1:9260 static_configs: - targets: ['public', 'private', 'ipv6-server'] # server names
Instead off using configuration file you can start xonotic exporter using Python API. For more information see this code. This gives you ability for dynamic configuration and server autodiscovery.
If you going to deploy this service with systemd check examples folder, there is example systemd unit for this service.