Receptores (plataforma)
Descripción general de los receptores de streaming
Puede configurar el servidor de Apstra para transmitir alertas, eventos y perfmon, o cualquier combinación de los mismos. Cada tipo de datos se envía a un receptor de transmisión a través de su propio socket TCP. Incluso si los tres tipos de datos están configurados para el mismo receptor de streaming, se crean tres (3) conexiones entre el servidor de Apstra y el receptor de streaming. Esto también permite que los tres tipos se envíen a tres receptores de transmisión diferentes.
Los receptores incluyen los siguientes detalles:
- Nombre de host: nombre de host
- Puerto - predeterminado: 4444
- Tipo de mensaje : alertas, eventos, perfmon
- Modo de secuenciación : sin secuenciar, secuenciado
En el menú de navegación de la izquierda, vaya a Plataforma > Streaming > Receptores para ir a Receptores. Puede crear y eliminar receptores.
Crear receptor
- En el menú de navegación izquierdo de la GUI de Apstra, vaya a Platform > Streaming > Receivers y haga clic en Create Receiver (Crear receptor).
- Introduzca o seleccione los valores necesarios.
- Haga clic en Crear para crear el receptor y volver a la vista de tabla.
Eliminar receptor
- En el menú de navegación izquierdo de la GUI de Apstra, vaya a Platform > Streaming > Receivers y haga clic en el botón Eliminar para que el receptor lo elimine.
- Haga clic en Eliminar para eliminar el receptor del sistema y volver a la vista de tabla.
Configurar receptores mediante el complemento Telegraf
Puede utilizar el complemento de entrada de Apstra Telegraf para recibir telemetría de transmisión de Apstra. Telegraf es un agente para recopilar, procesar, agregar y escribir métricas. Este es el componente de AOSOM-Streaming que maneja la recepción de los mensajes protobuf del entorno de Apstra. Para obtener más información, consulte la Guía de transmisión de AOSOM. La plataforma Telegraf consiste en complementos de entrada y salida entre los que puede elegir para agregar y almacenar métricas en diferentes bases de datos de backend. El complemento de entrada de Apstra para Telegraf deserializa el flujo protobuf y crea métricas que luego se pueden enviar a una base de datos de backend en particular, como Prometheus, InfluxDB o Elasticsearch.
La configuración descrita aquí asume que está utilizando el complemento de entrada de Apstra Telegraf. Puede configurar receptores de transmisión en Apstra con el complemento Telegraf proporcionándole credenciales de Apstra. Le recomendamos que use una cuenta de Apstra independiente con solo las credenciales de transmisión. Si configura a través de la GUI, entonces no es necesario proporcionar credenciales en el archivo de configuración de Telegraf.
La forma más fácil de ejecutar el receptor Telegraf es en un contenedor docker. El docker-compose.yml
siguiente fragmento de código muestra la configuración del contenedor Telegraf. Esto extrae el último contenedor Telegraf compatible con Apstra de 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'
El archivo de configuración de Telegraf - ./config/telegraf-prom.toml
- se asigna al /etc/telegraf/telegraf.conf
contenedor. Incluye los siguientes parámetros:
- dirección : especifica la dirección IP del receptor de streaming
- Puerto : especifica el puerto en el que escuchará el receptor de streaming.
- streaming_type : especifica el tipo de datos que se transmitirán desde Apstra a este receptor
Los parámetros restantes solo son necesarios si desea que el complemento Apstra Telegraf configure los receptores de transmisión en Apstra a través de la API.
- aos_server : especifica la dirección IP del servidor de Apstra
- aos_port - siempre debe ser 443
- aos_login - Apstrs nombre de usuario
- aos_password - Contraseña de Apstra
Las configuraciones del plugin de entrada y salida se muestran en el siguiente fragmento. El plugin de salida está configurado para el cliente Prometheus y escucha en el puerto 9126. El complemento de entrada está configurado para 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"