Xonotic metrics exporter for prometheus monitoring
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.
$ kill -HUP 4429 # 4429 is exporters PID $ curl -XPOST http://localhost:9260/-/reload
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.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.