Host Agent transport failures
Symptoms
Section titled “Symptoms”- Inventory only via Cloud though Edge is on LAN
- Rapid switching between Edge and Cloud paths
- 401/403 on ingest after approval
host_inventoryitems silently never appear in Assets/CMDB despite the agent reporting success
Checks
Section titled “Checks”| Check | Action |
|---|---|
| Always Cloud, never Edge | Expected today — Edge doesn’t advertise _edgezu-gateway._tcp yet (see Transport) |
| Edge gateway down | edgezu-hostagent-gateway service on Edge |
| Secret mismatch | Regenerate enrollment_secret for site |
| Token revoked | Re-approve or re-enroll host in Cloud UI |
| Sticky/fail-fast | First error switches path — inspect Edge LAN connectivity |
| Snapshot never lands in Assets | Confirm the snapshot actually reached Ingestor (DeviceConfig::ingest_base() on Edge, ingest_base_url on the host agent) — Cloud Backend has no ingest endpoint of any kind, so a misconfigured cloud_base_url/api_base() target would 404 rather than silently succeed. Check Ingestor logs for the batch and confirm internal/domain/hostinventory’s Asset-merge step didn’t error (merge failures are logged but don’t fail the ingest response). See Payload & ingest. |
Expected behavior
Section titled “Expected behavior”- Sticky on last good path; first push error triggers immediate fallback.
- Periodic rediscovery attempts to return to Edge when available.