az iot central diagnostics

Odwołanie

Uwaga

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.30.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az iot central diagnostics . Dowiedz się więcej o rozszerzeniach.

Przeprowadź diagnostykę na poziomie aplikacji i urządzenia.

Polecenia

az iot central diagnostics monitor-events	Wyświetlanie komunikatów telemetrycznych urządzenia wysyłanych do aplikacji usługi IoT Central.
az iot central diagnostics monitor-properties	Wyświetlanie żądanych i zgłoszonych właściwości wysyłanych do/z aplikacji usługi IoT Central.
az iot central diagnostics registration-summary	Wyświetl podsumowanie rejestracji wszystkich urządzeń w aplikacji.
az iot central diagnostics validate-messages	Zweryfikuj komunikaty wysyłane do IoT Hub dla aplikacji usługi IoT Central.
az iot central diagnostics validate-properties	Zweryfikuj zgłoszone właściwości wysłane do aplikacji usługi IoT Central.

az iot central diagnostics monitor-events

Wyświetlanie komunikatów telemetrycznych urządzenia wysyłanych do aplikacji usługi IoT Central.

Pokazuje dane telemetryczne wysyłane do aplikacji usługi IoT Central. Domyślnie są wyświetlane wszystkie dane wysyłane przez wszystkie urządzenia. Użyj parametru --device-id, aby filtrować do określonego urządzenia.

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

Przykłady

Podstawowy sposób użycia

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

Podstawowe użycie podczas filtrowania na urządzeniu docelowym

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

Podstawowe użycie podczas filtrowania urządzeń docelowych z symbolem wieloznacznymi w identyfikatorze

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

Podstawowe użycie podczas filtrowania modułu.

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

Podstawowe użycie podczas filtrowania modułów docelowych z symbolem wieloznacznymi w identyfikatorze

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

Filtruj urządzenie i określ grupę odbiorców centrum zdarzeń, z która ma być powiązana.

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

Otrzymywanie adnotacji komunikatów (nagłówki komunikatów)

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

Odbieranie adnotacji komunikatów i właściwości systemu. Nigdy nie przekroczono limitu czasu.

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

Odbieranie wszystkich atrybutów komunikatów ze wszystkich komunikatów urządzenia

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

Odbieranie wszystkich komunikatów i analizowanie ładunku komunikatu w formacie JSON

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

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu Pomocy.

Parametry opcjonalne

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

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com

--cg --consumer-group -c

Określ grupę odbiorców, która ma być używana podczas nawiązywania połączenia z punktem końcowym centrum zdarzeń.

wartość domyślna: $Default

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

--enqueued-time --et -e

Wskazuje czas, który powinien być używany jako punkt wyjścia do odczytywania komunikatów z partycji. Jednostki są milisekundami od epoki unix. Jeśli nie zostanie wyświetlony komunikat "now", jest używany żaden czas.

--module-id -m

Identyfikator modułu IoT Edge, jeśli typ urządzenia jest IoT Edge.

--properties --props -p

Wskaż kluczowe właściwości komunikatu do danych wyjściowych. sys = właściwości systemu, aplikacja = właściwości aplikacji, adnotacja = adnotacje.

akceptowane wartości: all, anno, app, sys

--repair -r

Zainstaluj ponownie zależność uamqp zgodną z wersją rozszerzenia. Wartość domyślna: false.

akceptowane wartości: false, true

--timeout --to -t

Maksymalna liczba sekund w celu utrzymania połączenia bez odbierania komunikatu. Użyj 0 dla nieskończoności.

wartość domyślna: 300

--token

Jeśli wolisz przesłać żądanie bez uwierzytelniania w interfejsie wiersza polecenia platformy Azure, możesz określić prawidłowy token użytkownika w celu uwierzytelnienia żądania. Musisz określić typ klucza w ramach żądania. Dowiedz się więcej na stronie https://aka.ms/iotcentraldocsapi.

--yes -y

Pomiń monity użytkownika. Wskazuje akceptację instalacji zależności (jeśli jest to wymagane). Używane głównie w scenariuszach automatyzacji. Wartość domyślna: false.

akceptowane wartości: false, true

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.

az iot central diagnostics monitor-properties

Wyświetlanie żądanych i zgłoszonych właściwości wysyłanych do/z aplikacji usługi IoT Central.

Sonduje bliźniaczą reprezentację urządzenia z centrum i porównuje ją z ostatnimi właściwościami bliźniaczej reprezentacji urządzenia Analizuje właściwości z bliźniaczej reprezentacji urządzenia i wykrywa, czy wprowadzono zmiany podzestawu właściwości, które zostały zmienione w interwale sondowania.

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

Przykłady

Podstawowy sposób użycia

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

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu Pomocy.

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

Parametry opcjonalne

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

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com

--token

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.

az iot central diagnostics registration-summary

Wyświetl podsumowanie rejestracji wszystkich urządzeń w aplikacji.

Uwaga: zwrócenie tego polecenia może zająć dużo czasu, jeśli aplikacja zawiera wiele urządzeń.

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

Przykłady

Podsumowanie rejestracji

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

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu Pomocy.

Parametry opcjonalne

--api-version --av

Wersja interfejsu API dla żądanej operacji.

akceptowane wartości: 1.0, 1.1-preview, preview

wartość domyślna: 1.0

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

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com

--token

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.

az iot central diagnostics validate-messages

Zweryfikuj komunikaty wysyłane do IoT Hub dla aplikacji usługi IoT Central.

Przeprowadza walidację komunikatów telemetrycznych i zgłasza dane wsteczne, które nie są modelowane w szablonie urządzenia lub danych, w których typ danych nie jest zgodny z definicją w szablonie urządzenia.

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

Przykłady

Podstawowy sposób użycia

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

Błędy wyjściowe w miarę ich wykrywania

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

Podstawowe użycie podczas filtrowania na urządzeniu docelowym

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

Podstawowe użycie podczas filtrowania urządzeń docelowych z symbolem wieloznacznymi w identyfikatorze

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

Podstawowe użycie podczas filtrowania modułu.

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

Podstawowe użycie podczas filtrowania modułów docelowych z symbolem wieloznacznymi w identyfikatorze

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

Filtruj urządzenie i określ grupę odbiorców centrum zdarzeń, z która ma być powiązana.

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

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu Pomocy.

Parametry opcjonalne

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

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com

--cg --consumer-group -c

Określ grupę odbiorców, która ma być używana podczas nawiązywania połączenia z punktem końcowym centrum zdarzeń.

wartość domyślna: $Default

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

--dr --duration

Maksymalny czas trwania odbierania komunikatów z urządzenia docelowego przed zakończeniem połączenia. Użyj 0 dla nieskończoności.

wartość domyślna: 300

--enqueued-time --et -e

--max-messages --mm

Maksymalna liczba komunikatów odbieranych z urządzenia docelowego przed zakończeniem połączenia. Użyj 0 dla nieskończoności.

wartość domyślna: 10

--minimum-severity

Minimalna ważność problemu wymaganego do raportowania.

akceptowane wartości: error, info, warning

wartość domyślna: warning

--module-id -m

Identyfikator modułu IoT Edge, jeśli typ urządzenia jest IoT Edge.

--properties --props -p

Wskaż kluczowe właściwości komunikatu do danych wyjściowych. sys = właściwości systemu, aplikacja = właściwości aplikacji, adnotacja = adnotacje.

akceptowane wartości: all, anno, app, sys

--repair -r

Zainstaluj ponownie zależność uamqp zgodną z wersją rozszerzenia. Wartość domyślna: false.

akceptowane wartości: false, true

--style

Wskaż style danych wyjściowychcroll = dostarcza błędy podczas ich nadejścia, json = summarize results as json, csv = summarize results as csv.

akceptowane wartości: csv, json, scroll

wartość domyślna: scroll

--timeout --to -t

Maksymalna liczba sekund w celu utrzymania połączenia bez odbierania komunikatu. Użyj 0 dla nieskończoności.

wartość domyślna: 300

--token

--yes -y

Pomiń monity użytkownika. Wskazuje akceptację instalacji zależności (jeśli jest to wymagane). Używane głównie w scenariuszach automatyzacji. Wartość domyślna: false.

akceptowane wartości: false, true

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.

az iot central diagnostics validate-properties

Zweryfikuj zgłoszone właściwości wysłane do aplikacji usługi IoT Central.

Przeprowadza walidację zgłoszonych aktualizacji właściwości:

Ostrzeżenie — właściwości wysyłane przez urządzenie, które nie są modelowane w centrum.
Ostrzeżenie — właściwości o tej samej nazwie zadeklarowanej w wielu interfejsach powinny mieć nazwę interfejsu dołączona w ramach aktualizacji właściwości.

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

Przykłady

Podstawowy sposób użycia

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

Parametry wymagane

--app-id -n

Identyfikator aplikacji usługi IoT Central, którą chcesz zarządzać. Identyfikator aplikacji można znaleźć na stronie "Informacje" dla aplikacji w menu Pomocy.

--device-id -d

Identyfikator urządzenia docelowego. Identyfikator urządzenia można znaleźć, klikając przycisk Połącz na stronie Szczegóły urządzenia.

Parametry opcjonalne

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

Sufiks DNS usługi IoT Central skojarzony z aplikacją.

wartość domyślna: azureiotcentral.com

--minimum-severity

Minimalna ważność problemu wymaganego do raportowania.

akceptowane wartości: error, info, warning

wartość domyślna: warning

--token

Parametry globalne

--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykłady.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debug, aby uzyskać pełne dzienniki debugowania.