gnmi-telemetry

gnmi-telemetry

gNMI streaming telemetry operations for multi-vendor network devices. Query device state via structured YANG model paths, subscribe to real-time telemetry streams, apply ITSM-gated configuration changes, browse YANG capabilities, and compare gNMI data against CLI output.

MCP Server

gnmi-mcp — gNMI Streaming Telemetry MCP Server (stdio transport)

Tools Used

1. gnmi_get — Retrieve device state/config via gNMI Get with YANG paths
2. gnmi_set — Apply configuration via gNMI Set (requires ServiceNow CR)
3. gnmi_subscribe — Create SAMPLE or ON_CHANGE telemetry subscriptions
4. gnmi_unsubscribe — Cancel active subscriptions
5. gnmi_get_subscriptions — List all active telemetry subscriptions
6. gnmi_get_subscription_updates — Retrieve latest telemetry updates
7. gnmi_capabilities — Discover YANG models and encodings on a device
8. gnmi_browse_yang_paths — Explore YANG path tree under a module
9. gnmi_compare_with_cli — Compare gNMI vs CLI state for validation
10. gnmi_list_targets — List configured gNMI target devices

Workflows

Query Device State

1. gnmi_list_targets — identify available devices
2. gnmi_capabilities — discover supported YANG models
3. gnmi_browse_yang_paths — explore available paths
4. gnmi_get — retrieve structured state data

Monitor Real-Time Telemetry

1. gnmi_subscribe — create subscription (SAMPLE or ON_CHANGE)
2. gnmi_get_subscriptions — verify subscription is active
3. gnmi_get_subscription_updates — poll for latest updates
4. gnmi_unsubscribe — clean up when monitoring is complete

Apply Configuration Change

1. gnmi_get — capture current baseline state
2. gnmi_set — apply change with ServiceNow CR number
3. gnmi_get — verify change was applied correctly