Logs

The Logs block finds workflow runs in the current workspace and reads their details. Use it to investigate failures or summarize runs without loading every trace at once.

Find failed runs

Name the query block Find Runs and the detail block Details so the references below match.

  1. Set Operation to Query Logs, Status to error, and Time Range to Past 24 hours.
  2. Pass <findruns.runIds> to a ForEach Loop.
  3. Inside the loop, use Get Run Details with <loop.currentItem> as Run ID.
  4. Inspect <details.traceSpans> or pass the protected trace to an Agent for diagnosis.

A Sim trigger can supply a runId directly, so you can skip the query when handling a specific run event.

Configuration

Query logs

Returns matching run IDs. Newest first is the default order.

FieldBehavior
WorkflowsSelect workflows, or leave empty for all. Advanced mode accepts comma-separated IDs.
StatusFilter by info, error, running, pending, or cancelled; leave empty for all.
TriggersSelect trigger types, or leave empty for all. Advanced mode accepts comma-separated types such as api, schedule, or slack.
Time RangeAll time or a preset from 30 minutes to 30 days. Advanced Start Date and End Date accept ISO timestamps.
CostCompare cost with a credit threshold, such as at least 10 credits.
DurationCompare duration with a threshold in milliseconds.
LimitMaximum IDs returned: default 100, maximum 200.
Sort By / Sort OrderAdvanced sorting by date, duration, cost, or status, ascending or descending.

Get run details

Enter one Run ID to fetch its protected trace, final output, and run metadata.

Outputs

OperationOutputs
Query LogsrunIds: matching IDs; count: IDs returned
Get Run DetailsrunId, workflowId, workflowName, status, trigger, startedAt, durationMs, cost, traceSpans, finalOutput

Read a block named Details with references such as <details.traceSpans> and <details.finalOutput>. Costs use credits in both filters and outputs.

traceSpans and finalOutput use the protected log-facing projection described in execution log protection. They do not expose every internal runtime value or change the workflow's runtime result.

Retention

Queries can only return retained logs. On Sim Cloud, Free's default log retention is 30 days; paid plans have no default expiry. Organization and workspace policies can change effective retention. Billing-disabled self-hosted deployments have no plan-based default expiry, but configured retention still applies. See data retention.