Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
AUF DIESER SEITE
 

Dial-Out-Telemetrieverbindung herstellen

Verwenden Sie dieses Verfahren, um eine Telemetrie-Verbindung herzustellen. Konfigurieren Sie den gRPC-Dienst, das Streamingserverprofil, das Sensorprofil, das Exportprofil und die Datenerfassung basierend auf den Sensorinformationen, die Sie vom Junos-Gerät erfassen möchten.

Im Dial-Out-Modus stellt das Juniper Gerät eine Verbindung zu einem externen Telemetrie-Collector her und streamt Telemetriedaten. Diese Methode wird bevorzugt, wenn eine zentrale Verwaltung von Telemetriedaten erforderlich ist, da das Gerät Daten an den Kollektor überträgt, ohne dass der Kollektor Verbindungen initiieren muss.

  • Stellen Sie sicher, dass auf dem Juniper Gerät eine kompatible Junos OS-Version ausgeführt wird, die Junos Telemetry unterstützt.

  • Richten Sie einen Telemetrie-Collector ein (z. B. Juniper Telemetry Collector, Prometheus oder InfluxDB), der mit dem gewählten Transportprotokoll (UDP oder TCP) kompatibel ist.

  • Stellen Sie sicher, dass die Netzwerkkonnektivität zwischen dem Juniper Gerät und dem Collector gewährleistet ist (z. B. TCP-Port 50051 für gRPC oder ein benutzerdefinierter Port für UDP).

  • Wenn Sie TLS mit gRPC verwenden, bereiten Sie Zertifikate für das Gerät und den Collector vor.

    Hinweis: Vor der Version von Junos OS 25.4R1 wurden TLS-Optionen unter der edit system services extension-service request-response grpc ssl Hierarchie konfiguriert. Verwenden Sie ab Junos OS Version 25.4R1 die PKI-Befehle (Public Key Infrastructure), um lokale Zertifikate und CA-Profile (Certificate Authority) zu laden, siehe Konfigurieren eines Streaming-Serverprofils.

  • Unterstützte Sensoren finden Sie im Junos YANG Data Model Explorer (eingeführt in Junos OS Version 23.2R2-S2) oder im Junos Telemetry Sensor Explorer (für die Versionen 20.2R1 bis 23.1R1).

  • Konfigurieren Sie für die Auswahl über TCP-Verbindungen die IP-Adresse und die Routinginstanz unter Konfigurieren des gRPC-Diensts für die Auswahl über TCP-Verbindungen.

  • Arten der Dial-Out-Telemetrie:

    Junos Telemetry unterstützt drei Arten von Dial-Out-Verbindungen. Jeder Verbindungstyp verwendet ein anderes Nachrichtenformat und hat spezifische Decodierungsanforderungen. Informationen zum Konfigurieren des dialout-type, siehe Konfigurieren eines Exportprofils.

    Tabelle 1: Arten der Dial-Out-Telemetrie
    Dial-Out-Typ Konfiguration mit der CLI-Option Format der Nachricht Datenmodelle Anforderungen an die Dekodierung Transportprotokoll Art des Abonnements
    Dial-out über UDP (Protobuf Compact Format, proprietär von Juniper) native-udp-compact Sensordaten im protobuf (.gpb) Format. Protobuf-Nachrichten haben eine kompakte Form. Junos native und OpenConfig-Modelle. Verwendet für die Dekodierung Junos-spezifische Dienstprogramme, Telemetrie_top.proto und Sensor-Proto-Dateien. UDP STREAMEN
    Dial-out über UDP (Protobuf Structured Format) native-udp-gpb Protobuf-Nachrichten liegen in strukturierten, selbstbeschreibenden Schlüssel-Wert-Paaren vor. Alle Datenmodelle Die Nachricht enthält vollständige Informationen zum Schlüsselnamen und zum Wertpaar, sodass der Collector keine Datenmodelle für die Verarbeitung oder Nutzung der Telemetriedaten benötigt. Die Nachrichtenstruktur wird in der Datei jnx_gnmi_over_udp.proto definiert. UDP STREAM mit SAMPLE-Modus
    Dial-out über TCP (Protobuf Structured Format) native-grpc-gpb Protobuf-Nachrichten haben ein strukturiertes universelles Schlüssel/Wert-Format. Alle Datenmodelle Verwendet gnmi.proto und GnmiJuniperTelemetryHeader.proto für die Decodierung. TCP STREAMEN
    Hinweis: Ab Version 25.4 sind die format Optionen und transport unter der [edit services analytics export-profile name] Hierarchie veraltet.

    • Protobuf kompaktes Format:

      Dieses Format gilt als "kompakt", da es keine ausführlichen Schlüssel-Wert-Darstellungen enthält. Sie müssen jedoch die neueste Version der protobuf-Dateien herunterladen, um die Telemetriedaten zu decodieren.

    • Strukturiertes Protobuf-Format:

      Dieses Format verwendet selbstbeschreibende Schlüssel-Wert-Paare in Protobuf-Nachrichten. Jede Nachricht enthält vollständige Sensordatennamen und -werte, die Dosensammler verarbeiten Sensordaten auch ohne die Datenmodelldateien.

Konfigurieren Sie einen Sensor zur Überwachung einer bestimmten Systemressource. Jede Sensorkonfiguration erfordert drei Hauptkomponenten:

  • Streaming-Serverprofil: Gibt den Server zum Sammeln von Daten und zugehörigen Parametern an, einschließlich der Ziel-IP-Adresse und der Portnummer. Bevor Sie beginnen, konfigurieren Sie eine Verbindung von Ihrem Juniper Networks-Gerät zu einem Server, der In-Band-Verwaltungsschnittstellen verwendet.

  • Sensorprofil: Ermöglicht die Überwachung der Systemressource und das Festlegen zugehöriger Parameter, z. B. des Zielservers, der zum Empfangen von Daten verwendet wird.

  • Exportprofil: Gibt Attribute für den Export der gesammelten Daten an.

Optimale Vorgehensweise:

Es wird empfohlen, mindestens ein Exportprofil und mindestens einen Streamingserver zu konfigurieren, bevor Sie ein Sensorprofil konfigurieren. Anschließend können Sie der Sensorprofilkonfiguration ein Exportprofil und einen Streamingserver zuordnen.

Um den Export von Statistiken zu aktivieren, schließen Sie die export-profile sensor und-Anweisungen auf der Hierarchieebene [edit services analytics] ein. Die Sensorkonfiguration muss den Namen des Collectors, den Namen des Exportprofils und den Ressourcenpfad enthalten.

Beispiel für Ressourcenpfad : /interfaces/interface[name='fxp0'].

Hinweis:

Wenn Sie ein Exportprofil für die Auswahl über UDP konfigurieren, sind die Exportprofilparameter wie {'dscp', 'forwarding-class', 'payload-size'} nicht anwendbar. Die Konfiguration einer dieser Optionen erzeugt einen Fehler.

Führen Sie die unten aufgeführten Verfahren aus, um eine wählbare Telemetrie-Verbindung herzustellen:

Konfigurieren eines Streamingserverprofils

Ein Serverprofil definiert die Parameter des Servers, der exportierte Telemetriedaten sammelt. Sie können mehr als ein Serverprofil definieren. Sie können dasselbe Serverprofil auch mehreren Sensorprofilen zuordnen. Sie können mehr als einen Server mit einem bestimmten Sensor verknüpfen.

Hinweis:

Richtlinien für das Streamen von Telemetriedaten über UDP:

  1. Telemetriedaten werden über UDP direkt von der Quellanwendung zum Kollektor gestreamt. Die Konfiguration hängt von der Art der Verbindung zum Kollektor ab. Der Collector muss über die Managementschnittstelle oder eine WAN-Schnittstelle erreichbar sein.
  2. Im Falle von Linecard-Sensoren können die Linecards die Daten direkt an den Collector exportieren, wenn die Remote-Adresse über die WAN-Schnittstelle erreichbar ist. Wenn die Telemetrie-Daten über die Verwaltungsschnittstelle für Linecard-Sensoren exportiert werden müssen, leiten Sie die Daten an die Routing-Engine weiter, und senden Sie sie dann an den Collector.

So definieren Sie das Profil eines Streamingservers zum Sammeln exportierter Telemetriedaten:

  1. Geben Sie den Namen des Streaming-Servers an.

    So geben Sie beispielsweise einen Streamingservernamen von telemetry-server:

  2. Geben Sie eine Ziel-IP-Adresse für die exportierten Pakete an.

    So geben Sie beispielsweise die Zieladresse 192.0.2.2 für einen Streaming-Server mit dem Namen telemetry-server:

  3. Geben Sie eine Zielportnummer für die exportierten Pakete an.

    So geben Sie beispielsweise eine Zielportnummer von 30000 für einen Streamingserver mit dem Namen telemetry-serveran:

  4. Geben Sie die TLS-Parameter, die lokale Zertifikats-ID und das ca-profile an. Sie können die TLS-Parameter für jeden Streamingserver konfigurieren. Für Dialout-Verbindungen müssen Sie die TLS-Parameter für jeden Streamingserver konfigurieren.
    Hinweis: TLS ist nicht auf UDP anwendbar.
    Hinweis:

    Vor Version 25.4 wurden TLS-Optionen unter der edit system services extension-service request-response grpc ssl Hierarchie konfiguriert. Diese Konfigurationsmethode wird ab Version 25.4 nicht mehr unterstützt.
    Hinweis:

    Verwenden Sie ab Version 25.4 die folgenden PKI-Befehle (Public Key Infrastructure), um lokale Zertifikate und CA-Profile (Certificate Authority) zu laden:

    • request security pki local-certificate load certificate-id certificate id filename dialout_client.crt key dialout_client.key

    • request security pki ca-certificate load ca-profile ca-profile-name filename path/filename

Konfigurieren eines Sensorprofils

Ein Sensorprofil definiert die Parameter der Systemressource zur Überwachung und zum Streamen von Daten. Sie können nur eine zu überwachende Systemressource für jedes Sensorprofil aktivieren. Konfigurieren Sie für jede Systemressource, die Sie überwachen möchten, ein anderes Sensorprofil. Sie können jedoch mehr als einen Sensor konfigurieren, um dieselbe Systemressource zu überwachen. Erwägen Sie beispielsweise, verschiedene Parameter für den Export von Daten aus derselben Systemressource zu konfigurieren.

So konfigurieren Sie ein Sensorprofil:

  1. Geben Sie den Namen des Sensors an.

    So geben Sie beispielsweise einen Sensornamen von interface-1:

  2. Geben Sie die Systemressource an, die Daten überwachen und streamen soll.

    Zum Beispiel, um die Überwachung logischer Schnittstellen für den Sensor interface-1zu ermöglichen:

    Hinweis:

    Sie müssen die Ressourcenzeichenfolge genau eingeben.

  3. (Optional) Geben Sie einen regulären Ausdruck an, um Daten für die Systemressource zu filtern, die Sie in Schritt 2 angegeben haben. Wenn Sie keinen regulären Ausdruck angeben, wird die Systemressource global, d. h. systemweit, überwacht.

    So filtern Sie beispielsweise Daten nur nach logischen Ethernet-Schnittstellen für Sensoren interface-1:

  4. Geben Sie den Namen eines Exportprofils an, das auf der [edit export-profile profile-name] Hierarchieebene konfiguriert ist, um es dem Sensorprofil zuzuordnen. Dieses Exportprofil definiert die Parameter für den Export von Telemetriedaten.

    So verknüpfen Sie beispielsweise ein Exportprofil mit dem Namen export-params eines Sensors mit dem Namen interface-1:

  5. Geben Sie den Namen eines Streaming-Servers an, der auf der [edit services analytics streaming-server server-name] Hierarchieebene konfiguriert ist, um exportierte Daten zu sammeln.
    Hinweis:

    Sie können mehr als einen Streamingserver für ein Sensorprofil angeben. Wenn Sie mehr als einen Streamingserver für einen Sensor angeben möchten, müssen Sie die Namen in Klammern einschließen.

    So verknüpfen Sie beispielsweise einen Streamingservernamen telemetry-server mit einem Sensor mit dem Namen interface-1:

Konfigurieren eines Exportprofils

Ein Exportprofil definiert die Parameter des Exportprozesses von Daten, die über den Junos Telemetrie-Mechanismus generiert werden. Sie müssen mindestens ein Exportprofil konfigurieren, Sie können auch mehrere Exportprofile konfigurieren. Jedes Exportprofil kann mehreren Sensorprofilen zugeordnet werden. Sie können jedoch nur ein Exportprofil mit einem bestimmten Sensorprofil verknüpfen.

Plattformspezifisches Exportprofilverhalten

Verwenden Sie den Feature-Explorer , um die Plattform- und Release-Unterstützung für bestimmte Funktionen zu bestätigen.

Verwenden Sie die folgende Tabelle, um plattformspezifische Verhaltensweisen für Ihre Plattformen zu überprüfen:

Tabelle 2: Verhalten des plattformspezifischen Exportprofils

Plattform

Unterschied

MX-Serie

Auf Routern der MX-Serie können Sie eine Paketverlustpriorität für ein Exportprofil angeben. Daher können Sie jedem Sensor die entsprechende Paketverlustpriorität zuweisen. Die Einstellungen für die Verlustpriorität helfen bei der Bestimmung, welche Pakete in Zeiten von Überlastung aus dem Netzwerk verworfen werden. Bisher konnten Sie in einem Exportprofil nur die Weiterleitungsklasse und den DSCP-Wert angeben. Die folgenden Einstellungen für die Priorität für Paketverluste werden unterstützt: high, lowund medium-high medium-low. Weitere Informationen zu den Prioritätseinstellungen für Paketverluste finden Sie unter Zuordnen von PLP zu RED Drop-Profilen.

So konfigurieren Sie ein Exportprofil:

  1. Geben Sie einen Namen für das Exportprofil an.

    So geben Sie beispielsweise den Namen eines Exportprofils an export-params:

  2. Geben Sie die Quell-IP-Adresse der exportierten Pakete an.

    Um beispielsweise eine Quell-IP-Adresse von 192.0.2.3 für ein Exportprofil mit dem Namen export-params:

  3. Geben Sie die Quellportnummer der exportierten Pakete an.

    So geben Sie beispielsweise die Quellportnummer 21111 für ein Exportprofil mit dem Namen export-paramsan:

  4. Geben Sie das Intervall in Sekunden an, in dem der Sensor Telemetriedaten generiert.

    • Am Ende jedes konfigurierten Intervalls erfasst der Sensor die neueste Probe und leitet sie an den dafür vorgesehenen Datenerfassungsserver weiter.

    • Gültiger Bereich: Für Veröffentlichungen vor 23.4 R2, 1 bis 86400 Sekunden (24 Stunden).

    Hinweis:

    Ab Junos OS und Junos Evolved 23.4R2 beträgt der unterstützte Mindestwert für reporting-rate Packet Forwarding Engine (PFE)-Sensoren "2" Sekunden. Wenn in einer Konfiguration ein Wert unter "2" Sekunden angegeben wird und ein Softwareupgrade durchgeführt wird, wird die Konfiguration verworfen, und die Telemetrie ist erst dann betriebsbereit, wenn der Wert korrigiert wurde.

    Um beispielsweise ein Intervall von 20 Sekunden anzugeben, in dem ein Sensor, der dem Exportprofil mit dem Namen export-params zugeordnet ist, Telemetriedaten erzeugt:

  5. Geben Sie den Typ der Wählverbindung an.

    • native-udp-gpb: Wählen Sie diese Option für die Wahl über UDP-Verbindungen (Protobuf Structured Format). Das Nachrichtenformat sind Protobuf-Nachrichten mit strukturierten, selbstbeschreibenden Schlüssel-Wert-Paaren und das Transportprotokoll ist UDP.

    • native-udp-compact: Wählen Sie diese Option für die Auswahl über UDP-Verbindungen (Protobuf Compact Format, Juniper Proprietär). Das Nachrichtenformat ist .gpb und das Transportprotokoll ist UDP.

    • native-grpc-gpb: Wählen Sie diese Option für die Auswahl über TCP-Verbindungen (Protobuf Structured Format). Das Nachrichtenformat ist gpb-gnmi (Protobuf-Nachrichten im strukturierten universellen Schlüssel/Wert-Format) und das Transportprotokoll ist TCP.

    So streamen Sie beispielsweise native Sensorinformationen über UDP:

    Hinweis: Ab Version 25.4 sind die format Optionen und transport veraltet.
  6. (Optional) Geben Sie den DiffServ-Codepunkt (DSCP) an, der den exportierten Paketen zugewiesen werden soll.
    Hinweis:

    Der Standardwert ist 0 (null).

    Alle von Ihnen konfigurierten DSCP-Rewrite-Regeln auf Schnittstellenebene überschreiben den DSCP-Wert, den Sie für das Exportprofil angeben. Geben Sie nur dann einen DSCP-Wert für das Exportprofil an, wenn Sie keine DSCP-Rewrite-Regeln für die ausgehende Schnittstelle konfigurieren. Weitere Informationen finden Sie unter Konfigurieren von Rewrite-Regeln.

    So geben Sie beispielsweise einen DSCP-Wert von 20 für ein Exportprofil mit dem Namen export-params:

  7. (Optional) Geben Sie eine Weiterleitungsklasse an, die exportierten Paketen zugewiesen werden soll.
    Hinweis:

    Sie können eine Weiterleitungsklasse nur für Pakete angeben, die von Packet Forwarding Engine-Sensoren exportiert werden. Der Standardwert ist best-effort.

    So geben Sie beispielsweise eine Weiterleitungsklasse von assured-forwarding für ein Exportprofil mit dem Namen export-params:

  8. (Optional) (nur auf Routern der MX-Serie) Geben Sie eine Paketverlustpriorität an, die exportierten Paketen zugewiesen werden soll.

    So geben Sie beispielsweise eine Verlustpriorität von high für ein Exportprofil mit dem Namen export-params:

Konfigurieren des Datensammlers

  1. Stellen Sie sicher, dass der Collector bereit ist, Daten vom Juniper Gerät zu empfangen:
    • IP-Adresse: Die Verwaltungs-IP-Adresse des Geräts (192.168.1.100).
    • Port: Der konfigurierte Port (z. B. 2000 für UDP, 50051 für gRPC).
    • Protokoll: Wählen Sie das Transportprotokoll aus (z. B. UDP oder gRPC).
    • Anmeldeinformationen: Wenn TLS aktiviert ist, konfigurieren Sie den Collector mit dem entsprechenden Clientzertifikat und Schlüssel.
    • Datenformat: Stellen Sie sicher, dass der Collector Google Protocol Buffers (gpb) unterstützt und über die erforderlichen Protokolldefinitionen zum Dekodieren von Sensordaten verfügt.

    Beispiel-Collector-Konfiguration (für einen UDP-basierten Collector):

    Konfigurieren Sie den Kollektor so, dass er Daten überwacht 192.168.1.100:2000 und verarbeitet gpb-encoded .

  2. Überprüfen Sie auf dem Datensammler, ob die Daten empfangen wurden. Wenn beispielsweise Prometheus oder Grafana als Datensammler verwendet wird, überprüfen Sie die Protokolle oder Visualisierungen. Überprüfen Sie bei benutzerdefinierten Kollektoren, ob der Datenstrom mit den konfigurierten Sensorpfaden übereinstimmt.
  3. Informationen zum Dekodieren von Junos-Telemetriedaten finden Sie unter Dekodieren von Junos-Telemetriedaten mit UNIX-Versorgungsunternehmen.

Überprüfen Sie die Konfiguration des Junos Telemetry Interface Sensors.

Zweck

Bestätigen Sie Ihre Konfiguration.

Aktion

Bestätigen Sie im Konfigurationsmodus Ihre Konfiguration durch Eingabe des show services analytics Befehls. Wenn Ihre Ausgabe nicht die beabsichtigte Konfiguration anzeigt, wiederholen Sie die Anweisungen im Konfigurationsverfahren, um sie zu korrigieren.

Überprüfen Sie nach dem Commit der Konfiguration, ob der Sensor aktiviert ist, indem Sie den show agent sensors Betriebsbefehl ausgeben.

Hinweis:

Die show agent sensors Befehlsausgabe für gRPC-Sensoren wird auf der Junos OS Evolved-Plattform abgeschnitten, um sie an das Ausgabeformat der Junos OS-Plattform anzupassen.

Auswählen von Sensorpfaden

Sensor-Explorer und Richtlinien für die Auswahl von Sensorpfaden

Verwenden Sie den Junos YANG-Datenmodell-Explorer von Juniper Networks, um alle unterstützten Ressourcenpfade, die entsprechenden Leaves und die Geräteplattformen, die sie unterstützen, anzuzeigen.

Hinweis: Der Junos YANG Data Model Explorer wurde in den Versionen 23.2R2-S2 eingeführt. Von den Versionen 20.2R1 bis 23.1R1 sind die Sensorinformationen im Junos Telemetry Sensor Explorer verfügbar.

Informationen zum Suchen und Anzeigen anderer Telemetriesensoren und spezifischer Informationen zu einigen Legacysensoren finden Sie unter Legacysensorpfade.

Informationen zu Richtlinien und bewährten Methoden zum Konfigurieren von Sensorpfaden finden Sie unter Erkunden von Sensorpfaden.

Dekodierung von Junos Telemetry Interface-Daten mit UNIX-Versorgungsunternehmen

Sie können UNIX-Dienstprogramme verwenden, um Daten der Junos Telemetry Interface auf einem Server oder Collector zu decodieren, der Daten von einem Gerät von Juniper Networks streamt. Das Beispiel in diesem Abschnitt zeigt, wie Sie ein einzelnes Paket gestreamter Daten decodieren.

Vorbereiten des Kollektors zum Decodieren von Daten

Für dieses Beispiel ist Folgendes erforderlich:

  • UNIX OS mit dem Dienstprogramm Netcat (nc).

  • Protokollpuffer-Compiler.

  • Protokollpufferdateien der Junos Telemetry Interface.

Dieses Verfahren zeigt, wie Sie den Collector für die Dekodierung von Daten mit dem Ubuntu OS vorbereiten.

  1. Installieren Sie das Netcat-Dienstprogramm.

  2. Installieren Sie den Protokollpuffer-Compiler.

  3. Installieren Sie die Entwicklerbibliothek der Protokollpuffer.

  4. Stellen Sie sicher, dass die Bibliotheksdateien installiert sind.

  5. Laden Sie die neueste Version der Protokollpufferdateien der Junos Telemetry Interface herunter und installieren Sie sie.

    Navigieren Sie in einem Webbrowser auf der Seite Juniper Networks zur URL zum Download der Software All Junos Platforms: https://www.juniper.net/support/downloads/. Nachdem Sie den Namen der Junos OS-Plattform und die Versionsnummer ausgewählt haben, wechseln Sie zum Abschnitt Tools , und laden Sie das Datenmodelldateienpaket der Junos Telemetry Interface herunter.

    Hinweis: Juniper Networks veröffentlicht YANG-Module für Junos-Geräte, die aus dem GitHub-Repository von Juniper heruntergeladen werden können. Ab Version 23.4 werden Konfiguration und Telemetrie-YANG-Modelle zusammengeführt und im GitHub-Repository von Juniper veröffentlicht. Diese enthält YANG-Definitionen für Konfiguration, RPCs und Telemetrie-Modelle.
    Hinweis:

    Notieren Sie sich den Speicherort der extrahierten Dateien.

Dekodieren von Daten auf dem Kollektor

In diesem Verfahren wird gezeigt, wie Sie Daten erfassen, Rohdaten decodieren und die Protokollpufferdateien zum Decodieren von Daten verwenden.

So decodieren Sie Daten:

  1. Erfassen Sie die Daten.

    Führen Sie netcat auf einem Ziel-Streaming-Telemetrie-Server oder -Collector im UDP-Listener-Modus aus, um alle eingehenden Datagramme in einer Datei zu speichern. Verwenden Sie die Zielportnummer, die im Streaming-Server-Profil Ihres Juniper Networks-Geräts konfiguriert ist.

    Hinweis:

    Dieser Befehl speichert Datagramme in einer Datei mit dem Namen data.gpb. Führen Sie dieses Programm aus, um Daten zu erfassen. Wenn Sie den Empfang von Daten beenden möchten, beenden Sie das Programm, indem Sie das Pausensignal (Control + C) senden.

  2. Dekodieren von Rohdaten.

    Hinweis:

    Dieser Schritt ist optional. Dies ist nicht erforderlich, wenn Sie den codierten Nachrichtentyp der Daten kennen.

    Die Dekodierungsanforderungen variieren je nach konfiguriertem dial-out Typ.

    • Dial-out over UDP (Protobuf Compact Format, Juniper Proprietär): Verwenden Sie für die Dekodierung Junos-spezifische Dienstprogramme, Telemetrie_top.proto und Sensor-Proto-Dateien.

    • Dial-out over UDP (Protobuf Structured Format): Die Nachricht enthält vollständige Informationen zum Schlüsselnamen und -wert-Paar, sodass der Collector keine Datenmodelle für die Verarbeitung oder Nutzung der Telemetriedaten benötigt. Die Nachrichtenstruktur wird in der Datei jnx_gnmi_over_udp.proto definiert.

    • Dial-out over TCP (Protobuf Structured Format): Verwenden Sie für die Dekodierung die Dateien gnmi.proto und GnmiJuniperTelemetryHeader.proto .

    Das folgende Beispiel zeigt, wie die Nachricht aus der Datei für die data.gpb Auswahl über UDP-Verbindungen (Protobuf Compact Format, Juniper Proprietär) decodiert wird:

    Die nächste verschachtelte Struktur unter 2636 identifiziert den Sensortyp. Der numerische Wert 2636 identifiziert die JuniperNetworksSensor Nachricht, die in der telemetry_top.proto Datei definiert ist. In diesem Beispiel entspricht der numerische Bezeichner 7 der LogicalPort in der logical_port.proto Datei definierten Nachricht. Verwenden Sie diese Informationen im nächsten Schritt, um eine detailliertere Ausgabe zu generieren.

  3. Decodieren Sie die Nachricht, um Feldnamen einzuschließen.

    Führen Sie den Protokollpuffer-Compiler mit der Option decode aus. Geben Sie außerdem den Nachrichtentyp der obersten Ebene (TelemetryStream) und die Datei mit der Nachrichtendefinition an. logical_port.proto Sie müssen auch die GPU-Bibliothek (Goggle Protocol Buffers) einschließen.

Dekodierung von UDP-Daten der Junos Telemetry Interface am Collector

Der Collector muss einen Listener auf der Remote-Adresse oder Portkombination starten, um die eingehenden Daten zu lesen. Bei der Wahl über UDP-Verbindungen (Protobuf Compact Format, Juniper Proprietary ) können die eingehenden Daten mit den Dateien Telemetrie_top.proto und Sensor proto dekodiert werden. Bei der Wahl über UDP-Verbindungen (Protobuf Structured Format) enthält die Nachricht vollständige Schlüsselnamen- und Wertpaarinformationen, sodass der Collector keine Datenmodelle für die Verarbeitung oder Nutzung der Telemetriedaten benötigt. Die Nachrichtenstruktur wird in der Datei jnx_gnmi_over_udp.proto definiert.

Um den Dekodierungsvorgang zu vereinfachen, können die Kollektoren alle Proto-Dateien laden, die als Teil des Telemetrie-Software-Pakets ausgeliefert werden, um die eingehenden Daten zu dekodieren.

Hinweis:
  1. Überprüfen Sie Streaming-Daten sowohl auf Management- als auch auf WAN-Schnittstellen. Geben Sie die entsprechende Adresse im Streamingserverprofil an.
  2. Enumerationen und float werden als Zeichenfolgen für das UDP-Streaming gestreamt. Enumerationen werden als Strings beibehalten, da gNMI dasselbe Format verwendet.
  3. Die Behandlung des float-Datentyps ist auf eine zukünftige Version beschränkt.

Wenn Telemetriedaten über UDP gestreamt werden, stellen Sie sicher, dass die Daten korrekt decodiert werden und unbekannte Felder nicht am Collector decodiert werden.

Beim Streamen von Telemetriedaten über UDP wurden unter anderem folgende Probleme beobachtet:

  1. Falsche Dekodierung: Eine falsche Dekodierung bedeutet, dass Telemetriedaten nicht korrekt über UDP gestreamt werden. Im folgenden Beispiel zeigen die fett hervorgehobenen Daten an, dass die Daten nicht ordnungsgemäß decodiert wurden. Dieses Verhalten ist entweder auf eine falsche Kodierung oder eine falsche Verpackung der Proto-Datei zurückzuführen.

    Das Beispiel für korrekt dekodierte Daten ist wie folgt:

  2. Unvollständiges Datenstreaming: Das Streaming unvollständiger Daten muss durch Datenvalidierung in der Ausgabedatei überprüft werden.

Siehe auch

Tabellarischer Änderungsverlauf

Die Unterstützung der Funktion hängt von der Plattform und der Version ab, die Sie benutzen. Verwenden Sie den Feature-Explorer , um festzustellen, ob eine Funktion auf Ihrer Plattform unterstützt wird.

Veröffentlichung
Beschreibung
17.3R1
Ab Junos OS Version 17.3R1 können Sie nur auf Routern der MX-Serie eine Paketverlustpriorität für ein Exportprofil angeben.
Änderung abgeschlossen
Ab Junos OS Version 25.4R1 wird die Option dialout-type CLI im export-profile Befehl zum Konfigurieren des Transportprotokolls und des Telemetrie-Nachrichtenformats eingeführt. Die format Optionen und transport sind veraltet.