Felsöka Azure Percept DK enhet

  • Artikel
  • 4 minuter för att läsa

Syftet med den här felsökningsartikeln är att hjälpa Azure Percept DK att snabbt lösa vanliga problem med sina dev kits. Den ger också vägledning om hur du samlar in loggar när extra support krävs.

Logginsamling

I det här avsnittet får du vägledning om vilka loggar som ska samlas in och hur du samlar in dem.

Så här samlar du in loggar

  1. Anslut till din dev kit via SSH.

  2. Kör de kommandon som behövs i SSH-terminalfönstret. I nästa avsnitt finns en lista över logginsamlingskommandon.

  3. Omdirigera alla utdata till en .txt-fil för ytterligare analys använder du följande syntax:

    sudo [command] > [file name].txt

  4. Ändra behörigheterna för .txt så att den kan kopieras:

    sudo chmod 666 [file name].txt

  5. Kopiera filen till värddatorn via SCP:

    scp [remote username]@[IP address]:[remote file path]/[file name].txt [local host file path]

    [local host file path] refererar till den plats på värddatorn som du vill kopiera filen .txt till. [remote username] är det SSH-användarnamn som valts under installationsupplevelsen.

Loggtyper och kommandon

Loggsyfte När du ska samla in den Kommando
Supportpaket – innehåller en uppsättning loggar som behövs för de flesta kundsupportförfrågningar. Samla in när du begär support. sudo iotedge support-bundle --since 1h

"--since 1h" kan ändras till val annat tidsintervall, till exempel "6h" (6 timmar), "6d" (6 dagar) eller "6 m" (6 minuter)
OOBE-loggar – registrerar information om installationsupplevelsen. Samla in när du hittar problem under installationen. sudo journalctl -u oobe -b
edgeAgent-loggar – registrerar versionsnumren för alla moduler som körs på enheten. Samla in när en eller flera moduler inte fungerar. sudo iotedge logs edgeAgent
Modulcontainerloggar – registrerar information om specifika IoT Edge modulcontainrar Samla in när du hittar problem med en modul sudo iotedge logs [container name]
Nätverksloggar – en uppsättning loggar som täcker Wi-Fi tjänster och nätverksstacken. Samla in när du Wi-Fi problem med nätverket. sudo journalctl -u hostapd.service -u wpa_supplicant.service -u ztpd.service -u systemd-networkd > network_log.txt

cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version && rpm -q ztpd > system_ver.txt

Kör båda kommandona. Varje kommando samlar in flera loggar och placerar dem i en enda utdata.

Varning

Utdata från support-bundle kommandot kan innehålla värd-, enhets- och modulnamn, information som loggas av dina moduler osv. Tänk på detta om du delar utdata i ett offentligt forum.

Felsökningskommandon

Här är en uppsättning kommandon som kan användas för felsökning av problem som du kan hitta med Dev Kit. Om du vill köra de här kommandona måste du först ansluta till dev kit via SSH.

Mer information om Azure IoT Edge finns i felsökningsdokumentationen Azure IoT Edge enheten.

Funktion När du ska använda detta Kommando
Kontrollerar programvaruversionen på dev kit. Använd varje gång du behöver bekräfta vilken programvaruversion som finns i ditt dev kit. cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version
Kontrollerar temperaturen för dev kit Använd i fall där du tror att dev kit kan vara undermålig. cat /sys/class/thermal/thermal_zone0/temp
Kontrollerar dev kits telemetri-ID Använd i fall där du behöver känna till dev kits unika telemetriidentifierare. sudo azure-device-health-id
Kontrollerar status för IoT Edge Används när det finns problem med IoT Edge moduler som ansluter till molnet. sudo iotedge check
Startar om Azure IoT Edge säkerhetsdaemon Använd när IoT Edge inte svarar eller inte fungerar korrekt. sudo systemctl restart iotedge
Visar en lista över de Azure IoT Edge modulerna Uwe när du behöver se alla moduler som distribuerats i dev kit sudo iotedge list
Visar tillgängligt/totalt utrymme i de angivna filsystemen Använd om du behöver känna till det tillgängliga lagringsutrymmet i dev kit. df [option] [file]
Visar dev kit:s IP- och gränssnittsinformation Använd när du behöver känna till Dev Kits IP-adress. ip route get 1.1.1.1
Visa endast Dev Kits IP-adress Använd när du bara vill ha Dev Kits IP-adress och inte den andra gränssnittsinformationen. ip route get 1.1.1.1 | awk '{print $7}'
ifconfig [interface]

USB-uppdateringsfel

Fel: Lösning:
LIBUSB_ERROR_XXX USB-flash via UUU Det här felet beror på ett USB-anslutningsfel under UUU-uppdatering. Om USB-kabeln inte är korrekt ansluten till USB-portarna på datorn eller Percept DK-transportkortet uppstår ett fel i det här formuläret. Prova att koppla från och återansluta båda ändar av USB-kabeln och anslut kabeln för att säkerställa en säker anslutning.

Rensa hårddiskutrymme på Azure Percept DK

Det finns två komponenter som tar upp hårddiskutrymmet på Azure Percept DK docker-containerloggarna och själva Docker-containrarna. För att se till att containerloggarna inte tar upp allt för det hårda utrymmet har Azure Percept DK loggrotation inbyggd som roterar ut alla gamla loggar när nya loggar genereras.

För situationer när antalet Docker-containrar orsakar problem med hårddiskutrymme kan du ta bort oanvända containrar genom att följa dessa steg:

  1. SSH i dev kit
  2. Kör det här kommandot: docker system prune

Detta tar bort alla oanvända containrar, nätverk, avbildningar och eventuellt volymer. Gå till den här sidan för mer information.

Azure Percept DK led-tillstånd för transportkort

Det finns tre små lysdioder ovanpå transportkortshöljet. En molnikon skrivs ut bredvid LED 1, en Wi-Fi-ikon skrivs ut bredvid LED 2 och ett utropstecken visas bredvid LED 3. Se tabellen nedan för information om varje LED-tillstånd.

LEDDE Stat Beskrivning
LED 1 (IoT Hub) På (heldragen) Enheten är ansluten till en IoT Hub.
LED 2 (Wi-Fi) Långsamt blinkning Enheten är redo att konfigureras av Wi-Fi Easy Anslut och meddelar att den finns i en konfigurator.
LED 2 (Wi-Fi) Snabbt blinkning Autentiseringen lyckades, enhetsassociatisering pågår.
LED 2 (Wi-Fi) På (heldragen) Autentisering och association lyckades; enheten är ansluten till ett Wi-Fi nätverk.
LED 3 NA Leden används inte.