Logs

Your agent writes log records while it runs a session: what it’s doing, warnings, and errors. You control how much it logs with log_level, read the logs of any session on the Dashboard, and can ship them to your own observability stack.

Set the log level

Set log_level on the room’s Observability to choose which records the agent emits. The agent logs records at that level and above.

from zeroruntime import Observability, Room

room = Room(
    observability=Observability(
        log_level="INFO",
    ),
)

import { Observability, Room } from '@zeroruntime/js-sdk';

const room = Room({
  observability: Observability({
    log_level: 'INFO',
  }),
});

Level	Logs
`DEBUG`	Everything, including detailed internal steps. Use it while developing.
`INFO`	Normal activity, warnings, and errors. This is the default.
`WARNING`	Warnings and errors only.
`ERROR`	Errors only.
`CRITICAL`	Critical errors only.

View logs on the Dashboard

Every session’s logs are kept on the Zero Runtime Dashboard. Open Sessions, click Actions > View on a session, then select the Logs tab. Logs are listed newest first.

Column	Shows
`Timestamp`	When the record was written.
`Level`	The record’s level, such as `Info` or `Error`.
`Logger`	The component that wrote the record, such as the metrics collector or the pipeline orchestrator.
`Message`	The log message.

Use Showing at the bottom of the table to set how many records appear on a page, and Previous and Next to page through the rest. Only records at or above the session’s log_level appear here.

Session view on the Zero Runtime Dashboard with the Logs tab selected, showing a table of log records with Timestamp, Level, Logger, and Message columns, and pagination controls below — The Logs tab of the Session view, listing each record's timestamp, level, logger, and message

Export logs to your observability stack

To send logs to your own observability stack, such as Datadog, SigNoz, or New Relic, set logs on the room’s Observability to an Exporter that points at your collector’s OpenTelemetry (OTLP) endpoint. log_level applies to exported logs too.

import zeroruntime
from zeroruntime import Exporter, Observability, Room

if __name__ == "__main__":
    zeroruntime.serve(
        MyVoiceAgent,
        room=Room(
            name="Logs Agent",
            observability=Observability(
                logs=Exporter(
                    enabled=True,
                    export_url="https://otel-collector.example.com/v1/logs",
                ),
                log_level="INFO",
            ),
        ),
    )

import * as zeroruntime from '@zeroruntime/js-sdk';
import { Exporter, Observability, Room } from '@zeroruntime/js-sdk';

zeroruntime.serve(MyVoiceAgent, {
  room: Room({
    name: 'Logs Agent',
    observability: Observability({
      logs: Exporter({
        enabled: true,
        export_url: 'https://otel-collector.example.com/v1/logs',
      }),
      log_level: 'INFO',
    }),
  }),
});

Replace the example URL with your collector’s logs endpoint. Set the Room on serve() to apply it to every session, or on invoke() to apply it to one session.

Exporter field	Type	Default	Description
`enabled`	`bool`	`True`	Turns the log export on or off. Set it to `False` to stop exporting while keeping the rest of the configuration.
`export_url`	`str`	`None`	The OTLP endpoint to send logs to. `None` uses the runtime’s default destination.
`export_headers`	`dict[str, str]`	`{}`	Headers sent with each export. Put your vendor’s API key or auth header here.

Leaving logs unset is not the same as turning it off. An unset stream follows the runtime’s default settings. To stop exporting logs, pass Exporter(enabled=False).

Get started

Quickstarts

Build

Testing and Eval

Observability

Deploy

Plugins

Set the log level

View logs on the Dashboard

Export logs to your observability stack

What’s Next

Metrics

Traces

References

Examples

Observability Hooks

Examples

Pipeline Events

​Set the log level

​View logs on the Dashboard

​Export logs to your observability stack

​What’s Next

Metrics

Traces

​References

​Examples

Observability Hooks

​Examples

Pipeline Events

Set the log level

View logs on the Dashboard

Export logs to your observability stack

What’s Next

References

Examples

Examples