Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

Análisis basado en la intención con la utilidad AOS-CLI

Descripción general de IBA con AOS-CLI

Después de implementar un plano, puede comenzar con los análisis basados en la intención (IBA). Puede trabajar con IBA mediante la GUI de Apstra o, en entornos que no sean de producción, puede usar la utilidad experimental aos-cli. Para obtener más información acerca de cómo usar los sondeos de IBA desde la GUI, consulte Sondeos en la sección Análisis. En esta guía, se muestra cómo usar aos-cli.

Nota:

La utilidad aos-cli es una herramienta experimental y tiene soporte limitado. No lo utilice en entornos de producción a menos que el soporte de Juniper lo aconseje. Algunas versiones no están pensadas para ciertas versiones de Apstra. Algunos comandos aos-cli pueden funcionar o no entre diferentes versiones de Apstra. Siempre es mejor probar una versión de aos-cli con una versión específica de Apstra en un entorno que no sea de producción, o ponerse en contacto con el soporte de Juniper para obtener ayuda.

La utilidad aos-cli le permite extraer información del servidor de Apstra para análisis (y otras funcionalidades). El flujo de trabajo para las pruebas iba es el siguiente:

  1. Instale aos-cli.
  2. Instalar paquetes.
  3. Cree perfiles de agente de dispositivo.
  4. Instalar agentes de dispositivo.
  5. Instale los sondeos iba.

Después de instanciar las pruebas, puede usar Syslog para enviar mensajes a los servidores Syslog. Consulte Configuración de Syslog para obtener más detalles.

Instalar AOS-CLI

Instale la utilidad aos-cli por instrucciones en el artículo kb36747 de la Base de conocimientos de soporte de Juniper.

Paquetes de instalación

  1. Descargue el paquete más reciente de Apstra SDK del artículo kb37156 de la Base de conocimientos del soporte de Juniper.
  2. Los paquetes de recolección personalizados permiten la recopilación de telemetría desde dispositivos. Extraiga el recopilador de su plataforma (por ejemplo, aosstdcollectors_custom_eos-0.1.0.post10-py2-none-any.whl dónde eos está la plataforma y 10 es la versión).
  3. Los recolectores requieren paquetes de biblioteca Python específicos. Si el entorno de Apstra tiene acceso a Internet, los archivos se instalan automáticamente. Si el entorno no tiene acceso a Internet, descargue los siguientes archivos del repositorio oficial de Python. Asegúrese de descargar las versiones correctas:
    • netaddr-0.7.17-py2.py3-none-any.whl
    • gtextfsm-0.2.1.tar.gz
    • pyeapi-0.8.2.tar.gz
  4. En el menú de navegación izquierdo de la GUI de Apstra, vaya a Dispositivos > System Agents > Paquetes y haga clic en Cargar paquetes.
  5. Haga clic en Elegir archivo y vaya al paquete del recopilador personalizado (y si no se puede acceder a Internet, los tres (3) paquetes Python), o arrastre y suelte los archivos en la ventana de diálogo. Vea el siguiente ejemplo para los dispositivos Arista en un entorno sin acceso a Internet:
  6. Haga clic en Cargar para cargar los paquetes en el servidor Apstra y, a continuación, cierre el cuadro de diálogo para volver a la vista de lista.

Crear perfiles de agente

Con los perfiles de agente, puede especificar paquetes una vez en el perfil y, a continuación, aplicar el perfil a varios agentes al mismo tiempo. Creemos un perfil que contenga los cuatro paquetes. (Recuerde que si su entorno tiene acceso a Internet, solo necesita incluir el paquete de recopilador personalizado.)

  1. En el menú de navegación izquierdo, vaya a Devices > System Agents > Agent Profiles y haga clic en Crear perfil de agente.
  2. Para este ejemplo, seleccione EOS en la lista desplegable de la plataforma.
  3. En la sección Paquetes, seleccione los cuatro paquetes cargados para asociarlos con el perfil del agente.
  4. Haga clic en Crear para crear el perfil del agente y volver a la vista de lista.

Para obtener más información acerca de los perfiles de agente, consulte Perfiles de agente.

Crear agentes

Ahora vamos a crear agentes para dispositivos Arista y usar el perfil de agente para asociar los paquetes a ellos. Recomendamos que utilice perfiles de agente para asociar paquetes de recopilador personalizados, de modo que pueda actualizar agentes en masa más tarde, según sea necesario, con un solo comando.

  1. En el menú de navegación izquierdo, vaya a Dispositivos > System Agents > Agents y haga clic en Create Onbox Agent(s).
  2. Ingrese los detalles del agente y seleccione el perfil del agente de la lista desplegable como se muestra en la imagen de abajo:
  3. Para comprobar que los paquetes se han instalado correctamente en los agentes, en el menú de navegación izquierdo, vaya a Dispositivos > System Agents < Agents y haga clic en la dirección del dispositivo para comprobar. La sección Configuración enumera los paquetes instalados. Si ha cargado manualmente los paquetes de Python (netaddr, gtextfsm y pyeapi) se enumeran. Si el servidor Apstra tiene acceso a Internet, se cargaron automáticamente y no se enumerarán aquí. (Para ver todos los paquetes instalados en el dispositivo, inicie sesión en el dispositivo y compruebe la /tmp/plugins carpeta.)

Para obtener más información acerca de los agentes, consulte Agentes.

Actualizar agentes desde AOS-CLI

A partir de la compilación 423 de apstra, puede actualizar agentes con un perfil de agente determinado, según sea necesario, según ip/ID o tipo de sistema operativo (os_type) (por ejemplo, EOS).

Para actualizar agentes por rango IP con un perfil de agente específico, utilice el comando system-agents update-profile como se muestra en el ejemplo siguiente. Al configurar la opción, aos-cli --profile muestra los perfiles de agente disponibles. Para seleccionar, utilice las teclas de dirección hacia arriba y hacia abajo.

Por ejemplo.

Instalar sondeos IBA

Puede instalar pruebas iba con la GUI de Apstra o, en entornos que no sean de producción, puede usar aos-cli. Para obtener más información acerca de cómo crear o instanciar sondas predefinidas a partir de la GUI, consulte Sondeos en la sección Analytics. En esta sección, se muestra cómo usar la utilidad aos-cli.

Todas las pruebas descritas en este documento se incluyen en la compilación 412 y posteriores de aos-cli. Es .j2 posible que los archivos de prueba estén disponibles si el archivo de prueba no está integrado en la compilación aos-cli.

Algunos de estos sondeos requieren un registro de servicios actualizado. Descargue el SDK más reciente de Apstra y extraiga el json-schemas.tar.gz archivo. Copie el archivo en el /home/admin directorio del servidor de Apstra para que esté disponible en el directorio aos-cli/mytmp .

Para crear sondeos, utilice el probe create comando aos-cli. Se le pedirán opciones adicionales.

Para seleccionar el ID de modelo, utilice --blueprint y complete la pestaña.

Para enumerar las pruebas disponibles suministradas con aos-cli, use --file y complete pestañas. Desplácese por la lista con las teclas de dirección hacia arriba y hacia abajo.

Algunas pruebas necesitan más Probe template variables.

Para ver los sondeos de IBA instalados en el plano, vaya a Análisis > sondas.

Ejemplos de pruebas iba de Apstra

En la siguiente sección se describe cómo instalar algunos de los sondeos más interesantes que no están disponibles de forma predeterminada.

Caídas de paquetes

Las pruebas de IBA de caída de paquetes detectan una cantidad anormal de caídas de paquetes en interfaces de dispositivos administrados por Apstra según la telemetría de interfaz recopilada por los agentes de dispositivo.

Descripción del nombre de archivo
pkt_discard_anomalies.j2 Detectar interfaces de estructura con descartes de paquetes continuos

Para instalar el pkt_discard_anomalies.j2 sondeo IBA:

Óptica SFP

Las sondas ópticas IBA SFP detectan umbrales de advertencia altos o bajos en la potencia de RX de SFP, la potencia de transmisión, la temperatura, el voltaje o la corriente para módulos ópticos compatibles en interfaces de dispositivos administrados por Apstra según la telemetría de SFP recopilada por los agentes de dispositivo.

Descripción del nombre de archivo
sfp.j2 Detecte umbrales de advertencia altos o bajos en la alimentación de RX SFP, la potencia de transmisión, la temperatura, el voltaje o la corriente

Para instalar el sfp.j2 sondeo IBA:

Pérdida de memoria del conmutador (solo Arista EOS)

Las pruebas de IBA de pérdida de memoria del conmutador detectan fugas de memoria anormales en procesos especificados en dispositivos administrados por Apstra según la telemetría del sistema recopilada por los agentes de dispositivo. Esta prueba requiere las credenciales de usuario del dispositivo establecidas en la configuración del agente de dispositivo que tiene inicio de sesión y acceso al símbolo de BASH del dispositivo.

Descripción del nombre de archivo
memory_usage_threshold_anomalies.j2 Detecte fugas de memoria en el proceso especificado en todos los conmutadores de la estructura
system_memory_usage_threshold_anomalies.j2 Detecte conmutadores con potenciales fugas de memoria en la estructura

El memory_usage_threshold_anomalies.j2 sondeo IBA requiere "variables de plantilla de prueba" adicionales para os_family y process.

La única opción es eos para os_family Arista EOS. Las (2) opciones de process son edac-poller y fastcapi o configagent.

Nota:

"FastCapi" como proceso de servicio es válido solo para la versión 4.18 de EOS. Para la versión más reciente de EOS, por ejemplo, 4.20 y posteriores, solo Es válido ConfigAgent. Cuide mucho más que el nombre del servicio esté en minúscula durante la creación de la sonda. Así que debería ser configagent en lugar de ConfigAgent.

Para instalar el sondeo IBA para un segundo proceso, repita el probe create comando para el otro proceso.

Puede editar el nombre del sondeo IBA para incluir el nombre del proceso.

Para instalar el system_memory_usage_threshold_anomalies.j2 sondeo IBA:

Tolerancia a errores

Estas (2) pruebas requieren una compilación 430 o posterior.

Descripción del nombre de archivo
spine_fault_tolerance.j2 Descubra si se va a tolerar la falla de un número determinado de spines en la estructura. Aumente la anomalía si el tráfico total en todas las spines es mayor que la capacidad spine disponible, con el número especificado de fallas de spine.
lag_link_fault_tolerance.j2 Descubra si se va a tolerar una falla de un vínculo en un LAG del servidor. Monitorea el tráfico total en cada LAG con la capacidad total disponible del vínculo, con una falla de vínculo. Aumento de anomalías para racks con más del 50 % de dichos bonos sobreusados, sostenidos durante cierto tiempo.

Para instalar el spine_fault_tolerance.j2 sondeo IBA:

Nota:

number_of_faulty_spines_to_be_tolerated se debe especificar.

Para instalar el lag_link_fault_tolerance.j2 sondeo IBA: