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)