armsnyder/a2s-exporter

A Prometheus exporter for Steam game servers

stars

commits

primary language

Dec 1, 2025

updated

hub.docker.com/r/armsnyder/a2s-exporter

a2s

counter-strike

prometheus

prometheus-exporter

rust-game

rust-server

source-engine

source-server-query

steam

team-fortress-2

valheim

valheim-server

valve

valve-servers

README

A2S Exporter

A Prometheus exporter for Steam game server info.

Supports all Steam game servers which speak the UDP-based A2S query protocol, for example:

Counter-Strike
The Forest
Rust
Team Fortress 2
Valheim

Usage

The image is hosted on Docker Hub. (Link)

docker run --rm -p 9841:9841 armsnyder/a2s-exporter --address myserver.example.com:12345

Arguments

Arguments may be provided using commandline flags or environment variables.

Required

Flag	Variable	Help
--address	A2S_EXPORTER_QUERY_ADDRESS	Address of the A2S query server as host:port (This is a separate port from the main server port).

Optional

Flag	Variable	Default	Help
--port	A2S_EXPORTER_PORT	9841	Port for the metrics exporter.
--path	A2S_EXPORTER_PATH	/metrics	Path for the metrics exporter.
--namespace	A2S_EXPORTER_NAMESPACE	a2s	Namespace prefix for all exported a2s metrics.
--exclude-player-metrics	A2S_EXPORTER_EXCLUDE_PLAYER_METRICS	false	If true, exclude all `player_*` metrics. This option may be necessary for some servers.
--a2s-only-metrics	A2S_EXPORTER_A2S_ONLY_METRICS	false	If true, excludes Go runtime and promhttp metrics.
--max-packet-size	A2S_EXPORTER_MAX_PACKET_SIZE	1400	Advanced option to set a non-standard max packet size of the A2S query server.

Special

Flag	Help
-h	Show help.
--version	Show build version.

Exported Metrics

Metrics names are prefixed with a namespace (default a2s_).

Name	Help	Labels
player_count	Total number of connected players.	server_name
player_duration	Time (in seconds) player has been connected to the server.	server_name player_name player_index
player_info	Non-numerical player info, including player_name and player_index. The value is 1, and the info is in the labels.	server_name player_name player_index
player_score	Player's score (usually "frags" or "kills").	server_name player_name player_index
player_the_ship_deaths	Player's deaths in a The Ship server.	server_name player_name player_index
player_the_ship_money	Player's money in a The Ship server.	server_name player_name player_index
player_up	Was the last player info query successful.
server_bots	Number of bots on the server.	server_name
server_info	Non-numerical server info, including server_steam_id and version. The value is 1, and info is in the labels.	server_name map folder game server_type server_os version server_id keywords server_game_id server_steam_id the_ship_mode source_tv_name
server_max_players	Maximum number of players the server reports it can hold.	server_name
server_players	Number of players on the server.	server_name
server_port	The server's game port number.	server_name
server_protocol	Protocol version used by the server.	server_name
server_source_tv_port	Spectator port number for SourceTV.	server_name
server_the_ship_duration	Time (in seconds) before a player is arrested while being witnessed in a The Ship server.	server_name
server_the_ship_witnesses	The number of witnesses necessary to have a player arrested in a The Ship server.	server_name
server_up	Was the last server info query successful.
server_vac	Specifies whether the server uses VAC (0 for unsecured, 1 for secured).	server_name
server_visibility	Indicates whether the server requires a password (0 for public, 1 for private).	server_name

Credits

This exporter depends on rumblefrog/go-a2s (MIT). Big thanks to them!

Contributors

armsnyder

22 commits

dependabot[bot]

5 commits

Similar repos

dalance/softether_exporter

Prometheus Exporter of SoftEther VPN Server

guohuachan/ZLMediaKit_exporter

Prometheus Exporter for ZLMediakit

weihao/bungeecord-prometheus-exporter

📊 A lightweight Bungeecord/Velocity plugin that exports network stats to Prometheus

sladkoff/minecraft-prometheus-exporter

A Bukkit plugin which exports minecraft server stats to Prometheus

539

damoun/twitch_exporter

Twitch exporter for Prometheus

foxdalas/sphinx_exporter

Exports metrics from sphinx servers for consumption by Prometheus.

prometheus-community/windows_exporter

Prometheus exporter for Windows machines

3,621

corelight/suricata_exporter

A Prometheus Exporter for Suricata

Languages

98.3%

Dockerfile

1.3%