h5vx/samp-monitor

SA-MP Monitor

Мониторинг серверов San Andreas Multiplayer (SA-MP / open.mp): экспортёр метрик Prometheus, REST API, веб-интерфейс для управления списком серверов и готовый дашборд Grafana.

• Написан на Go без внешних зависимостей: протокол запросов SA-MP, формат Prometheus и хранилище реализованы вручную.
• Работает в пределах ~10–15 МБ RSS. Потребление памяти жёстко ограничено (подробнее в разделе Память).
• Отслеживает статус каждого игрока (онлайн/офлайн), его счёт, пинг и длительность сессии.
• Настраивается только переменными окружения.

Быстрый старт

cp .env.example .env        # при желании поправьте
docker compose up -d --build

Дашборд SA-MP Monitor подключается через provisioning и открывается как домашний.

Чтобы попробовать без настоящего сервера, запустите фейковый SA-MP сервер с «живыми» игроками:

go run ./cmd/fakesamp     # напечатает адрес, добавьте его в UI

API

Если задан API_TOKEN, все изменяющие запросы требуют заголовок Authorization: Bearer <token> (или X-API-Token). Запросы на чтение требуют его только при API_READ_AUTH=true.

Адрес указывается как host[:port], порт по умолчанию 7777. Поддерживаются домены (с кэшем DNS) и только IPv4: у протокола SA-MP нет IPv6.

curl -X POST localhost:8080/api/servers -H 'Content-Type: application/json' \
     -d '{"address":"127.0.0.1:7777","name":"Local"}'
curl -X DELETE localhost:8080/api/servers/127.0.0.1:7777

Список серверов хранится в DATA_FILE. Формат выбирается по расширению: .json (по умолчанию) или .csv (address,name,encoding,added_at). Запись атомарная (временный файл + rename).

Метрики

У каждого сервера одно уникальное значение метки server — нормализованный host:port.

Про список игроков: сначала выполняется запрос d (id, ник, счёт, пинг). Если сервер его не поддерживает, используется c (ник, счёт), а к d мониторинг вернётся через час. SA-MP не отдаёт список, когда на сервере больше 100 игроков. В этом случае samp_server_players_list_available равна 0, и повторная попытка будет через 10 минут.

Конфигурация

Переменные для docker-compose (SAMP_MONITOR_PORT, SAMP_MONITOR_MEM_LIMIT, GRAFANA_*, PROMETHEUS_* и др.) описаны в .env.example.

Память

Потребление ограничено на трёх уровнях:

1. Жёсткий лимит контейнера. mem_limit + memswap_limit (по умолчанию 48 МБ, без swap), pids_limit, cpus. Выше лимита ядро убьёт процесс, поэтому потребление никогда не превысит лимит.
2. Мягкий лимит Go. При старте процесс читает лимит cgroup и выставляет GOMEMLIMIT = 80 % от него. Приближаясь к лимиту, GC работает агрессивнее, так что до OOM дело не доходит. Дополнительно задан GOGC=50.
3. Ограниченные структуры данных.
   • MAX_SERVERS и MAX_PLAYERS_PER_SERVER ограничивают число серверов и игроков в памяти, PLAYER_RETENTION — время хранения вышедших игроков.
   • Число воркеров фиксировано. У каждого воркера один UDP-сокет и один переиспользуемый буфер.
   • Разбор пакетов идёт без аллокаций: срезы указывают прямо в буфер, поиск игрока по нику тоже не аллоцирует.
   • /metrics пишется потоком через bufio из пула, без промежуточных объектов. gzip отключён, так как он стоит около 800 КБ на запрос.
   • Размер тела запросов API и заголовков ограничен.

Грубая оценка: около 250 байт на отслеживаемого игрока и около 2 КБ на сервер. При 200 серверах по 100 игроков это примерно 5 МБ данных.

Разработка

go test -race ./...
go run ./cmd/samp-monitor
python3 grafana/gen_dashboard.py   # пересобрать grafana/dashboards/samp.json

Структура:

cmd/samp-monitor      точка входа, лимиты памяти, healthcheck
cmd/fakesamp          фейковый SA-MP сервер для отладки
internal/samp         протокол запросов SA-MP (+ samptest)
internal/monitor      список серверов, поллер, состояние игроков
internal/metrics      вывод в формате Prometheus
internal/api          REST API и встроенный веб-интерфейс (web/index.html)
internal/store        хранилище JSON/CSV
grafana/              provisioning и дашборд (генерируется gen_dashboard.py)
prometheus/           конфиг scrape