Routing Configuration Guide, Cisco IOS XE Catalyst SD-WAN Release 17.x

PDF

OMP vDiagnostics

Updated: March 9, 2026

Want to summarize with AI?

Log in

Overview

Explains about a troubleshooting tool that automatically captures data snapshots (hello packets, system health, TCP metrics) when an OMP peering session fails.

OMP vDiagnostics is a diagnostic tool for Cisco SD-WAN to troubleshoot Overlay Management Protocol (OMP) peering failures. When OMP peering is lost, the system automatically captures a data snapshot using a CLI. This allows you to identify the root cause of the failure quickly, without needing to collect data manually at the time of the event.

The system collects diagnostics immediately when an OMP peering session goes down. The diagnostic tool captures a point-in-time state of peer-specific, global, and TCP-level metrics. Data collection and network connectivity tests are handled in a separate thread to ensure the main OMP process is not impacted. Then it summarizes the complex protocol states and network statistics into an interpreted format.

The OMP snapshot includes three sections.

  • Peer diagnostics: Focuses on the health and history of the specific OMP peer. When OMP peering is lost, the following data is collected and saved:

    • Hello packet metrics: Time of last received Hello, interarrival times (minimum, maximum, and Mean), and maximum delay observed before and after the peer was last up.

    • State and events: Peer up and down timestamps, peer flags, and the number of missed Hello packets.

    • Transition counters: Number of up and down events and Graceful Restart entry and exit counts.

  • Global diagnostics: Provides context on the overall system and network environment:

    • Connectivity: Results of a network connectivity test to the underlay IP address of the peer (performed through a TCP socket check on port 80).

    • System Health: CPU and memory usage.

    • Interface State: Status of the tunnel interface.

    • Scale Information: Total number of Cisco SD-WAN Controllers, edge devices and route statistics (received, sent, and installed).

  • Peer TCP metrics: Analyzes the underlying transport performance:

    • Round-Trip Time (RTT) and retransmit timeouts.

    • Maximum Segment Size (MSS) for both Send and Receive.

    • Path Maximum Transmission Unit (PMTU) and congestion window size.

    • Packet reordering counts and delivery rate (bytes per second).

To view the diagnostics on Cisco SD-WAN Controllers, use vdiagnose omp command.