Skip to main content

Logs

The Logs page is the audit trail for every request Willow handles: tool calls, client connections, connector authentications, and AI agent interactions. Use it to see exactly what an AI agent did, on whose behalf, against which MCP server, and whether a guard acted on it. Open it from Monitor > Logs.

Logs page with Start Date, End Date, and Action Type controls, an Advanced Filters toggle, a search field, and a table with Date, Action, AI Agent, MCP Server, Tool / Status, User, Duration, Tokens, and Details columns

Filters

  • Start Date and End Date set the window of activity to show.
  • Search logs does a free-text search across the entries.

Action Type

The Action Type dropdown filters by the kind of event:

OptionEvent
All ActionsNo filter; show every event type.
InitSession initialization.
ConnectA client connecting to the gateway.
Connector AuthAn upstream connector authentication event, for example an OAuth completion.
Tool CallA tool invocation.
WebhookA webhook event.
MessagesA message exchanged with the agent, from any source: agent telemetry, guard hook evaluations, the browser extension, or a compliance sync.
ConversationsA conversation-level event.
Logs Action Type dropdown open, showing All Actions, Init, Connect, Connector Auth, Tool Call, Webhook, Messages, and Conversations

Source

With Action Type set to Messages, a Source selector appears alongside it. Every prompt and reply Willow collects lands in the same place, whichever pipeline reported it, and Source narrows the list to one of them:

SourceReported by
TelemetryThe agent's own OTLP telemetry (Claude Code, Codex, Cursor).
Guard HookA guard hook evaluation in an IDE or coding agent.
ComplianceThe Claude compliance sync.
ExtensionThe browser extension's Prompt Guard on a web AI chat.

A single prompt often reaches Willow twice — a Claude Code prompt is reported by both the hook evaluation and the OTLP export — and Willow stores it once, listing every source that contributed. Those rows show more than one source badge and match either Source value.

Advanced Filters

Select Advanced Filters to expand a row of additional selectors:

FilterScopes results to
UserA specific user.
AI AgentA specific client or agent.
MCP ServerA specific MCP server.
ToolA specific tool.
StatusOutcome: All, Success, or Failed.
Guard ActionThe action a guard took: All, Blocked, Warned, or Transformed.
GuardA specific guard.

The User, AI Agent, MCP Server, Tool, and Guard selectors are searchable lists populated from your organization's activity. The Guard Action and Guard filters are the fastest way to find events a guard acted on, for example every request that was Blocked.

Logs Advanced Filters expanded, showing User, AI Agent, MCP Server, Tool, Status, Guard Action, and Guard selectors

Table columns

The table supports search and sortable columns. Select a column header to toggle the sort order.

ColumnDescription
DateWhen the event occurred, shown as relative time (for example "10 days ago").
ActionThe event type, shown as an icon. Present only while Action Type is All Actions; filtering to a single type hides this column, since every row would carry the same value.
AI AgentThe client or agent that made the call (Cursor, Claude Code, VS Code, ChatGPT, and so on).
MCP ServerThe MCP server involved.
Tool / StatusThe tool that was called and whether it succeeded: a green check for success, a red ✗ for failure.
UserThe user the call belongs to.
DurationHow long the call took (for example 735ms or 4.37s).
TokensToken count for the call.
DetailsThe full event payload. Select it to open the details modal.

View log details

Hover a row and select the view (eye) icon, or select the row's Details, to open the Details modal: a scrollable, line-numbered JSON viewer showing the full event, including the MCP server and tool, arguments, the resolved user identity, the success flag, any guard decisions, and a performance breakdown.

Log Details modal showing a scrollable, line-numbered JSON viewer with mcp, tool, success, arguments, and performance fields

Export logs

Select the overflow (three-dot) menu at the top right. It offers:

  • Export CSV: download the currently filtered logs for compliance or analysis.
  • SCIM Logs: jump to the SCIM Logs page for identity-provisioning events.
  • Log Delivery: open the Log Delivery page to track delivery of audit logs to your external log providers.
Logs overflow menu open, showing Export CSV, SCIM Logs, and Log Delivery options

What to do next

  • Investigate with Logs: use these filters to diagnose common issues
  • SCIM Logs: audit identity-provider provisioning operations
  • Analytics: usage trends and performance metrics over time
  • Radar: flagged security and operations gaps