Skip to content
ByteBrew Engine

Admin Dashboard: Audit Log

The Audit Log provides a complete, immutable record of all administrative actions performed on the engine. Every configuration change, authentication event, and API key lifecycle event is captured with full context.

What is logged

Section titled “What is logged”
  • Configuration changes — creating, updating, or deleting agents, models, tools, triggers, and MCP servers. Includes before/after state.
  • Authentication events — admin login attempts (successful and failed).
  • API key lifecycle — key creation (with scopes) and revocation.
  • Config operations — hot reload, import, and export events.
  • Settings changes — BYOK toggles, logging level changes.
Section titled “Filtering and search”

The audit log provides several filters to find specific events:

  • Actor type — filter by who performed the action (admin user, API key, system).
  • Action — create, update, delete, login, reload, import, export.
  • Resource — agent, model, tool, trigger, mcp_server, api_key, config, settings.
  • Date range — select a start and end date to narrow results.

Audit entry structure

Section titled “Audit entry structure”

Click any entry to expand the detail view with the full JSON payload:

{
  "id": "audit_abc123",
  "actor": "admin",
  "actor_type": "user",
  "action": "update",
  "resource_type": "agent",
  "resource_id": "sales-bot",
  "timestamp": "2025-03-19T14:30:00Z",
  "details": {
    "changes": [
      {
        "field": "max_steps",
        "old_value": 50,
        "new_value": 100
      },
      {
        "field": "tools",
        "old_value": ["web_search"],
        "new_value": ["web_search", "create_order"]
      }
    ]
  }
}

What’s next

Section titled “What’s next”