Probleem oplossen waarbij gegevens van uw apparaten niet worden weergegeven in Azure IoT Central

Dit document helpt u erachter te komen waarom de gegevens die uw apparaten verzenden naar IoT Central mogelijk niet worden weergegeven in de toepassing.

Er zijn twee belangrijke gebieden om te onderzoeken:

• Problemen met apparaatconnectiviteit
  • Verificatieproblemen, zoals het apparaat, hebben ongeldige referenties
  • Problemen met de netwerkverbinding
  • Apparaat is niet goedgekeurd of geblokkeerd
• Problemen met de vorm van de nettolading van het apparaat

Deze gids voor probleemoplossing richt zich op verbindingsproblemen met apparaten en problemen met de vorm van de nettolading van het apparaat.

Problemen met apparaatconnectiviteit

In deze sectie kunt u bepalen of uw gegevens IoT Central.

Als u dit nog niet hebt gedaan, installeert u het az cli hulpprogramma en de azure-iot extensie.

Zie Azure CLI installeren voor meer az cli informatie over het installeren vande .

Voer de volgende opdracht uit om de extensie te azure-iot installeren:

az extension add --name azure-iot

Wanneer u de extensie hebt geïnstalleerd, start u het apparaat om te zien of de berichten die worden verzonden, naar de azure-iot IoT Central.

Gebruik de volgende opdrachten om u aan te melden bij het abonnement waar u uw IoT Central hebt:

az login
az account set --subscription <your-subscription-id>

Gebruik de volgende opdracht om de telemetrie te bewaken die door uw apparaat wordt verzonden:

az iot central diagnostics monitor-events --app-id <app-id> --device-id <device-name>

Als het apparaat is verbonden met IoT Central, ziet u uitvoer die er ongeveer als volgt uit ziet:

Monitoring telemetry.
Filtering on device: device-001
{
    "event": {
        "origin": "device-001",
        "module": "",
        "interface": "",
        "component": "",
        "payload": {
            "temp": 65.57910343679293,
            "humid": 36.16224660107426
        }
    }
}

Gebruik de volgende preview-opdracht om de updates van eigenschappen te controleren IoT Central apparaat wordt uitgewisseld:

az iot central diagnostics monitor-properties --app-id <app-id> --device-id <device-name>

Als het apparaat updates van eigenschappen verzendt, ziet u uitvoer die er ongeveer als volgt uit ziet:

Changes in reported properties:
version : 32
{'state': 'true', 'name': {'value': {'value': 'Contoso'}, 'status': 'completed', 'desiredVersion': 7, 'ad': 'completed', 'av': 7, 'ac
': 200}, 'brightness': {'value': {'value': 2}, 'status': 'completed', 'desiredVersion': 7, 'ad': 'completed', 'av': 7, 'ac': 200}, 'p
rocessorArchitecture': 'ARM', 'swVersion': '1.0.0'}

Als er gegevens worden weergegeven in uw terminal, komen de gegevens tot aan de IoT Central toepassing.

Als er na een paar minuten geen gegevens worden weergegeven, drukt u op de toets of op het toetsenbord, voor het geval Enter return de uitvoer vastloopt.

Als er nog steeds geen gegevens worden weergegeven op de terminal, heeft uw apparaat waarschijnlijk problemen met de netwerkverbinding of worden er geen gegevens correct verzonden naar IoT Central.

De inrichtingsstatus van uw apparaat controleren

Als uw gegevens niet worden weergegeven op de monitor, controleert u de inrichtingsstatus van uw apparaat door de volgende opdracht uit te voeren:

az iot central device registration-info --app-id <app-id> --device-id <device-name>

In de volgende uitvoer ziet u een voorbeeld van een apparaat dat geen verbinding kan maken:

{
  "@device_id": "v22upeoqx6",
  "device_registration_info": {
    "device_status": "blocked",
    "display_name": "Environmental Sensor - v22upeoqx6",
    "id": "v22upeoqx6",
    "instance_of": "urn:krhsi_k0u:modelDefinition:w53jukkazs",
    "simulated": false
  },
  "dps_state": {
    "error": "Device is blocked from connecting to IoT Central application. Unblock the device in IoT Central and retry. Learn more:
https://aka.ms/iotcentral-docs-dps-SAS",
    "status": null
  }
}

Meer informatie over apparaatstatuscodes.

Foutcodes

Als u nog steeds niet kunt vaststellen waarom uw gegevens niet worden weergegeven in , is de volgende stap het zoeken naar foutcodes die door uw monitor-events apparaat zijn gerapporteerd.

Start een debugging-sessie op uw apparaat of verzamel logboeken van uw apparaat. Controleer op foutcodes die het apparaat rapporteert.

In de volgende tabellen worden de algemene foutcodes en mogelijke acties weergegeven die kunnen worden beperkt.

Als u problemen ziet met betrekking tot uw verificatiestroom:

Gedetailleerde autorisatiefoutcodes

Foutcodes voor bestand uploaden

Hier ziet u een lijst met veelvoorkomende foutcodes die u kunt zien wanneer een apparaat probeert een bestand naar de cloud te uploaden. Houd er rekening mee dat u uploads van apparaatbestand in uw toepassing moet configureren voordat uw apparaat een bestand kan uploaden.

Problemen met de vorm van de nettolading

Wanneer u hebt vastgesteld dat uw apparaat gegevens naar IoT Central, is de volgende stap ervoor te zorgen dat uw apparaat gegevens in een geldige indeling verstuurt.

Er zijn twee hoofdcategorieën met veelvoorkomende problemen die ertoe leiden dat apparaatgegevens niet worden weergegeven in IoT Central:

• Apparaatsjabloon voor niet-overeenkomende apparaatgegevens:
  • Komt niet overeen in naamgeving, zoals typfouten of problemen die overeenkomen met case's.
  • Niet-gemodelleerde eigenschappen waarbij het schema niet is gedefinieerd in de apparaatsjabloon.
  • Schema komt niet overeen, zoals een type dat in de sjabloon is gedefinieerd als boolean , maar de gegevens zijn een tekenreeks.
  • Dezelfde telemetrienaam wordt gedefinieerd in meerdere interfaces, maar het apparaat is niet compatibel Plug en Play IoT.
• Gegevensvorm is ongeldige JSON. Zie Nettoladingen voor telemetrie, eigenschappen enopdrachten voor meer informatie.

Als u wilt detecteren in welke categorieën uw probleem zich voordeed, moet u de meest geschikte opdracht uitvoeren voor uw scenario:

• Gebruik de preview-opdracht om telemetrie te valideren:

  az iot central diagnostics validate-messages --app-id <app-id> --device-id <device-name>
  

• Als u updates van eigenschappen wilt valideren, gebruikt u de preview-opdracht

  az iot central diagnostics validate-properties --app-id <app-id> --device-id <device-name>
  

U wordt mogelijk gevraagd de bibliotheek te installeren wanneer u de uamqp eerste keer een opdracht uit te validate voeren.

In de volgende uitvoer ziet u voorbeeldfout- en waarschuwingsberichten van de validatieopdracht:

Validating telemetry.
Filtering on device: v22upeoqx6.
Exiting after 300 second(s), or 10 message(s) have been parsed (whichever happens first).
[WARNING] [DeviceId: v22upeoqx6] No encoding found. Expected encoding 'utf-8' to be present in message header.

[WARNING] [DeviceId: v22upeoqx6] Content type '' is not supported. Expected Content type is 'application/json'.

[ERROR] [DeviceId: v22upeoqx6] [TemplateId: urn:krhsi_k0u:modelDefinition:w53jukkazs] Datatype of field 'humid' does not match the da
tatype 'double'. Data '56'. All dates/times/datetimes/durations must be ISO 8601 compliant.

Als u liever een GUI gebruikt, gebruikt u de IoT Central onbewerkte gegevensweergave om te zien of er iets niet wordt gemodelleerd. In de weergave Onbewerkte gegevens wordt niet gedetecteerd of het apparaat een verkeerd vorm van JSON verstuurt.

Wanneer u het probleem hebt gedetecteerd, moet u mogelijk apparaatfirmware bijwerken of een nieuwe apparaatsjabloon maken die eerder niet-gemodelleerde gegevens modelleerde.

Als u ervoor hebt gekozen om een nieuwe sjabloon te maken die de gegevens correct modeleert, migreert u apparaten van uw oude sjabloon naar de nieuwe sjabloon. Zie Apparaten beheren in uw Azure IoT Central toepassing voor meer informatie.

Volgende stappen

Als u meer hulp nodig hebt, kunt u contact opnemen met de Azure-experts op de MSDN Azure-en Stack Overflow forums . U kunt ook een ticket indienen ondersteuning voor Azure indienen.

Zie Ondersteunings- en helpopties voor Azure IoT voor meer informatie.