Мониторинг Azure Digital Twins с помощью метрик, оповещений и диагностики

Azure Digital Twins интегрируется с Azure Monitor для предоставления метрик и диагностических сведений, которые можно использовать для мониторинга ресурсов Azure Digital Twins. Метрики включены по умолчанию и предоставляют сведения о состоянии ресурсов Azure Digital Twins в подписке Azure. Оповещения могут заранее уведомлять вас, когда определенные условия находятся в данных метрик. Вы также можете собирать журналы диагностики для экземпляра службы с целью мониторинга его доступности, производительности и других данных.

Эти функции мониторинга помогут оценить общую работоспособность службы Azure Digital Twins и ресурсов, подключенных к нему. Их можно использовать, чтобы понять, что происходит в экземпляре Azure Digital Twins, и проанализировать первопричины проблем, не обращаясь в поддержку Azure.

К ним можно получить доступ из портала Azure, сгруппированные под заголовком Мониторинг для ресурса Azure Digital Twins.

Оповещения и метрики

Общие сведения о просмотре метрик ресурсов Azure см. в статье "Начало работы с обозревателем метрик" в документации по Azure Monitor. Общие сведения о настройке оповещений для метрик Azure см. в статье "Создание нового правила генерации оповещений".

В остальной части этого раздела описываются метрики, отслеживаемые каждым экземпляром Azure Digital Twins, и как каждая метрика связана с общим состоянием экземпляра.

Метрики для отслеживания лимитов службы

Вы можете настроить эти метрики, чтобы контролировать, когда приближается опубликованное ограничение на использование службы для какого-либо аспекта вашего решения.

Чтобы настроить отслеживание, используйте функцию оповещения в Azure Monitor. Вы можете определить пороговые значения для этих метрик, чтобы получать оповещения каждый раз, когда метрика достигает определенного процента от его опубликованного ограничения.

Метрики запросов API

Метрики, относящиеся к запросам API:

Метрики выставления счетов

Метрики, относящиеся к выставлению счетов:

Дополнительные сведения о том, как выставляются счета за использование Azure Digital Twins, см. в статье Цены на службу Azure Digital Twins.

Метрики входящих данных

Метрики, относящиеся ко входным данным:

Метрики массовых операций (из API для заданий)

Метрики, связанные с массовыми операциями из API заданий:

Метрики маршрутизации

Метрики, относящиеся к маршрутизации:

Метрические размеры

Измерения помогают определить дополнительные сведения о метриках. Некоторые метрики маршрутизации предоставляют сведения для каждой конечной точки. В таблице ниже перечислены возможные значения для этих измерений.

Журналы диагностики

Общую информацию о параметрах диагностики Azure, включая способы их включения, см. в разделе "Параметры диагностики в Azure Monitor". Сведения о запросе журналов диагностики с помощью Log Analytics см. в разделе "Обзор Log Analytics" в Azure Monitor.

В остальной части этого раздела описываются категории журналов диагностики, которые Azure Digital Twins могут собирать, и их схемы.

Категории логов

Ниже приведены подробные сведения о категориях журналов, собираемых Azure Digital Twins.

Каждая категория журнала состоит из операций "write" (запись), "read" (чтение), "delete" (удаление) и "action" (действие). Эти категории сопоставляются с вызовами REST API следующим образом:

Ниже приведен полный список операций и соответствующих вызовов REST API Azure Digital Twins REST API calls, которые регистрируются в каждой категории.

Схемы журналов

Для каждой категории логов существует схема, определяющая, как фиксируются события в этой категории. Каждая отдельная запись журнала хранится как текст, а также в формате большого двоичного объекта JSON. Ниже для каждого типа журнала представлены поля в журнале и примеры тела JSON.

ADTDigitalTwinsOperation, ADTModelsOperation и ADTQueryOperation используют согласованную схему журналов API. ADTEventRoutesOperation расширяет схему, добавляя поле endpointName в свойства.

Схемы журналов API

Эта схема журнала является согласованной для ADTDigitalTwinsOperation, ADTModelsOperation, ADTQueryOperation. Эта же схема также используется для ADTEventRoutesOperation, за исключением имени операции Microsoft.DigitalTwins/eventroutes/action (дополнительные сведения о данной схеме вы найдете в следующем разделе: Схемы Журналов Исходящего Трафика).

Схема содержит сведения, относящиеся к вызовам API для экземпляра Azure Digital Twins.

Ниже приведены описания полей и свойств для журналов 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"
  }
}

ОперацияМаршрутизацииСобытийADT

Вот пример текстового тела JSON для ADTEventRoutesOperation, который не является типа Microsoft.DigitalTwins/eventroutes/action (дополнительные сведения об этой схеме см. в следующем разделе: схемы журналов исходящего трафика).

  {
    "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"
    }
  },

Схемы журналов исходящего трафика

В следующем примере представлена схема для журналов ADTEventRoutesOperation, характерных для имени операции Microsoft.DigitalTwins/eventroutes/action. Они содержат подробные сведения об исключениях и операциях API, связанных с исходящими конечными точками, подключенными к экземпляру Azure Digital Twins.

Ниже приведен пример тела JSON для ADTEventRoutesOperation, принадлежащего к типу Microsoft.DigitalTwins/eventroutes/action.

{
  "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.