Comprendre le format d’exportation des données collectées de l’interface de télémétrie Junos
L’interface de télémétrie Junos prend en charge deux méthodes d’exportation de données au format gpb (protocol buffers) :
Grâce à UDP à partir de capteurs dits natifs qui exportent des données à proximité de la source, telles que la carte de ligne ou l’unité de traitement réseau (NPU). Juniper Networks définit le modèle de données, qui est ouvert et extensible.
Par le biais d’appels de procédure distante gRPC (gRPC) qui exportent des données via le moteur de routage. Le modèle de données est défini par OpenConfig, qui prend en charge l’utilisation de modèles de données indépendants du fournisseur pour configurer et gérer le réseau. OpenConfig pour Junos OS prend en charge les modèles de données YANG. Pour les plates-formes qui exécutent une version de Junos OS basée uniquement sur un noyau FreeBSD mis à jour, vous devez installer un package séparé appelé Agent d’administration qui fonctionne comme un serveur gRPC et termine les interfaces RPC. . Pour toutes les autres versions de Junos OS, la fonctionnalité Agent d’administration est intégrée au logiciel. Vous devez également installer OpenConfig pour le module Junos OS et les modèles YANG.
Cette section décrit le format des données exportées à partir de capteurs natifs à l’aide d’UDP. Les données sont encapsulées dans un en-tête UDP, qui est à son tour encapsulé dans la charge utile IPv4. Ce modèle d’interface de télémétrie Junos repose sur une architecture distribuée, à travers laquelle les données générées par les capteurs configurés sont exportées directement à partir du plan de données, en contournant le plan de contrôle, et donc en conservant ces ressources pour exécuter d’autres fonctions nécessaires.
L’interface de télémétrie Junos a été introduite dans Junos OS version 15.1F3, sur les routeurs MX Series avec interfaces configurées sur MPC1 à MPC6E, et sur les routeurs PTX Series avec interfaces configurées sur FPC3. À partir de Junos OS version 15.1F5, l’interface de télémétrie Junos est également prise en charge sur MPC7E, MPC8E et MPC9E sur les routeurs MX Series.
À partir de Junos OS version 16.1R3, FPC1, FPC2 et les moteurs de routage doubles sur les routeurs PTX Series sont également pris en charge.
À partir de Junos OS version 17.2R1, les commutateurs QFX10000 et QFX5200 sont également pris en charge. Sur les commutateurs QFX5200, seul le streaming gRPC est pris en charge.
À partir de Junos OS version 17.3R1, l’interface de télémétrie Junos est prise en charge sur le contrôle et la carte de routage (RCB) sur les routeurs PTX3000, les commutateurs QFX5110 et les commutateurs EX4600 et EX9200.
À partir de Junos OS version 17.4R1, les routeurs MX2008 sont pris en charge.
Comprendre le format d’encapsulation des données du capteur
Un capteur natif exporte les données à proximité de la source à l’aide d’UDP. Différents types de données de télémétrie, telles que les statistiques d’interface physique, les statistiques des compteurs de filtres de pare-feu ou les statistiques pour les chemins de commutation d’étiquettes (LSP), peuvent être exportés. Un capteur commence à émettre des données dès qu’il est activé.
Les données du capteur sont représentées sous la forme d’un message de tampon de protocole structuré unique, nommé TelemetryStream. Le message, ou fichier, illustré ci-dessous, inclut plusieurs attributs qui identifient la source de données, tels qu’une carte de ligne, un moteur de transfert de paquets ou .proto un moteur de routage. Le nom du capteur configuré est également inclus. Pour plus d’informations sur la configuration des capteurs, voir Configuration d’un capteur d’interface de télémétrie Junos (procédure CLI). Pour obtenir la liste des capteurs natifs pris en charge, voir capteur.
Vous devez également télécharger les .proto fichiers de tous les capteurs pris en charge sur un serveur de streaming ou un collecteur. Dans un navigateur Web, accédez à l’URL de téléchargement du logiciel Toutes les plates-formes Junos sur la page Juniper Networks : https://www.juniper.net/support/downloads/. Après avoir sélectionné le nom de la plate-forme Junos OS et le numéro de version, accédez à la section Outils et téléchargez le package Fichiers de modèle de données de l’interface de télémétrie Junos. Pour plus d’informations sur la configuration d’un serveur de streaming, consultez serveur de streaming (Junos Telemetry Interface).
Définition du message des tampons de protocole
Voici la définition de message pour TelemetryStream dans le langage de définition Protocol Buffers. Il montre plusieurs structures imbriquées optionnelles, telles que EnterpriseSensors, qui transportent des données de capteur définies de manière privée.
//
// This file defines the top level message used for all Juniper
// Telemetry packets encoded to the protocol buffer format.
// The top level message is TelemetryStream.
//
import "google/protobuf/descriptor.proto";
extend google.protobuf.FieldOptions {
optional TelemetryFieldOptions telemetry_options = 1024;
}
message TelemetryFieldOptions {
optional bool is_key = 1;
optional bool is_timestamp = 2;
optional bool is_counter = 3;
optional bool is_gauge = 4;
}
message TelemetryStream {
// router name or export IP address
required string system_id = 1 [(telemetry_options).is_key = true];
// line card / RE (slot number)
optional uint32 component_id = 2 [(telemetry_options).is_key = true];
// PFE (if applicable)
optional uint32 sub_component_id = 3 [(telemetry_options).is_key = true];
// configured sensor name
optional string sensor_name = 4 [(telemetry_options).is_key = true];
// sequence number, monotonically increasesing for each
// system_id, component_id, sub_component_id + sensor_name.
optional uint32 sequence_number = 5;
// timestamp (milliseconds since 00:00:00 UTC 1/1/1970)
optional uint64 timestamp = 6 [(telemetry_options).is_timestamp = true];
// major version
optional uint32 version_major = 7;
// minor version
optional uint32 version_minor = 8;
optional IETFSensors ietf = 100;
optional EnterpriseSensors enterprise = 101;
}
message IETFSensors {
extensions 1 to max;
}
message EnterpriseSensors {
extensions 1 to max;
}
extend EnterpriseSensors {
// re-use IANA assigned numbers
optional JuniperNetworksSensors juniperNetworks = 2636;
}
message JuniperNetworksSensors {
extensions 1 to max;
}
Le TelemetryStream message inclut également des structures imbriquées facultatives qui transportent différents types de données. Une structure transporte des données d’entreprise, c’est-à-dire définies de manière privée. Des entreprises individuelles, telles que Juniper Networks, définissent et gèrent les attributs générés par les capteurs d’entreprise. Chaque entreprise se voit attribuer un identifiant d’attribut unique. La convention actuelle consiste à utiliser des identificateurs MIB d’entreprise attribués par l’IANA pour chaque attribut. Pour Juniper Networks, l’identifiant attribué est 2636.
Pour vérifier qu’un type de message particulier a été exporté et reçu, recherchez ces attributs sous TelemetryStream.enterprise.juniperNetworks dans le message gpb.
Voir le tableau 1 pour une description de chaque élément collecté par les données des capteurs, y compris la sémantique et le schéma correspondant.
Type d’élément |
Description |
|---|---|
Counter |
Entier non signé qui augmente de façon monotone. Lorsqu’il atteint sa valeur maximale, il repart à zéro. |
Jauge |
Entier non signé de 32 bits ou 64 bits dont la valeur peut augmenter ou diminuer. Un exemple des données représentées par cet élément est la valeur instantanée d’une ressource spécifique, telle que la profondeur ou la température de la file d’attente. |
Taux |
Vitesse à laquelle une mesure de base change, telle qu’un compteur ou une jauge. Pour ce type d’élément, les unités de mesure sont définies explicitement (telles que les bits par seconde), ainsi que l’intervalle sur lequel le débit est collecté. |
Moyenne |
Moyenne de plusieurs échantillons d’une métrique de base. Par exemple, un élément de données de profondeur de file d’attente moyenne serait calculé en faisant la moyenne de plusieurs éléments de la profondeur de file d’attente . Pour ce type d’élément, nous recommandons fortement de définir le nombre de mesures utilisées pour calculer la moyenne, ainsi que l’intervalle de temps entre les mesures. Sinon, vous devez définir explicitement les moyens par lesquels cette valeur moyenne est calculée. |
Pic |
Valeur maximale parmi plusieurs échantillons d’une métrique de base. Par exemple, un élément de profondeur de file d’attente maximale serait calculé en comparant plusieurs mesures de la profondeur de file d’attente et en sélectionnant le maximum. Pour ce type d’élément de données, nous vous recommandons vivement de définir le nombre de mesures utilisées pour calculer la valeur maximale, ainsi que l’intervalle de temps entre les mesures. Sinon, définissez explicitement comment cette valeur de pointe est définie. Vous devez également savoir si cette valeur n’est jamais effacée et représente donc la valeur maximale globale sur tous les temps. |
Chaque type d’élément de données inclut également des sous-ensembles d’éléments. Par exemple, les éléments Counter de données et inclurait des sous-ensembles pour rate, averageet Gauge peak les mesures.
Tableau de l’historique des modifications
La prise en charge des fonctionnalités est déterminée par la plate-forme et la version que vous utilisez. Utilisez l’Explorateur de fonctionnalités pour déterminer si une fonctionnalité est prise en charge sur votre plateforme.