Observability & Debugging

Execution Logs

Every workflow execution produces a complete, immutable audit trail — allowing you to debug failures, analyze performance, and understand agent behavior at every step.

Why Execution Logs Matter

In AI automation, failures are inevitable — models hallucinate, APIs timeout, tools misbehave. This platform treats observability as a first-class feature. Logs are not an afterthought; they are the foundation for trust, safety, and reproducibility.

Observability Stack

Run History

Every workflow trigger creates a permanent execution record.

Step-Level Status

Track success, failure, retries, and timing for each step.

Payload Inspection

Full visibility into inputs, outputs, and intermediate results.

Log Structure

Logs are stored per task execution and indexed by workflow, step, and timestamp. This enables efficient querying, debugging, and replay.

FieldDescription
messageHuman-readable log message
levelLog severity: debug, info, success, warn, error
workerIdIdentifier of the worker that emitted the log
workflowIdID of the workflow being executed
taskIdID of the task execution
createdAtISO timestamp of the log entry
traceIdTrace ID for correlating logs across steps

Log Levels

debugDetailed diagnostic information.
infoGeneral informational messages.
successStep or workflow completed successfully.
warnPotential issues that do not stop execution.
errorFailures that caused a step or workflow to fail.

Filtering Logs

The Logs page supports filtering by level, workflow ID, task ID, search text, and date range. Use structured view for detailed inspection or raw terminal view for quick scanning.

Log API

GET/api/logs

List logs with filtering by level, workflowId, taskId, search, and date range. Supports pagination.