az iot central diagnostics

Megjegyzés

Ez a hivatkozás az Azure CLI Azure-iot bővítményének része (2.30.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az iot central diagnostics parancs első futtatásakor. További információ a bővítményekről.

Alkalmazás- és eszközszintű diagnosztikát végezhet.

Parancsok

az iot central diagnostics monitor-events	Az IoT Central-alkalmazásnak küldött eszköztelemetriaüzenetek megtekintése.
az iot central diagnostics monitor-properties	Megtekintheti az IoT Central alkalmazásba vagy onnan küldött kívánt és jelentett tulajdonságokat.
az iot central diagnostics registration-summary	Megtekintheti az alkalmazás összes eszközének regisztrációs összegzését.
az iot central diagnostics validate-messages	Ellenőrizze az IoT Central-alkalmazás IoT Hub küldött üzeneteit.
az iot central diagnostics validate-properties	Ellenőrizze az IoT Central-alkalmazásnak küldött jelentett tulajdonságokat.

az iot central diagnostics monitor-events

Az IoT Central-alkalmazásnak küldött eszköztelemetriaüzenetek megtekintése.

Az IoT Central-alkalmazásnak küldött telemetriai adatok megjelenítése. Alapértelmezés szerint az összes eszköz által küldött összes adatot megjeleníti. A --device-id paraméterrel szűrhet egy adott eszközre.

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éldák

Alapvető használat

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

Alapszintű használat a céleszközre való szűréskor

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

Alapszintű használat a megcélzott eszközök szűréséhez helyettesítő karakterrel az azonosítóban

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

Alapszintű használat a modul szűrésekor.

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

Alapszintű használat a megcélzott modulok szűréséhez helyettesítő karakterrel az azonosítóban

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

Szűrje az eszközt, és adjon meg egy eseményközpont fogyasztói csoportot, amelyhez kötést szeretne kötni.

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

Üzenetjegyzetek fogadása (üzenetfejlécek)

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

Üzenetjegyzetek és rendszertulajdonságok fogadása. Soha ne időtúllépés.

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

Az összes eszközüzenet összes üzenetattribútumának fogadása

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

Az összes üzenet fogadása és az üzenetek hasznos adatainak elemzése JSON-ként

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

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazásazonosítót az alkalmazás "Névjegy" lapján találja a súgómenüben.

Opcionális paraméterek

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

Az alkalmazáshoz társított IoT Central DNS-utótag.

alapértelmezett érték: azureiotcentral.com

--cg --consumer-group -c

Adja meg az eseményközpont-végponthoz való csatlakozáskor használni kívánt fogyasztói csoportot.

alapértelmezett érték: $Default

--device-id -d

A céleszköz eszközazonosítója. Az eszközazonosítót az Eszköz részletei lapon a Csatlakozás gombra kattintva találja meg.

--enqueued-time --et -e

Azt az időt jelzi, amelyet kiindulási pontként kell használni a partíciók üzeneteinek olvasásához. Az egységek unix korszak óta ezredmásodpercek. Ha nincs idő jelezve, a rendszer "most" értéket használ.

--module-id -m

A IoT Edge modul azonosítója, ha az eszköz típusa IoT Edge.

--properties --props -p

Adja meg a kimenethez a fő üzenettulajdonságokat. sys = rendszertulajdonságok, alkalmazás = alkalmazástulajdonságok, anno = széljegyzetek.

elfogadott értékek: all, anno, app, sys

--repair -r

Telepítse újra az uamqp függőséget, amely kompatibilis a bővítmény verziójával. Alapértelmezett érték: false (hamis).

elfogadott értékek: false, true

--timeout --to -t

Maximális másodperc a kapcsolat üzenet fogadása nélküli fenntartásához. A végtelenséghez használja a 0-t.

alapértelmezett érték: 300

--token

Ha az Azure CLI hitelesítése nélkül szeretné elküldeni a kérést, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérelem részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

--yes -y

Felhasználói kérések kihagyása. A függőség telepítésének elfogadását jelzi (ha szükséges). Elsősorban automatizálási forgatókönyvekhez használatos. Alapértelmezett érték: false (hamis).

elfogadott értékek: false, true

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central diagnostics monitor-properties

Megtekintheti az IoT Central alkalmazásba vagy onnan küldött kívánt és jelentett tulajdonságokat.

Lekérdezi az ikereszközt a központiról, és összehasonlítja az utolsó ikereszköz-ikerpéldány tulajdonságaival, és észleli, hogy történt-e módosítás, és megjeleníti a lekérdezési időközben módosított tulajdonságok részhalmazát.

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

Példák

Alapvető használat

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

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazásazonosítót az alkalmazás "Névjegy" lapján találja a súgómenüben.

--device-id -d

A céleszköz eszközazonosítója. Az eszközazonosítót az Eszköz részletei lapon a Csatlakozás gombra kattintva találja meg.

Opcionális paraméterek

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

Az alkalmazáshoz társított IoT Central DNS-utótag.

alapértelmezett érték: azureiotcentral.com

--token

Ha az Azure CLI hitelesítése nélkül szeretné elküldeni a kérést, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérelem részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central diagnostics registration-summary

Megtekintheti az alkalmazás összes eszközének regisztrációs összegzését.

Megjegyzés: Ez a parancs jelentős időt vehet igénybe, ha az alkalmazás sok eszközt tartalmaz.

az iot central diagnostics registration-summary --app-id
                                                [--api-version {1.0, 1.1-preview, 2022-05-31, preview}]
                                                [--central-api-uri]
                                                [--token]

Példák

Regisztráció összegzése

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

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazásazonosítót az alkalmazás "Névjegy" lapján találja a súgómenüben.

Opcionális paraméterek

--api-version --av

A kért művelet API-verziója.

elfogadott értékek: 1.0, 1.1-preview, 2022-05-31, preview

alapértelmezett érték: 2022-05-31

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

Az alkalmazáshoz társított IoT Central DNS-utótag.

alapértelmezett érték: azureiotcentral.com

--token

Ha az Azure CLI hitelesítése nélkül szeretné elküldeni a kérést, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérelem részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central diagnostics validate-messages

Ellenőrizze az IoT Central-alkalmazás IoT Hub küldött üzeneteit.

Érvényesíti a telemetriai üzeneteket, és az eszközsablonban nem modellezett adatokat, illetve azokat az adatokat küldi vissza, amelyek adattípusa nem egyezik meg az eszközsablonban definiált adatokkal.

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éldák

Alapvető használat

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

Kimeneti hibák észlelésekor

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

Alapszintű használat a céleszközre való szűréskor

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

Alapszintű használat a megcélzott eszközök szűréséhez helyettesítő karakterrel az azonosítóban

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

Alapszintű használat a modul szűrésekor.

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

Alapszintű használat a megcélzott modulok szűréséhez helyettesítő karakterrel az azonosítóban

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

Szűrje az eszközt, és adjon meg egy eseményközpont fogyasztói csoportot, amelyhez kötést szeretne kötni.

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

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazásazonosítót az alkalmazás "Névjegy" lapján találja a súgómenüben.

Opcionális paraméterek

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

Az alkalmazáshoz társított IoT Central DNS-utótag.

alapértelmezett érték: azureiotcentral.com

--cg --consumer-group -c

Adja meg az eseményközpont-végponthoz való csatlakozáskor használni kívánt fogyasztói csoportot.

alapértelmezett érték: $Default

--device-id -d

A céleszköz eszközazonosítója. Az eszközazonosítót az Eszköz részletei lapon a Csatlakozás gombra kattintva találja meg.

--dr --duration

A céleszközről érkező üzenetek fogadásának maximális időtartama a kapcsolat megszüntetése előtt. A végtelenséghez használja a 0-t.

alapértelmezett érték: 300

--enqueued-time --et -e

Azt az időt jelzi, amelyet kiindulási pontként kell használni a partíciók üzeneteinek olvasásához. Az egységek unix korszak óta ezredmásodpercek. Ha nincs idő jelezve, a rendszer "most" értéket használ.

--max-messages --mm

A céleszközről a kapcsolat megszüntetése előtt fogadandó üzenetek maximális száma. A végtelenséghez használja a 0-t.

alapértelmezett érték: 10

--minimum-severity

A jelentéskészítéshez szükséges probléma minimális súlyossága.

elfogadott értékek: error, info, warning

alapértelmezett érték: warning

--module-id -m

A IoT Edge modul azonosítója, ha az eszköz típusa IoT Edge.

--properties --props -p

Adja meg a kimenethez a fő üzenettulajdonságokat. sys = rendszertulajdonságok, alkalmazás = alkalmazástulajdonságok, anno = széljegyzetek.

elfogadott értékek: all, anno, app, sys

--repair -r

Telepítse újra az uamqp függőséget, amely kompatibilis a bővítmény verziójával. Alapértelmezett érték: false (hamis).

elfogadott értékek: false, true

--style

Adja meg a kimeneti stylescroll = kézbesítési hibákat a beérkezéskor, json = összegezze az eredményeket jsonként, csv = összegezze az eredményeket csv-ként.

elfogadott értékek: csv, json, scroll

alapértelmezett érték: scroll

--timeout --to -t

Maximális másodperc a kapcsolat üzenet fogadása nélküli fenntartásához. A végtelenséghez használja a 0-t.

alapértelmezett érték: 300

--token

Ha az Azure CLI hitelesítése nélkül szeretné elküldeni a kérést, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérelem részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

--yes -y

Felhasználói kérések kihagyása. A függőség telepítésének elfogadását jelzi (ha szükséges). Elsősorban automatizálási forgatókönyvekhez használatos. Alapértelmezett érték: false (hamis).

elfogadott értékek: false, true

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az iot central diagnostics validate-properties

Ellenőrizze az IoT Central-alkalmazásnak küldött jelentett tulajdonságokat.

Érvényesíti a jelentett tulajdonságfrissítéseket:

1. Figyelmeztetés – A nem központi modellezett eszköz által küldött tulajdonságok.
2. Figyelmeztetés – A több felületen deklarált azonos nevű tulajdonságoknak a tulajdonságfrissítés részeként tartalmazniuk kell a felület nevét.

az iot central diagnostics validate-properties --app-id
                                               --device-id
                                               [--central-api-uri]
                                               [--minimum-severity {error, info, warning}]
                                               [--token]

Példák

Alapvető használat

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

Kötelező paraméterek

--app-id -n

A kezelni kívánt IoT Central-alkalmazás alkalmazásazonosítója. Az alkalmazásazonosítót az alkalmazás "Névjegy" lapján találja a súgómenüben.

--device-id -d

A céleszköz eszközazonosítója. Az eszközazonosítót az Eszköz részletei lapon a Csatlakozás gombra kattintva találja meg.

Opcionális paraméterek

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

Az alkalmazáshoz társított IoT Central DNS-utótag.

alapértelmezett érték: azureiotcentral.com

--minimum-severity

A jelentéskészítéshez szükséges probléma minimális súlyossága.

elfogadott értékek: error, info, warning

alapértelmezett érték: warning

--token

Ha az Azure CLI hitelesítése nélkül szeretné elküldeni a kérést, megadhat egy érvényes felhasználói jogkivonatot a kérés hitelesítéséhez. A kérelem részeként meg kell adnia a kulcs típusát. További információ: https://aka.ms/iotcentraldocsapi.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.