Audit Logging

Aigentic maintains a comprehensive audit log of all significant actions taken by agents and the platform. The audit log provides accountability and helps you monitor what your agents are doing.

What Gets Logged

Agent Events

Event	Description
`agent.created`	A new agent was created
`agent.config_changed`	Agent configuration was modified
`agent.deleted`	An agent was deleted

Tool Invocations

Event	Description
`tool.invoked`	A tool was called by the agent
`tool.completed`	A tool invocation completed successfully
`tool.failed`	A tool invocation failed
`tool.denied`	A tool invocation was blocked by permissions

Tool invocation logs include the tool name, input parameters, output summary, and execution duration.

Channel Events

Event	Description
`channel.connected`	A channel connection was established
`channel.disconnected`	A channel was disconnected
`channel.message_received`	A message was received from an external platform
`channel.message_sent`	A response was sent to an external platform
`channel.error`	A channel error occurred

Credential Events

Event	Description
`vault.secret_added`	A new credential was added
`vault.secret_removed`	A credential was removed

Scheduling Events

Event	Description
`schedule.task_triggered`	A scheduled task started executing
`schedule.task_completed`	A scheduled task completed
`schedule.task_failed`	A scheduled task failed

Skill Events

Event	Description
`skill.installed`	A skill was installed
`skill.removed`	A skill was uninstalled

Viewing the Audit Log

In the Console

Audit log entries appear in the Analytics page (under Recent Activity) and the Security dashboard. To view them:

Open Analytics from the sidebar to see recent activity.
The log shows events in reverse chronological order (newest first).
Use the filters to narrow down:
- Agent — Show events from a specific agent
- Event type — Filter by event category
- Date range — Show events within a time window
- Status — Filter by success, failure, or denied

Per-Agent Activity

Each agent’s dashboard includes an activity view showing audit events specific to that agent.

Search

The audit log supports text search across event details. Search for tool names, channel names, error messages, or any text in the log entries.

Log Format

Each log entry contains:

{
  "timestamp": "2026-01-15T08:30:45.123Z",
  "event": "tool.invoked",
  "agent_id": "agent-abc123",
  "agent_name": "Research Assistant",
  "details": {
    "tool": "web_search",
    "input": {
      "query": "latest AI safety research papers"
    },
    "source": "chat"
  },
  "status": "pending"
}

Log Integrity

The audit log is append-only. Entries cannot be modified or deleted through the application interface. This ensures a reliable record of all agent activity.

Alerting

Aigentic displays notifications for significant audit events:

Tool denied — A tool invocation was blocked by permissions
Scheduled task failed — A recurring task encountered an error
Channel error — A channel connection failed