health

kix health checks that the resources of a cluster’s Active activation are all present. It reads the kix.run/depends-on annotations on live resources and confirms each named dependency exists, identified by its identity hash. It checks presence only; use kix drift to compare field content. It does not build the cluster.

This page is hand-maintained. Check cli/kix-cli/src/cli.rs and cli/kix-cli/src/commands/health.rs when in doubt.

Synopsis

kix health <CLUSTER> [--flake <FLAKE>] [--context <CONTEXT>] [-v | -vv] [-q]

Argument or flag	Meaning
<CLUSTER>	Cluster name, as recorded on its Activation records.
--flake <FLAKE>	Flake reference used to evaluate the cluster name when no Activation record in the context carries <CLUSTER>. See Global flags.
--context <CONTEXT>	Kubeconfig context.
-v, -vv	-vv prints each resource and dependency as it is checked.
-q, --quiet	Omit the connection and count lines.

The output is text only; -o has no effect. See Global flags.

Scope

Kix finds the cluster’s Active Activation record and walks its dependencies. Resources that the Active activation does not reach, such as leftovers from superseded activations, are not reported.

Statuses

Resource status	Meaning
in-sync	Present, and every dependency is present
imported	An import marker for a resource Kix does not manage
missing	A dependency named by a present resource and not found on the cluster
at risk	Present, but depends on a missing or at-risk resource

Each package line reads healthy, external, DEGRADED (a missing resource), or AT RISK. Packages with problems are expanded below the summary.

Kix reads the sealed manifest for a dependency’s hash from the local Nix store to name a missing resource. On a machine that never built this activation, missing resources are shown by hash.

A finished Job counts as present. Jobs that Kix builds do not delete themselves, so a Job that is gone is missing, whether it finished or not.

Examples

❱ kix health demo

❱ kix health demo -vv

Exit status

Code	Meaning
0	Every package is healthy or external
1	A resource is missing or at risk; no Active record exists for the cluster; or a cluster error

Use it in a task

See Check cluster health for acting on missing or at-risk resources.