Řešení potíží Azure Percept DK zařízení

Účelem tohoto článku o řešení potíží je pomoct Azure Percept DK rychle vyřešit běžné problémy s jejich vývojová sadami. Poskytuje také pokyny ke shromažďování protokolů v případě, že je potřeba další podpora.

Shromažďování protokolů

V této části najdete pokyny, které protokoly se mají shromažďovat a jak je shromažďovat.

Shromažďování protokolů

  1. Připojení se k vývojové sadě přes SSH.

  2. V okně terminálu SSH spusťte potřebné příkazy. Seznam příkazů pro shromažďování protokolů najdete v další části.

  3. Přesměrovat výstup do .txt souboru pro další analýzu, použijte následující syntaxi:

    sudo [command] > [file name].txt
    
  4. Změňte oprávnění souboru .txt, aby ho bylo možné zkopírovat:

    sudo chmod 666 [file name].txt
    
  5. Zkopírujte soubor do hostitelského počítače přes SCP:

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

    [local host file path] odkazuje na umístění na hostitelském počítači, do které chcete zkopírovat .txt souboru. [remote username] je uživatelské jméno SSH zvolené během instalace.

Typy a příkazy protokolu

Účel protokolu Kdy ho shromáždit Příkaz
Sada podpory – poskytuje sadu protokolů, které jsou potřeba pro většinu žádostí o zákaznickou podporu. Shromáždí se vždy, když požádáte o podporu. sudo iotedge support-bundle --since 1h

"--since 1h" can be changed to any time span, example, "6h" (6 hours), "6d" (6 days) or "6m" (6 minutes)
Protokoly OOBE – zaznamenává podrobnosti o prostředí instalace. Shromáždí, když zjistíte problémy během instalace. sudo journalctl -u oobe -b
edgeAgent logs – zaznamenává čísla verzí všech modulů spuštěných na vašem zařízení. Shromáždí, když jeden nebo více modulů nefunguje. sudo iotedge logs edgeAgent
Protokoly kontejnerů modulů – zaznamenává údaje o konkrétních kontejnerech IoT Edge modulu. Shromažďování informací o problémech s modulem sudo iotedge logs [container name]
Síťové protokoly – sada protokolů pokrývajících Wi-Fi služeb a zásobníku sítě. Shromáždí, když zjistíte Wi-Fi problémy se sítí. 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

Spusťte oba příkazy. Každý příkaz shromáždí několik protokolů a vkládá je do jednoho výstupu.

Upozornění

Výstup příkazu support-bundle může obsahovat názvy hostitelů, zařízení a modulů, informace protokolované moduly atd. Pokud sdílíte výstup na veřejném fóru, mějte na paměti tyto informace.

Příkazy pro řešení potíží

Tady je sada příkazů, které můžete použít k řešení potíží, které můžete najít u vývojové sady. Pokud chcete tyto příkazy spustit, musíte se nejprve připojit k vývojové sadě přes SSH.

Další informace o příkazech Azure IoT Edge najdete v dokumentaci k řešení Azure IoT Edge zařízení.

Funkce Kdy je použít Příkaz
Kontroluje verzi softwaru na vývojové sadě. Použijte vždy, když potřebujete potvrdit, která verze softwaru je na vaší vývojové sadě. cat /etc/os-release && cat /etc/os-subrelease && cat /etc/adu-version
Kontroluje teplotu vývojové sady. Používejte je v případech, kdy si myslíte, že se vývojová sada může přehřát. cat /sys/class/thermal/thermal_zone0/temp
Zkontroluje ID telemetrie vývojové sady. Použijte v případech, kdy potřebujete znát jedinečný identifikátor telemetrie vývojových sad. sudo azure-device-health-id
Kontroluje stav IoT Edge Použijte vždy, když dojde k problémům IoT Edge s připojením modulů ke cloudu. sudo iotedge check
Restartuje proces démon zabezpečení Azure IoT Edge zabezpečení. Použijte v IoT Edge, že aplikace nereaguje nebo nefunguje správně. sudo systemctl restart iotedge
Uvádí seznam nasazených Azure IoT Edge modulů. Když potřebujete zobrazit všechny moduly nasazené na vývojové sadě sudo iotedge list
Zobrazí dostupné a celkové místo v zadaných systémech souborů. Použijte , pokud potřebujete znát dostupné úložiště na vývojové sadě. df [option] [file]
Zobrazí INFORMACE o IP adrese a rozhraní vývojové sady. Tuto adresu použijte, když potřebujete znát IP adresu vývojové sady. ip route get 1.1.1.1
Zobrazit jenom IP adresu vývojové sady Použijte, když chcete jenom IP adresu vývojové sady, a ne další informace o rozhraní. ip route get 1.1.1.1 | awk '{print $7}'
ifconfig [interface]

Chyby aktualizace USB

Chyba: Řešení:
LIBUSB_ERROR_XXX usb flash prostřednictvím jednotky UUU Tato chyba je výsledkem selhání připojení USB během aktualizace jednotky UUU. Pokud není kabel USB správně připojený k portům USB na počítači nebo nosné desce Percept DK, dojde k chybě tohoto formuláře. Zkuste odpojit a znovu připojit oba konce kabelu USB a kabel zabalit, abyste zajistili zabezpečené připojení.

Vymazání místa na pevném disku na Azure Percept DK

Existují dvě komponenty, které zachytají místo na pevném disku v Azure Percept DK, protokoly kontejnerů Dockeru a samotné kontejnery Dockeru. Aby se zajistilo, že protokoly kontejneru nezachytnou všechny pevné místo, má Azure Percept DK integrovanou obměnou protokolů, která při generování nových protokolů obměna starých protokolů.

V situacích, kdy počet kontejnerů Dockeru způsobuje problémy s místo na pevném disku, můžete nepoužívané kontejnery odstranit pomocí následujícího postupu:

  1. SSH do vývojové sady
  2. Spusťte tento příkaz: docker system prune

Tím se odeberou všechny nepoužívané kontejnery, sítě, image a volitelně svazky. Další podrobnosti najdete na této stránce.

Azure Percept DK led diodu nosné desky

Nad skříněmi nosné desky jsou tři malé LED diody. Vedle indikátoru LED 1 se vytiskne ikona cloudu, vedle indikátoru LED 2 se vytiskne ikona indikátoru Wi-Fi a vedle indikátoru LED 3 se vykřičník. Informace o jednotlivých stavech LED najdete v následující tabulce.

LED State Popis
LED 1 (IoT Hub) On (solid) Zařízení je připojené k IoT Hub.
LED 2 (Wi-Fi) Pomalé blikání Zařízení je připravené ke konfiguraci Wi-Fi Easy Připojení a oznamuje, že se nachází v konfigurátoru.
LED 2 (Wi-Fi) Rychlé blikání Ověření bylo úspěšné, probíhá přidružení zařízení.
LED 2 (Wi-Fi) On (solid) Ověření a přidružení bylo úspěšné. zařízení je připojené k Wi-Fi síti.
LED 3 NA Indikátor LED se nepou3/4í.