monitoring

Game server monitoring with metrics, alerting, and performance tracking for production reliability

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

This Claude skill provides a comprehensive solution for game server monitoring, designed to enhance production reliability through real-time metrics, automated alerting, and performance tracking. It enables seamless integration with industry-standard backends like Prometheus, Datadog, and CloudWatch, allowing developers to maintain high-performance gaming environments by monitoring critical KPIs such as tick rates, player latency, and server health.

Use Cases

  • Real-time Player & Match Tracking: Monitor active player counts and ongoing matches across different regions and game modes to optimize server scaling and load balancing.
  • Performance Bottleneck Detection: Track game loop tick durations and network latency (P99) to identify lag spikes and ensure a smooth, high-frequency gaming experience.
  • Automated Incident Alerting: Configure critical alerts for server downtime, high latency, or low player thresholds to enable rapid response from SRE and LiveOps teams.
  • Infrastructure Resource Management: Maintain system stability by monitoring CPU and memory usage against predefined thresholds to prevent crashes and resource exhaustion.
  • Production Troubleshooting: Utilize built-in checklists and query templates to perform root cause analysis on missing metrics, alert storms, or data gaps.
namemonitoring
descriptionGame server monitoring with metrics, alerting, and performance tracking for production reliability
sasmp_version"1.3.0"
version"2.0.0"
bonded_agent08-liveops-specialist
bond_typePRIMARY_BOND
typecounter
enum[prometheus, datadog, cloudwatch, influxdb]
min7
max365
default30
max_attempts3
backoffexponential
initial_delay_ms1000
levelinfo
fields[metric_name, value, labels]
- namemetrics_collected

Server Monitoring

Monitor game server health with metrics, logs, and alerts.

Key Game Metrics

const prometheus = require('prom-client');

// Player metrics
const activePlayers = new prometheus.Gauge({
  name: 'game_active_players',
  help: 'Currently connected players',
  labelNames: ['region', 'game_mode']
});

const matchesInProgress = new prometheus.Gauge({
  name: 'game_matches_active',
  help: 'Active matches',
  labelNames: ['game_mode']
});

// Performance metrics
const tickDuration = new prometheus.Histogram({
  name: 'game_tick_duration_seconds',
  help: 'Game loop tick duration',
  buckets: [0.001, 0.005, 0.01, 0.016, 0.033]
});

const networkLatency = new prometheus.Histogram({
  name: 'game_network_latency_ms',
  help: 'Player network latency',
  labelNames: ['region'],
  buckets: [10, 25, 50, 75, 100, 150, 200]
});

Alert Rules

groups:
- name: game-alerts
  rules:
  - alert: GameServerDown
    expr: up{job="game-servers"} == 0
    for: 1m
    labels:
      severity: critical

  - alert: HighTickLatency
    expr: histogram_quantile(0.99, game_tick_duration_seconds) > 0.02
    for: 5m
    labels:
      severity: high

  - alert: LowPlayerCount
    expr: game_active_players < 10
    for: 10m
    labels:
      severity: warning

Target Thresholds

Metric Target Alert
Tick Rate 60 Hz < 55 Hz
Latency P99 < 100ms > 200ms
Memory < 80% > 90%
CPU < 70% > 85%

Troubleshooting

Common Failure Modes

Error Root Cause Solution
Missing metrics Scrape failure Check targets
Alert storms Too sensitive Tune thresholds
Dashboard slow Too many queries Aggregate
Gaps in data Network issues Add redundancy

Debug Checklist

# Check Prometheus targets
curl localhost:9090/api/v1/targets | jq '.data.activeTargets'

# Check firing alerts
curl localhost:9090/api/v1/alerts | jq '.data.alerts'

# Query metrics
curl 'localhost:9090/api/v1/query?query=game_active_players'

Unit Test Template

describe('Metrics', () => {
  test('records tick duration', async () => {
    const end = tickDuration.startTimer();
    await sleep(10);
    end();

    const metrics = await prometheus.register.metrics();
    expect(metrics).toContain('game_tick_duration_seconds');
  });
});

Resources

  • assets/ - Dashboard configs
  • references/ - Alerting guides