chio doctor

Diagnose the local toolchain, guard registry, telemetry exporter, and chio.yaml, with exit codes that separate warnings from errors.

On this page

Diagnose toolchain, registry, OTEL, and chio.yaml health.

All command families · Global flags

Usage

Command synopsistext

chio doctor [OPTIONS]

--json Emit a structured JSON report on stdout instead of human text.
--fix Run idempotent repairs after probes complete. Destructive repairs are explicitly rejected.
--skip-network Skip probes that would otherwise reach the network. Useful in CI sandboxes; equivalent to CHIO_DOCTOR_SKIP_NETWORK=1.

Additional behavior

Probes (in order):

1. Toolchain version vs. workspace MSRV / rust-toolchain.toml. 2. OCI guard registry reachability. 3. Cosign guard-bundle freshness. 4. OTEL exporter endpoint resolution. 5. Kernel runtime /metrics (asserts the chio_kernel_dispatch_inflight gauge is reachable). 6. chio.yaml schema validity.

Exit codes follow the worst observed severity: 0 for ok / info / warning, 1 for error, 2 for fatal. The optional --fix flag runs idempotent repairs only; destructive operations are rejected.

Example

Run in the deployment environment to collect structured local diagnostics without network probes. Exit 0 includes warnings, so read the report; 1 means error and 2 means fatal.

Terminalbash

chio doctor --json --skip-network

Read more in Observe and diagnose the node.

PreviousCLI task index