Récepteurs (plate-forme)
Présentation des récepteurs en streaming
Vous pouvez configurer le serveur Apstra pour qu’il diffuse des alertes, des événements et perfmon, ou toute combinaison de ces derniers. Chaque type de données est envoyé à un récepteur de streaming via son propre socket TCP. Même si les trois types de données sont configurés pour le même récepteur de streaming, trois (3) connexions sont créées entre le serveur Apstra et le récepteur de streaming. Cela permet également d’envoyer les trois types à trois récepteurs de streaming différents.
Les récepteurs comprennent les détails suivants :
- Nom d’hôte - Nom d’hôte
- Port - par défaut : 4444
- Type de message : alertes, événements, perfmon
- Mode de séquençage - non récessuré, séquen
Dans le menu de navigation de gauche, accédez à Platform > Streaming > Receivers pour accéder aux récepteurs. Vous pouvez créer et supprimer des récepteurs.
Créer un récepteur
- Dans le menu de navigation de gauche de l’interface graphique Apstra, accédez à Platform > Streaming > Receivers et cliquez sur Créer un récepteur.
- Saisissez/sélectionnez les valeurs requises.
- Cliquez sur Créer pour créer le récepteur et revenir à la vue du tableau.
Supprimer le récepteur
- Dans le menu de navigation de gauche de l’interface graphique Apstra, accédez à Platform > Streaming > Receivers et cliquez sur le bouton supprimer pour que le récepteur soit supprimé.
- Cliquez sur Supprimer pour supprimer le récepteur du système et revenir à la vue du tableau.
Configurer les récepteurs à l’aide du plugin Telegraf
Vous pouvez utiliser le plug-in d’entrée Apstra Telegraf pour recevoir des télémètres en streaming d’Apstra. Telegraf est un agent de collecte, de traitement, d’agrégation et d’écriture de métriques. Il s’agit du composant d’AOSOM-Streaming qui gère la réception des messages protobuf de l’environnement Apstra. Pour plus d’informations, consultez le guide de streaming AOSOM. La plate-forme Telegraf se compose de plugins d’entrée et de sortie que vous pouvez choisir pour agréger et stocker des métriques dans différentes bases de données back-end. Le plug-in d’entrée Apstra pour Telegraf désérialise le flux protobuf et crée des métriques qui peuvent ensuite être envoyées à une base de données back-end particulière, telle que Prometheus, InfluxDB ou Elasticsearch.
La configuration décrite ici suppose que vous utilisez le plug-in d’entrée Apstra Telegraf. Vous pouvez configurer les récepteurs de streaming dans Apstra avec le plug-in Telegraf en lui fournissant des informations d’identification Apstra. Nous vous recommandons d’utiliser un compte Apstra distinct avec uniquement les informations d’identification de streaming. Si vous configurez via l’interface graphique, il n’est pas nécessaire de fournir des informations d’identification dans le fichier de configuration Telegraf.
Le moyen le plus simple d’exécuter le récepteur Telegraf est dans un conteneur Docker. L’extrait docker-compose.yml
ci-dessous montre la configuration du conteneur Telegraf. Cela extrait le dernier conteneur Telegraf pris en charge par Apstra depuis Docker Hub.
# Telegraf container config telegraf-prom: image: apstra/telegraf:latest command: telegraf volumes: - ./config/telegraf-prom.toml:/etc/telegraf/telegraf.conf ports: - '9999:9999'
Le fichier de configuration Telegraf - ./config/telegraf-prom.toml
est mappé /etc/telegraf/telegraf.conf
sur le conteneur. Il comprend les paramètres suivants :
- adresse : spécifie l’adresse IP du récepteur de streaming
- port : spécifie le port sur lequel le récepteur de streaming écoutera
- streaming_type : spécifie le type de données à diffuser depuis Apstra vers ce récepteur
Les paramètres restants ne sont nécessaires que si vous voulez que le plug-in Apstra Telegraf configure les récepteurs de streaming dans Apstra via l’API.
- aos_server - spécifie l’adresse IP du serveur Apstra
- aos_port - devrait toujours être 443
- aos_login - Nom d’utilisateur Apstrs
- aos_password - Mot de passe Apstra
Les configurations des plug-ins d’entrée et de sortie sont indiquées dans l’extrait ci-dessous. Le plug-in de sortie est configuré pour le client Prometheus et écoute sur le port 9126. Le plug-in d’entrée est configuré pour Apstra.
# Configuration for Prometheus server to expose metrics [[outputs.prometheus_client]] listen = ":9126" expiration_interval = "0" [[inputs.aos]] address = "10.1.1.200" port = 9999 streaming_type = [ "perfmon", "alerts", "events" ] aos_server = "$AOS_SERVER" aos_port = $AOS_PORT aos_login = "$AOS_LOGIN" aos_password = "$AOS_PASSWORD"