az iot central diagnostics

참고 항목

이 참조는 Azure CLI(버전 2.46.0 이상)에 대한 azure-iot 확장의 일부입니다. az iot central diagnostics 명령을 처음 실행할 때 확장이 자동으로 설치됩니다 . 확장 프로그램에 대해 자세히 알아보세요.

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

애플리케이션 및 디바이스 수준 진단을 수행합니다.

명령

Name	Description	형식	상태
az iot central diagnostics monitor-events	IoT Central 앱으로 전송된 디바이스 원격 분석 메시지를 봅니다.	내선 번호	프리뷰
az iot central diagnostics monitor-properties	IoT Central 앱에서 전송된 desired 및 reported 속성을 봅니다.	내선 번호	프리뷰
az iot central diagnostics registration-summary	앱의 모든 디바이스에 대한 등록 요약을 봅니다.	내선 번호	프리뷰
az iot central diagnostics validate-messages	IoT Central 앱에 대해 IoT Hub로 전송된 메시지의 유효성을 검사합니다.	내선 번호	프리뷰
az iot central diagnostics validate-properties	IoT Central 애플리케이션으로 전송된 reported 속성의 유효성을 검사합니다.	내선 번호	프리뷰

az iot central diagnostics monitor-events

미리 보기

명령 그룹 'IoT 중앙 진단'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Central 앱으로 전송된 디바이스 원격 분석 메시지를 봅니다.

IoT Central 애플리케이션으로 전송된 원격 분석 데이터를 표시합니다. 기본적으로 모든 디바이스에서 보낸 모든 데이터가 표시됩니다. --device-id 매개 변수를 사용하여 특정 디바이스로 필터링합니다.

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

예제

기본 사용법

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

대상 디바이스에서 필터링할 때 기본 사용

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

ID에서 와일드카드를 사용하여 대상 디바이스를 필터링할 때 기본 사용

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

모듈을 필터링할 때 기본 사용.

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

ID에서 와일드카드를 사용하여 대상 모듈을 필터링할 때 기본 사용

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

디바이스를 필터링하고 바인딩할 Event Hub 소비자 그룹을 지정합니다.

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

메시지 주석 수신(메시지 헤더)

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

메시지 주석 + 시스템 속성을 받습니다. 시간을 초과하지 마십시오.

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

모든 디바이스 메시지에서 모든 메시지 특성 받기

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

모든 메시지 수신 및 메시지 페이로드를 JSON으로 구문 분석

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

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

선택적 매개 변수

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

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--cg --consumer-group -c

이벤트 허브 엔드포인트에 연결할 때 사용할 소비자 그룹을 지정합니다.

Default value: $Default

--device-id -d

대상 디바이스의 디바이스 ID입니다. 디바이스 세부 정보 페이지에서 연결 단추를 클릭하여 디바이스 ID를 찾을 수 있습니다.

--enqueued-time --et -e

파티션에서 메시지를 읽기 위한 시작점으로 사용해야 하는 시간을 나타냅니다. 단위는 unix epoch 이후 밀리초입니다. 시간이 표시되지 않으면 "now"가 사용됩니다.

--module-id -m

디바이스 유형이 IoT Edge인 경우 IoT Edge 모듈 ID입니다.

--properties --props -p

출력할 키 메시지 속성을 나타냅니다. sys = 시스템 속성, app = application properties, anno = annotations.

허용되는 값: all, anno, app, sys

--repair -r

확장 버전과 호환되는 uamqp 종속성을 다시 설치합니다. 기본값: false입니다.

허용되는 값: false, true

Default value: False

--timeout --to -t

메시지를 받지 않고 연결을 유지하기 위한 최대 시간(초)입니다. 무한대에 0을 사용합니다.

Default value: 300

--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

--yes -y

사용자 프롬프트를 건너뜁니다. 작업 수락을 나타냅니다. 자동화 시나리오에 주로 사용됩니다. 기본값: false입니다.

허용되는 값: false, true

Default value: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central diagnostics monitor-properties

미리 보기

명령 그룹 'IoT 중앙 진단'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Central 앱에서 전송된 desired 및 reported 속성을 봅니다.

중앙에서 디바이스 쌍을 폴링하고 디바이스 쌍의 마지막 디바이스 쌍 구문 분석 속성과 비교하고, 폴링 간격 내에 변경된 속성의 Prints 하위 집합이 변경되었는지 감지합니다.

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

예제

기본 사용법

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

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--device-id -d

대상 디바이스의 디바이스 ID입니다. 디바이스 세부 정보 페이지에서 연결 단추를 클릭하여 디바이스 ID를 찾을 수 있습니다.

선택적 매개 변수

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

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central diagnostics registration-summary

미리 보기

명령 그룹 'IoT 중앙 진단'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

앱의 모든 디바이스에 대한 등록 요약을 봅니다.

참고: 이 명령은 앱에 많은 디바이스가 포함된 경우 반환하는 데 상당한 시간이 걸릴 수 있습니다.

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

예제

등록 요약

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

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

선택적 매개 변수

--api-version --av

사용되지 않음

'api_version' 인수는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다.

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31

Default value: 2022-07-31

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

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central diagnostics validate-messages

미리 보기

명령 그룹 'IoT 중앙 진단'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Central 앱에 대해 IoT Hub로 전송된 메시지의 유효성을 검사합니다.

원격 분석 메시지에 대한 유효성 검사를 수행하고 디바이스 템플릿에서 모델링되지 않은 데이터 또는 데이터 형식이 디바이스 템플릿에 정의된 데이터와 일치하지 않는 데이터를 다시 보고합니다.

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

예제

기본 사용법

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

검색된 출력 오류

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

대상 디바이스에서 필터링할 때 기본 사용

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

ID에서 와일드카드를 사용하여 대상 디바이스를 필터링할 때 기본 사용

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

모듈을 필터링할 때 기본 사용.

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

ID에서 와일드카드를 사용하여 대상 모듈을 필터링할 때 기본 사용

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

디바이스를 필터링하고 바인딩할 Event Hub 소비자 그룹을 지정합니다.

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

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

선택적 매개 변수

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

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--cg --consumer-group -c

이벤트 허브 엔드포인트에 연결할 때 사용할 소비자 그룹을 지정합니다.

Default value: $Default

--device-id -d

대상 디바이스의 디바이스 ID입니다. 디바이스 세부 정보 페이지에서 연결 단추를 클릭하여 디바이스 ID를 찾을 수 있습니다.

--dr --duration

연결을 종료하기 전에 대상 디바이스에서 메시지를 수신하는 최대 기간입니다. 무한대에 0을 사용합니다.

Default value: 300

--enqueued-time --et -e

파티션에서 메시지를 읽기 위한 시작점으로 사용해야 하는 시간을 나타냅니다. 단위는 unix epoch 이후 밀리초입니다. 시간이 표시되지 않으면 "now"가 사용됩니다.

--max-messages --mm

연결을 종료하기 전에 대상 디바이스에서 받을 최대 메시지 수입니다. 무한대에 0을 사용합니다.

Default value: 10

--minimum-severity

보고에 필요한 문제의 최소 심각도입니다.

허용되는 값: error, info, warning

Default value: warning

--module-id -m

디바이스 유형이 IoT Edge인 경우 IoT Edge 모듈 ID입니다.

--properties --props -p

출력할 키 메시지 속성을 나타냅니다. sys = 시스템 속성, app = application properties, anno = annotations.

허용되는 값: all, anno, app, sys

--repair -r

확장 버전과 호환되는 uamqp 종속성을 다시 설치합니다. 기본값: false입니다.

허용되는 값: false, true

Default value: False

--style

출력 stylescroll = 오류가 도착하면 오류를 전달함을 나타내고, json = 결과를 json으로 요약하고, csv = 결과를 csv로 요약합니다.

허용되는 값: csv, json, scroll

Default value: scroll

--timeout --to -t

메시지를 받지 않고 연결을 유지하기 위한 최대 시간(초)입니다. 무한대에 0을 사용합니다.

Default value: 300

--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

--yes -y

사용자 프롬프트를 건너뜁니다. 작업 수락을 나타냅니다. 자동화 시나리오에 주로 사용됩니다. 기본값: false입니다.

허용되는 값: false, true

Default value: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az iot central diagnostics validate-properties

미리 보기

명령 그룹 'IoT 중앙 진단'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

IoT Central 애플리케이션으로 전송된 reported 속성의 유효성을 검사합니다.

보고된 속성 업데이트에 대한 유효성 검사를 수행합니다.

1. 경고 - 중앙에서 모델링되지 않은 디바이스에서 보낸 속성입니다.
2. 경고 - 여러 인터페이스에서 선언된 이름이 같은 속성에는 속성 업데이트의 일부로 인터페이스 이름이 포함되어야 합니다.

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

예제

기본 사용법

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

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--device-id -d

대상 디바이스의 디바이스 ID입니다. 디바이스 세부 정보 페이지에서 연결 단추를 클릭하여 디바이스 ID를 찾을 수 있습니다.

선택적 매개 변수

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

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

Default value: azureiotcentral.com

--minimum-severity

보고에 필요한 문제의 최소 심각도입니다.

허용되는 값: error, info, warning

Default value: warning

--token

Azure CLI에 대해 인증하지 않고 요청을 제출하려는 경우 유효한 사용자 토큰을 지정하여 요청을 인증할 수 있습니다. 요청의 일부로 키 유형을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.