Azure IoT Hub 데이터 참조 모니터링

아티클
06/01/2023

Azure 모니터링을 시작하려면 Azure IoT Hub 모니터링을 참조하여 Azure IoT Hub에 대한 모니터링 데이터를 수집하고 분석하는 방법을 이해합니다.

이 문서는 Azure 모니터링을 구현하기 위한 참고 자료입니다.

이 참조 문서의 주요 섹션은 다음과 같습니다.

메트릭: 항목별 IoT Hub 플랫폼 메트릭 목록
메트릭 차원: 라우팅 및 Event Grid 메트릭에 대한 차원
리소스 로그: 범주 유형별 로그 및 Azure IoT Hub를 위해 수집된 스키마
Azure Monitor 로그 테이블: Azure Monitor 로그 Kusto 테이블에 대해 설명합니다.

또는 Azure Monitor 로그 테이블 참조로 직접 이동합니다.

메트릭

이 섹션은 Azure IoT Hub에 대한 모든 자동 수집 플랫폼 메트릭을 나열합니다. IoT Hub 메트릭에 대한 리소스 공급자 네임스페이스는 Microsoft.Devices이며 형식 네임스페이스는 IoTHubs입니다.

다음 하위 섹션에서는 IoT Hub 플랫폼 메트릭을 일반 범주별로 표시하고 Azure Portal에서 할당된 대로 표시 이름으로 메트릭을 나열합니다.

Azure Monitor 설명서의 Microsoft. Devices/IotHubs에서 메트릭 이름별로 모든 IoT Hub 플랫폼 메트릭을 나열하는 단일 테이블도 찾을 수 있습니다. 이 표는 이 문서에서 확인할 수 있는 일부 메트릭에 대해 지원되는 집계와 같은 모든 정보를 제공하지는 않습니다.

다른 Azure 서비스에서 지원하는 메트릭에 대한 자세한 정보는 Azure Monitor에서 지원되는 메트릭을 참조하세요.

이 섹션의 토픽

이 페이지의 정보로 이동할 토픽을 선택합니다.

지원되는 집계
클라우드-디바이스 명령 메트릭
클라우드-디바이스 직접 메서드 메트릭
클라우드-디바이스 쌍 작업 메트릭
구성 메트릭
일일 할당량 메트릭
디바이스 메트릭
디바이스 원격 분석 메트릭
디바이스-클라우드 쌍 작업 메트릭
Event Grid 메트릭
작업 메트릭
라우팅 메트릭
쌍 쿼리 메트릭

지원되는 집계

각 테이블의 집계 유형 열은 차트 또는 경고 메트릭을 선택할 때 사용되는 기본 집계에 해당합니다.

메트릭에 대한 집계를 보여 주는 스크린샷

모든 집계 형식이 대부분의 메트릭에 유효합니다. 그러나 단위 열 값이 개수인 개수 메트릭의 경우 일부 집계만 유효합니다. 개수 메트릭은 다음 두 가지 유형 중 하나일 수 있습니다.

단일 지점 개수 메트릭의 경우 측정된 작업이 발생될 때마다 IoT Hub가 단일 데이터 요소(기본적으로 1)를 등록합니다. 그다음 Azure Monitor가 지정된 세분성에 대한 데이터 포인트의 합계를 계산합니다. 단일 지점 메트릭의 예는 전송된 원격 분석 메시지 및 배달 완료된 C2D 메시지입니다. 해당 메트릭의 경우 관련된 유일한 집계 유형은 합계(Sum)입니다. 포털에서 최소, 최대 및 평균을 선택할 수 있습니다. 그러나 해당 값은 항상 1입니다.
스냅샷 개수 메트릭의 경우, 측정된 작업이 발생할 때 IoT Hub가 총 개수를 등록합니다. 현재 IoT Hub에서 내보내는 스냅샷메트릭에는 사용되는 총 메시지 수, 총 디바이스, 연결된 디바이스의 세 가지가 있습니다. 해당 메트릭은 내보낼 때마다 “합계” 수량을 제공하므로 지정된 세분성에 대해 합계를 합산하는 것은 의미가 없습니다. Azure Monitor는 해당 메트릭의 집계 유형에 대한 평균, 최솟값, 최댓값을 선택하는 것을 제한합니다.

클라우드-디바이스 명령 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
만료된 C2D 메시지	C2DMessagesExpired	개수	합계	만료된 클라우드-디바이스 메시지 수	없음
C2D 메시지 배달 완료	c2d.commands.egress.complete.success	개수	합계	디바이스에서 성공적으로 배달 완료한 클라우드-디바이스 메시지 수	없음
중단된 C2D 메시지	c2d.commands.egress.abandon.success	개수	합계	디바이스에서 중단한 클라우드-디바이스 메시지 수	없음
거부된 C2D 메시지	c2d.commands.egress.reject.success	개수	합계	디바이스에서 거부한 클라우드-디바이스 메시지 수	없음

단위 값이 개수인 메트릭의 경우 합계(sum) 집계만 유효합니다. 최솟값, 최댓값, 평균 집계는 항상 1을 반환합니다. 자세한 내용은 지원되는 집계를 참조하세요.

클라우드-디바이스 직접 메서드 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
실패한 직접 메서드 호출	c2d.methods.failure	개수	합계	실패한 모든 직접 메서드 호출의 수입니다.	없음
직접 메서드 호출의 요청 크기	c2d.methods.requestSize	바이트	평균	성공한 모든 직접 메서드 요청의 수입니다.	없음
직접 메서드 호출의 응답 크기	c2d.methods.responseSize	바이트	평균	성공한 모든 직접 메서드 응답의 수입니다.	없음
성공한 직접 메서드 호출	c2d.methods.success	개수	합계	성공한 모든 직접 메서드 호출의 수입니다.	없음

단위 값이 개수인 메트릭에 대해서만 합계(sum) 집계가 유효합니다. 최솟값, 최댓값, 평균 집계는 항상 1을 반환합니다. 자세한 내용은 지원되는 집계를 참조하세요.

클라우드-디바이스 쌍 작업 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
백 엔드에서의 실패한 쌍 읽기	c2d.twin.read.failure	개수	합계	실패한 모든 백 엔드 시작 쌍 읽기 수입니다.	없음
백 엔드에서의 실패한 쌍 업데이트	c2d.twin.update.failure	개수	합계	실패한 모든 백 엔드 시작 쌍 업데이트 수입니다.	없음
백 엔드에서의 쌍 읽기 응답 크기	c2d.twin.read.size	바이트	평균	성공한 모든 백 엔드 시작 쌍 읽기 수입니다.	없음
백 엔드에서의 쌍 업데이트 크기	c2d.twin.update.size	바이트	평균	성공한 모든 백 엔드 시작 쌍 업데이트의 총 크기입니다.	없음
백 엔드에서의 성공한 쌍 읽기	c2d.twin.read.success	개수	합계	성공한 모든 백 엔드 시작 쌍 읽기 수입니다.	없음
백 엔드에서의 성공한 쌍 업데이트	c2d.twin.update.success	개수	합계	성공한 모든 백 엔드 시작 쌍 업데이트 수입니다.	없음

구성 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
구성 메트릭	구성	개수	합계	대상 디바이스 집합에서 디바이스 구성 및 IoT Edge 배포에 대해 수행된 총 CRUD 작업 수입니다. 이러한 구성으로 인해 디바이스 쌍 또는 모듈 쌍을 수정하는 작업의 수가 포함됩니다.	없음

일일 할당량 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
총 디바이스 데이터 사용량	deviceDataUsage	바이트	합계	IotHub에 연결된 모든 디바이스에서 전송된 바이트	없음
총 디바이스 데이터 사용량(미리 보기)	deviceDataUsageV2	바이트	합계	IotHub에 연결된 모든 디바이스에서 전송된 바이트	없음
사용된 전체 메시지 수	dailyMessageQuotaUsed	개수	평균	오늘 사용된 전체 메시지 수입니다. 매일 00:00 UTC에 0으로 다시 설정되는 누적 값입니다.	없음

사용된 총 메시지 수에 대해 최소, 최대, 평균 집계만 지원됩니다. 자세한 내용은 지원되는 집계를 참조하세요.

디바이스 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
총 디바이스(사용되지 않음)	devices.totalDevices	개수	합계	IoT 허브에 등록된 디바이스 수	없음
연결된 디바이스(사용되지 않음)	devices.connectedDevices.allProtocol	개수	합계	IoT 허브에 연결된 디바이스 수	없음
총 디바이스	totalDeviceCount	개수	평균	IoT 허브에 등록된 디바이스 수	없음
연결된 디바이스	connectedDeviceCount	개수	평균	IoT 허브에 연결된 디바이스 수	없음

총 디바이스(사용되지 않음) 및 연결된 디바이스(사용되지 않음)의 경우 합계(sum)만 유효합니다. 최솟값, 최댓값, 평균 집계는 항상 1을 반환합니다. 자세한 내용은 지원되는 집계를 참조하세요.

총 디바이스 및 연결된 디바이스의 경우 최소, 최대 및 평균 집계만 유효합니다. 자세한 내용은 지원되는 집계를 참조하세요.

진단 설정을 통해 총 디바이스 및 연결된 디바이스를 내보낼 수 없습니다.

디바이스 원격 분석 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
제한 오류 수	d2c.telemetry.ingress.sendThrottle	개수	합계	디바이스 처리량 제한으로 인한 제한 오류 수	없음
원격 분석 '메시지 보내기' 시도	d2c.telemetry.ingress.allProtocol	개수	합계	IoT Hub로 보내려 한 디바이스-클라우드 원격 분석 메시지 수	없음
보낸 원격 분석 메시지	d2c.telemetry.ingress.success	개수	합계	IoT Hub로 보내기 성공한 디바이스-클라우드 원격 분석 메시지 수	없음

디바이스-클라우드 쌍 작업 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
디바이스에서의 실패한 쌍 읽기	d2c.twin.read.failure	개수	합계	실패한 모든 디바이스 시작 쌍 읽기 수입니다.	없음
디바이스에서의 실패한 쌍 업데이트	d2c.twin.update.failure	개수	합계	실패한 모든 디바이스 시작 쌍 업데이트 수입니다.	없음
디바이스에서의 쌍 읽기 응답 크기	d2c.twin.read.size	바이트	평균	성공한 모든 디바이스 시작 쌍 읽기 수입니다.	없음
디바이스에서의 쌍 업데이트 크기	d2c.twin.update.size	바이트	평균	성공한 모든 디바이스 시작 쌍 업데이트 총 크기입니다.	없음
디바이스에서의 성공한 쌍 읽기	d2c.twin.read.success	개수	합계	성공한 모든 디바이스 시작 쌍 읽기 수입니다.	없음
디바이스에서의 성공한 쌍 업데이트	d2c.twin.update.success	개수	합계	성공한 모든 디바이스 시작 쌍 업데이트 수입니다.	없음

Event Grid 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
Event Grid 전송	EventGridDeliveries	개수	합계	Event Grid에 게시된 IoT Hub 이벤트 수. 성공 및 실패한 요청 수에 대한 결과 차원을 사용합니다. EventType 차원은 이벤트 형식(https://aka.ms/ioteventgrid)을 보여 줍니다.	결과, EventType 자세한 내용은 메트릭 차원을 참조하세요.
Event Grid 대기 시간	EventGridLatency	밀리초	평균	Iot Hub 이벤트가 생성된 시간부터 Event Grid에 게시된 시간까지의 평균 대기 시간(밀리초). 이 숫자는 모든 이벤트 유형의 평균입니다. 특정 이벤트 유형의 대기 시간을 확인하려면 EventType 차원을 사용합니다.	EventType 자세한 내용은 메트릭 차원을 참조하세요.

작업 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
완료된 작업	jobs.completed	개수	합계	완료된 모든 작업의 수입니다.	없음
목록 작업에 대한 실패한 호출	jobs.listJobs.failure	개수	합계	목록 작업에 대한 실패한 모든 호출 수입니다.	없음
실패한 메서드 호출 작업 만들기	jobs.createDirectMethodJob.failure	개수	합계	직접 메서드 호출 작업에 대한 실패한 모든 만들기의 수입니다.	없음
쌍 업데이트 작업에 대한 실패한 만들기	jobs.createTwinUpdateJob.failure	개수	합계	쌍 업데이트 작업에 대한 실패한 모든 만들기의 수입니다.	없음
실패한 작업 취소	jobs.cancelJob.failure	개수	합계	작업 취소에 대한 실패한 모든 호출 수입니다.	없음
실패한 작업 쿼리	jobs.queryJobs.failure	개수	합계	쿼리 작업에 대한 실패한 모든 호출 수입니다.	없음
실패한 작업	jobs.failed	개수	합계	실패한 모든 작업의 수입니다.	없음
목록 작업에 대한 성공한 호출	jobs.listJobs.success	개수	합계	목록 작업에 대한 성공한 모든 호출 수입니다.	없음
메서드 호출 작업에 대한 성공한 만들기	jobs.createDirectMethodJob.success	개수	합계	직접 메서드 호출 작업에 대한 성공한 모든 만들기의 수입니다.	없음
쌍 업데이트 작업에 대한 성공한 만들기	jobs.createTwinUpdateJob. 성공	개수	합계	쌍 업데이트 작업에 대한 성공한 모든 만들기의 수입니다.	없음
성공한 작업 취소	jobs.cancelJob.success	개수	합계	작업 취소에 대한 성공한 모든 호출 수입니다.	없음
성공한 작업 쿼리	jobs.queryJobs.success	개수	합계	쿼리 작업에 대한 성공한 모든 호출 수입니다.	없음

라우팅 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
라우팅 전송(미리 보기)	RoutingDeliveries	개수	합계	라우팅 배달 메트릭. 차원을 사용하여 특정 엔드포인트 또는 특정 라우팅 원본의 배달 상태를 식별할 수 있습니다.	결과, RoutingSource, EndpointType, FailureReasonCategory, EndpointName 자세한 내용은 메트릭 차원을 참조하세요.
라우팅 전송 메시지 크기(바이트)(미리 보기)	RoutingDataSizeInBytesDelivered	바이트	합계	IoT Hub 의해 사용자 지정 엔드포인트와 기본 제공 엔드포인트에 라우팅되는 총 바이트 수입니다. 차원을 사용하여 특정 엔드포인트 또는 특정 라우팅 원본에 대해 라우팅되는 데이터 크기를 식별할 수 있습니다.	RoutingSource, EndpointType EndpointName 자세한 내용은 메트릭 차원을 참조하세요.
라우팅 전송 대기 시간(미리 보기)	RoutingDeliveryLatency	밀리초	평균	라우팅 전달 대기 시간 메트릭입니다. 차원을 사용하여 특정 엔드포인트 또는 특정 라우팅 원본의 대기 시간을 식별합니다.	RoutingSource, EndpointType, EndpointName 자세한 내용은 메트릭 차원을 참조하세요.
라우팅: 스토리지에 배달된 Blob	d2c.endpoints.egress.storage.blobs	개수	합계	IoT Hub 라우팅에서 스토리지 엔드포인트에 Blob을 배달한 횟수입니다.	없음
라우팅: 스토리지에 배달된 데이터	d2c.endpoints.egress.storage.bytes	바이트	합계	IoT Hub 라우팅에서 스토리지 엔드포인트에 배달된 데이터 양입니다(바이트).	없음
라우팅: Event Hubs에 대한 메시지 대기 시간	d2c.endpoints.latency.eventHubs	밀리초	평균	IoT Hub로의 메시지 수신 및 Event Hubs 유형의 사용자 지정 엔드포인트로의 메시지 수신 사이에 걸리는 평균 대기 시간(밀리초)입니다. 기본 제공 엔드포인트(이벤트)에 대한 메시지 경로는 포함되지 않습니다.	없음
라우팅: Service Bus 큐에 대한 메시지 대기 시간	d2c.endpoints.latency.serviceBusQueues	밀리초	평균	IoT Hub로의 메시지 수신 및 Service Bus 큐 엔드포인트로의 메시지 수신 사이에 걸리는 평균 대기 시간(밀리초)입니다.	없음
라우팅: Service Bus 토픽에 대한 메시지 대기 시간	d2c.endpoints.latency.serviceBusTopics	밀리초	평균	IoT Hub로의 메시지 수신 및 Service Bus 토픽 엔드포인트로의 메시지 수신 사이에 걸리는 평균 대기 시간(밀리초)입니다.	없음
라우팅: 메시지/이벤트에 대한 메시지 대기 시간	d2c.endpoints.latency.builtIn.events	밀리초	평균	IoT Hub로의 메시지 수신 및 기본 제공 엔드포인트(메시지/이벤트)로의 메시지 수신 사이에 걸리는 평균 대기 시간(밀리초)입니다.	없음
라우팅: 스토리지에 대한 메시지 대기 시간	d2c.endpoints.latency.storage	밀리초	평균	IoT Hub로의 메시지 수신 및 스토리지 엔드포인트로의 메시지 수신 사이에 걸리는 평균 대기 시간(밀리초)입니다.	없음
라우팅: Event Hubs로 전달된 메시지	d2c.endpoints.egress.eventHubs	개수	합계	IoT Hubs 라우팅이 이벤트 허브 형식의 엔드포인트에 메시지를 성공적으로 배달한 횟수입니다. 기본 제공 엔드포인트(이벤트)에 대한 메시지 경로는 포함되지 않습니다.	없음
라우팅: Service Bus 큐에 배달된 메시지	d2c.endpoints.egress.serviceBusQueues	개수	합계	IoT Hub 라우팅에서 Service Bus 큐 엔드포인트에 메시지를 성공적으로 배달한 횟수입니다.	없음
라우팅: Service Bus 토픽에 배달된 메시지	d2c.endpoints.egress.serviceBusTopics	개수	합계	IoT Hub 라우팅에서 Service Bus 토픽 엔드포인트에 메시지를 성공적으로 배달한 횟수입니다.	없음
라우팅: 대체에 배달된 메시지	d2c.telemetry.egress.fallback	개수	합계	IoT Hub 라우팅에서 대체 경로와 연결된 엔드포인트에 메시지를 배달한 횟수입니다.	없음
라우팅: 메시지/이벤트에 배달된 메시지	d2c.endpoints.egress.builtIn.events	개수	합계	IoT Hub 라우팅이 기본 제공 엔드포인트(메시지/이벤트) 및 대체 경로에 성공적으로 메시지를 전달한 횟수입니다.	없음
라우팅: 스토리지에 배달된 메시지	d2c.endpoints.egress.storage	개수	합계	IoT Hub 라우팅에서 스토리지 엔드포인트에 메시지를 성공적으로 배달한 횟수입니다.	없음
라우팅: 배달된 원격 분석 메시지	d2c.telemetry.egress.success	개수	합계	IoT Hub 라우팅을 사용하여 모든 엔드포인트에 메시지가 성공적으로 배달된 횟수입니다. 메시지가 여러 엔드포인트로 라우팅되는 경우 이 값은 각 성공적인 배달에 대해 하나씩 증가합니다. 메시지가 동일한 엔드포인트로 여러 번 배달되는 경우 이 값은 각 성공적인 배달에 대해 하나씩 증가합니다.	없음
라우팅: 삭제된 원격 분석 메시지	d2c.telemetry.egress.dropped	개수	합계	데드 엔드포인트로 인해 IoT Hub 라우팅에서 메시지가 삭제된 횟수입니다. 삭제된 메시지는 배달되지 않으므로 이 값은 대체 경로에 배달된 메시지를 계산에 넣지 않습니다.	없음
라우팅: 원격 분석 메시지 호환되지 않음	d2c.telemetry.egress.invalid	개수	합계	IoT Hub 라우팅에서 엔드포인트와의 비호환성으로 인해 메시지를 배달하지 못한 횟수입니다. Iot Hub가 엔드포인트에 메시지를 배달하려고 시도하고 일시적이지 않은 오류로 인해 실패하는 경우 메시지는 엔드포인트와 호환되지 않습니다. 잘못된 메시지는 다시 시도되지 않습니다. 이 값은 재시도를 포함하지 않습니다.	없음
라우팅: 분리된 원격 분석 메시지	d2c.telemetry.egress.orphaned	개수	합계	대체 경로를 사용할 수 없는 경우 메시지가 라우팅 쿼리와 일치하지 않기 때문에 IoT Hub 라우팅이 메시지를 분리한 횟수입니다.	없음

쌍 쿼리 메트릭

메트릭 표시 이름	메트릭	단위	집계 형식	Description	차원
실패한 쌍 쿼리	twinQueries.failure	개수	합계	실패한 모든 쌍 쿼리의 수입니다.	없음
성공한 쌍 쿼리	twinQueries.success	개수	합계	성공한 모든 쌍 쿼리의 수입니다.	없음
쌍 쿼리 결과 크기	twinQueries.resultSize	바이트	평균	성공한 모든 쌍 쿼리 결과 크기의 합계입니다.	없음

메트릭 차원

Azure IoT Hub에는 일부 라우팅 및 Event Grid 메트릭과 관련된 다음과 같은 차원이 있습니다.

차원 이름	Description

EndpointName	엔드포인트 이름
EndpointType	eventHubs, serviceBusQueues, cosmosDB, serviceBusTopics. builtin 또는 blobStorage
EventType	Microsoft.Devices.DeviceCreated. Microsoft.Devices.DeviceDeleted, Microsoft.Devices.DeviceConnected, Microsoft.Devices.DeviceDisconnected 또는 Microsoft.Devices.DeviceTelemetry 자세한 내용은 이벤트 형식을 참조하세요.
FailureReasonCategory	invalid, dropped, orphaned, 또는 null 중 하나입니다.
결과	성공 또는 실패
RoutingSource	디바이스 메시지 쌍 변경 이벤트 디바이스 수명 주기 이벤트

메트릭 차원에 대한 자세한 정보는 다차원 메트릭을 참조하세요.

리소스 로그

이 섹션은 Azure IoT Hub에 대해 수집된 모든 리소스 로그 범주 유형 및 스키마를 나열합니다. 모든 IoT Hub 로그의 리소스 공급자 및 유형은 Microsoft. Devices/IotHubs입니다. 이벤트는 일부 범주의 오류에 대해서만 발생합니다.

이 섹션의 토픽

연결
디바이스 원격 분석
클라우드-디바이스 명령
디바이스 ID 작업
파일 업로드 작업
경로
디바이스-클라우드 쌍 작업
클라우드-디바이스 쌍 작업
쌍 쿼리
작업 연산
직접 메서드
분산 추적(미리 보기)
구성
디바이스 스트림(미리 보기)

Connections

이 연결 범주에서는 IoT Hub에서의 디바이스 연결 및 연결 해제 이벤트와 오류를 추적합니다. 이 범주는 디바이스에 대한 연결을 분실한 경우 무단 연결 시도를 식별하고 경고하는 데 유용합니다.

디바이스의 안정적인 연결 상태는 디바이스 연결 상태 모니터링을 참조하세요.

{
   "records":
   [
        {
            "time": " UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "deviceConnect",
            "category": "Connections",
            "level": "Information",
            "properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"maskedIpAddress\":\"<maskedIpAddress>\"}",
            "location": "Resource location"
        }
    ]
}

연결 로그를 사용하여 디바이스 연결을 모니터링하는 방법에 대한 자세한 내용은 Azure IoT Hub에 대한 디바이스 연결 모니터링, 진단 및 문제 해결을 참조하세요.

디바이스 원격 분석

디바이스 원격 분석 범주는 IoT Hub에서 발생하고 원격 분석 파이프라인에 관련된 오류를 추적합니다. 이 범주에는 원격 분석 이벤트를 보내고(예: 제한) 원격 분석 이벤트를 수신할 때(예: 무단된 판독기) 발생하는 오류가 포함됩니다. 이 범주는 디바이스 자체에서 실행되는 코드에 의해 발생한 오류를 포착할 수 없습니다.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "ingress",
            "category": "DeviceTelemetry",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"deviceId\":\"<deviceId>\",\"batching\":\"0\",\"messageSizeInBytes\":\"<messageSizeInBytes>\",\"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\",\"partitionId\":\"1\"}", 
            "location": "Resource location"
        }
    ]
}

클라우드-디바이스 명령

클라우드-디바이스 명령 범주는 IoT Hub에서 발생하고 클라우드-디바이스 메시지 파이프라인에 관련된 오류를 추적합니다. 이 범주는 다음에서 발생하는 오류를 포함합니다.

클라우드-디바이스 메시지 보내기(예: 권한이 없는 보낸 사람 오류),
클라우드-디바이스 메시지 수신(예: 배달 횟수 초과 오류) 및
클라우드-디바이스 메시지 피드백 수신(예: 피드백 만료 오류)

이 범주는 클라우드-디바이스 메시지가 성공적으로 전달되었지만 디바이스에서 부적절하게 처리된 경우 오류를 포착하지 않습니다.

{
    "records":
    [
        {
            "time": " UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "messageExpired",
            "category": "C2DCommands",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"deviceId\":\"<deviceId>\",\"messageId\":\"<messageId>\",\"messageSizeInBytes\":\"<messageSize>\",\"protocol\":\"Amqp\",\"deliveryAcknowledgement\":\"<None, NegativeOnly, PositiveOnly, Full>\",\"deliveryCount\":\"0\",\"expiryTime\":\"<timestamp>\",\"timeInSystem\":\"<timeInSystem>\",\"ttl\":<ttl>, \"EventProcessedUtcTime\":\"<UTC timestamp>\",\"EventEnqueuedUtcTime\":\"<UTC timestamp>\", \"maskedIpAddress\": \"<maskedIpAddress>\", \"statusCode\": \"4XX\"}",
            "location": "Resource location"
        }
    ]
}

디바이스 ID 작업

디바이스 ID 작업 범주는 IoT Hub ID 레지스트리의 항목을 만들거나, 업데이트하거나 삭제하려고 할 때 발생하는 오류를 추적합니다. 이 범주를 추적하는 것은 프로비전 시나리오에 유용합니다.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "get",
            "category": "DeviceIdentityOperations",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "properties": "{\"maskedIpAddress\":\"<maskedIpAddress>\",\"deviceId\":\"<deviceId>\", \"statusCode\":\"4XX\"}",
            "location": "Resource location"
        }
    ]
}

파일 업로드 작업

파일 업로드 범주는 IoT Hub에서 발생하고 파일 업로드 기능과 관련된 오류를 추적합니다. 이 범주에는 다음이 포함됩니다.

SAS URI에서 발생하는 오류(예: 디바이스가 허브에 완료된 업로드를 알리기 전에 만료되는 경우).
디바이스에 의해 보고된 실패한 업로드.
IoT Hub 알림 메시지 생성 중 스토리지에서 파일을 찾을 수 없는 경우 발생하는 오류입니다.

이 범주는 디바이스가 스토리지로 파일을 업로드하는 동안 직접 발생하는 오류를 검색할 수 없습니다.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "ingress",
            "category": "FileUploadOperations",
            "level": "Error",
            "resultType": "Event status",
            "resultDescription": "MessageDescription",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"protocol\":\"<protocol>\",\"authType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\",\"blobUri\":\"http//bloburi.com\"}",
            "location": "Resource location"
        }
    ]
}

경로

메시지 라우팅 범주는 IoT Hub에서 감지하는 대로 메시지 경로 평가 중에 발생한 오류 및 엔드포인트 상태를 추적합니다. 이 범주는 다음과 같은 이벤트를 포함합니다.

규칙에서 "정의되지 않음"으로 평가,
IoT Hub에서 엔드포인트를 데드로 표시 또는
엔드포인트에서 받은 모든 오류

이 범주는 메시지 자체에 대한 특정 오류(예: 디바이스 제한 오류)를 포함하지 않습니다. 해당 오류는 "디바이스 원격 분석" 범주 아래에서 보고됩니다.

{
    "records":
    [
        {
            "time":"2019-12-12T03:25:14Z",
            "resourceId":"/SUBSCRIPTIONS/91R34780-3DEC-123A-BE2A-213B5500DFF0/RESOURCEGROUPS/ANON-TEST/PROVIDERS/MICROSOFT.DEVICES/IOTHUBS/ANONHUB1",
            "operationName":"endpointUnhealthy",
            "category":"Routes",
            "level":"Error",
            "resultType":"403004",
            "resultDescription":"DeviceMaximumQueueDepthExceeded",
            "properties":"{\"deviceId\":null,\"endpointName\":\"anon-sb-1\",\"messageId\":null,\"details\":\"DeviceMaximumQueueDepthExceeded\",\"routeName\":null,\"statusCode\":\"403\"}",
            "location":"westus"
        }
    ]
}

라우팅 리소스 로그에 대한 자세한 내용은 다음과 같습니다.

디바이스-클라우드 쌍 작업

클라우드-디바이스 쌍 작업 범주는 디바이스 쌍에서 디바이스가 시작한 이벤트를 추적합니다. 이러한 작업에는 쌍 가져오기, 보고된 속성 업데이트, 원하는 속성 구독이 포함될 수 있습니다.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "update",
            "category": "D2CTwinOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"protocol\":\"<protocol>\",\"authenticationType\":\"{\\\"scope\\\":\\\"device\\\",\\\"type\\\":\\\"sas\\\",\\\"issuer\\\":\\\"iothub\\\",\\\"acceptingIpFilterRule\\\":null}\"}",
            "location": "Resource location"
        }
    ]
}

클라우드-디바이스 쌍 작업

클라우드-디바이스 쌍 작업 범주는 디바이스 쌍에서 서비스가 시작한 이벤트를 추적합니다. 이러한 작업에는 쌍 가져오기, 태그 업데이트 또는 대체, 원하는 속성 업데이트 또는 대체가 포함될 수 있습니다.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "read",
            "category": "C2DTwinOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":\"<deviceId>\",\"sdkVersion\":\"<sdkVersion>\",\"messageSize\":\"<messageSize>\"}",
            "location": "Resource location"
        }
    ]
}

쌍 쿼리

쌍 쿼리 범주는 클라우드에서 시작된 디바이스 쌍에 대한 쿼리 요청을 보고합니다.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "query",
            "category": "TwinQueries",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"query\":\"<twin query>\",\"sdkVersion\":\"<sdkVersion>\",\"messageSize\":\"<messageSize>\",\"pageSize\":\"<pageSize>\", \"continuation\":\"<true, false>\", \"resultSize\":\"<resultSize>\"}",
            "location": "Resource location"
        }
    ]
}

작업 연산

작업 연산 범주는 디바이스 쌍을 업데이트하는 작업 요청 또는 여러 디바이스에 대한 직접 메서드를 호출하는 작업 요청에 대해 보고합니다. 이러한 요청은 클라우드에서 시작됩니다.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "jobCompleted",
            "category": "JobsOperations",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"jobId\":\"<jobId>\", \"sdkVersion\": \"<sdkVersion>\",\"messageSize\": <messageSize>,\"filter\":\"DeviceId IN ['1414ded9-b445-414d-89b9-e48e8c6285d5']\",\"startTimeUtc\":\"Wednesday, September 13, 2017\",\"duration\":\"0\"}",
            "location": "Resource location"
        }
    ]
}

직접 메서드

직접 메서드 범주는 개별 디바이스로 전송되는 요청-응답 상호 작용을 추적합니다. 이러한 요청은 클라우드에서 시작됩니다.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "send",
            "category": "DirectMethods",
            "level": "Information",
            "durationMs": "1",
            "properties": "{\"deviceId\":<messageSize>, \"RequestSize\": 1, \"ResponseSize\": 1, \"sdkVersion\": \"2017-07-11\"}",
            "location": "Resource location"
        }
    ]
}

분산 추적(미리 보기)

분산 추적 범주는 추적 컨텍스트 헤더를 전달하는 메시지의 상관 관계 ID를 추적합니다. 해당 로그를 완전히 활성화하려면 IoT Hub 분산 추적(미리 보기)을 사용한 IoT 애플리케이션 엔드투엔드 분석 및 진단에 따라 클라이언트 쪽 코드를 업데이트해야 합니다.

correlationId는 trace-id 및 span-id를 포함하는 W3C 추적 컨텍스트 제안을 준수합니다.

IoT Hub D2C(디바이스-클라우드) 로그

IoT Hub는 유효한 추적 속성이 포함된 메시지가 IoT Hub에 도착할 때 이 로그를 기록합니다.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubD2C",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-0144d2590aacd909-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Receive message success",
            "durationMs": "",
            "properties": "{\"messageSize\": 1, \"deviceId\":\"<deviceId>\", \"callerLocalTimeUtc\": : \"2017-02-22T03:27:28.633Z\", \"calleeLocalTimeUtc\": \"2017-02-22T03:27:28.687Z\"}",
            "location": "Resource location"
        }
    ]
}

여기서 durationMs는 IoT Hub 시계가 디바이스 시계와 동기화되지 않아 기간 계산이 잘못될 수 있기 때문에 계산되지 않습니다. 디바이스-클라우드 대기 시간의 급증을 캡처하려면 properties 섹션에서 타임스탬프를 사용한 논리를 작성하는 것이 좋습니다.

속성	형식	설명
messageSize	정수	디바이스-클라우드 메시지의 크기(바이트)
deviceId	ASCII 7비트 영숫자 문자의 문자열	디바이스의 ID
callerLocalTimeUtc	UTC 타임스탬프	디바이스 로컬 시계에서 보고한 메시지 생성 시간
calleeLocalTimeUtc	UTC 타임스탬프	IoT Hub 서비스 쪽 시계에서 메시지가 IoT Hub의 게이트웨이에 도착했다고 보고한 시간

IoT Hub 수신 로그

IoT Hubs는 유효한 추적 속성이 포함된 메시지가 내부 또는 기본 제공 이벤트 허브에 작성될 때 이 로그를 기록합니다.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubIngress",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-349810a9bbd28730-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Ingress message success",
            "durationMs": "10",
            "properties": "{\"isRoutingEnabled\": \"true\", \"parentSpanId\":\"0144d2590aacd909\"}",
            "location": "Resource location"
        }
    ]
}

properties 섹션의 이 로그에는 메시지 수신에 대한 추가 정보가 포함됩니다.

속성	형식	설명
isRoutingEnabled	String	true 또는 false이며, IoT Hub에서 메시지 라우팅이 사용되는지 여부를 나타냅니다.
parentSpanId	String	부모 메시지(이 경우 D2C 메시지 추적)의 span-id입니다.

IoT Hub 송신 로그

IoT Hub는 라우팅이 사용되고 메시지가 엔드포인트에 작성될 때 이 로그를 기록합니다. 라우팅이 사용되지 않는 경우 IoT Hub는 이 로그를 기록하지 않습니다.

{
    "records":
    [
        {
            "time": "UTC timestamp",
            "resourceId": "Resource Id",
            "operationName": "DiagnosticIoTHubEgress",
            "category": "DistributedTracing",
            "correlationId": "00-8cd869a412459a25f5b4f31311223344-98ac3578922acd26-01",
            "level": "Information",
            "resultType": "Success",
            "resultDescription":"Egress message success",
            "durationMs": "10",
            "properties": "{\"endpointType\": \"EventHub\", \"endpointName\": \"myEventHub\", \"parentSpanId\":\"349810a9bbd28730\"}",
            "location": "Resource location"
        }
    ]
}