Sdílet prostřednictvím

az iot central diagnostics

  • Preview
  • Reference

Poznámka:

Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.46.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az iot central diagnostics . Přečtěte si další informace o rozšířeních.

Tato skupina příkazů je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Proveďte diagnostiku na úrovni aplikací a zařízení.

Příkazy

Name Description Typ Stav
az iot central diagnostics monitor-events

Umožňuje zobrazit zprávy telemetrie zařízení odeslané do aplikace IoT Central.

 Rozšíření Preview
az iot central diagnostics monitor-properties

Zobrazení požadovaných a ohlášených vlastností odeslaných do/z aplikace IoT Central

 Rozšíření Preview
az iot central diagnostics registration-summary

Zobrazte souhrn registrace všech zařízení v aplikaci.

 Rozšíření Preview
az iot central diagnostics validate-messages

Ověřte zprávy odeslané do IoT Hubu pro aplikaci IoT Central.

 Rozšíření Preview
az iot central diagnostics validate-properties

Ověřte ohlášené vlastnosti odeslané do aplikace IoT Central.

 Rozšíření Preview

az iot central diagnostics monitor-events

Preview

Skupina příkazů iot Central Diagnostics je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Umožňuje zobrazit zprávy telemetrie zařízení odeslané do aplikace IoT Central.

Zobrazuje telemetrická data odesílaná do aplikace IoT Central. Ve výchozím nastavení se zobrazují všechna data odesílaná všemi zařízeními. Pomocí parametru --device-id vyfiltrujte konkrétní zařízení.

az iot central diagnostics monitor-events --app-id
                                          [--central-api-uri]
                                          [--cg]
                                          [--device-id]
                                          [--enqueued-time]
                                          [--module-id]
                                          [--properties {all, anno, app, sys}]
                                          [--repair {false, true}]
                                          [--timeout]
                                          [--token]
                                          [--yes {false, true}]

Příklady

Základní použití

az iot central diagnostics monitor-events --app-id {app_id}

Základní použití při filtrování na cílovém zařízení

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id}

Základní použití při filtrování cílových zařízení se zástupným znakem v ID

az iot central diagnostics monitor-events --app-id {app_id} -d Device*d

Základní použití při filtrování podle modulu

az iot central diagnostics monitor-events --app-id {app_id} -m {module_id}

Základní použití při filtrování cílových modulů se zástupným znakem v ID

az iot central diagnostics monitor-events --app-id {app_id} -m Module*

Vyfiltrujte zařízení a zadejte skupinu příjemců centra událostí, ke které se má vytvořit vazba.

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --cg {consumer_group_name}

Příjem poznámek ke zprávám (záhlaví zpráv)

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --properties anno

Příjem poznámek zpráv + systémových vlastností Nikdy nevypadá časový limit.

az iot central diagnostics monitor-events --app-id {app_id} -d {device_id} --properties anno sys --timeout 0

Příjem všech atributů zpráv ze všech zpráv zařízení

az iot central diagnostics monitor-events --app-id {app_id} --props all

Příjem všech zpráv a analýza datové části zpráv jako JSON

az iot central diagnostics monitor-events --app-id {app_id} --output json

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

Volitelné parametry

--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

Default value: azureiotcentral.com
--cg --consumer-group -c

Zadejte skupinu příjemců, která se má použít při připojování ke koncovému bodu centra událostí.

Default value: $Default
--device-id -d

ID zařízení cílového zařízení. ID zařízení najdete kliknutím na tlačítko Připojit na stránce Podrobnosti o zařízení.

--enqueued-time --et -e

Označuje čas, který se má použít jako výchozí bod pro čtení zpráv z oddílů. Jednotky jsou milisekundy od epochy unixu. Pokud není čas označený jako "nyní".

--module-id -m

ID modulu IoT Edge, pokud je typ zařízení IoT Edge.

--properties --props -p

Označte vlastnosti klíčové zprávy k výstupu. sys = systémové vlastnosti, app = vlastnosti aplikace, anno = poznámky.

Přípustné hodnoty: all, anno, app, sys
--repair -r

Přeinstalujte závislost uamqp kompatibilní s verzí rozšíření. Výchozí hodnota: false.

Přípustné hodnoty: false, true
Default value: False
--timeout --to -t

Maximální počet sekund pro zachování připojení bez přijetí zprávy Použijte 0 pro nekonečno.

Default value: 300
--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

--yes -y

Přeskočte výzvy uživatele. Označuje přijetí akce. Používá se především pro scénáře automatizace. Výchozí hodnota: false.

Přípustné hodnoty: false, true
Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot central diagnostics monitor-properties

Preview

Skupina příkazů iot Central Diagnostics je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Zobrazení požadovaných a ohlášených vlastností odeslaných do/z aplikace IoT Central

Dotazuje dvojče zařízení z centrálního centra a porovnává ho s posledními dvojčaty zařízení parsuje vlastnosti z dvojčete zařízení a zjistí, jestli byly provedeny změny v podmnožině vlastností, které byly změněny v intervalu dotazování.

az iot central diagnostics monitor-properties --app-id
                                              --device-id
                                              [--central-api-uri]
                                              [--token]

Příklady

Základní použití

az iot central diagnostics monitor-properties --app-id {app_id} -d {device_id}

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

--device-id -d

ID zařízení cílového zařízení. ID zařízení najdete kliknutím na tlačítko Připojit na stránce Podrobnosti o zařízení.

Volitelné parametry

--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

Default value: azureiotcentral.com
--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot central diagnostics registration-summary

Preview

Skupina příkazů iot Central Diagnostics je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Zobrazte souhrn registrace všech zařízení v aplikaci.

Poznámka: Tento příkaz může trvat značné množství času, než se vrátí, pokud vaše aplikace obsahuje velké množství zařízení.

az iot central diagnostics registration-summary --app-id
                                                [--api-version {2022-06-30-preview, 2022-07-31}]
                                                [--central-api-uri]
                                                [--token]

Příklady

Souhrn registrace

az iot central diagnostics registration-summary --app-id {appid}

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

Volitelné parametry

--api-version --av
Zastaralé

Argument api_version je zastaralý a v budoucí verzi se odebere.

Tento parametr příkazu je zastaralý a bude ignorován. V budoucí verzi budeme podporovat pouze rozhraní API IoT Central z nejnovější verze GA. Pokud ještě některé rozhraní API není obecně dostupné, zavoláme nejnovější verzi Preview.

Přípustné hodnoty: 2022-06-30-preview, 2022-07-31
Default value: 2022-07-31
--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

Default value: azureiotcentral.com
--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot central diagnostics validate-messages

Preview

Skupina příkazů iot Central Diagnostics je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Ověřte zprávy odeslané do IoT Hubu pro aplikaci IoT Central.

Provádí ověření u zpráv telemetrie a hlásí zpět data, která nejsou modelována v šabloně zařízení nebo v datech, kde datový typ neodpovídá tomu, co je definováno v šabloně zařízení.

az iot central diagnostics validate-messages --app-id
                                             [--central-api-uri]
                                             [--cg]
                                             [--device-id]
                                             [--dr]
                                             [--enqueued-time]
                                             [--max-messages]
                                             [--minimum-severity {error, info, warning}]
                                             [--module-id]
                                             [--properties {all, anno, app, sys}]
                                             [--repair {false, true}]
                                             [--style {csv, json, scroll}]
                                             [--timeout]
                                             [--token]
                                             [--yes {false, true}]

Příklady

Základní použití

az iot central diagnostics validate-messages --app-id {app_id}

Chyby výstupu při jejich zjištění

az iot central diagnostics validate-messages --app-id {app_id} --style scroll

Základní použití při filtrování na cílovém zařízení

az iot central diagnostics validate-messages --app-id {app_id} -d {device_id}

Základní použití při filtrování cílových zařízení se zástupným znakem v ID

az iot central diagnostics validate-messages --app-id {app_id} -d Device*

Základní použití při filtrování podle modulu

az iot central diagnostics validate-messages --app-id {app_id} -m {module_id}

Základní použití při filtrování cílových modulů se zástupným znakem v ID

az iot central diagnostics validate-messages --app-id {app_id} -m Module*

Vyfiltrujte zařízení a zadejte skupinu příjemců centra událostí, ke které se má vytvořit vazba.

az iot central diagnostics validate-messages --app-id {app_id} -d {device_id} --cg {consumer_group_name}

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

Volitelné parametry

--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

Default value: azureiotcentral.com
--cg --consumer-group -c

Zadejte skupinu příjemců, která se má použít při připojování ke koncovému bodu centra událostí.

Default value: $Default
--device-id -d

ID zařízení cílového zařízení. ID zařízení najdete kliknutím na tlačítko Připojit na stránce Podrobnosti o zařízení.

--dr --duration

Maximální doba trvání příjmu zpráv z cílového zařízení před ukončením připojení. Použijte 0 pro nekonečno.

Default value: 300
--enqueued-time --et -e

Označuje čas, který se má použít jako výchozí bod pro čtení zpráv z oddílů. Jednotky jsou milisekundy od epochy unixu. Pokud není čas označený jako "nyní".

--max-messages --mm

Maximální počet zpráv, které se mají přijímat z cílového zařízení před ukončením připojení Použijte 0 pro nekonečno.

Default value: 10
--minimum-severity

Minimální závažnost problému vyžadovaná pro generování sestav.

Přípustné hodnoty: error, info, warning
Default value: warning
--module-id -m

ID modulu IoT Edge, pokud je typ zařízení IoT Edge.

--properties --props -p

Označte vlastnosti klíčové zprávy k výstupu. sys = systémové vlastnosti, app = vlastnosti aplikace, anno = poznámky.

Přípustné hodnoty: all, anno, app, sys
--repair -r

Přeinstalujte závislost uamqp kompatibilní s verzí rozšíření. Výchozí hodnota: false.

Přípustné hodnoty: false, true
Default value: False
--style

Označte výstupní stylycroll = doručovat chyby při jejich doručení, json = sumarizovat výsledky jako JSON, CSV = sumarizovat výsledky jako CSV.

Přípustné hodnoty: csv, json, scroll
Default value: scroll
--timeout --to -t

Maximální počet sekund pro zachování připojení bez přijetí zprávy Použijte 0 pro nekonečno.

Default value: 300
--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

--yes -y

Přeskočte výzvy uživatele. Označuje přijetí akce. Používá se především pro scénáře automatizace. Výchozí hodnota: false.

Přípustné hodnoty: false, true
Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az iot central diagnostics validate-properties

Preview

Skupina příkazů iot Central Diagnostics je ve verzi Preview a ve vývoji. Referenční úrovně a úrovně podpory: https://aka.ms/CLI_refstatus

Ověřte ohlášené vlastnosti odeslané do aplikace IoT Central.

Provádí ověření u ohlášených aktualizací vlastností:

  1. Upozornění – vlastnosti odesílané zařízením, které nejsou modelovány v centrálním umístění
  2. Upozornění – Vlastnosti se stejným názvem deklarovanými ve více rozhraních by měly mít název rozhraní zahrnutý jako součást aktualizace vlastnosti.
az iot central diagnostics validate-properties --app-id
                                               --device-id
                                               [--central-api-uri]
                                               [--minimum-severity {error, info, warning}]
                                               [--token]

Příklady

Základní použití

az iot central diagnostics validate-properties --app-id {app_id} -d {device_id}

Povinné parametry

--app-id -n

ID aplikace IoT Central, kterou chcete spravovat. ID aplikace najdete na stránce O aplikaci v nabídce nápovědy.

--device-id -d

ID zařízení cílového zařízení. ID zařízení najdete kliknutím na tlačítko Připojit na stránce Podrobnosti o zařízení.

Volitelné parametry

--central-api-uri --central-dns-suffix

Přípona DNS IoT Central přidružená k vaší aplikaci.

Default value: azureiotcentral.com
--minimum-severity

Minimální závažnost problému vyžadovaná pro generování sestav.

Přípustné hodnoty: error, info, warning
Default value: warning
--token

Pokud chcete žádost odeslat bez ověřování v Azure CLI, můžete zadat platný token uživatele pro ověření vaší žádosti. Jako součást požadavku musíte zadat typ klíče. Další informace najdete na adrese https://aka.ms/iotcentraldocsapi.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.