Lightweight telemetry aggregation server. Named after the "Radio Zenit" broadcasting station in Chernarus (DayZ), this service was originally designed to track usage of server-side DayZ modifications.

However, it is agnostic and can be used for:

• Generic Applications: Tracking version distribution and uptime via simple heartbeats.
• Game Servers: Any game server compatible with the Valve Source Query Protocol (A2S_INFO).

Download binary from releases page or build it, just run make build or use container image.

Container images are available at:

• ghcr.io/woozymasta/zenit:latest
• docker.io/woozymasta/zenit:latest

mkdir -p data
docker run -d --name zenit \
  -p 8080:8080 \
  -v "$PWD/data:/data" \
  ghcr.io/woozymasta/zenit:latest --auth-token=admin

The application is configured via command-line flags or environment variables.
For a complete list of available options, run:

./zenit --help

• POST /api/telemetry - Ingests telemetry data. Expects JSON.

{
  "application": "MetricZ",
  "version": "1.1.0",
  "type": "steam",
  "port": 27016
}

Protected via HTTP Basic Auth or Bearer token.

• GET /dashboard - Web interface.
• GET /api/stats - Returns all nodes as JSON.
• GET /api/node - Node details.
• GET /api/a2s - Proxy A2S query to a remote server.
• DELETE /api/node - Remove node.

You can ctrl+c/v

# install app
sudo curl -sSfLo /usr/local/bin/zenit \
  https://github.com/WoozyMasta/zenit/releases/latest/download/zenit-linux-amd64
sudo chmod +x /usr/local/bin/zenit

# check it works
zenit -v

# install systemd service
sudo curl -sSfLo /etc/systemd/system/zenit.service \
  https://raw.githubusercontent.com/WoozyMasta/zenit/master/zenit.service
sudo systemctl daemon-reload

# install config
sudo curl -sSfLo /etc/default/zenit \
  https://raw.githubusercontent.com/WoozyMasta/zenit/master/.env

# add system user and group
sudo groupadd --system zenit
sudo useradd --system \
  --gid zenit \
  --home /var/lib/zenit \
  --shell /usr/sbin/nologin \
  zenit

# make work dir
sudo mkdir -p /var/lib/zenit
sudo chown zenit:zenit /var/lib/zenit
sudo chmod 0750 /var/lib/zenit

# edit settings, change ZENIT_AUTH_TOKEN !!!
sudo editor /etc/default/zenit

# start, check and enable
sudo systemctl start zenit.service
sudo systemctl status zenit.service
sudo systemctl enable zenit.service

The binary supports standalone maintenance modes to clean up the database. These commands exit after completion.

• --prune-empty - Delete records with no A2S data.
• --check-inactive - Re-check servers not seen recently; update or delete.
• --check-all - Re-check all servers.

State is maintained in a SQLite database (zenit.db) and a MaxMind GeoIP database (zenit.mmdb). Both are stored in the working directory or the path specified via flags.