Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 22 additions & 4 deletions docs/cloud/features/observability/run.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,23 @@
# Runs

Run pages, like [plan pages](./plan.md), serve as centralized information sources that provide detailed insights into individual runs executed across your various environments.

They were created with the same philosophy as the plan pages, providing a consistent user experience and navigation pattern.

These pages act as a central hub where team members can monitor and understand all aspects of a run’s execution, from start to finish. Additionally, they can serve as a jumping off point for investigating run-related errors or unexpected behavior.

![tcloud run](./run/tcloud_run.png)

## When you might use this

If you're monitoring data pipelines, a common activity is verifying the status of the most recent run.

The run page provides a quick way to check whether a run has succeeded or failed and when exactly it was executed. The page includes a comprehensive view of all model executions and audits that were included in the run.

If you need deeper insights, the [Debugger View](../debugger_view.md) offers advanced analysis capabilities. This powerful tool allows teams to investigate which models are taking the longest time to update, helping identify potential performance bottlenecks in their data pipelines.

## Navigating to a Run page

Every SQLMesh `run` is applied to a specific environment. To locate a `run`, first navigate to its [Environment page](./development_environment.md).

The environment page's Recent Activity table includes a list of every recent `plan` and `run`. To learn more about a `run`, locate the `run` by application date and click on its blue ID link in the table's final column.
Expand All @@ -14,9 +32,9 @@ Clicking the link opens the detailed run overview page:

The top of the overview page summarizes the `run`, including:

- `Status`: completion status (completed, in progress, or failed)
- `When`: start and end times
- `Changes since previous run`: list of project changes that occurred since the previous `run`
1. `Status`: completion status (completed, in progress, or failed)
2. `When`: start and end times
3. `Changes since previous run`: list of project changes that occurred since the previous `run`

![tcloud run](./run/tcloud_run_summary.png)

Expand All @@ -32,6 +50,6 @@ The lower portion of the page contains a table with three tabs.

![tcloud run model executions](./run/run_audits.png)

`Explore Executions`: interactive view of executed models, including a lineage graph of model dependencies, and detailed information about impact analysis, model definitions, time intervals processed, and links to associated logs
`Explore Executions`: interactive view of executed models, including a lineage graph of model dependencies, and detailed information about impact analysis, model definitions, time intervals processed, and links to associated logs (learn more on the [Debugger View page](../debugger_view.md))

![tcloud run model executions](./run/run_explore_executions.png)
Binary file modified docs/cloud/features/observability/run/tcloud_run_summary.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.