메트릭, 경고 및 진단을 사용하여 Azure Digital Twins 모니터링

Azure Digital Twins는 Azure Monitor와 통합되어 Azure Digital Twins 리소스를 모니터링하는 데 사용할 수 있는 메트릭 및 진단 정보를 제공합니다. 메트릭은 기본값으로 사용 설정되며 Azure 구독에서 Azure Digital Twins 리소스의 상태에 대한 정보를 제공합니다. 경고는 메트릭 데이터에서 특정 조건이 발견되면 사전에 알림을 발송합니다. 서비스 인스턴스에 대한 진단 로그를 수집하여 성능, 액세스 및 기타 데이터를 모니터링할 수도 있습니다.

이러한 모니터링 기능을 사용하면 Azure Digital Twins 서비스의 전반적인 상태와 연결된 리소스를 평가하는 데 도움이 됩니다. 이를 사용하여 Azure Digital Twins 인스턴스에서 발생하는 상황을 파악하고, Azure 지원에 문의하지 않고도 문제에 대한 근본 원인을 분석할 수 있습니다.

Azure Digital Twins 리소스에 대한 모니터링 제목 아래에 그룹화된 Azure Portal에서 액세스할 수 있습니다.

메트릭 및 경고

Azure 리소스 메트릭을 보는 방법에 대한 일반적인 내용은 Azure Monitor 설명서에서 메트릭 탐색기 시작을 참조하세요. Azure 메트릭에 대한 경고를 구성하는 방법에 대한 일반적인 내용은 새 경고 규칙 만들기를 참조하세요.

이 섹션의 나머지 부분에서는 각 Azure Digital Twins 인스턴스가 추적하는 메트릭과 각 메트릭이 인스턴스의 전체 상태와 어떻게 관련되는지를 설명합니다.

서비스 제한 추적에 대한 메트릭

이러한 메트릭을 솔루션의 일부 측면에 대해 게시된 서비스 제한에 도달 하는 시기를 추적하도록 구성할 수 있습니다.

추적을 설정하려면 Azure Monitor의 경고 기능을 사용합니다. 메트릭이 게시된 한도의 특정 비율에 도달하면 경고를 받도록 이러한 메트릭에 대한 임계값을 정의할 수 있습니다.

API 요청 메트릭

API 요청으로 수행해야 하는 메트릭:

청구 메트릭

청구로 수행해야 하는 메트릭:

Azure Digital Twins 요금이 청구되는 방법에 관한 자세한 내용은 Azure Digital Twins 가격 책정을 참조하세요.

수신 메트릭

데이터 수신으로 수행해야 하는 메트릭:

대량 작업 메트릭(작업 API에서)

작업 API의 대량 작업과 관련이 있는 메트릭:

라우팅 메트릭

라우팅으로 수행해야 하는 메트릭:

메트릭 차원

차원은 메트릭에 대한 자세한 정보를 식별하는 데 도움이 됩니다. 일부 라우팅 메트릭은 엔드포인트당 정보를 제공합니다. 다음 표에서는 이러한 차원에 사용할 수 있는 값을 나열합니다.

진단 로그

Azure 진단 설정을 사용하도록 설정하는 방법을 포함한 일반적인 내용은 Azure Monitor의 진단 설정을 참조하세요. Log Analytics를 사용하여 진단 로그를 쿼리하는 방법에 대한 자세한 내용은 Azure Monitor의 Log Analytics 개요를 참조하세요.

이 섹션의 나머지 부분에서는 Azure Digital Twins에서 수집할 수 있는 진단 로그 범주와 해당 스키마에 대해 설명합니다.

로그 범주

Azure Digital Twins가 수집하는 로그의 범주에 대한 자세한 정보는 다음과 같습니다.

각 로그 범주는 쓰기, 읽기, 삭제 및 동작의 작업으로 구성됩니다. 이러한 범주는 다음과 같이 REST API 호출에 매핑됩니다.

다음은 각 범주에 로그된 작업 및 해당 Azure Digital Twins REST API 호출의 포괄적인 목록입니다.

로그 스키마

각 로그 범주에는 해당 범주의 이벤트를 보고하는 방식을 정의하는 스키마가 있습니다. 각 개별 로그 항목은 텍스트로 저장되고 JSON Blob으로 서식이 지정됩니다. 아래의 각 로그 유형에 대해 로그 및 예제 JSON 본문의 필드가 제공됩니다.

ADTDigitalTwinsOperation, ADTModelsOperation 및 ADTQueryOperation은 일관된 API 로그 스키마를 사용합니다. ADTEventRoutesOperation은 속성에서 endpointName 필드를 포함하도록 스키마를 확장합니다.

API 로그 스키마

이 로그 스키마는 ADTDigitalTwinsOperation, ADTModelsOperation, ADTQueryOperation에 대해 일관됩니다. Microsoft.DigitalTwins/eventroutes/action 작업 이름을 제외하고 동일한 스키마가 ADTEventRoutesOperation에도 사용됩니다(이 스키마에 대한 자세한 정보는 다음 섹션인 송신 로그 스키마 참조).

이 스키마에는 Azure Digital Twins 인스턴스에 대한 API 호출과 관련된 정보가 포함됩니다.

다음은 API 로그에 대한 필드 및 속성 설명입니다.

다음은 이러한 로그 유형에 대한 예제 JSON 본문입니다.

ADTDigitalTwinsOperation

{
  "time": "2020-03-14T21:11:14.9918922Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/digitaltwins/write",
  "operationVersion": "2020-10-31",
  "category": "DigitalTwinOperation",
  "resultType": "Success",
  "resultSignature": "200",
  "resultDescription": "",
  "durationMs": 8,
  "callerIpAddress": "13.68.244.*",
  "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/digitaltwins/factory-58d81613-2e54-4faa-a930-d980e6e2a884?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTModelsOperation

{
  "time": "2020-10-29T21:12:24.2337302Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/models/write",
  "operationVersion": "2020-10-31",
  "category": "ModelsOperation",
  "resultType": "Success",
  "resultSignature": "201",
  "resultDescription": "",
  "durationMs": "80",
  "callerIpAddress": "13.68.244.*",
  "correlationId": "bbbb1111-cc22-3333-44dd-555555eeeeee",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/Models?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTQueryOperation

{
  "time": "2020-12-04T21:11:44.1690031Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/query/action",
  "operationVersion": "2020-10-31",
  "category": "QueryOperation",
  "resultType": "Success",
  "resultSignature": "200",
  "resultDescription": "",
  "durationMs": "314",
  "callerIpAddress": "13.68.244.*",
  "correlationId": "cccc2222-dd33-4444-55ee-666666ffffff",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/query?api-version=2020-10-31",
  "properties": {},
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
}

ADTEventRoutesOperation

다음은 Microsoft.DigitalTwins/eventroutes/action 유형이 아닌 ADTEventRoutesOperation에 대한 JSON 본문 예제입니다(이 스키마에 대한 자세한 정보는 다음 섹션인 송신 로그 스키마 참조).

  {
    "time": "2020-10-30T22:18:38.0708705Z",
    "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
    "operationName": "Microsoft.DigitalTwins/eventroutes/write",
    "operationVersion": "2020-10-31",
    "category": "EventRoutesOperation",
    "resultType": "Success",
    "resultSignature": "204",
    "resultDescription": "",
    "durationMs": 42,
    "callerIpAddress": "212.100.32.*",
    "correlationId": "dddd3333-ee44-5555-66ff-777777aaaaaa",
    "identity": {
      "claims": {
        "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
      }
    },
    "level": "4",
    "location": "southcentralus",
    "uri": "https://myinstancename.api.scus.digitaltwins.azure.net/EventRoutes/egressRouteForEventHub?api-version=2020-10-31",
    "properties": {},
    "traceContext": {
      "traceId": "95ff77cfb300b04f80d83e64d13831e7",
      "spanId": "b630da57026dd046",
      "parentId": "9f0de6dadae85945",
      "traceFlags": "01",
      "tracestate": "k1=v1,k2=v2"
    }
  },

송신 로그 스키마

다음 예는 Microsoft.DigitalTwins/eventroutes/action 작업 이름과 관련된 ADTEventRoutesOperation 로그의 스키마입니다. 여기에는 Azure Digital Twins 인스턴스에 연결된 송신 엔드포인트에 대한 예외 및 API 작업과 관련된 세부 정보가 포함됩니다.

다음은 Microsoft.DigitalTwins/eventroutes/action 유형의 ADTEventRoutesOperation에 대한 예제 JSON 본문입니다.

{
  "time": "2020-11-05T22:18:38.0708705Z",
  "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/MYRESOURCEGROUP/PROVIDERS/MICROSOFT.DIGITALTWINS/DIGITALTWINSINSTANCES/MYINSTANCENAME",
  "operationName": "Microsoft.DigitalTwins/eventroutes/action",
  "operationVersion": "",
  "category": "EventRoutesOperation",
  "resultType": "",
  "resultSignature": "",
  "resultDescription": "Unable to send EventHub message to [myPath] for event Id [f6f45831-55d0-408b-8366-058e81ca6089].",
  "durationMs": -1,
  "callerIpAddress": "",
  "correlationId": "dddd3333-ee44-5555-66ff-777777aaaaaa",
  "identity": {
    "claims": {
      "appId": "00001111-aaaa-2222-bbbb-3333cccc4444"
    }
  },
  "level": "4",
  "location": "southcentralus",
  "uri": "",
  "properties": {
    "endpointName": "myEventHub"
  },
  "traceContext": {
    "traceId": "95ff77cfb300b04f80d83e64d13831e7",
    "spanId": "b630da57026dd046",
    "parentId": "9f0de6dadae85945",
    "traceFlags": "01",
    "tracestate": "k1=v1,k2=v2"
  }
},

다음 단계

Azure Monitor 설명서에서 Azure Monitor 및 해당 기능에 대해 자세히 알아보세요.