OBSERVERTC / Overview

Components and responsibilities

Choose the library that owns the work you need to do.

Start with Client Monitor to inspect an endpoint. Add Observer when your backend needs to combine reports from participants. Schemas define their shared sample contract, and codecs optionally reduce the cost of transporting those samples.

ComponentResponsibilityWhat your application provides
Client MonitorRead browser statistics, derive metrics, evaluate endpoint conditions, and create samples.Existing connections, application context, and any sample transport.
ObserverMaintain live call/client state, mirror reported issues, and run registered server analysis.Authenticated ingestion, validation, identity mapping, and storage.
SchemasDefine the records and types carried by ClientSample.A compatible producer/consumer contract.
CodecsEncode and decode changes between successive samples.Ordered delivery and a separate stateful stream per client.

Supporting projects

The Stats Dashboard and STUNner demo provide examples and tools around the libraries. They are not required to embed Client Monitor or Observer. Read their repositories for deployment requirements.

Keep telemetry separate from media

The monitoring pipeline transports statistics and application records, not audio/video. Your application’s signaling and media infrastructure continue to establish and carry the call. See Architecture for the integration boundaries.

Version coverage varies by reference. Source revisions · Markdown source