get_run_logs
Fetch structured log events for a run with optional severity filtering and pagination. Use for detailed run investigation when a failure summary is insufficient.
Instructions
Get structured log events for a run, with optional severity filtering and pagination.
Returns events with __typename, timestamp, message, level, and (where applicable) stepKey and error details. Events include step starts/completions, failures, retries, materializations, and run-level events. EngineEvent events also carry metadataEntries — a list of {label, description, value} dicts (e.g. run worker image, k8s pod name, step keys) surfaced by the engine.
Parameters:
run_id: the run to fetch logs for
level_filter: only return events at this level or above. Values: 'DEBUG', 'INFO', 'WARNING', 'ERROR'. When set to 'ERROR', also includes ExecutionStepFailureEvent and RunFailureEvent regardless of their level field. Default: None (return all events).
cursor: pagination cursor returned in previous response. Pass the cursor from the last call to get the next page.
limit: max events per page (default 100)
When to use: to investigate what happened during a run. For a quick failure diagnosis, prefer get_run_failure_summary instead — it returns a consolidated view in a single call. Use get_run_logs when you need the full event stream or want to filter by level.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| env | No | ||
| limit | No | ||
| cursor | No | ||
| run_id | Yes | ||
| level_filter | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||