Observability Options

Zero Runtime captures recording, traces, and metrics for every session. Recording is configured directly on serve() and on the per-session Room passed to invoke(). Traces and metrics are collected automatically and shown on the Zero Runtime Dashboard with no extra setup.

Capability	Where you configure it
Recording	`serve(recording=...)` or the per-session `Room(recording=True)` / `invoke(..., recording_config=...)`.
Traces & metrics	Collected automatically for every session and shown on the Dashboard.

Quick Start

Record sessions (audio + video):

import zrt
from zrt import RecordingConfig

AGENT_ID = "assistant"

if __name__ == "__main__":
    zrt.serve(
        Assistant,
        recording=RecordingConfig(enabled=True, record_video=True),
        on_ready=lambda: zrt.invoke(
            AGENT_ID,
            room=zrt.Room(
                playground=True,
                recording=True,
            ),
        ),
    )

Recording

Audio is recorded by default; video and screen share are opt-in. Pass a RecordingConfig to serve(recording=...) to set defaults for every session. See Recording for the full lifecycle.

Parameter	Type	Default	Description
`record_video`	`bool`	`False`	Record the agent’s camera video track (composite audio + video).
`record_screen_share`	`bool`	`False`	Record the screen-share track. Requires `vision=True` on `serve()` / `Room`.

import zrt
from zrt import RecordingConfig

zrt.serve(
    Assistant,
    vision=True,
    recording=RecordingConfig(
        enabled=True,
        record_video=True,
        record_screen_share=True,
    ),
    on_ready=lambda: zrt.invoke("assistant", room=zrt.Room(playground=True)),
)

Traces & metrics

Traces and metrics are collected for every session and shown on the Zero Runtime Dashboard automatically (no configuration needed). For programmatic, in-process access to metrics, use Pipeline Observability hooks (@pipeline.metrics.on(...)).

What’s Next

Session Analytics

Review sessions on the Dashboard.

Trace Insights

Drill into per-turn traces and spans.

References

Python

Examples

Observability Hooks

Configure what is observed in a session.

SDK Reference

Metrics

Metrics in the Python API reference.

Pipeline Hooks

Pipeline Hooks in the Python API reference.

Get started

Modalities

Configure Pipeline

Tools and Capabilities

Turn Detection and Interruptions

Telephony Agents

Context Management

Observability and Monitoring

Quick Start

Recording

Traces & metrics

What’s Next

Session Analytics

Trace Insights

References

Examples

Observability Hooks

SDK Reference

Metrics

Pipeline Hooks

​Quick Start

​Recording

​Traces & metrics

​What’s Next

Session Analytics

Trace Insights

​References

​Examples

Observability Hooks

​SDK Reference

Metrics

Pipeline Hooks

Quick Start

Recording

Traces & metrics

What’s Next

References

Examples

SDK Reference