az iot central diagnostics
참고
이 참조는 Azure CLI 대한 azure-iot 확장의 일부이며 버전 2.17.1 이상이 필요합니다. az iot central diagnostics 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.
애플리케이션 및 디바이스 수준 진단을 수행합니다.
명령
| 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 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*
디바이스를 필터링하고 바인딩할 이벤트 허브 소비자 그룹을 지정합니다.
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
필수 매개 변수
관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.
선택적 매개 변수
애플리케이션과 연결된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com.
이벤트 허브 엔드포인트에 연결할 때 사용할 소비자 그룹을 지정합니다.
대상 디바이스의 ID인 디바이스 세부 정보 페이지에서 커넥트 단추를 클릭하여 디바이스 ID를 찾을 수 있습니다.
파티션에서 메시지를 읽기 위한 시작점으로 사용해야 하는 시간을 나타냅니다. 단위는 unix epoch 이후 밀리초입니다. 시간이 표시되지 않으면 "now"가 사용됩니다.
디바이스 유형이 IoT Edge 경우 IoT Edge 모듈 ID를 제공합니다.
출력할 키 메시지 속성을 나타냅니다. sys = 시스템 속성, app = 애플리케이션 속성, anno = 주석
확장 버전과 호환되는 uamqp 종속성을 다시 설치합니다. 기본값: false입니다.
메시지를 받지 않고 연결을 유지하는 최대 시간(초)입니다. 무한대로 0을 사용합니다.
Azure CLI 대해 인증하지 않고 요청을 제출하려는 경우 요청을 인증할 유효한 사용자 토큰을 지정할 수 있습니다. 요청의 일부로 키 형식을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
사용자 프롬프트를 건너뜁니다. 종속성 설치에 대한 동의를 나타냅니다(필요한 경우). 주로 자동화 시나리오에 사용됩니다. 기본값: false입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot central diagnostics monitor-properties
IoT Central 앱에서 전송된 desired 및 reported 속성을 봅니다.
중앙에서 디바이스 쌍을 폴링하고 마지막 디바이스 쌍과 비교하여 device-twin에서 속성을 구문 분석하고 변경 내용이 변경되었는지 감지하고 폴링 간격 내에 변경된 속성의 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}
필수 매개 변수
관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.
대상 디바이스의 ID인 디바이스 세부 정보 페이지에서 커넥트 단추를 클릭하여 디바이스 ID를 찾을 수 있습니다.
선택적 매개 변수
애플리케이션과 연결된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com.
Azure CLI 대해 인증하지 않고 요청을 제출하려는 경우 요청을 인증할 유효한 사용자 토큰을 지정할 수 있습니다. 요청의 일부로 키 형식을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot central diagnostics registration-summary
앱의 모든 디바이스에 대한 등록 요약을 봅니다.
참고: 이 명령은 앱에 많은 디바이스가 포함된 경우 반환하는 데 상당한 시간이 걸릴 수 있습니다.
az iot central diagnostics registration-summary --app-id
[--central-api-uri]
[--token]
예제
등록 요약
az iot central diagnostics registration-summary --app-id {appid}
필수 매개 변수
관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.
선택적 매개 변수
애플리케이션과 연결된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com.
Azure CLI 대해 인증하지 않고 요청을 제출하려는 경우 요청을 인증할 유효한 사용자 토큰을 지정할 수 있습니다. 요청의 일부로 키 형식을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot central diagnostics validate-messages
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*
디바이스를 필터링하고 바인딩할 이벤트 허브 소비자 그룹을 지정합니다.
az iot central diagnostics validate-messages --app-id {app_id} -d {device_id} --cg {consumer_group_name}
필수 매개 변수
관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.
선택적 매개 변수
애플리케이션과 연결된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com.
이벤트 허브 엔드포인트에 연결할 때 사용할 소비자 그룹을 지정합니다.
대상 디바이스의 ID인 디바이스 세부 정보 페이지에서 커넥트 단추를 클릭하여 디바이스 ID를 찾을 수 있습니다.
연결을 종료하기 전에 대상 디바이스에서 메시지를 받는 최대 기간입니다. 무한대로 0을 사용합니다.
파티션에서 메시지를 읽기 위한 시작점으로 사용해야 하는 시간을 나타냅니다. 단위는 unix epoch 이후 밀리초입니다. 시간이 표시되지 않으면 "now"가 사용됩니다.
연결을 종료하기 전에 대상 디바이스에서 받을 최대 메시지 수입니다. 무한대로 0을 사용합니다.
보고에 필요한 문제의 최소 심각도입니다.
디바이스 유형이 IoT Edge 경우 IoT Edge 모듈 ID를 제공합니다.
출력할 키 메시지 속성을 나타냅니다. sys = 시스템 속성, app = 애플리케이션 속성, anno = 주석
확장 버전과 호환되는 uamqp 종속성을 다시 설치합니다. 기본값: false입니다.
출력 스타일 표시croll = 오류가 도착하면 오류를 전달합니다. json = 결과를 json으로 요약, csv = 결과를 csv로 요약합니다.
메시지를 받지 않고 연결을 유지하는 최대 시간(초)입니다. 무한대로 0을 사용합니다.
Azure CLI 대해 인증하지 않고 요청을 제출하려는 경우 요청을 인증할 유효한 사용자 토큰을 지정할 수 있습니다. 요청의 일부로 키 형식을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
사용자 프롬프트를 건너뜁니다. 종속성 설치에 대한 동의를 나타냅니다(필요한 경우). 주로 자동화 시나리오에 사용됩니다. 기본값: false입니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az iot central diagnostics validate-properties
IoT Central 애플리케이션으로 전송된 reported 속성의 유효성을 검사합니다.
보고된 속성 업데이트에 대한 유효성 검사를 수행합니다.
- 경고 - 중앙에서 모델링되지 않은 디바이스에서 보낸 속성입니다.
- 경고 - 여러 인터페이스에서 선언된 동일한 이름의 속성에는 속성 업데이트의 일부로 포함된 인터페이스 이름이 있어야 합니다.
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}
필수 매개 변수
관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.
대상 디바이스의 ID인 디바이스 세부 정보 페이지에서 커넥트 단추를 클릭하여 디바이스 ID를 찾을 수 있습니다.
선택적 매개 변수
애플리케이션과 연결된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com.
보고에 필요한 문제의 최소 심각도입니다.
Azure CLI 대해 인증하지 않고 요청을 제출하려는 경우 요청을 인증할 유효한 사용자 토큰을 지정할 수 있습니다. 요청의 일부로 키 형식을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.