Skip to main content

Logs

Logs lists every event your agents emit: conversation turns, tool calls and errors. Open it from your project under Observe → Logs.

Use Logs to find out why something happened on a call. To read or listen to a whole conversation, use Calls & transcripts. See Conversation data.

Read the log​

Each row is one event, newest first:

ColumnWhat it shows
TimeWhen the event happened.
Agent · channelThe agent and the channel (phone, widget, chat and so on).
Event · toolThe event type, or the tool's name for a tool call.
MessageWhat happened. Errors are red and warnings are amber.
DurationHow long it took, for events that have one, such as a tool call.

The page loads 50 events at a time. Click Load more at the bottom for the next batch.

Filter​

  • Search: message text, tool names or error codes.
  • Level: All, Error, Warning or Info. Start with Error when something went wrong.
  • Agent, Channel and Event: narrow to one of each.
  • Date range: a start and end day, in your local time.

Filters are saved in the page address, so you can bookmark a filtered view or send it to a teammate. An agent's or channel's View logs link opens Logs already filtered to it.

Open the conversation​

Click a row, or the arrow at its end, to open that conversation in Calls & transcripts. There you can:

  • read the transcript turn by turn, search it and copy it
  • see the session details: duration, response time and tool calls
  • play or download the recording, if your organization records calls

Recording is off until your organization turns it on, and recordings and transcripts are deleted when the project's retention period ends. See Conversation data.

"Unknown agent"​

A log entry or session shows Unknown agent when the agent that handled it has been deleted. The events and transcripts are kept until retention removes them, but they're no longer linked to an agent, so filtering by agent won't find them. Use the date range or search instead.

Export logs​

Logs aren't exported from this page. Open Reports (under Observe), pick a date range, select Logs, and download CSV or JSON. Timestamps are in UTC. See Export.

How long logs are kept is set by the Agent logs retention period. See Retention.

Logs and the audit log​

They record different things:

LogsAudit log
RecordsWhat agents did during conversations: turns, tool calls, errors.What people and API keys did in the console: member and role changes, API key events, settings changes.
WhereObserve → LogsSettings → Audit log (project), or Organization → Audit log
Use it toDebug an agent or a call.Check who changed what.

See Access control.

Plans​

Logs are part of your plan's logging feature. If your plan doesn't include it, the page shows an upgrade notice.

Was this page helpful?
On this page
Try it in the consoleBuild an agent and test it in the Playground.Open console →