Análisis basado en la intención con la utilidad apstra-cli
Descripción general de IBA con apstra-cli
Puede trabajar con análisis basados en la intención (IBA) desde la GUI de Apstra o, para entornos que no sean de producción, puede usar la utilidad experimental apstra-cli (anteriormente llamada aos-cli). Para obtener información acerca de cómo usar sondeos IBA desde la GUI, consulte Sondeos en la sección Análisis. En esta guía se muestra cómo usar apstra-cli.
La utilidad apstra-cli es una herramienta experimental y tiene un soporte limitado. No lo utilice en entornos de producción a menos que se lo indique el Soporte de Juniper. Algunas versiones de apstra-cli no están pensadas para determinadas versiones de Apstra. Algunos comandos de apstra-cli pueden o no funcionar entre diferentes versiones de Apstra. Siempre es mejor probar una versión de apstra-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 apstra-cli le permite extraer información del servidor de Apstra para análisis (y otras funcionalidades). El flujo de trabajo para las sondas IBA es el siguiente:
- Instale apstra-cli.
- Instalar paquetes.
- Crear perfiles de agente de dispositivo.
- Instale agentes de dispositivos.
- Instalar sondas IBA.
Después de crear instancias de sondeos, puede utilizar Syslog para enviar mensajes a los servidores de Syslog.
Instalar apstra-cli
Instalar paquetes
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. Vamos a crear un perfil que contenga los cuatro paquetes. (Recuerde que si su entorno tiene acceso a Internet, sólo necesita incluir el paquete recopilador personalizado).
- En el menú de navegación izquierdo, vaya a Dispositivos > Agentes del sistema > perfiles de agente y haga clic en Crear perfil de agente.
- Para este ejemplo, seleccione EOS en la lista desplegable de la plataforma.
- En la sección Paquetes, seleccione los cuatro paquetes cargados para asociarlos al perfil del agente. (Si su entorno tiene acceso a Internet, solo necesita incluir el paquete recopilador personalizado).
- Haga clic en Crear para crear el perfil del agente y volver a la vista de tabla de resumen.
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. Se recomienda usar perfiles de agente para asociar paquetes de recopiladores personalizados, de modo que pueda actualizar los agentes de forma masiva más adelante, según sea necesario, con un solo comando.
- En el menú de navegación izquierdo, vaya a Dispositivos > agentes del sistema > agentes y haga clic en Crear agente de bandeja de entrada.
- Introduzca los detalles del agente y seleccione el perfil del agente en la lista desplegable, tal y como se muestra en la imagen siguiente:
- Para verificar que los paquetes se han instalado correctamente en los agentes, en el menú de navegación izquierdo, vaya a Dispositivos > dispositivos administrados y haga clic en la IP de administración del dispositivo. Haga clic en la ficha Agente. La sección Configuración enumera los paquetes instalados. Si cargó manualmente los paquetes de Python (netaddr, gtextfsm y pyeapi) se enumeran. Si el servidor de Apstra tiene acceso a Internet, se cargó automáticamente y no aparecerá aquí. (Para ver todos los paquetes instalados en el dispositivo, inicie sesión en el dispositivo y compruebe la
/tmp/plugins
carpeta).
Agentes de actualización desde apstra-cli
A partir de la compilación 423 de apstra-cli, puede actualizar los 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 de 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, apstra-cli muestra los --profile
perfiles de agente disponibles. Para seleccionar, utilice las teclas de flecha arriba y abajo.
apstra-cli> system-agents update-profile --ip 172.20.120.6-11 --profile EOS-IBA EOS
Por ejemplo.
apstra-cli> system-agents update-profile --ip 172.20.120.6-11 --profile 692bb0bb-c5e0-4d7e-a70c-c24b0d5650a8 Successfully updated agent 172.20.120.9 with given profile Successfully updated agent 172.20.120.6 with given profile Successfully updated agent 172.20.120.11 with given profile Successfully updated agent 172.20.120.7 with given profile Successfully updated agent 172.20.120.10 with given profile Successfully updated agent 172.20.120.8 with given profile apstra-cli>
Instalar sondas IBA
Puede instalar sondas IBA mediante la GUI de Apstra o, para entornos que no sean de producción, puede usar apstra-cli. Para obtener información acerca de cómo crear o crear instancias de sondeos predefinidos desde la GUI, consulte Sondeos en la sección Análisis. En esta sección se muestra cómo utilizar la utilidad apstra-cli.
Todos los sondeos descritos en este documento se incluyen en la compilación 412 y posteriores de apstra-cli. Los archivos de sondeo .j2
pueden estar disponibles si el archivo de sondeo no está integrado en la compilación de apstra-CLI.
Algunos de estos sondeos requieren un registro de servicio actualizado. Descargue la última versión de Apstra SDK 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 apstra-cli /mytmp
.
apstra-cli> service-registry import-from --file /mytmp/json-schemas.tar.gz Successfully imported service registry entry for interface_details Successfully imported service registry entry for route_count Successfully imported service registry entry for multicast_groups Successfully imported service registry entry for sfp Successfully imported service registry entry for resource_usage Successfully imported service registry entry for mlag_domain Successfully imported service registry entry for stp Successfully imported service registry entry for vtep_counters Successfully imported service registry entry for vlan Successfully imported service registry entry for evpn_type5 Successfully imported service registry entry for ping Successfully imported service registry entry for vxlan_info Successfully imported service registry entry for pim_neighbor_count Successfully imported service registry entry for lldp_details Successfully imported service registry entry for evpn_type3 Successfully imported service registry entry for multicast_info Successfully imported service registry entry for bgp_vrf Successfully imported service registry entry for traceroute Successfully imported service registry entry for vrf Successfully imported service registry entry for table_usage Successfully imported service registry entry for vxlan_address_table Successfully imported service registry entry for acl_stats Successfully imported service registry entry for device_info Successfully imported service registry entry for power_supply Successfully imported service registry entry for interface_buffer Successfully imported service registry entry for pim_rp Successfully imported service registry entry for anycast_rp Successfully imported service registry entry for bgp_iba Successfully imported service registry entry for interface_iba apstra-cli>
Para crear sondeos, utilice el probe create
comando apstra-cli. Se te pedirán opciones adicionales.
apstra-cli> probe create --blueprint Id of the blueprint --file Filename of json file with probe data. Choose from dropdown or specify custom path --skip-service-check [Optional] By default, required telemetry services are checked and enabled on target --check-status [Optional] Wait for probe to become operational. Default: False --service-interval When skip-service-check is False and service is not alreadypresent, this indicates
Para seleccionar el ID del plano, use --blueprint
y complete la tabulación.
apstra-cli> probe create --blueprint 67cd936d-c2de-49f8-8708-df465f0cdc68 L2 Virtual two_stage_l3clos
Para enumerar las sondas disponibles suministradas con apstra-cli, utilícelas --file
y complete la tabulación. Desplácese por la lista con las teclas de flecha arriba y abajo.
apstra-cli> probe create --blueprint 67cd936d-c2de-49f8-8708-df465f0cdc68 --file evpn.j2 sfp.j2 memory_usage_threshold_anomalies.j2 bandwidth_utilization_history.j2 power_supply_anomalies.j2 virtual_infra_vlan_mismatch.j2 hardware_vtep_counters_enabled.j2
Algunas sondas necesitan archivos .Probe template variables
apstra-cli> probe create --blueprint 67cd936d-c2de-49f8-8708-df465f0cdc68 --file /usr/local/lib/python2.7/site-packages/aos_cli/resources/probes/memory_usage_threshold_anomalies.j2 --skip-service-check [Optional] By default, required telemetry services are checked and enabled on target --check-status [Optional] Wait for probe to become operational. Default: False --service-interval When skip-service-check is False and service is not alreadypresent, this indicates --process Probe template variable --os_family Probe template variable
Para ver los sondeos IBA instalados en el plano, vaya a Analytics > Probes.
Ejemplos de sondas IBA de Apstra
En la siguiente sección se describe cómo instalar algunas de las sondas más interesantes que no están disponibles de forma predeterminada.
Entrega de paquetes
Las sondas IBA de entrega de paquetes detectan una cantidad anormal de caídas de paquetes en las interfaces de dispositivos que administra el software Apstra, según la telemetría de la interfaz que recopilan los agentes de dispositivos.
Descripción del nombre de archivo | |
---|---|
pkt_discard_anomalies.j2 | Detectar interfaces de estructura que tienen descartes de paquetes sostenidos |
Para instalar la pkt_discard_anomalies.j2
sonda IBA:
apstra-cli> probe create --blueprint 67cd936d-c2de-49f8-8708-df465f0cdc68 --file /usr/local/lib/python2.7/site-packages/aos_cli/resources/probes/pkt_discard_anomalies.j2 Ensuring needed telemetry services for probe are enabled... Successfully created probe f472ba21-d60f-44dc-9f5d-8318c8b9c07b in blueprint 67cd936d-c2de-49f8-8708-df465f0cdc68 apstra-cli>
Pérdida de memoria del conmutador (solo Arista EOS)
Las sondas IBA de pérdida de memoria del conmutador detectan pérdidas de memoria anormales en procesos especificados en dispositivos que administra el software Apstra, según la telemetría del sistema que recopilan los agentes del dispositivo. Esta sonda requiere credenciales de usuario del dispositivo establecidas en la configuración del agente de dispositivo que tiene inicio de sesión y acceso al indicador de BASH del dispositivo.
Descripción del nombre de archivo | |
---|---|
memory_usage_threshold_anomalies.j2 | Detectar pérdidas de memoria en el proceso especificado en todos los conmutadores de la estructura |
system_memory_usage_threshold_anomalies.j2 | Detectar conmutadores con posibles pérdidas de memoria en la estructura |
La memory_usage_threshold_anomalies.j2
sonda IBA requiere "variables de plantilla de sondeo" adicionales para os_family
y process
.
apstra-cli> probe create --blueprint 67cd936d-c2de-49f8-8708-df465f0cdc68 --file /usr/local/lib/python2.7/site-packages/aos_cli/resources/probes/memory_usage_threshold_anomalies.j2 --skip-service-check [Optional] By default, required telemetry services are checked and enabled on target --check-status [Optional] Wait for probe to become operational. Default: False --service-interval When skip-service-check is False and service is not alreadypresent, this indicates --process Probe template variable --os_family Probe template variable
La única opción es os_family
eos
Arista EOS. Las (2) opciones para process
son edac-poller
y fastcapi
o configagent
.
apstra-cli> probe create --blueprint 67cd936d-c2de-49f8-8708-df465f0cdc68 --file /usr/local/lib/python2.7/site-packages/aos_cli/resources/probes/memory_usage_threshold_anomalies.j2 --os_family eos --process fastcapi Ensuring needed telemetry services for probe are enabled... Enabled service resource_usage on device l2-virtual-002-leaf1:172.20.60.11 Enabled service resource_usage on device l2-virtual-001-leaf1:172.20.60.9 Enabled service resource_usage on device spine2:172.20.60.8 Enabled service resource_usage on device spine1:172.20.60.6 Enabled service resource_usage on device l2-virtual-003-leaf1:172.20.60.10 Enabled service resource_usage on device l2-virtual-004-leaf1:172.20.60.7 Successfully created probe 6a258d83-1053-42ad-935c-0550cc500b7d in blueprint 67cd936d-c2de-49f8-8708-df465f0cdc68 apstra-cli>
apstra-cli> probe create --blueprint rack-based-blueprint-10990707 --file /usr/local/lib/python2.7/site-packages/aos_cli/resources/probes/memory_usage_threshold_anomalies.j2 --os_family eos --process configagent Ensuring needed telemetry services for probe are enabled... Successfully created probe ed2c6be1-b4b1-4e1b-bd07-da431e89eeec in blueprint rack-based-blueprint-10990707 apstra-cli>
"FastCapi" como proceso de servicio es válido solo para EOS versión 4.18. Para la versión más reciente de EOS, por ejemplo 4.20 y posterior, solo es válido ConfigAgent. Tenga especial cuidado de que el nombre del servicio esté en minúsculas durante la creación de la sonda. Así que debería ser configagent
en lugar de ConfigAgent
.
Para instalar la sonda IBA para un segundo proceso, repita el probe create
comando para el otro proceso.
Puede editar el nombre de la sonda IBA para incluir el nombre del proceso.
Para instalar la system_memory_usage_threshold_anomalies.j2
sonda IBA:
apstra-cli> probe create --blueprint 67cd936d-c2de-49f8-8708-df465f0cdc68 --file /usr/local/lib/python2.7/site-packages/aos_cli/resources/probes/system_memory_usage_threshold_anomalies.j2 Ensuring needed telemetry services for probe are enabled... Successfully created probe a669ccf8-cba7-414b-ad46-a7d4b4ca3928 in blueprint 67cd936d-c2de-49f8-8708-df465f0cdc68 apstra-cli>
Tolerancia a fallos
Estas (2) sondas requieren la compilación 430 o posterior de apstra-cli.
Descripción del nombre de archivo | |
---|---|
spine_fault_tolerance.j2 | Averigüe si se tolerará la falla de un número dado de espinas en la tela. Aumente la anomalía si el tráfico total en todas las espinas es mayor que la capacidad de columna disponible, con el número especificado de errores de columna vertebral. |
lag_link_fault_tolerance.j2 | Averigüe si se va a tolerar el fallo de un enlace en un LAG de servidor. Supervisa el tráfico total de cada GAL en comparación con la capacidad total disponible del vínculo, con un error de vínculo. Aumentar la anomalía para racks con más del 50% de tales bonos sobreutilizados, sostenidos durante cierta duración. |
Para instalar la spine_fault_tolerance.j2
sonda IBA:
apstra-cli> probe create --blueprint bf7a322c-ee3a-4dcf-aa20-df0560f538da --file /usr/local/lib/python2.7/site-packages/aos_cli/resources/probes/spine_fault_tolerance.j2 --number_of_faulty_spines_to_be_tolerated 1 Successfully created probe 0f0e9bf7-d9b3-43d7-906e-a9f0675e68f2 in blueprint bf7a322c-ee3a-4dcf-aa20-df0560f538da apstra-cli>
number_of_faulty_spines_to_be_tolerated
debe especificarse.
Para instalar la lag_link_fault_tolerance.j2
sonda IBA:
apstra-cli> probe create --blueprint bf7a322c-ee3a-4dcf-aa20-df0560f538da --file /usr/local/lib/python2.7/site-packages/aos_cli/resources/probes/lag_link_fault_tolerance.j2 Successfully created probe 45ce5fe8-555f-41a9-b0ae-267125669d3f in blueprint bf7a322c-ee3a-4dcf-aa20-df0560f538da apstra-cli>