network-health-sweep

name	Network Health Sweep
when_to_use	When running a portfolio-wide or single-client network health check across whatever network monitoring tools are connected. Use when: network health, network audit, device down, device offline, interface errors, interface utilization, topology change, network status review, is the network okay.
description	Use this skill when checking device and network health across whatever network-monitoring tools (Auvik, Meraki, Domotz) are connected through the gateway. Covers device-down detection, interface error/utilization thresholds, topology-change detection, and how to reconcile each vendor family's different data model — Auvik's device/interface model, Meraki's dashboard-org/network model, Domotz's agent-based collector model — into one normalized health view. Always use conduit__search_tools to discover what's actually connected before assuming a specific vendor's tool names.

Network Health Sweep

Overview

"Is the network healthy" is a portfolio question, not a single-device question. This skill runs a normalized health check across every connected network-monitoring tool and rolls the result up into one ranked view — the same sweep a senior network engineer would run by hand across each vendor's console, made explicit, repeatable, and vendor-agnostic.

This is infrastructure-substrate health: is the network itself up, are interfaces clean, has the topology changed unexpectedly. It is not ticket triage (see ops-pack) and it is not application-layer reliability (see devops-pack, if connected) — this skill only answers whether the wires, switches, firewalls, and access points a client depends on are functioning.

Discovering available tools first

Because this pack is cross-vendor, never assume which network-monitoring tool is connected, or what its tools are literally named:

1. Call conduit__search_tools with a query like "list devices", "network health", or "device status" to discover which network-monitoring connector(s) are actually live for this org, and the exact tool names each exposes (they follow <vendor-slug>__<tool_name>, e.g. auvik__devices_list, meraki__list_networks, domotz__list_agents).
2. More than one network-monitoring tool can be connected at once (e.g. Auvik for one site, Meraki for another) — discovery may return multiple vendor families. Sweep all of them; do not stop at the first match.
3. Only after discovery, call the concrete tools that came back. Never speculatively call a tool name that discovery didn't return — an unrecognized tool call is a worse failure mode than reporting "no network monitoring connector found."

Key Concepts

Each vendor family's data model, and how they normalize

Concern	Auvik	Meraki	Domotz
Unit of "connected"	Tenant → Network → Device → Interface	Organization → Network → Device	Agent (collector) → Network → Device
Device-down signal	Device status field (online/offline/warning) via auvik__devices_list / auvik__devices_get_details	Device status via Meraki's device/network status tools	Device status per agent, reported by the local Domotz collector
Interface/link health	Per-interface stats (errors, discards, utilization) via auvik__interfaces_list / auvik__statistics_interface	Per-port/uplink stats surfaced at the network/device level	Interface-level detail is thinner — Domotz is stronger on device reachability than deep interface counters
Topology-change detection	Auvik's core differentiator — topology/config diffs surfaced via configuration and audit history tools (auvik__configurations_list, auvik__entities_list_audits)	Not a first-class primitive — infer from device/network membership changes between sweeps	Agent-scoped network scans can surface new/missing devices between runs
Collection unit that can itself be "down"	N/A — cloud-polled via SNMP/API	N/A — cloud-managed dashboard	The agent itself — if the collector host is offline, every device behind it reads as unknown, not necessarily down. Always check agent status first.

Normalize every vendor's native status into one shared health taxonomy before combining results:

• Down — device confirmed offline/unreachable.
• Degraded — device online but showing interface errors, high utilization, or a warning-level status.
• Unknown — the collector/agent responsible for that device can't be confirmed healthy itself (this matters most for Domotz — an offline agent means "unknown," not "down," for everything behind it).
• Healthy — no findings.

Interface errors and utilization thresholds

In the absence of a documented client-specific threshold, use these as defaults and state clearly that they're defaults, not tuned policy:

• Utilization — sustained (not momentary) utilization above 80% on an uplink or trunk interface is a capacity/degradation flag; above 90% is urgent.
• Errors/discards — any non-zero, climbing error or discard counter on an interface across two consecutive sweeps is a degraded-link flag. A single static, non-climbing count is likely historical and lower priority.

Topology-change detection

A topology change (new device joins, a device disappears, an uplink moves) is not automatically bad — but it's a signal that deserves a callout, because unplanned topology changes are how MSPs miss rogue devices or a client's in-house change that wasn't communicated. Where the connected tool exposes audit/config history (Auvik is strongest here), surface changes since the last sweep rather than silently absorbing them into the current-state view.

Common Workflows

Portfolio-wide sweep

1. Discover connected network-monitoring tools via conduit__search_tools (see above).
2. For each connected vendor family, pull the device/network list and resolve status per the normalized taxonomy above.
3. For Domotz specifically, check agent/collector status first — an offline agent invalidates the "down" reading for everything behind it, so it should be reported as its own top-line finding, not buried under a wall of "unknown" devices.
4. Pull interface-level detail where the vendor exposes it (strongest on Auvik) and apply the utilization/error thresholds above.
5. Where available, pull topology/config-change history since the last sweep and surface it as its own section.
6. Roll up into one ranked list: Down first, then Degraded, then Unknown-due-to-collector-issue, then a topology-changes section, then a clean summary count of Healthy devices.

Single-client or single-site check

Same steps, scoped to the client/site/network identified by the caller. Resolve the client/network first (name lookup) before pulling device data — don't assume a network ID.

Error Handling

No network-monitoring connector discovered

Say so explicitly: "No network-monitoring connector (Auvik, Meraki, or Domotz) is available through the gateway, so there's no network health data to report." Do not fabricate device status.

One vendor connected, others aren't

Report on what's connected and state plainly which vendor families weren't available — never silently narrow scope without saying so.

Domotz agent itself is offline

Call this out as the top-line finding for that site, not a footnote — every device behind an offline agent should read as "unknown, pending agent recovery," not "healthy" (no news isn't good news when the collector can't report) or "down" (unconfirmed).

Vendor tool call fails mid-sweep

Report the partial results gathered so far, note which vendor/section failed and why, and don't let one vendor's failure suppress the rest of the report.

Best Practices

• Always discover tools before calling them — never hardcode a vendor's tool name.
• Keep each vendor's native status visible alongside the normalized status in the output, so a technician can cross-check against the vendor's own console if needed.
• State default thresholds explicitly when no client-specific policy is known, so the reader can tell a tuned judgment from an assumed one.
• Treat an offline collector (Domotz agent) as a distinct failure mode from a down device — conflating them produces false "everything is down" reports.
• Don't silently drop a vendor family from the sweep because a lookup failed — report the gap.

Related Skills

• Cloud Capacity Planning — the cloud side of infrastructure health, for Azure/DigitalOcean resource right-sizing rather than network device/link health
• Cloud Cost Management — spend anomalies and reclaimable cost, a different axis from health