guest_health_summary
Provide a single read-only health summary per guest: live status, resource pressure, filesystem headroom, Docker container health, and backup recency, with actionable concerns.
Instructions
One consolidated read of a guest, on exactly the node named.
Read-only and idempotent. Combines live status, resource pressure against the guest's
configured limits, filesystem headroom, Docker container health counts, snapshot and
backup recency, and a short list of concrete concerns. Prefer this over calling
get_guest_status, list_snapshots, list_backups, and list_guest_containers
separately when the question is "how is this guest doing".
Each entry in concerns is a whole sentence naming both the observation and the
threshold it crossed, so it can be quoted to an operator without further interpretation.
An empty list means nothing that was read crossed a threshold; it does not mean everything
was read, which partial and warnings report.
Three states stay distinguishable and none of them is an error. A guest that is not
running reports its state, a warning, and no resource figures, because the zeroes the
cluster carries for it describe nothing. A guest without Docker reports
docker_available false and no container counts. A guest with no backup reports
backup_count 0 and a null age, never an age of zero.
A vmid the cluster does not report on the node named raises a structured error naming
both. Anything that could not be read yields a warning and partial, never an exception
that hides the rest of the answer.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | Yes | ||
| vmid | Yes | ||
| profile | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | Yes | ||
| swap | No | ||
| vmid | Yes | ||
| cores | No | ||
| memory | No | ||
| source | Yes | ||
| status | Yes | ||
| partial | No | ||
| profile | Yes | ||
| concerns | No | ||
| warnings | No | ||
| containers | No | ||
| filesystem | No | ||
| guest_type | Yes | ||
| backup_count | No | ||
| collected_at | Yes | ||
| snapshot_count | No | ||
| uptime_seconds | No | ||
| docker_available | No | ||
| newest_backup_at | No | ||
| cpu_used_fraction | No | ||
| newest_snapshot_at | No | ||
| newest_backup_age_seconds | No | ||
| newest_snapshot_age_seconds | No |