журналы автоматизации вызовов Службы коммуникации Azure
Службы коммуникации Azure предоставляют возможности ведения журналов, которые можно использовать для мониторинга и отладки решения Служб коммуникации. Эти возможности можно настроить с помощью портал Azure.
Необходимые компоненты
Службы коммуникации Azure предоставляет функции мониторинга и аналитики с помощью Журналы Azure Monitor и метрики Azure Monitor. Для каждого ресурса Azure требуется собственный параметр диагностики, который определяет следующие критерии:
Категории данных журналов и метрик, отправленных в места назначения, которые определяет параметр. Доступные категории зависят от типа ресурса.
здесь указываются одно или несколько назначений для отправки журналов. Текущие назначения включают рабочую область Log Analytics, Центры событий Azure и служба хранилища Azure.
Один параметр диагностики может определять не более одного типа назначения. Если вы хотите отправить данные нескольким типам назначения (например, двум рабочим областям Log Analytics), создайте несколько параметров. Каждый ресурс может иметь до пяти параметров диагностики.
Важно!
Необходимо включить параметр диагностики в Azure Monitor для отправки данных журнала опросов в рабочую область Log Analytics, концентратор событий или учетную запись хранения Azure для получения и анализа данных опроса. Если вы не отправляете данные службы автоматизации вызовов в один из этих вариантов, данные опроса не будут храниться и будут потеряны.
Ниже приведены инструкции по настройке ресурса Azure Monitor для создания журналов и метрик для экземпляра Служб коммуникации. Подробные сведения об использовании параметров диагностики во всех ресурсах Azure см. в статье "Включение ведения журнала в параметрах диагностики".
В разделе имени параметра диагностики выберите журналы автоматизации вызовов операций и сводные журналы событий службы автоматизации вызовов, чтобы включить журналы для автоматизации вызовов.
Категории журналов ресурсов
Службы коммуникации предоставляют следующие типы журналов, которые можно включить:
- Журналы использования: предоставьте данные об использовании, связанные с каждым выставленным предложением службы.
- Журналы операций автоматизации вызовов: укажите оперативную информацию о запросах API автоматизации вызовов. Эти журналы можно использовать для идентификации точек сбоя и запроса всех запросов, выполненных в вызове (с помощью идентификатора корреляции или идентификатора вызова сервера).
- Сводные журналы мультимедиа службы автоматизации вызовов: укажите сведения о результатах операций мультимедиа. Эти журналы приходят к вам асинхронно при выполнении запросов мультимедиа с помощью API автоматизации вызовов. Эти журналы можно использовать для выявления точек сбоя и возможных шаблонов взаимодействия пользователей с приложением.
Схема журнала использования
| Свойство | Description |
|---|---|
Timestamp |
Метка времени (UTC) о том, когда был создан журнал. |
OperationName |
Операция, связанная с записью журнала. |
OperationVersion |
Значение api-version , связанное с операцией, если OperationName операция была выполнена через API. Если API не соответствует этой операции, версия представляет версию операции, если свойства, связанные с операцией, изменяются в будущем. |
Category |
Категория журнала для события. Категория — это степень детализации, при которой можно включить или отключить журналы в ресурсе. Свойства, отображаемые в большом двоичном объекте события, совпадают с properties категорией журнала и типом ресурса. |
CorrelationID |
Идентификатор для коррелированных событий. Его можно использовать для выявления коррелированных событий между несколькими таблицами. |
Properties |
Другие данные, применимые к различным режимам служб коммуникации. |
RecordID |
Уникальный идентификатор записи об использовании. |
UsageType |
Режим использования (например, чат, ТСОП или NAT). |
UnitType |
Тип единицы использования основан на режиме использования (например, минутах, мегабайтах или сообщениях). |
Quantity |
Количество единиц, использованных или потребленных для данной записи. |
Операционные журналы службы автоматизации вызовов
| Свойство | Description |
|---|---|
TimeGenerated |
Метка времени (UTC) о том, когда был создан журнал. |
OperationName |
Операция, связанная с записью журнала. |
CorrelationID |
Идентификатор для идентификации вызова и сопоставления событий для уникального вызова. |
OperationVersion |
Версия, связанная api-version с операцией, если operationName операция была выполнена через API. Если API не соответствует этой операции, версия представляет версию операции, если свойства, связанные с операцией, изменяются в будущем. |
Category |
Категория журнала для события. Категория — это степень детализации, при которой можно включить или отключить журналы в ресурсе. Свойства, отображаемые в большом двоичном объекте события, совпадают с properties категорией журнала и типом ресурса. |
ResultType |
Состояние операции. |
ResultSignature |
Подстатус операции. Если эта операция соответствует вызову REST API, то это поле содержит код состояния HTTP соответствующего вызова REST. |
DurationMs |
Время выполнения операции в миллисекундах. |
CallerIpAddress |
IP-адрес вызывающего объекта, если операция соответствует вызову API, который поступает из сущности с общедоступным IP-адресом. |
Level |
Уровень серьезности события. |
URI |
URI-адрес запроса. |
CallConnectionId |
Идентификатор, представляющий подключение к вызову, если оно доступно. Этот идентификатор отличается для каждого участника и используется для идентификации подключения к вызову. |
ServerCallId |
Уникальный идентификатор для идентификации вызова. |
SDKVersion |
Версия пакета SDK, используемая для запроса. |
SDKType |
Тип пакета SDK, используемый для запроса. |
ParticipantId |
Идентификатор для идентификации участника вызова, который сделал запрос. |
SubOperationName |
Имя, используемое для идентификации подтипа операции мультимедиа (воспроизведение или распознавание). |
operationID |
Идентификатор, используемый для сопоставления асинхронных событий. |
Ниже приведен пример операционного журнала службы автоматизации вызовов:
[
{
"TimeGenerated [UTC]": "5/25/2023, 5:43:25.746 PM",
"Level": "Informational",
"CorrelationId": "e2a97d52-0cbb-4adf-8c4b-e10f791fb764",
"OperationName": "Play",
"OperationVersion": "3/6/23",
"URI": "ccts-media-synthetics-prod.communication.azure.com",
"ResultType": "Succeeded",
"ResultSignature": "202",
"DurationMs": "82",
"CallerIpAddress": "40.88.50.228",
"CallConnectionId": "401f3500-fcb6-4b84-927e-81cd6372560b",
"ServerCallId": "aHR0cHM6Ly9hcGkuZmxpZ2h0cHJveHkuc2t5cGUuY29tL2FwaS92Mi9jcC9jb252LXVzZWEyLTAxLmNvbnYuc2t5cGUuY29tL2NvbnYvZzRoWlVoS1ZEVUtma19HenRDZ1JTQT9pPTEyJmU9NjM4MjA1NDc4MDg5MzEzMjIz",
"SdkVersion": "",
"SdkType": "unknown",
"SubOperationName": "File",
"OperationId": "5fab0875-3211-4879-8051-c688d0854c4d",
}
Сводные журналы мультимедиа службы автоматизации вызовов
| Свойство | Description |
|---|---|
TimeGenerated |
Метка времени (UTC) события. |
level |
Уровень серьезности события. Оно должно быть одним из Informational, WarningErrorили Critical. |
resourceId |
Идентификатор ресурса, создавшего событие. |
durationMs |
Время выполнения операции в миллисекундах. |
callerIpAddress |
|
correlationId |
Идентификатор цепочки Skype. |
operationName |
Имя операции, которую представляет это событие. |
operationVersion |
|
resultType |
Состояние события. Типичные значения включают Completed, Canceledи Failed. |
resultSignature |
Подстатус операции. Если эта операция соответствует вызову REST API, то это поле содержит код состояния HTTP соответствующего вызова REST. |
operationId |
Идентификатор операции, используемый для сопоставления асинхронных событий. |
recognizePromptSubOperationName |
Подтип операции. Возможные значения: File, TextToSpeechи SSML. |
playInLoop |
True Если цикл был запрошен для операции воспроизведения. False Значение ,если в противном случае. |
playToParticipant |
True Если у операции воспроизведения был целевой объект. False Если это была операция "играть ко всем". |
interrupted |
True Если запрос прерван. False Значение ,если в противном случае. |
resultCode |
Код результата операции. |
resultSubcode |
Подкод результата операции. |
resultMessage |
Сообщение о результатах операции. |
Ниже приведен пример сводного журнала мультимедиа службы автоматизации вызовов:
[
{
"TimeGenerated [UTC]": "5/24/2023, 7:57:40.480 PM",
"Level": "Informational",
"CorrelationId": "d149d528-a392-404c-8fcd-69087e9d0802",
"ResultType": "Completed",
"OperationName": "Play",
"OperationId": "7bef24d5-eb95-4ee6-bbab-0b7d45d91288",
"PlayInLoop": "FALSE",
"PlayToParticipant": "TRUE",
"PlayInterrupted": "FALSE",
"RecognizePromptSubOperationName": "",
"ResultCode": "200",
"ResultSubcode": "0",
"ResultMessage": "Action completed successfully."
}
Следующие шаги
- Сведения о панели мониторинга аналитики для мониторинга журналов и метрик службы автоматизации вызовов.