## Logs

The Logs screen provides a detailed view of every MCP tool execution that passes through your Agen for SaaS gateway. Each log entry captures the full lifecycle of a tool call — from the initial request through authentication, policy evaluation, and response.

![logs](/assets/logs.bf263486dbc298d793739cfa9aeaa7063c97407fc35485460fd8a606784ec2e6.212f8da4.png)

### Log list view

The Logs screen displays a searchable, filterable table of events. Each row represents a single MCP interaction.

You can filter logs by:

- **Time range** — Select a specific date range.
- **Tool** — Filter by tool name.
- **User** — Filter by user identity.
- **Status** — Filter by outcome (success, denied, pending approval).


### Log detail view

Click any log entry to expand its detail panel. The detail view shows the full structured log in JSON format, including:


```json
{
  "timestamp": "2026-02-03T14:22:31.456Z",
  "tool": "Create_a_new_expense",
  "method": "POST",
  "path": "/api/expenses",
  "user_id": "u-12345",
  "tenant_id": "acme-inc",
  "ai_platform": "ChatGPT",
  "policy_action": "allow",
  "access_control": "passed",
  "data_protection": "applied",
  "response_status": 200,
  "duration_ms": 342
}
```

### Using logs for troubleshooting

- **Policy denials** — Filter by denied status to see which policies blocked tool calls and why.
- **Approval bottlenecks** — Filter by pending approval status to identify requests waiting for human review.
- **Performance issues** — Sort by duration to find slow tool calls that may need optimization.
- **Access control issues** — Look for access control failures to verify that role/permission mappings are correct.


### Related topics

- [Monitoring overview](/agen-for-saas/monitoring/overview)
- [Streaming logs](/agen-for-saas/monitoring/streaming)
- [Policies](/agen-for-saas/policies/overview)