get_asset_health
Checks if assets are healthy and up-to-date. Returns freshness, staleness reasons, and last materialization status for an asset or group.
Instructions
Get a consolidated health view for a single asset or all assets in a group.
This is the BEST tool to assess whether assets are healthy and up-to-date.
asset_key_or_group: pass either a single asset key (e.g. 'my_report') or a group name (e.g. 'analytics'). If it matches a group, returns health for ALL assets in that group.
Returns per asset:
asset_key, group, description
last_materialization: {run_id, timestamp, status} of the latest run
freshness_policy: {maximum_lag_minutes, cron_schedule} if defined
staleness: {is_stale, reasons[]} explaining why the asset is stale
When to use: to check if critical assets are fresh, find stale assets in a group, or verify that recent materializations succeeded. Prefer this over get_recent_materializations when you need a health assessment rather than raw materialization history.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| env | No | ||
| asset_key_or_group | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |