# Logging & Audit Trail

> All decisions are logged so you can review what happened and why.

Source: https://bifrost5.com/foundry/docs/logging/

# Logging and Audit Trail

Information

Watch the audit trail live from your phone, browser or terminal, and get a chat message when something important happens, with Production-Grade.

[See editions](/foundry/docs/editions)

## Where to Look

- **Audit log**: `sandbox/

/audit.log.jsonl`: append-only, task lifecycle, state diffs, events

- **Verbose logs**: stdout (PM2 captures with `pm2 logs supervisor`)

- **Prompt logs**: `prompts.log.jsonl` (if enabled): full prompts and responses for debugging

## What Gets Logged

- State transitions (RUNNING, HALTED, COMPLETED, BLOCKED)

- Task start / complete / blocked

- Validation results and retries

- Halt reason and details

- Provider and circuit breaker events

- Performance analytics (helper durations, cache-hit rate, token usage)

All decisions are logged so you can review what happened and why.
