Alleen-lezen opdrachten voor Network Fabric voor probleemoplossing

Artikel
04/17/2024

Problemen met netwerkapparaten oplossen is een essentieel aspect van effectief netwerkbeheer. Het garanderen van de gezondheid en optimale prestaties van uw infrastructuur vereist een tijdige diagnose en oplossing van problemen. In deze handleiding presenteren we een uitgebreide benadering voor het oplossen van problemen met Azure Operator Nexus-apparaten met behulp van alleen-lezen opdrachten (RO).

Informatie over alleen-lezen opdrachten

RO-opdrachten fungeren als essentiële hulpprogramma's voor netwerkbeheerders. In tegenstelling tot LS-opdrachten (read-write) waarmee apparaatconfiguraties worden gewijzigd, kunnen BEHEERDERS met RO-opdrachten diagnostische gegevens verzamelen zonder de status van het apparaat te wijzigen. Deze opdrachten bieden waardevolle inzichten in de status, configuratie en operationele gegevens van het apparaat.

Diagnostische API met het kenmerk Alleen-lezen

Met de alleen-lezen diagnostische API kunnen gebruikers opdrachten uitvoeren show op netwerkapparaten via een API-aanroep. Met deze efficiënte methode kunnen beheerders diagnostische query's op afstand uitvoeren op alle netwerkinfrastructuurapparaten. Belangrijke functies van de diagnostische API met het kenmerk Alleen-lezen zijn onder andere:

Efficiëntie : voer opdrachten uit show zonder directe toegang tot de apparaatconsole.
Naadloze integratie met AZCLI: gebruikers kunnen de reguliere Azure-opdrachtregelinterface (AZCLI) gebruiken om de gewenste 'show command' door te geven. De API faciliteert vervolgens de uitvoering van opdrachten op het doelapparaat, waarbij de uitvoer wordt opgehaald.
JSON-uitvoer: resultaten van de uitgevoerde opdrachten worden weergegeven in JSON-indeling, zodat u deze eenvoudig kunt parseren en analyseren.
Beveiligde opslag: de uitvoergegevens worden opgeslagen in het opslagaccount van de klant, waardoor gegevensbeveiliging en naleving worden gegarandeerd.

Met behulp van de alleen-lezen diagnostische API kunnen netwerkbeheerders efficiënt problemen oplossen, configuraties verifiëren en de apparaatstatus bewaken op hun Azure Operator Nexus-apparaten.

Vereisten

Voer de volgende stappen uit om alleen-lezen opdrachten voor Network Fabric te gebruiken:

Richt de Nexus Network Fabric in.
Genereer de opslag-URL.

Raadpleeg Een container maken om een container te maken.

Notitie

Voer de naam van de container in met alleen kleine letters.

Raadpleeg Een shared access signature genereren om de SAS-URL van de container te maken. Geef schrijfmachtigingen op voor SAS.

Notitie

SAS-URL's hebben een korte levensduur. Deze is standaard ingesteld op verlopen in acht uur. Als de SAS-URL verloopt, moet de infrastructuur opnieuw worden gepatcht.
Geef de opslag-URL schrijftoegang op via een ondersteuningsticket.

Notitie

De opslag-URL moet zich in een andere regio bevinden dan de netwerkinfrastructuur. Als de infrastructuur bijvoorbeeld wordt gehost in VS - oost, moet de opslag-URL zich buiten VS - oost bevinden.

Opdrachtbeperkingen

Ro-opdrachten moeten voldoen aan de volgende specifieke regels om beveiliging en naleving te garanderen:

Alleen absolute opdrachten moeten worden opgegeven als invoer. Korte formulieren en prompts worden niet ondersteund. Bijvoorbeeld:
- show interfaces Ethernet 1/1 status invoeren
- Voer niet in sh int stat of sh int e1/1 status
Opdrachten mogen niet null, leeg of bestaan uit slechts één woord.
Opdrachten mogen het pipeteken (|) niet bevatten.
Opdrachten weergeven zijn onbeperkt, met uitzondering van de hoge CPU-intensieve opdrachten die specifiek worden genoemd in deze lijst met beperkingen.
Opdrachten mogen niet eindigen op tech-support, agent logsof ip routeip route vrf all.
Er kan slechts één show opdracht tegelijk worden gebruikt op een specifiek apparaat.
U kunt de show opdracht parallel uitvoeren in een ander CLI-venster.
U kunt tegelijkertijd een show opdracht uitvoeren op verschillende apparaten.

Problemen oplossen met behulp van alleen-lezen opdrachten

Voer de volgende stappen uit om problemen op te lossen met behulp van alleen-lezen opdrachten:

Open een Microsoft-ondersteuningsticket. De ondersteuningstechnicus voert de benodigde updates uit.

Voer de volgende Azure CLI-opdracht uit:

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

Verwachte uitvoer:

{ }

Voer de volgende opdracht in:

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

De volgende uitvoer (afgekapt) wordt weergegeven. Kopieer de URL via een privévoorbeeld. Dit gedeelte van de URL wordt in de volgende stap gebruikt om de status van de bewerking te controleren.

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-

Controleer de status van de bewerking programmatisch met behulp van de volgende Azure CLI-opdracht:

az rest -m get -u "<Azure-AsyncOperation-endpoint url>"

De bewerkingsstatus geeft aan of de API is geslaagd of mislukt en lijkt op de volgende uitvoer:

https://management.azure.com/subscriptions/xxxxxxxxxxx/providers/Microsoft.ManagedNetworkFabric/locations/EASTUS/operationStatuses/xxxxxxxxxxx?api-version=20XX-0X-xx-xx

Het gegenereerde uitvoerbestand weergeven en downloaden. Voorbeelduitvoer wordt hier weergegeven.

 {
 "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"
 }

Delen via