Op afstand diagnostische logboeken verzamelen van apparaten met Device Update voor IoT Hub

Meer informatie over het initiëren van een apparaatupdate voor IoT Hub logboekbewerking en het weergeven van verzamelde logboeken in Azure Blob Storage.

Vereisten

Azure-portal

• Toegang tot een IoT Hub met Apparaatupdate voor IoT Hub ingeschakeld.
• Een IoT-apparaat (of simulator) dat is ingericht voor Device Update binnen IoT Hub en de diagnostische interface implementeert.
• Een Azure Blob Storage-account onder hetzelfde abonnement als uw Device Update voor IoT Hub-account.

Notitie

De functie voor externe logboekverzameling is momenteel alleen compatibel met apparaten die de diagnostische interface implementeren en bestanden kunnen uploaden naar Azure Blob Storage. De implementatie van de referentieagent verwacht ook dat het apparaat logboekbestanden schrijft naar een door de gebruiker opgegeven bestandspad op het apparaat.

Azure-CLI

• Toegang tot een IoT Hub met Apparaatupdate voor IoT Hub ingeschakeld.

• Een IoT-apparaat (of simulator) dat is ingericht voor Device Update binnen IoT Hub en de diagnostische interface implementeert.

• Een Azure Blob Storage-account onder hetzelfde abonnement als uw Device Update voor IoT Hub-account.

• Een Azure CLI-omgeving:

  • Gebruik de Bash-omgeving in Azure Cloud Shell.

    

  • Of, als u liever cli-referentieopdrachten lokaal uitvoert, installeert u de Azure CLI

    • Meld u aan bij de Azure CLI met behulp van de opdracht az login .
    • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.
    • Installeer bij het eerste gebruik de Azure CLI-extensie wanneer hierom wordt gevraagd. De opdrachten in dit artikel maken gebruik van de extensie azure-iot . Voer uit az extension update --name azure-iot om te controleren of u de nieuwste versie van de extensie gebruikt.

Notitie

De functie voor externe logboekverzameling is momenteel alleen compatibel met apparaten die de diagnostische interface implementeren en bestanden kunnen uploaden naar Azure Blob Storage. De implementatie van de referentieagent verwacht ook dat het apparaat logboekbestanden schrijft naar een door de gebruiker opgegeven bestandspad op het apparaat.

Uw Azure Blob Storage-account koppelen aan uw Device Update-exemplaar

Als u de functie voor het verzamelen van externe logboeken wilt gebruiken, moet u eerst een Azure Blob Storage-account koppelen aan uw Device Update-exemplaar. Dit Azure Blob Storage-account is waar uw apparaten diagnostische logboeken naar uploaden.

Azure-portal

1. Navigeer in de Azure Portal naar uw Apparaatupdate voor IoT Hub-account.

2. Selecteer Exemplaren in de sectie Exemplaarbeheer van het navigatiedeelvenster.

3. Selecteer uw Device Update-exemplaar in de lijst en vervolgens Diagnostische gegevens configureren.

4. Selecteer het tabblad Customer Diagnostics en selecteer vervolgens Azure Storage-account.

5. Kies het gewenste opslagaccount in de lijst en selecteer Opslaan.

6. Wanneer u terug bent in de lijst met exemplaren, selecteert u periodiek vernieuwen totdat de inrichtingsstatus van het exemplaar 'Geslaagd' wordt weergegeven. Dit proces duurt meestal 2-3 minuten.

Azure-CLI

Gebruik de opdracht az iot device-update instance create om diagnostische gegevens te configureren voor uw Device Update-exemplaar.

Tip

U kunt de az iot device-update instance create opdracht op bestaande Device Update-exemplaren gebruiken en het exemplaar configureren met de bijgewerkte parameters.

Vervang de volgende tijdelijke aanduidingen door uw eigen gegevens:

• < >account_name: de naam van uw Device Update-account.
• < >instance_name: de naam van uw Device Update-exemplaar.
• < >storage_id: de resource-id van het opslagaccount waarin de diagnostische logboeken worden opgeslagen. U kunt de resource-id ophalen met behulp van de opdracht az storage show en query's uitvoeren op de id-waarde: az storage account show -n <storage_name> --query id.

az iot device-update instance update --account <account_name> --instance <instance_name> --set enableDiagnostics=true diagnosticStorageProperties.resourceId=<storage_id>

Logboekverzameling configureren

De agent voor apparaatupdates verwijst naar een configuratiebestand op het apparaat, dat zich bevindt op /etc/adu/du-diagnostics-config.json in de referentieagent.

Bestandspaden voor logboekverzameling

De Device Update-agent op een apparaat verzamelt bestanden van specifieke bestandspaden op het apparaat wanneer het een startsignaal voor het uploaden van logboeken ontvangt van de Device Update-service. Deze bestandspaden worden gedefinieerd in het diagnostische configuratiebestand.

In het configuratiebestand wordt elk logboekbestand dat moet worden verzameld en geüpload, weergegeven als een logComponent object met de eigenschappen componentName en logPath. Deze configuratie kan naar wens worden gewijzigd.

Maximale grootte van logboekbestanden

De Device Update-agent verzamelt alleen logboekbestanden met een bepaalde bestandsgrootte. Deze maximale bestandsgrootte wordt gedefinieerd in het configuratiebestand voor diagnostische gegevens.

De relevante parameter 'maxKilobytesToUploadPerLogPath' is van toepassing op elk logComponent-object en kan naar wens worden gewijzigd.

Een logboekbewerking maken

Logboekbewerkingen zijn een servicegestuurde actie die u uw IoT-apparaten kunt instrueren uit te voeren via de Device Update-service. Zie Diagnostische gegevens over apparaatupdates voor een gedetailleerdere uitleg van de werking van logboekbewerkingen.

1. Ga naar uw IoT Hub en selecteer het tabblad Updates onder de sectie Apparaatbeheer van het navigatiedeelvenster.

2. Selecteer het tabblad Diagnostische gegevens in de gebruikersinterface. Als u geen tabblad Diagnostische gegevens ziet, controleert u of u de nieuwste versie van Device Update gebruikt voor IoT Hub gebruikersinterface. Als u 'Diagnostische gegevens moeten zijn ingeschakeld voor dit Device Update-exemplaar' ziet, controleert u of u een Azure Blob Storage-account hebt gekoppeld aan uw Device Update-exemplaar.

3. Selecteer Uploadbewerking voor logboek toevoegen om naar de pagina voor het maken van logboekbewerkingen te navigeren.

4. Voer een naam (id) en beschrijving in voor de nieuwe logboekbewerking en selecteer apparaten toevoegen om te selecteren van welke IoT-apparaten u diagnostische logboeken wilt verzamelen.

5. Selecteer Toevoegen.

6. Eenmaal terug op het tabblad Diagnostische gegevens selecteert u Vernieuwen totdat de logboekbewerking wordt weergegeven in de bewerkingstabel.

7. Zodra de bewerkingsstatus Geslaagd of Mislukt is, selecteert u de naam van de bewerking om de details ervan weer te geven. Een bewerking wordt alleen gemarkeerd als Geslaagd als alle doelapparaten het uploaden van het logboek hebben voltooid. Als sommige doelapparaten zijn geslaagd en sommige niet, wordt de logboekbewerking gemarkeerd als Mislukt. U kunt de pagina met details van logboekbewerkingen gebruiken om te zien welke apparaten zijn geslaagd en welke niet.

8. In de details van de logboekbewerking kunt u de apparaatspecifieke status bekijken en het pad naar de logboeklocatie bekijken. Dit pad komt overeen met het pad van de virtuele map in uw Azure Blob Storage-account waar de diagnostische logboeken zijn geüpload.

Verzamelde diagnostische logboeken weergeven en exporteren

1. Zodra de logboekbewerking is voltooid, gaat u naar uw Azure Blob Storage-account.

2. Selecteer Containers in de sectie Gegevensopslag van het navigatiedeelvenster.

3. Selecteer de container met dezelfde naam als uw Device Update-exemplaar.

4. Gebruik het pad naar de logboeklocatie van de details van de logboekbewerking om naar de juiste map met de logboeken te navigeren. Standaard geeft de functie voor het verzamelen van externe logboeken aan doelapparaten de opdracht diagnostische logboeken te uploaden met behulp van het volgende directorypadmodel: Blob Storage-container/Doelapparaat-id/Logboekbewerkings-id/Logboeklogboekpad op het apparaat

5. Als u het diagnostische onderdeel van de DU-agent niet hebt gewijzigd, reageert het apparaat op elke logboekbewerking door twee logboekbestanden zonder opmaak te uploaden: het diagnostische logboek van de DU-agent ('aduc.log') en het diagnostische logboek van de DO-agent ('do-agent.log'). Meer informatie over welke logboekbestanden de DU-referentieagent verzamelt, vindt u op de conceptpagina Diagnostische gegevens voor apparaatupdates .

6. U kunt de inhoud van het logboekbestand weergeven door de bestandsnaam te selecteren, vervolgens het menu-element (beletselteken) te selecteren en op Weergeven/bewerken te klikken. U kunt het logboekbestand ook downloaden of verwijderen door de respectievelijk gelabelde opties te selecteren.

   

Volgende stappen

Zie Overzicht van diagnostische functies voor apparaatupdates voor meer informatie over de diagnostische mogelijkheden van Device Update