Поделиться через

Схема журнала операций вызова клиента

  • Статья

Журнал операций клиента вызова предоставляет клиентские сведения о конечных точках вызова и участниках, участвующих в вызове. Эти журналы в настоящее время находятся в предварительной версии и отображают события клиента, которые произошли в вызове и какие действия выполняет клиент во время звонка.

Этот журнал содержит подробные сведения о действиях, выполняемых во время вызова, и может использоваться для визуализации и изучения проблем с вызовами с помощью диагностики вызовов для ресурса Службы коммуникации Azure. Дополнительные сведения о вызове диагностика

Использование журналов вызовов

Мы рекомендуем собирать все доступные журналы вызовов в ресурсе log analytics, чтобы отслеживать использование звонков и улучшать качество звонков и получать новые журналы из Службы коммуникации Azure по мере их выпуска.

Существует два основных инструмента, которые можно использовать для мониторинга звонков и улучшения качества звонков.

Мы рекомендуем использовать панели мониторинга мониторинга голосовой и видеоанализатора для запуска любых исследований качества и использования вызовов диагностика по мере необходимости для изучения отдельных вызовов при необходимости детализации.

Основные понятия данных

Внимание

Если вы хотите проанализировать их, необходимо собрать журналы. Дополнительные сведения см. в статье Разделы справки журналы хранения?

Azure не хранит данные журнала вызовов, если вы не включите эти параметры диагностики. Данные вызова не доступны ретроактивно. После создания параметров диагностики накапливаются данные.

Определения данных

Схема журнала операций вызова клиента

В этой таблице описано каждое свойство.

Свойство Description
CallClientTimeStamp Метка времени выполнения операции в пакете SDK в формате UTC.
OperationName Имя операции, активироваемой в вызывающем пакете SDK.
CallId Уникальный идентификатор для вызова. Он определяет коррелированные события от всех участников и конечных точек, которые подключаются во время одного вызова, и его можно использовать для присоединения данных из разных журналов. Он аналогичен корреляции в журнале сводки вызовов и вызове журнала диагностика.
ParticipantId Уникальный идентификатор для каждого этапа вызова (в групповых вызовах) или участника вызова (в одноранговых вызовах). Этот идентификатор является основной точкой корреляции между журналами CallSummary, CallDiagnostic, CallClientOperations и CallClientMediaStats.
OperationType Вызов операции клиента.
OperationId Уникальный GGUID, определяющий операцию пакета SDK.
DurationMs Время, необходимое для операции пакета SDK для вызова, чтобы завершиться ошибкой или успешной.
ResultType Поле, описывающее успешное или неудачное выполнение операции.
ResultSignature Сбой или код успешного выполнения HTTP (200, 500).
SdkVersion Используемая версия пакета SDK для вызовов.
UserAgent Используется строка стандартного агента пользователя на основе браузера или пакета SDK для вызова платформы.
ClientInstanceId Уникальный GGUID, определяющий объект CallClient.
EndpointId Уникальный идентификатор, представляющий каждую конечную точку, подключенную к вызову, где endpointType определяет тип конечной точки. Если значение равно NULL, подключенная сущность является сервером служб коммуникации (endpointType = "Сервер").

Значение endpointId иногда может сохраняться для одного пользователя в нескольких вызовах (correlationId) для собственных клиентов. Количество значений endpointId определяет количество журналов сводки вызовов. Для каждого значения endpointId создается отдельный журнал сводки.
OperationPayload Динамическая полезная нагрузка, которая зависит от операции, предоставляющей дополнительные сведения об операции.

Примеры данных для различных типов вызовов

Журнал операций вызова клиента

Ниже приведен журнал операций клиента вызова для операции CreateView:

"properties": {
    "TenantId":               "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "TimeGenerated":          "2024-01-09T17:06:50.3Z",
    "CallClientTimeStamp":    "2024-01-09T15:07:56.066Z",
    "OperationName":          "CreateView" ,   
    "CallId":                 "92d800c4-abde-40be-91e9-3814ee786b19",
    "ParticipantId":          "2656fd6c-6d4a-451d-a1a5-ce1baefc4d5c",
    "OperationType":          "client-api-request",
    "OperationId":            "0d987336-37e0-4acc-aba3-e48741d88103",
    "DurationMs":             "577",
    "ResultType":             "Succeeded",
    "ResultSignature":        "200",
    "SdkVersion":             "1.19.2.2_beta",
    "UserAgent":              "azure-communication-services/1.3.1-beta.1 azsdk-js-communication-calling/1.19.2-beta.2 (javascript_calling_sdk;#clientTag:904f667c-5f25-4729-9ee8-6968b0eaa40b). Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
    "ClientInstanceId":       "d08a3d05-db90-415f-88a7-87ae74edc1dd",
    "OperationPayload":       "{"StreamType":"Video","StreamId":"2.0","Source":"remote","RemoteParticipantId":"remote"}",
    "Type":                   "ACSCallClientOperations"
}

Каждый участник может иметь множество различных метрик для вызова. Вы можете выполнить следующий запрос в Log Analytics в портал Azure, чтобы перечислить все возможные операции в журнале операций клиента вызова:

ACSCallClientOperations | distinct OperationName

Часто задаваемые вопросы

Разделы справки хранить журналы?

В следующем разделе объясняется это требование.

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

Данные не хранятся ретроактивно, поэтому вы начинаете записывать журналы вызовов только после настройки параметра диагностики.

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

Плата за объем данных, хранение и использование в Log Analytics в Azure Monitor взимается с помощью существующих счетчиков данных Azure. Рекомендуется отслеживать использование данных и политики хранения по мере необходимости. Дополнительные сведения см. в разделе "Управление затратами".

Если у вас несколько идентификаторов ресурсов Служб коммуникации Azure, необходимо включить эти параметры для каждого идентификатора ресурса.

Следующие шаги