Azure IoT Hub Device Provisioning Service 모니터링 참조 자료

  • 아티클

Azure IoT Hub DPS(Device Provisioning Service)에 대한 모니터링 데이터 수집 및 분석에 대한 자세한 내용은 IoT Hub Device Provisioning Service 모니터링을 참조하세요.

메트릭

이 섹션에는 DPS에 대해 수집되는 모든 자동 수집 플랫폼 메트릭이 나와 있습니다.

리소스 공급자 및 유형: Microsoft.Devices/provisioningServices.

메트릭 진단 설정 통해 내보낼 수 있나요? 메트릭 표시 이름 단위 집계 유형 설명 차원
AttestationAttempts 예 증명 시도 개수 합계 시도된 디바이스 증명 수 ProvisioningServiceName, 상태, 프로토콜
DeviceAssignments 예 할당된 디바이스 개수 합계 IoT Hub에 할당된 디바이스 수 ProvisioningServiceName, IotHubName
RegistrationAttempts 예 등록 시도 개수 합계 디바이스 등록 시도 수 ProvisioningServiceName, IotHubName, 상태

자세한 내용은 Azure Monitor에서 지원되는 모든 플랫폼 메트릭 목록을 참조하세요.

메트릭 차원

DPS에는 해당 메트릭과 연결된 다음 차원이 있습니다.

차원 이름 설명
IotHubName 대상 IoT Hub의 이름입니다.
프로토콜 사용되는 디바이스 또는 서비스 프로토콜입니다.
ProvisioningServiceName DPS 인스턴스의 이름입니다.
상태 작업의 상태입니다.

메트릭 차원에 대한 자세한 내용은 다차원 메트릭을 참조하세요.

리소스 로그

이 섹션에는 DPS에 대해 수집할 수 있는 리소스 로그 유형이 나열되어 있습니다.

리소스 공급자 및 유형: Microsoft.Devices/provisioningServices.

범주 설명
DeviceOperations 디바이스 증명 이벤트와 관련된 로그입니다. 청구 가능한 서비스 작업 및 가격 책정에 나열된 디바이스 API를 참조하세요.
ServiceOperations DPS 서비스 이벤트와 관련된 로그입니다. 청구 가능한 서비스 작업 및 가격 책정에 나열된 DPS 서비스 API를 참조하세요.

Azure Monitor에서 지원되는 모든 리소스 로그 범주 유형 목록을 참조하세요.

DPS는 AzureDiagnostics 테이블을 사용하여 리소스 로그 정보를 저장합니다. 다음 열은 관련이 있습니다.

속성 데이터 형식 설명
ApplicationId GUID 전달자 권한 부여에 사용되는 애플리케이션 ID
callerIpAddress 문자열 이벤트의 마스킹된 원본 IP 주소.
범주 문자열 ServiceOperations 또는 DeviceOperations 작업 유형입니다.
CorrelationId GUID 이벤트에 대한 고유 식별자입니다.
DurationMs 문자열 이벤트를 수행하는 데 걸린 시간(밀리초).
수준 정수 이벤트의 로깅 심각도. 예를 들어 정보 또는 오류입니다.
OperationName 문자열 이벤트 중 수행되는 작업의 유형 예: 쿼리, 가져오기, Upsert 등입니다.
OperationVersion 문자열 이벤트 중 사용된 API 버전
리소스 문자열 이벤트가 발생한 리소스의 이름입니다. 예를 들어 "MYEXAMPLEDPS"입니다.
ResourceGroup 문자열 리소스가 있는 리소스 그룹의 이름입니다.
ResourceId String 이벤트가 발생한 리소스의 Azure Resource Manager 리소스 ID.
ResourceProvider 문자열 이벤트에 대한 리소스 공급자입니다. 예: "MICROSOFT.DEVICES".
ResourceType 문자열 이벤트에 대한 리소스 공급자입니다. 예를 들어 "PROVISIONINGSERVICES"입니다.
ResultDescription 문자열 실패한 경우 이벤트에 대한 오류 세부 정보입니다.
ResultSignature 문자열 실패한 경우 이벤트에 대한 HTTP 상태 코드입니다.
ResultType 문자열 이벤트의 결과: 성공, 실패, ClientError 등
SubscriptionId GUID 리소스가 있는 Azure 구독의 구독 ID입니다.
TenantId GUID 리소스가 있는 Azure 테넌트의 테넌트 ID입니다.
TimeGenerated DateTime 해당 이벤트가 발생한 날짜 및 시간(UTC).
location_s 문자열 이벤트가 발생한 Azure 지역입니다.
properties_s JSON 이벤트에 대한 추가 정보 세부 정보입니다.

DeviceOperations

다음 JSON은 디바이스에서 성공적인 증명 시도의 예입니다. 디바이스의 등록 ID는 properties_s 속성에서 식별됩니다.

  {
    "CallerIPAddress": "24.18.226.XXX",
    "Category": "DeviceOperations",
    "CorrelationId": "68952383-80c0-436f-a2e3-f8ae9a41c69d",
    "DurationMs": "226",
    "Level": "Information",
    "OperationName": "AttestationAttempt",
    "OperationVersion": "March2019",
    "Resource": "MYEXAMPLEDPS",
    "ResourceGroup": "MYRESOURCEGROUP",
    "ResourceId": "/SUBSCRIPTIONS/747F1067-xxx-xxx-xxxx-9DEAA894152F/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DEVICES/PROVISIONINGSERVICES/MYEXAMPLEDPS",
    "ResourceProvider": "MICROSOFT.DEVICES",
    "ResourceType": "PROVISIONINGSERVICES",
    "ResultDescription": "",
    "ResultSignature": "",
    "ResultType": "Success",
    "SourceSystem": "Azure",
    "SubscriptionId": "747F1067-xxx-xxx-xxxx-9DEAA894152F",
    "TenantId": "37dcb621-xxxx-xxxx-xxxx-e8c8addbc4e5",
    "TimeGenerated": "2022-04-02T00:05:51Z",
    "Type": "AzureDiagnostics",
    "_ResourceId": "/subscriptions/747F1067-xxx-xxx-xxxx-9DEAA894152F/resourcegroups/myresourcegroup/providers/microsoft.devices/provisioningservices/myexampledps",
    "location_s": "centralus",
    "properties_s": "{\"id\":\"my-device-1\",\"type\":\"Registration\",\"protocol\":\"Mqtt\"}",
  }

ServiceOperations

다음 JSON은 성공적인 추가(Upsert) 개별 등록 작업의 예입니다. 등록 및 등록 유형에 대한 등록 ID는 properties_s 속성에서 식별됩니다.

  {
    "CallerIPAddress": "13.91.244.XXX",
    "Category": "ServiceOperations",
    "CorrelationId": "23bd419d-d294-452b-9b1b-520afef5ef52",
    "DurationMs": "98",
    "Level": "Information",
    "OperationName": "Upsert",
    "OperationVersion": "October2021",
    "Resource": "MYEXAMPLEDPS",
    "ResourceGroup": "MYRESOURCEGROUP",
    "ResourceId": "/SUBSCRIPTIONS/747F1067-xxxx-xxxx-xxxx-9DEAA894152F/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DEVICES/PROVISIONINGSERVICES/MYEXAMPLEDPS",
    "ResourceProvider": "MICROSOFT.DEVICES",
    "ResourceType": "PROVISIONINGSERVICES",
    "ResultDescription": "",
    "ResultSignature": "",
    "ResultType": "Success",
    "SourceSystem": "Azure",
    "SubscriptionId": "747f1067-xxxx-xxxx-xxxx-9deaa894152f",
    "TenantId": "37dcb621-xxxx-xxxx-xxxx-e8c8addbc4e5",
    "TimeGenerated": "2022-04-01T00:52:00Z",
    "Type": "AzureDiagnostics",
    "_ResourceId": "/subscriptions/747F1067-xxxx-xxxx-xxxx-9DEAA894152F/resourcegroups/myresourcegroup/providers/microsoft.devices/provisioningservices/myexampledps",
    "location_s": "centralus",
    "properties_s": "{\"id\":\"my-device-1\",\"type\":\"IndividualEnrollment\",\"protocol\":\"Http\"}",
  }

Azure Monitor 로그 테이블

이 섹션은 DPS와 관련되고 Log Analytics에서 쿼리에 사용할 수 있는 모든 Azure Monitor Logs Kusto 테이블을 참조하세요. 해당 테이블 목록 및 DPS 리소스 유형에 대한 자세한 정보 관련 링크는 Azure Monitor Logs 테이블 참조의 Device Provisioning Service를 참조하세요.

모든 Azure Monitor Logs/Log Analytics 테이블에 대한 참조는 Azure Monitor 로그 테이블 참조를 확인하세요.

활동 로그

활동 로그 항목의 스키마에 대한 자세한 내용은 활동 로그 스키마를 참조하세요.

참고 항목