Řešení potíží v případě nezobrazování dat ze zařízení v Azure IoT Central

Tento dokument vám pomůže zjistit, proč se data, která vaše zařízení odesílala IoT Central nemusí v aplikaci zobrazovat.

Existují dvě hlavní oblasti, které je dobré prozkoumat:

• Problémy s připojením zařízení
  • Problémy s ověřováním, jako je například, že zařízení má neplatné přihlašovací údaje
  • Problémy s připojením k síti
  • Zařízení není schválené nebo blokované
• Problémy s obrazcem datové části zařízení

Tento průvodce odstraňováním potíží se zaměřuje na problémy s připojením zařízení a problémy s tvarem datové části zařízení.

Problémy s připojením zařízení

Tato část vám pomůže určit, jestli vaše data IoT Central.

Pokud jste to ještě neudělali, nainstalujte az cli nástroj a azure-iot rozšíření.

Informace o tom, jak nainstalovat az cli , najdete v tématu Instalace Azure CLI.

Rozšíření nainstalujete azure-iot spuštěním následujícího příkazu:

az extension add --name azure-iot

Po instalaci rozšíření spusťte zařízení a podívejte se, jestli odesílané zprávy instalují svůj způsob, jak azure-iot IoT Central.

Pomocí následujících příkazů se přihlaste k předplatnému, ve kterém máte svou IoT Central aplikace:

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

Pokud chcete monitorovat telemetrii, která vaše zařízení odesílá, použijte následující příkaz:

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

Pokud se zařízení úspěšně připojilo k IoT Central, zobrazí se výstup podobný následujícímu:

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

Pokud chcete monitorovat aktualizace vlastností, které zařízení IoT Central, použijte následující příkaz Preview:

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

Pokud zařízení úspěšně odesílá aktualizace vlastností, zobrazí se výstup podobný následujícímu:

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

Pokud se v terminálu zobrazí data, přidají se až k vaší aplikaci IoT Central aplikace.

Pokud se po několika minutách nezobrazí žádná data, zkuste stisknout klávesu nebo na klávesnici pro případ, že se Enter return výstup zasekne.

Pokud se v terminálu stále nezobrazují žádná data, je pravděpodobné, že ve vašem zařízení dochází k problémům s připojením k síti nebo že data správně odesílá do IoT Central.

Kontrola stavu zřizování zařízení

Pokud se vaše data na monitoru nezobrazují, spuštěním následujícího příkazu zkontrolujte stav zřizování vašeho zařízení:

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

Následující výstup ukazuje příklad zařízení, které má zablokované připojení:

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

Přečtěte si další informace o stavových kódech zařízení.

Kódy chyb

Pokud stále nemůžete diagnostikovat, proč se vaše data nezobrazují v , je dalším krokem vyhledávání kódů chyb monitor-events hlášených vaším zařízením.

Spusťte na svém zařízení relaci ladění nebo shromáždíte protokoly ze zařízení. Zkontrolujte všechny kódy chyb, které zařízení hlásí.

V následujících tabulkách jsou uvedené běžné kódy chyb a možné akce, které je možné zmírnit.

Pokud dochází k problémům souvisejícím s tokem ověřování:

Podrobné kódy chyb autorizace

Kódy chyb nahrávání souborů

Tady je seznam běžných kódů chyb, které se můžou zobrazit, když se zařízení pokusí nahrát soubor do cloudu. Mějte na paměti, že než zařízení může nahrát soubor, musíte nakonfigurovat nahrání souborů zařízení ve vaší aplikaci.

Problémy s obrazcem datové části

Po ověření, že zařízení odesílá data do IoT Central, je dalším krokem zajistit, aby zařízení odesílala data v platném formátu.

Existují dvě hlavní kategorie běžných problémů, které způsobují, že se data zařízení nezobrazují v IoT Central:

• Neshoda mezi šablonou zařízení a daty zařízení:
  • Neshoda v pojmenování, jako jsou překlepy nebo problémy s porovnáváním malá a velká písmena.
  • Nemodelované vlastnosti, ve kterých není schéma definované v šabloně zařízení.
  • Neshoda schématu, například typ definovaný v šabloně jako boolean , ale data jsou řetězec.
  • Stejný název telemetrie je definovaný ve více rozhraních, ale zařízení IoT Plug and Play předpisy.
• Tvar dat je neplatný ve formátu JSON. Další informace najdete v tématu Datové části telemetrie, vlastnosti a příkazu.

Pokud chcete zjistit, ve kterých kategoriích se váš problém nachází, spusťte nejvhodnější příkaz pro váš scénář:

• Pokud chcete ověřit telemetrii, použijte příkaz preview:

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

• Pokud chcete ověřit aktualizace vlastností, použijte příkaz preview.

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

Při prvním spuštění příkazu se může zobrazit výzva k instalaci uamqp validate knihovny.

Následující výstup ukazuje příklad chybových a varovných zpráv z příkazu 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.

Pokud dáváte přednost použití grafického uživatelského rozhraní, IoT Central zobrazení nezpracovaných dat a podívejte se, jestli se něco nemodeluje. Zobrazení nezpracovaných dat nezjistí, jestli zařízení odesílá poškozený json.

Po zjištění problému možná budete muset aktualizovat firmware zařízení nebo vytvořit novou šablonu zařízení, která modeluje dříve nemodelovaná data.

Pokud jste se rozhodli vytvořit novou šablonu, která data správně modeluje, migrujte zařízení ze staré šablony do nové šablony. Další informace najdete v tématu Správa zařízení ve vaší Azure IoT Central aplikaci.

Další kroky

Pokud potřebujete další pomoc, můžete se obrátit na odborníky na Azure na webu MSDN Azure a na Stack Overflow fóra. Případně můžete vytvořit lístek podpora Azure .

Další informace najdete v tématu Podpora Azure IoT a možnosti nápovědy.