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

Схема журнала сводки вызовов обновлений

  • Статья

Единственное различие в свойствах между схемой журнала сводки вызовов обновлений и схемой сводного журнала вызова является дополнительным CallUpdatesVersion свойством. Свойство CallUpdatesVersion указывает, как последнее значение журнала. Схема журнала сводки вызовов имеет меньшую задержку, чем схема сводного журнала вызова, она достигает этой низкой задержки путем отправки свойств схемы сразу после их отправки. В отличие от этого, схема сводного журнала вызова не отправляет схему журнала до тех пор, пока вся схема журнала не завершит внутреннее создание Майкрософт.

Журнал обновлений сводки вызовов содержит данные, которые помогут вам определить ключевые свойства всех вызовов. Для каждого participantId (или endpointId для одноранговых вызовов [P2P] в вызове создается другой журнал обновлений с сводным вызовом.

Для каждого участника в вызове службы коммуникации создают отдельный журнал обновлений сводки вызовов. Если кто-то повторно присоединит вызов, этот участник имеет то же EndpointId значение, но другое ParticipantId значение. После этого конечная точка может иметь два журнала сводных обновлений вызова.

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

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

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

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

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

Внимание

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

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

При использовании схемы журнала сводки обновлений вызовов всегда следует ссылаться на наибольшее CallUpdatesVersion число, чтобы убедиться, что у вас есть самые актуальные сведения. При обновлении данных вызова создается новая версия журнала, содержащая самые актуальные сведения. Например, чем выше CallUpdatesVersion число, тем более последнее обновление. Это означает, что версия 3 является более новой и включает более последние изменения по сравнению с версией 1.

Дополнительные сведения о версиях журналов и задержке данных

После завершения вызова исходная версия журнала (версия 1) отправляется в таблицы CallSummaryUpdates и CallDiagnosticUpdates. Начальные версии могут содержать null значения, если дополнительные сведения становятся доступными обновленными версиями журналов, создаются с более полной информацией. Например, данные клиента могут быть отложены из-за проблем с сетевым подключением между клиентским компьютером и нашими серверами, или что-то простое, как пользователь, закрывающий крышку на ноутбуке после вызова до отправки и повторного открытия его часов (или дней).

Из-за таких вариантов коллекции могут отображаться добавочные версии, поступающие часы или даже через несколько дней. Вы можете использовать версии для более быстрого понимания вызываемого ресурса, чем ожидание, пока не будут получены все вызывающие клиентские данные пакета SDK. Лучший сценарий — для всех участников вызовов, чтобы завершить их вызовы, и для того, чтобы вызывающий пакет SDK мог отправлять данные на сервер.

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

Схема журнала сводки вызовов обновлений

Внимание

Сведения о участниках в журнале обновлений сводки вызовов зависят от клиента участника. Версия пакета SDK и версия ОС редактируются, если участник не находится в одном клиенте (также называемом межтенантным) ресурсом служб коммуникации. Межтенантные участники классифицируются как внешние пользователи, приглашенные клиентом ресурсов для присоединения и совместной работы во время вызова.

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

Свойство Description
time Метка времени (UTC) при создании журнала.
operationName Операция, связанная с записью журнала.
operationVersion Значение api-version , связанное с операцией, если operationName операция была выполнена через API. Если API не соответствует этой операции, версия представляет версию операции, если свойства, связанные с операцией, изменяются в будущем.
category Категория журнала для события. Это свойство является степенью детализации, при которой можно включить или отключить журналы в ресурсе. Свойства, отображаемые в большом двоичном объекте события, совпадают с properties категорией журнала и типом ресурса.
correlationId Уникальный идентификатор для вызова. Он определяет коррелированные события от всех участников и конечных точек, которые подключаются во время одного вызова, и его можно использовать для присоединения данных из разных журналов. Если вам когда-либо нужно открыть вариант поддержки с корпорацией Майкрософт, можно использовать correlationId значение, чтобы легко определить вызов, который вы устраняете.
identifier Уникальный идентификатор пользователя. Удостоверение может быть Службы коммуникации Azure пользователем, идентификатором пользователя Microsoft Entra, анонимным идентификатором пользователя Teams или идентификатором бота Teams. Этот идентификатор можно использовать для сопоставления событий пользователей в журналах.
callStartTime Метка времени для начала вызова на основе первого попытки подключения из любой конечной точки.
callDuration Длительность вызова, выраженная в секундах, на основе первого попытки подключения и конца последнего подключения между двумя конечными точками.
callType Тип вызова. Он содержит либо "P2P""Group". Вызов "P2P" — это прямое подключение 1:1 между двумя несерверными конечными точками. Вызов "Group" — это вызов, имеющий более двух конечных точек или созданный в качестве "Group" вызова перед подключением.
teamsThreadId Идентификатор потока Teams. Этот идентификатор имеет значение только в том случае, если звонок организован как собрание Teams. Затем он представляет вариант взаимодействия между Microsoft Teams и Службы коммуникации Azure.

Этот идентификатор указывается в журналах операций. Этот идентификатор также можно получить с помощью API-интерфейсов чата.
participantId Идентификатор, созданный для представления двустороннего подключения между конечной "Participant" точкой (endpointType = "Server") и сервером. При callType = "P2P"наличии прямого подключения между двумя конечными точками и не participantId создается никакого значения.
participantStartTime Метка времени начала первой попытки подключения участника.
participantDuration Длительность подключения каждого участника в секундах от participantStartTime метки времени до окончания соединения.
participantEndReason Причина окончания подключения участника. Он содержит коды ошибок пакета SDK для вызова, которые пакет SDK выдает (при необходимости) для каждого participantId значения.
endpointId Уникальный идентификатор, представляющий каждую конечную точку, подключенную к вызову, где endpointType определяет тип конечной точки. Если значение равно null, подключенная сущность — сервер служб коммуникации (endpointType = "Server").

Иногда endpointId значение может сохраняться для одного пользователя в нескольких вызовах (correlationId) для собственных клиентов. Количество значений endpointId определяет количество журналов сводки вызовов. Для каждого endpointId значения создается отдельный журнал сводки.
endpointType Это значение описывает свойства каждой конечной точки, подключенной к вызову. Он может содержать "Server", , "PSTN""VOIP""BOT""Unknown"или .
sdkVersion Строка версии пакета SDK для вызовов служб коммуникации, которая использует каждую соответствующую конечную точку (например, "1.1.00.20212500").
osVersion Строка, представляющая операционную систему и версию каждого устройства конечной точки.
participantTenantId Идентификатор клиента Майкрософт, связанного с удостоверением участника. Клиент может быть клиентом Azure, который владеет ресурсом Службы коммуникации Azure или клиентом Майкрософт удостоверения Microsoft 365. Это поле используется для руководства по редактированию между клиентами.
participantType Описание участника в качестве сочетания клиента (Службы коммуникации Azure или Teams) и его удостоверения (Службы коммуникации Azure или Microsoft 365). Возможные значения: Службы коммуникации Azure (удостоверение Службы коммуникации Azure и пакет SDK Службы коммуникации Azure), Teams (удостоверение Teams и клиент Teams); Службы коммуникации Azure как внешний пользователь Teams (удостоверение Службы коммуникации Azure и пакет SDK Службы коммуникации Azure в вызовах или собрании Teams), Службы коммуникации Azure как пользователь Microsoft 365 (удостоверение Microsoft 365 и клиент Службы коммуникации Azure) и приложения Голосовой связи Teams.
pstnParticipantCallType Представляет тип и направление участников ТСОП, включая экстренные вызовы, прямую маршрутизацию, передачу, пересылку и т. д.
ParticipantEndSubCode Представляет подкод ошибки пакета SDK для вызовов, который пакет SDK выдает (при необходимости) для каждого participantId значения.
ResultCategory Представляет категорию участника, завершающего вызов. Это может быть одно из следующих 4 значений: Success, ExpectedError, UnexpectedClientError, UnexpectedServerError.
DiagnosticOptions Это значение позволяет разработчикам присоединять пользовательские теги к телеметрии клиента, которые затем можно просмотреть в разделе диагностики вызовов. Это помогает более эффективно выявлять и устранять проблемы. Сведения о добавлении пользовательских тегов в это значение см . в руководстве по добавлению пользовательских тегов в данные телеметрии клиента.
CallUpdatesVersion Представляет версию журнала с более высокими числами, указывающими самую последнюю опубликованную версию.

Коды ошибок

Свойство participantEndReason содержит значение из набора кодов ошибок пакета SDK для вызовов. Эти коды можно использовать для устранения неполадок, обнаруженных во время вызова, для каждой конечной точки. См. сведения об устранении неполадок с кодами ответов на вызовы для пакета SDK для вызовов, пакета SDK службы автоматизации вызовов, ТСОП, пакета SDK чата и ПАКЕТА SDK SMS.

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

Примечание.

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

Вызов P2P

Ниже приведены общие поля для всех журналов в вызове P2P:

"time":                     "2021-07-19T18:46:50.188Z",
"resourceId":               "SUBSCRIPTIONS/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/RESOURCEGROUPS/ACS-TEST-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-PROD-CCTS-TESTS",
"correlationId":            "aaaa0000-bb11-2222-33cc-444444dddddd",

Журналы обновлений сводки вызовов

Вызов сводных обновлений журналов общего доступа и сведений о категориях:

"operationName":            "CallSummary",
"operationVersion":         "1.0",
"category":                 "CallSummary",

Ниже приведена сводка по вызову для пользователя VoIP 1:

"properties": {
    "identifier":               "acs:61fddbe3-0003-4066-97bc-6aaf143bbb84_0000000b-4fee-66cf-ac00-343a0d003158",
    "callStartTime":            "2021-07-19T17:54:05.113Z",
    "callDuration":             6,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",    
    "participantStartTime":     "2021-07-19T17:54:06.758Z",
    "participantDuration":      "5",
    "participantEndReason":     "0",
    "endpointId":               "570ea078-74e9-4430-9c67-464ba1fa5859",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.1.0",
    "osVersion":                "Windows 10.0.17763 Arch: x64"
    "callupdatesversion":   "2"
}

Ниже приведена сводка по вызову для пользователя VoIP 2:

"properties": {
    "identifier":               "acs:7af14122-9ac7-4b81-80a8-4bf3582b42d0_06f9276d-8efe-4bdd-8c22-ebc5434903f0",
    "callStartTime":            "2021-07-19T17:54:05.335Z",
    "callDuration":             6,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",
    "participantStartTime":     "2021-07-19T17:54:06.335Z",
    "participantDuration":      "5",
    "participantEndReason":     "0",
    "endpointId":               "a5bd82f9-ac38-4f4a-a0fa-bb3467cdcc64",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.1.0.0",
    "osVersion":                "null"
    "callupdatesversion":   "2"
}

Ниже приведен журнал сводных обновлений вызовов для пользователя VoIP 1.

"properties": {
    "identifier":               "1e4c59e1-r1rr-49bc-893d-990dsds8f9f5",
    "callStartTime":            "2022-08-14T06:18:27.010Z",
    "callDuration":             520,
    "callType":                 "P2P",
    "teamsThreadId":            "null",
    "participantId":            "null",
    "participantTenantId":      "02cbdb3c-155a-4b95-b829-6d56a45787ca",
    "participantStartTime":     "2022-08-14T06:18:27.010Z",
    "participantDuration":      "520",
    "participantEndReason":     "0",
    "endpointId":               "02cbdb3c-155a-4d98-b829-aaaaa61d44ea",
    "endpointType":             "VoIP",
    "sdkVersion":               "Redacted",
    "osVersion":                "Redacted"
    "callupdatesversion":   "2"
}

Ниже приведена сводка по вызову ТСОП:

Примечание.

Журналы вызовов P2P или групповых вызовов имеют версии ОС и пакета SDK, редактируемые независимо от того, является ли он клиентом участника или клиентом бота.

"properties": {
    "identifier": "b1999c3e-bbbb-4650-9b23-9999bdabab47",
    "callStartTime": "2022-08-07T13:53:12Z",
    "callDuration": 1470,
    "callType": "Group",
    "teamsThreadId": "19:36ec5177126fff000aaa521670c804a3@thread.v2",
    "participantId": " b25cf111-73df-4e0a-a888-640000abe34d",
    "participantStartTime": "2022-08-07T13:56:45Z",
    "participantDuration": 960,
    "participantEndReason": "0",
    "endpointId": "8731d003-6c1e-4808-8159-effff000aaa2",
    "endpointType": "PSTN",
    "sdkVersion": "Redacted",
    "osVersion": "Redacted"
    "callupdatesversion":   "2"
}

Групповые вызовы

Данные для группового вызова создаются в трех журналах сводки вызовов и шести журналах вызовов диагностика журналов. Ниже приведены общие поля для всех журналов в вызове:

"time":                     "2021-07-05T06:30:06.402Z",
"resourceId":               "SUBSCRIPTIONS/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX/RESOURCEGROUPS/ACS-TEST-RG/PROVIDERS/MICROSOFT.COMMUNICATION/COMMUNICATIONSERVICES/ACS-PROD-CCTS-TESTS",
"correlationId":            "bbbb1111-cc22-3333-44dd-555555eeeeee",

Журналы обновлений сводки вызовов

Вызов сводных обновлений журналов общего доступа и сведений о категориях:

"operationName":            "CallSummary",
"operationVersion":         "1.0",
"category":                 "CallSummary",

Ниже приведена сводка по вызову для конечной точки VoIP 1:

"properties": {
    "identifier":               "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-729f-ac00-343a0d00d975",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "04cc26f5-a86d-481c-b9f9-7a40be4d6fba",
    "participantStartTime":     "2021-07-05T06:16:44.235Z",
    "participantDuration":      "82",
    "participantEndReason":     "0",
    "endpointId":               "5ebd55df-ffff-ffff-89e6-4f3f0453b1a6",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.0.3",
    "osVersion":                "Darwin Kernel Version 18.7.0: Mon Nov 9 15:07:15 PST 2020; root:xnu-4903.272.3~3/RELEASE_ARM64_S5L8960X"
    "callupdatesversion":   "2"
}

Ниже приведена сводка по вызову для конечной точки VoIP 3:

"properties": {
    "identifier":               "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-57c6-ac00-343a0d00d972",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLTk2ZDUtYTZlM2I2ZjgxOTkw@thread.v2",
    "participantId":            "1a9cb3d1-7898-4063-b3d2-26c1630ecf03",
    "participantStartTime":     "2021-07-05T06:16:40.240Z",
    "participantDuration":      "87",
    "participantEndReason":     "0",
    "endpointId":               "5ebd55df-ffff-ffff-ab89-19ff584890b7",
    "endpointType":             "VoIP",
    "sdkVersion":               "1.0.0.3",
    "osVersion":                "Android 11.0; Manufacturer: Google; Product: redfin; Model: Pixel 5; Hardware: redfin"
    "callupdatesversion":   "2"
}

Ниже приведена сводка по вызову для конечной точки ТСОП 2:

"properties": {
    "identifier":               "null",
    "callStartTime":            "2021-07-05T06:16:40.240Z",
    "callDuration":             87,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "515650f7-8204-4079-ac9d-d8f4bf07b04c",
    "participantStartTime":     "2021-07-05T06:17:10.447Z",
    "participantDuration":      "52",
    "participantEndReason":     "0",
    "endpointId":               "46387150-692a-47be-8c9d-1237efe6c48b",
    "endpointType":             "PSTN",
    "sdkVersion":               "null",
    "osVersion":                "null"
    "callupdatesversion":   "2"
}

Ниже приведен журнал обновлений сводки вызовов для нескольких клиентов:

"properties": {
    "identifier":               "1e4c59e1-r1rr-49bc-893d-990dsds8f9f5",
    "callStartTime":            "2022-08-14T06:18:27.010Z",
    "callDuration":             912,
    "callType":                 "Group",
    "teamsThreadId":            "19:meeting_MjZiOTAyN2YtZWU1Yi00ZTZiLT77777OOOOO99999jgxOTkw@thread.v2",
    "participantId":            "aa1dd7da-5922-4bb1-a4fa-e350a111fd9c",
    "participantTenantId":      "02cbdb3c-155a-4b95-b829-6d56a45787ca",
    "participantStartTime":     "2022-08-14T06:18:27.010Z",
    "participantDuration":      "902",
    "participantEndReason":     "0",
    "endpointId":               "02cbdb3c-155a-4d98-b829-aaaaa61d44ea",
    "endpointType":             "VoIP",
    "sdkVersion":               "Redacted",
    "osVersion":                "Redacted"
    "callupdatesversion":   "2"
}

Ниже приведен журнал сводных обновлений вызовов между клиентами с ботом в качестве участника:


"properties": {
    "identifier":             "b1902c3e-b9f7-4650-9b23-9999bdabab47",
    "callStartTime":          "2022-08-09T16:00:32Z",
    "callDuration":            1470,
    "callType":               "Group",
    "teamsThreadId":         "19:meeting_MmQwZDcwYTQtZ000HWE6NzI4LTg1YTAtNXXXXX99999ZZZZZ@thread.v2",
    "participantId":           "66e9d9a7-a434-4663-d91d-fb1ea73ff31e",
    "participantStartTime":    "2022-08-09T16:14:18Z",
    "participantDuration":      644,
    "participantEndReason":    "0",
    "endpointId":             "69680ec2-5ac0-4a3c-9574-eaaa77720b82",
    "endpointType":           "Bot",
    "sdkVersion":             "Redacted",
    "osVersion":              "Redacted"
    "callupdatesversion":   "2"
}

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

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

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

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

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

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

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

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

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