gNMI-Befehle: Streaming-Telemetrie und Konfiguration mit gNMIc

gNMI-Befehle zeigen den Umgang mit dem gRPC-basierten gNMI-Protokoll. gNMI ist Teil des OpenConfig-Projekts und dient vor allem dem effizienten Streaming von Betriebsdaten sowie der Konfiguration. Der Standard-Client ist gNMIc (OpenConfig), das alle vier RPCs beherrscht: Capabilities, Get, Set und Subscribe.

Verbindung und Capabilities

gNMI läuft über gRPC/HTTP/2, typischerweise auf Port 57400. Die Ziele werden mit -a, Nutzer und Passwort mit -u/-p übergeben, bei Laborservern schaltet --insecure TLS ab:

gnmic -a 10.0.0.1:57400 -u admin -p secret --insecure capabilities
gnmic -a 10.0.0.1:57400 -u admin -p secret --insecure get --path /interfaces/interface/state/counters

Subscribe und Set

Der Subscribe-RPC ist das Herzstück der Streaming-Telemetrie. Mit --stream-mode wählt man zwischen sample (Intervall) und on_change (bei Änderung):

gnmic -a 10.0.0.1:57400 -u admin -p secret --insecure subscribe 
       --path /interfaces/interface/state --stream-mode on_change

Konfiguration schreibt man mit set, wobei Pfad und Wert getrennt übergeben werden:

gnmic -a 10.0.0.1:57400 -u admin -p secret --insecure set 
       --path /interfaces/interface[name=eth0]/config/description --value uplink

Neben gNMIc existieren die gnxi-Werkzeuge (Go-Client des OpenConfig-Projekts) und Collectoren wie Telegraf mit gNMI-Plugin. Wer XML über SSH bevorzugt, nutzt NETCONF-Befehle; wer HTTP-basiert arbeitet, RESTCONF-Befehle.

Verwandte Grundlagen: gNMI, OpenConfig, YANG, Telemetrie.