From 6b3ffda6a0dbe8c3e540a3603f739bae6aa8f10e Mon Sep 17 00:00:00 2001 From: Eric Wetzel Date: Tue, 14 Jul 2026 20:59:24 +0000 Subject: [PATCH 1/2] docs: add scout version to ingestion troubleshooting --- .../stuck_objects/host_ingestion_failures.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/playbooks/stuck_objects/host_ingestion_failures.md b/docs/playbooks/stuck_objects/host_ingestion_failures.md index cdbb93d3b2..f404eef607 100644 --- a/docs/playbooks/stuck_objects/host_ingestion_failures.md +++ b/docs/playbooks/stuck_objects/host_ingestion_failures.md @@ -91,6 +91,23 @@ Look for: - NIC or DPU pairing problems - SKU or validation input mismatch +### Check the Scout version + +NICo records the build version of Scout most recently observed during machine +discovery. Use this value to determine whether ingestion or validation failures +may correlate with a specific Scout release: + +```bash +nico-admin-cli -a -f json machine show \ + | jq -r '.last_scout_observed_version // "unknown"' +``` + +The `last_scout_observed_version` value is updated whenever Scout registers the +host during discovery and remains associated with the machine after assignment. +It identifies the last discovery image, not necessarily a currently running agent. +The value is `null` for machines that have not completed discovery with a Scout +version that reports it, and a later Scout discovery replaces the stored value. + ## Validation and SKU After discovery, ingestion may block on validation. From 65b081be596ccc066f5592c474e7626764349d7b Mon Sep 17 00:00:00 2001 From: Eric Wetzel Date: Tue, 14 Jul 2026 21:15:15 +0000 Subject: [PATCH 2/2] fix whitespace --- docs/playbooks/stuck_objects/host_ingestion_failures.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/playbooks/stuck_objects/host_ingestion_failures.md b/docs/playbooks/stuck_objects/host_ingestion_failures.md index f404eef607..1b524e6b97 100644 --- a/docs/playbooks/stuck_objects/host_ingestion_failures.md +++ b/docs/playbooks/stuck_objects/host_ingestion_failures.md @@ -105,7 +105,7 @@ nico-admin-cli -a -f json machine show \ The `last_scout_observed_version` value is updated whenever Scout registers the host during discovery and remains associated with the machine after assignment. It identifies the last discovery image, not necessarily a currently running agent. -The value is `null` for machines that have not completed discovery with a Scout +The value is `null` for machines that have not completed discovery with a Scout version that reports it, and a later Scout discovery replaces the stored value. ## Validation and SKU