Skip to main content

Device Status

The Device Status page provides a real-time overview of all network devices managed within your tenant, including dedicated edges, shared gateways (MTGEs), and connectors.

Status Indicators

Each device displays a color-coded status indicator based on its heartbeat activity:

StatusIndicatorMeaning
OnlineGreenThe device is actively reporting. Heartbeat received within the expected threshold.
OfflineRedNo heartbeat has been received from the device. It may be powered off, disconnected, or unreachable.
DegradedYellowThe device is reachable but experiencing partial functionality issues (e.g., a tunnel is down or an interface is in error state).

Devices report their status via periodic heartbeats. Dedicated edges and MTGEs send an inform message every 60 seconds containing VPP interface statistics. Connectors send a keepalive every 30 seconds.

Device Information

For each device, the status page displays:

  • Device Name and Serial Number -- Identifies the device in your network.
  • Last Seen -- The timestamp of the most recent heartbeat or inform message from the device. This tells you exactly when the device last reported in.
  • WAN IP -- The current public IP address of the edge, extracted from the VPP interface inform data. This is useful for verifying the device's internet-facing address, especially after network changes.
  • Config Sync Status -- Shows whether the device's running configuration matches the orchestrator's desired configuration. Possible states include:
    • In Sync -- The device has confirmed receipt and application of the latest configuration.
    • Pending Sync -- A configuration change has been made but not yet delivered to the device.
    • Sync Failed -- The device reported an error applying the configuration.

Filtering and Navigation

Use the quick filter buttons at the top of the device list to narrow the view:

  • All -- Show all devices regardless of status.
  • Online -- Show only devices currently reporting as online.
  • Offline -- Show only devices that have stopped reporting.
  • Degraded -- Show only devices with partial functionality issues.

Click on any device row to navigate to its detail page, where you can view full configuration, interface status, tunnel details, and per-device performance metrics.

tip

If a device appears offline unexpectedly, check its physical connectivity and power status first. You can also use the Diagnostic Tools to test reachability once the device comes back online.

How Online/Offline Detection Works

The dashboard uses a dual-check approach to determine whether a device is online. Both of the following conditions must be true for a device to show as online:

  1. Telemetry presence — The orchestrator queries the metrics database for recent CPU usage data from the device. If metric data exists, the device has been reporting telemetry recently.
  2. Last seen recency — Every time a device sends a heartbeat or status report, its "Last Seen" timestamp is updated. The dashboard considers a device offline if this timestamp is more than 5 minutes old.

This dual-check approach prevents false positives. For example, if cached metrics exist in the database but the device has actually stopped reporting, the stale "Last Seen" timestamp will correctly cause it to show as offline.

Heartbeat Intervals

Different device types report at different intervals:

Device TypeReport TypeIntervalWhat It Contains
Dedicated EdgeInformEvery 60 secondsVPP interface statistics, WAN IP address
MTGEKeepaliveEvery 30 secondsHeartbeat signal (updates last-seen time)
MTGEInformEvery 60 secondsVPP interface statistics, WAN IP address
ConnectorKeepaliveEvery 30 secondsHeartbeat signal (updates last-seen time)

If a device misses several consecutive heartbeats and its last-seen timestamp exceeds 5 minutes, the dashboard transitions its status to Offline.

For Admins

For a deeper look at how telemetry flows from edge devices through the observability pipeline — including metrics, logs, IPFIX flows, and alerting — see Observability Pipeline in the Admin Guide.