Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Службы коммуникации Azure предоставляют возможности ведения журналов, которые можно использовать для мониторинга и отладки решения Служб коммуникации. Эти возможности можно настроить с помощью портал Azure.
Необходимые компоненты
Службы коммуникации Azure предоставляет функции мониторинга и аналитики с помощью Журналы Azure Monitor и метрики Azure Monitor. Для каждого ресурса Azure требуется собственный параметр диагностики, который определяет следующие критерии:
Категории данных журналов и метрик, отправленных в места назначения, которые определяет параметр. Доступные категории зависят от типа ресурса.
здесь указываются одно или несколько назначений для отправки журналов. Текущие назначения включают рабочую область Log Analytics, Центры событий Azure и служба хранилища Azure.
Один параметр диагностики может определять не более одного типа назначения. Если вы хотите отправить данные нескольким типам назначения (например, двум рабочим областям Log Analytics), создайте несколько параметров. Каждый ресурс может иметь до пяти параметров диагностики.
Внимание
Необходимо включить параметр диагностики в Azure Monitor для отправки данных журнала опросов в рабочую область Log Analytics, концентратор событий или учетную запись хранения Azure для получения и анализа данных опроса. Если вы не отправляете данные службы автоматизации вызовов в один из этих вариантов, данные опроса не будут храниться и будут потеряны.
Ниже приведены инструкции по настройке ресурса Azure Monitor для создания журналов и метрик для экземпляра Служб коммуникации. Подробные сведения об использовании параметров диагностики во всех ресурсах Azure см. в статье "Включение ведения журнала в параметрах диагностики".
В разделе имени параметра диагностики выберите следующее, чтобы включить журналы для автоматизации вызовов:
- Журналы автоматизации операций вызова
- Сводные журналы событий службы автоматизации вызовов
- Журналы данных использования функций потоковой передачи мультимедиа для автоматизации вызовов
Категории журналов ресурсов
Службы коммуникации предоставляют следующие типы журналов, которые можно включить:
- Журналы использования: предоставьте данные об использовании, связанные с каждым выставленным предложением службы.
- Журналы операций автоматизации вызовов: укажите оперативную информацию о запросах API автоматизации вызовов. Эти журналы можно использовать для идентификации точек сбоя и запроса всех запросов, выполненных в вызове (с помощью идентификатора корреляции или идентификатора вызова сервера).
- Сводные журналы мультимедиа службы автоматизации вызовов: укажите сведения о результатах операций мультимедиа. Эти журналы приходят к вам асинхронно при выполнении запросов мультимедиа с помощью API автоматизации вызовов. Эти журналы можно использовать для выявления точек сбоя и возможных шаблонов взаимодействия пользователей с приложением.
- Журналы сведений об использовании функций потоковой передачи мультимедиа службы автоматизации вызовов. Укажите сведения об использовании функций потоковой передачи в режиме реального времени, таких как потоковая передача мультимедиа и транскрибирование. Эти логи поступают к вам асинхронно, когда передача потокового видео в реальном времени остановлена или завершена. Эти журналы можно использовать для идентификации вызовов с поддержкой потоковой передачи в режиме реального времени, участников потоковой передачи в несмешанных случаях потоковой передачи, времени начала потоковой передачи, длительности и возможных тенденций потоковой передачи, используемых в приложении.
Схема журнала использования
| Свойство | Описание |
|---|---|
Timestamp |
Метка времени (UTC) о том, когда был создан журнал. |
OperationName |
Операция, связанная с записью журнала. |
OperationVersion |
Значение api-version , связанное с операцией, если OperationName операция была выполнена через API. Если API не соответствует этой операции, версия представляет версию операции, если свойства, связанные с операцией, изменяются в будущем. |
Category |
Категория журнала для события. Категория — это степень детализации, при которой можно включить или отключить журналы в ресурсе. Свойства, отображаемые в большом двоичном объекте события, совпадают с properties категорией журнала и типом ресурса. |
CorrelationID |
Идентификатор для коррелированных событий. Его можно использовать для выявления коррелированных событий между несколькими таблицами. |
Properties |
Другие данные, применимые к различным режимам служб коммуникации. |
RecordID |
Уникальный идентификатор записи об использовании. |
UsageType |
Режим использования (например, чат, ТСОП или NAT). |
UnitType |
Тип единицы использования основан на режиме использования (например, минутах, мегабайтах или сообщениях). |
Quantity |
Количество единиц, использованных или потребленных для данной записи. |
Операционные журналы службы автоматизации вызовов
| Свойство | Описание |
|---|---|
TimeGenerated |
Метка времени (UTC) о том, когда был создан журнал. |
OperationName |
Операция, связанная с записью журнала. |
CorrelationID |
Идентификатор, используемый для сопоставления событий для вызова. Этот идентификатор может измениться в течение длительности вызова в зависимости от событий, таких как присоединение участников или выход из нее. Для полностью стабильного идентификатора вызова рекомендуется использовать CallConnectionId. |
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, используемый для запроса. |
SubOperationName |
Имя, используемое для идентификации подтипа операции мультимедиа (воспроизведение или распознавание). |
operationID |
Идентификатор, используемый для сопоставления асинхронных событий. |
Ниже приведен пример операционного журнала службы автоматизации вызовов:
{
"TimeGenerated [UTC]": "5/25/2023, 5:43:25.746 PM",
"Level": "Informational",
"CorrelationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
"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",
}
Сводные журналы мультимедиа службы автоматизации вызовов
| Свойство | Описание |
|---|---|
TimeGenerated |
Метка времени (UTC) события. |
level |
Уровень серьезности события. Оно должно быть одним из Informational, WarningErrorили Critical. |
resourceId |
Идентификатор ресурса, создавшего событие. |
durationMs |
Время выполнения операции в миллисекундах. |
callerIpAddress |
|
correlationId |
Определите коррелированные запросы, сделанные с помощью службы автоматизации вызовов. |
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": "bbbb1111-cc22-3333-44dd-555555eeeeee",
"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."
}
Журналы сведений об использовании функций потоковой передачи мультимедиа для автоматизации звонков
| Свойство | Описание |
|---|---|
TimeGenerated |
Метка времени (UTC) события. |
CorrelationId |
Определите коррелированные запросы, сделанные с помощью службы автоматизации вызовов. |
CallConnectionId |
Идентификатор, представляющий подключение к вызову, если оно доступно. Этот идентификатор отличается для каждого участника и используется для идентификации подключения к вызову. |
StreamingModality |
Тип потоковой передачи в режиме реального времени (например, AudioStreamingUnmixed, AudioStreamingMixed, Транскрибирование), представляемого этим событием. |
StreamingStartTime |
Метка времени (UTC), с которой запущен сеанс потоковой передачи в режиме реального времени. |
StreamingDurationInMs |
Длительность сеанса потоковой передачи в реальном времени в миллисекундах. |
StreamingSessionId |
Уникальный идентификатор для каждого сеанса потоковой передачи в режиме реального времени, который определяется как время между началом и окончанием единой модальности потоковой передачи в режиме реального времени в любой заданной временной рамке. |
ParticipantId |
Уникальный идентификатор для каждого участника, который присутствовал в сеансе потоковой передачи, обозначенном StreamingSessionId, начавшемся в StreamingStartTime и продолжительностью StreamingDurationInMs. Это относится только к StreamingModality AudioStreamingUnmixed и транскрипции, где каждый участник представлен собственной записью в этой таблице. |
Вот пример информации об использовании функций потоковой передачи мультимедиа в службе автоматизации вызовов в журналах:
{
"TimeGenerated [UTC]": "5/24/2023, 7:57:40.480 PM",
"CorrelationId": "bbbb1111-cc22-3333-44dd-555555eeeeee",
"CallConnectionId": "401f3500-fcb6-4b84-927e-81cd6372560b",
"StreamingModality": "AudioStreamingUnmixed",
"StreamingStartTime [UTC]": "5/24/2023, 7:57:45.480 PM",
"StreamingDurationInMs": "1172487.9394",
"StreamingSessionId": "8dc674eb-0313-46e1-8326-326ea71c7a45",
"ParticipantId": "7a5ae46f-efb0-4abb-bc9f-c1f1ccfd1470"
}
Следующие шаги
- Сведения о панели мониторинга аналитики для мониторинга журналов и метрик службы автоматизации вызовов.