Felsök varför data från dina enheter inte visas i Azure IoT Central

Det här dokumentet hjälper dig att ta reda på varför de data som dina enheter skickar till IoT Central kanske inte visas i programmet.

Det finns två huvudområden att undersöka:

• Problem med enhetsanslutning
  • Autentiseringsproblem som att enheten har ogiltiga autentiseringsuppgifter
  • Problem med nätverksanslutning
  • Enheten är inte godkänd eller blockerad
• Problem med nyttolastform för enhet

Den här felsökningsguiden fokuserar på problem med enhetsanslutningar och problem med enhetens nyttolastform.

Problem med enhetsanslutning

Det här avsnittet hjälper dig att avgöra om dina data når IoT Central.

Installera verktyget och tillägget om du inte redan az cli har azure-iot gjort det.

Information om hur du installerar az cli finns i Installera Azure CLI.

Kör följande kommando azure-iot för att installera tillägget:

az extension add --name azure-iot

När du har installerat tillägget startar du enheten för att se om de meddelanden som den skickar kommer azure-iot IoT Central.

Använd följande kommandon för att logga in på prenumerationen där du har IoT Central program:

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

Använd följande kommando för att övervaka telemetrin som enheten skickar:

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

Om enheten har anslutits till IoT Central visas utdata som liknar följande:

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

Om du vill övervaka egenskapsuppdateringar som din enhet utbyter IoT Central använder du följande förhandsgranskningskommando:

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

Om enheten skickar egenskapsuppdateringar visas utdata som liknar följande:

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'}

Om du ser data i terminalen kommer data att ta sig så långt som IoT Central program.

Om inga data visas efter några minuter kan du försöka trycka på tangenten eller på tangentbordet Enter om utdatan return har fastnat.

Om du fortfarande inte ser några data i terminalen är det troligt att enheten har problem med nätverksanslutningen eller inte skickar data korrekt till IoT Central.

Kontrollera enhetens etableringsstatus

Om dina data inte visas på övervakaren kontrollerar du enhetens etableringsstatus genom att köra följande kommando:

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

Följande utdata visar ett exempel på en enhet som har blockerats från att ansluta:

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

Läs mer om enhetsstatuskoder.

Felkoder

Om du fortfarande inte kan diagnostisera varför dina data inte visas i är nästa steg att söka efter felkoder som rapporteras monitor-events av enheten.

Starta en felsökningssession på enheten eller samla in loggar från enheten. Sök efter eventuella felkoder som enheten rapporterar.

I följande tabeller visas vanliga felkoder och möjliga åtgärder att åtgärda.

Om du får problem som rör ditt autentiseringsflöde:

Detaljerade felkoder för auktorisering

Felkoder för filuppladdning

Här är en lista över vanliga felkoder som kan visas när en enhet försöker ladda upp en fil till molnet. Kom ihåg att innan enheten kan ladda upp en fil måste du konfigurera enhetsfiluppladdningar i ditt program.

Problem med nyttolastform

När du har fastställt att enheten skickar data till IoT Central är nästa steg att se till att enheten skickar data i ett giltigt format.

Det finns två huvudkategorier av vanliga problem som gör att enhetsdata inte visas i IoT Central:

• Enhetsmall till enhetsdatamatchningsfel:
  • Matchningsfel i namngivning, till exempel stavfel eller problem med fallmatchning.
  • Ej inbyggda egenskaper där schemat inte har definierats i enhetsmallen.
  • Schemamatchningsfel, till exempel en typ som definierats i boolean mallen som , men data är en sträng.
  • Samma telemetrinamn definieras i flera gränssnitt, men enheten är inte IoT-Plug and Play kompatibel.
• Dataformen är ogiltig JSON. Mer information finns i Telemetri, egenskap och nyttolaster för kommandon.

Kör det lämpligaste kommandot för ditt scenario för att identifiera vilka kategorier problemet finns i:

• Verifiera telemetrin med hjälp av förhandsgranskningskommandot:

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

• Verifiera egenskapsuppdateringar med hjälp av förhandsgranskningskommandot

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

Du kan uppmanas att installera biblioteket uamqp första gången du kör ett validate kommando.

Följande utdata visar exempel på fel- och varningsmeddelanden från kommandot validate:

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.

Om du föredrar att använda ett grafiskt användargränssnitt använder du IoT Central raw-datavyn för att se om något inte modelleras. Vyn Rådata identifierar inte om enheten skickar felaktig JSON.

När du har identifierat problemet kan du behöva uppdatera enhetens inbyggda programvara eller skapa en ny enhetsmall som modellerar tidigare omoderade data.

Om du väljer att skapa en ny mall som modellerar data korrekt migrerar du enheter från din gamla mall till den nya mallen. Mer information finns i Hantera enheter i ditt Azure IoT Central program.

Nästa steg

Om du behöver mer hjälp kan du kontakta Azure-experter på MSDN Azureoch Stack Overflow forumen . Du kan också skapa en Azure-supportbiljett.

Mer information finns i Support- och hjälpalternativ för Azure IoT.