Metrics
GET /metrics (unversioned, text exposition 0.0.4; anonymous on the LAN listener unless [metrics] require_auth).
Names below are stable within v1 (renaming = breaking); new metrics / labels are minor. All values are real
measurements — no synthetic numbers. Prefix freedome_mediaserver_ (the old name freedome_legacy_requests_total
is spelled freedome_mediaserver_legacy_requests_total).
| Name | Type | Labels | Meaning |
|---|---|---|---|
freedome_mediaserver_build_info |
gauge (1) | version, contract |
build and implemented contract version |
freedome_mediaserver_http_requests_total |
counter | route, method, status |
REST requests (matched route template) |
freedome_mediaserver_http_request_duration_seconds |
histogram | route, method |
REST latency |
freedome_mediaserver_graphql_operations_total |
counter | type (query/mutation/subscription), name, outcome |
GraphQL operations |
freedome_mediaserver_ws_connections |
gauge | transport (ws, socketio, socketio-legacy, graphql-ws) |
open realtime connections |
freedome_mediaserver_ws_messages_total |
counter | transport, direction, type |
realtime messages |
freedome_mediaserver_osc_packets_total |
counter | listener, outcome (ok, dropped-cidr, malformed, unknown-address) |
OSC packets |
freedome_mediaserver_auth_failures_total |
counter | transport, reason |
rejected credentials |
freedome_mediaserver_rate_limited_total |
counter | transport |
429 / rate-limited messages |
freedome_mediaserver_bus_published_total |
counter | class (S, E, T) |
events published |
freedome_mediaserver_bus_dropped_total |
counter | class, reason (coalesced, overflow) |
events dropped / coalesced |
freedome_mediaserver_bus_subscribers |
gauge | transport |
active subscriptions |
freedome_mediaserver_bus_resync_total |
counter | transport |
resync sent to clients |
freedome_mediaserver_engine_up |
gauge (0/1) | engine, node |
engine reachable and compatible |
freedome_mediaserver_engine_rpc_duration_seconds |
histogram | engine, method |
gRPC latency |
freedome_mediaserver_engine_rpc_errors_total |
counter | engine, method, code |
gRPC errors |
freedome_mediaserver_engine_reconnects_total |
counter | engine |
reconnects |
freedome_mediaserver_engine_fps |
gauge | engine, node, output |
engine-reported frame rate |
freedome_mediaserver_engine_dropped_frames_total |
counter | engine, node, output |
engine-reported dropped frames |
freedome_mediaserver_engine_gpu_load |
gauge (0..1) | engine, node |
engine-reported GPU load |
freedome_mediaserver_player_state |
gauge | venue, player, state |
1 for the current state |
freedome_mediaserver_assets |
gauge | status, type |
asset count |
freedome_mediaserver_blob_store_bytes |
gauge | — | content store size |
freedome_mediaserver_upload_bytes_total |
counter | — | bytes received through uploads |
freedome_mediaserver_uploads_active |
gauge | — | unfinished tus uploads |
freedome_mediaserver_devices |
gauge | kind, state (online, offline, unpaired) |
visual + audio devices |
freedome_mediaserver_gateway_requests_total |
counter | gateway, outcome |
gateway traffic |
freedome_mediaserver_gateway_unknown_total |
counter | gateway, cmd |
commands the gateway does not know |
freedome_mediaserver_gateway_up |
gauge (0/1) | gateway |
gateway listener / driver up |
freedome_mediaserver_legacy_requests_total |
counter | client, message |
legacy-profile hits |
freedome_mediaserver_clock_offset_seconds |
gauge | node, source |
clock offset to the time base |
freedome_mediaserver_clock_locked |
gauge (0/1) | node |
clock within the sync threshold |
freedome_mediaserver_audio_reactive_frames_total |
counter | input, outcome (applied, dropped) |
analysis frames received by AudioReactive |
freedome_mediaserver_audio_reactive_messages_total |
counter | gateway, outcome (sent, coalesced, failed) |
messages sent to gateways |
freedome_mediaserver_audio_reactive_stage_seconds |
histogram | stage (receive, map, send) |
time in each stage, for per-link measurement |
freedome_mediaserver_scenario_sessions |
gauge | scenario, status |
scenario sessions |
freedome_mediaserver_jobs |
gauge | kind, status |
jobs |
process_* |
— | — | standard process metrics (CPU, RSS, fds) |