Subchapter 2.29
references/cli/api/asset/get-health.mdMarkdown1 KBView on GitHub
Get asset health and runtime status information.
dg api asset get-health <ASSET_KEY>For prefixed asset keys, use slash-separated syntax: dg api asset get-health my_prefix/my_asset.
The MCP server’s get_asset returns the same four status enums (asset_health, materialization_status, freshness_status, asset_checks_status) inside its health field, and is enough when you only need the status itself.
Params: asset_key (path segment list, e.g. ["my_prefix", "my_asset"]), deployment_name (both required).
The dg api asset get-health command additionally returns the evidence behind each status, none of which the MCP server exposes:
health_metadata — failing run ID, failed/missing/total partition counts, failed/warning/total check counts, last materialized timestamplatest_materialization — timestamp, run ID, and partitionfreshness_info — current lag, minutes late, maximum lag, cron schedulechecks_status — check status with its countsUse the dg command whenever you need to explain why an asset is degraded, not just that it is.