Comandos de solo lectura de Network Fabric para la solución de problemas

Artículo
04/18/2024

La solución de problemas de dispositivos de red es un aspecto fundamental de la administración de red eficaz. Garantizar el estado y el rendimiento óptimo de la infraestructura requiere un diagnóstico y una resolución de problemas oportunos. En esta guía, presentamos un enfoque integral para la solución de problemas de dispositivos de Azure Operator Nexus mediante comandos de solo lectura (RO).

Descripción de los comandos de solo lectura

Los comandos RO sirven como herramientas esenciales para los administradores de red. A diferencia de los comandos de lectura y escritura (RW) que modifican las configuraciones de dispositivos, los comandos RO permiten a los administradores recopilar información de diagnóstico sin modificar el estado del dispositivo. Estos comandos proporcionan información valiosa sobre el estado, la configuración y los datos operativos del dispositivo.

API de diagnóstico de solo lectura

La API de diagnóstico de solo lectura permite a los usuarios ejecutar comandos show en dispositivos de red a través de una llamada API. Este método eficaz permite a los administradores ejecutar consultas de diagnóstico de forma remota en todos los dispositivos del tejido de red. Entre las características clave de la API de diagnóstico de solo lectura se incluyen las siguientes:

Eficacia: ejecute comandos show sin acceso directo a la consola del dispositivo.
Perfecta integración con AZCLI: los usuarios pueden usar la Interfaz de la línea de comandos de Azure (AZCLI) normal para pasar el "comando show" deseado. A continuación, la API facilita la ejecución de comandos en el dispositivo de destino, capturando la salida.
Salida JSON: los resultados de los comandos ejecutados se presentan en formato JSON, lo que facilita el análisis.
Almacenamiento seguro: los datos de salida se almacenan en la cuenta de almacenamiento propiedad del cliente, lo que garantiza la seguridad y el cumplimiento de los datos.

Gracias al uso de la API de diagnóstico de solo lectura, los administradores de red pueden solucionar problemas, comprobar las configuraciones y supervisar el estado de sus dispositivos de Azure Operator Nexus de forma eficaz.

Requisitos previos

Para usar comandos de solo lectura de Network Fabric, complete los pasos siguientes:

Aprovisione Nexus Network Fabric correctamente.
Genere la dirección URL de almacenamiento.

Consulte Creación de un contenedor para crear un contenedor.

Nota:

Escriba el nombre del contenedor con solo letras minúsculas.

Consulte Generación de una firma de acceso compartido para crear la dirección URL de SAS del contenedor. Proporcione permiso de escritura para SAS.

Nota:

Las direcciones URL de SAS son de corta duración. De forma predeterminada, se establece para que expire en ocho horas. Si expira la dirección URL de SAS, el tejido debe volver a aplicar revisiones.
Proporcione la dirección URL de almacenamiento con acceso de escritura a través de una incidencia de soporte técnico.

Nota:

La dirección URL de almacenamiento debe estar en una región diferente de Network Fabric. Por ejemplo, si fabric se hospeda en Este de EE. UU., la dirección URL de almacenamiento debe estar fuera del Este de EE. UU.

Restricciones de comando

Para garantizar la seguridad y el cumplimiento, los comandos RO deben cumplir las siguientes reglas específicas:

Solo los comandos absolutos deben proporcionarse como entrada. No se admiten formas abreviadas ni mensajes. Por ejemplo:
- Escriba show interfaces Ethernet 1/1 status.
- No escriba sh int stat ni sh int e1/1 status
Los comandos no deben ser nulos, estar vacíos ni constar solo de una sola palabra.
Los comandos no deben incluir el carácter de barra vertical (|).
Los comandos show no están restringidos salvo en el caso de los comandos intensivos de uso elevado de CPU a los que se hace referencia específicamente en esta lista de restricciones.
Los comandos no deben terminar con tech-support, agent logs, ip routeo ip route vrf all.
Solo se puede usar un comando show a la vez en un dispositivo específico.
Puede ejecutar el comando show en otra ventana de la CLI en paralelo.
Puede ejecutar un comando show en diferentes dispositivos al mismo tiempo.

Solución de problemas mediante comandos de solo lectura

Para solucionar problemas mediante comandos de solo lectura, siga estos pasos:

Abra una incidencia de soporte técnico de Microsoft. El ingeniero de soporte técnico realiza las actualizaciones necesarias.

Ejecute el siguiente comando de la CLI de Azure:

az networkfabric device run-ro --resource-name "<NFResourceName>" --resource-group "<NFResourceGroupName>" --ro-command "show version"

Resultado esperado:

{ }

Escriba el comando siguiente:

az networkfabric device run-ro --resource-group Fab3LabNF-6-0-A --resource-name nffab3-6-0-A-AggrRack-CE1 --ro-command "show version" --no-wait --debug

Aparecerá la siguiente salida (truncada). Copie la dirección URL a través de la versión preliminar privada. Esta parte de la dirección URL se usa en el paso siguiente para comprobar el estado de la operación.

https://management.azure.com/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS2EUAP/operationStatuses/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e*A9E6DB3DF5C58D67BD395F7A608C056BC8219C392CC1CE0AD22E4C36D70CEE5C?api-version=2022-01-15-privatepreview***&t=638485032018035520&c=MIIHHjCCBgagAwIBAgITfwKWMg6goKCq4WwU2AAEApYyDjANBgkqhkiG9w0BAQsFADBEMRMwEQYKCZImiZPyLGQBGRYDR0JMMRMwEQYKCZImiZPyLGQBGRYDQU1FMRgwFgYDVQQDEw9BTUUgSW5mcmEgQ0EgMDIwHhcNMjQwMTMwMTAzMDI3WhcNMjUwMTI0MTAzMDI3WjBAMT4wPAYDVQQDEzVhc3luY29wZXJhdGlvbnNpZ25pbmdjZXJ0aWZpY2F0ZS5tYW5hZ2VtZW50LmF6dXJlLmNvbTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALMk1pBZQQoNY8tos8XBaEjHjcdWubRHrQk5CqKcX3tpFfukMI0_PVZK-Kr7xkZFQTYp_ItaM2RPRDXx-0W9-mmrUBKvdcQ0rdjcSXDek7GvWS29F5sDHojD1v3e9k2jJa4cVSWwdIguvXmdUa57t1EHxqtDzTL4WmjXitzY8QOIHLMRLyXUNg3Gqfxch40cmQeBoN4rVMlP31LizDfdwRyT1qghK7vgvworA3D9rE00aM0n7TcBH9I0mu-96JE0gSX1FWXctlEcmdwQmXj_U0sZCu11_Yr6Oa34bmUQHGc3hDvO226L1Au-QsLuRWFLbKJ-0wmSV5b3CbU1kweD5LUCAwEAAaOCBAswggQHMCcGCSsGAQQBgjcVCgQaMBgwCgYIKwYBBQUHAwEwCgYIKwYBBQUHAwIwPQYJKwYBBAGCNxUHBDAwLgYmKwYBBAGCNxUIhpDjDYTVtHiE8Ys-

Compruebe mediante programación el estado de la operación mediante el siguiente comando de la CLI de Azure:
```
az rest -m get -u "<Azure-AsyncOperation-endpoint url>"
```
El estado de la operación indica si la API se realizó correctamente o no y tiene un aspecto similar a la siguiente salida:
```
https://management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx
```

Vea y descargue el archivo de salida generado. A continuación se muestra la salida de ejemplo.

 {
 "architecture": "x86_64",
  "bootupTimestamp": 1701940797.5429916,
  "configMacAddress": "00:00:00:00:00:00",
  "hardwareRevision": "12.05",
  "hwMacAddress": "c4:ca:2b:62:6d:d3",
  "imageFormatVersion": "3.0",
  "imageOptimization": "Default",
  "internalBuildId": "d009619b-XXXX-XXXX-XXXX-fcccff30ae3b",
  "internalVersion": "4.30.3M-33434233.4303M",
  "isIntlVersion": false,
  "memFree": 3744220,
  "memTotal": 8107980,
  "mfgName": "Arista",
  "modelName": "DCS-7280DR3-24-F",
  "serialNumber": "JPAXXXX1LZ",
  "systemMacAddress": "c4:ca:2b:62:6d:d3",
  "uptime": 8475685.5,
  "version": "4.30.3M"
 }

Compartir a través de