Skip to main content

Xonotic metrics exporter for prometheus monitoring

Project description

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+ 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:

  port: 26000
  rcon_password: "secretpassword"
  rcon_mode: 1
  rcon_password: "secret"
  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

Prometheus Configuration

The exporter needs server name to be passed as target parameter. It similar to blackbox and snmp exporters.

Example prometheus configuration:

  - job_name: 'xonotic_exporter'
      - source_labels: [__address__]
        target_label: __param_target
      - source_labels: [__param_target]
        target_label: instance
      - target_label: __address__
      - targets: ['public', 'private', 'ipv6-server']  # server names

Other features

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.

Project details

Release history Release notifications | RSS feed

This version


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xonotic_exporter-0.1.tar.gz (21.2 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page