Schemat dziennika aktualizacji podsumowania wywołań

Jedyną różnicą we właściwościach między schematem dziennika podsumowania wywołań i schematem dziennika podsumowania wywołań jest dodatkowa CallUpdatesVersion właściwość. Właściwość CallUpdatesVersion wskazuje, jak świeży jest dziennik. Schemat dziennika aktualizacji podsumowania wywołań ma mniejsze opóźnienie niż schemat dziennika podsumowania wywołań, osiąga to małe opóźnienie, wysyłając właściwości schematu tak szybko, jak to możliwe. W przeciwieństwie do tego, schemat dziennika podsumowania połączeń nie jest wysyłany, dopóki cały dziennik nie zostanie ukończony przez wewnętrzne procesy Microsoft.

Dziennik aktualizacji podsumowania wywołań zawiera dane ułatwiające zidentyfikowanie kluczowych właściwości wszystkich wywołań. W wywołaniu tworzony jest osobny dziennik aktualizacji podsumowania wywołań dla każdej wartości participantId (lub endpointId dla wywołań równorzędnych [P2P]).

Dla każdego uczestnika połączenia, usługa Communication Services tworzy odrębny dziennik aktualizacji podsumowania połączeń. Jeśli ktoś ponownie dołączy do połączenia, uczestnik ma tę samą EndpointId wartość, ale inną ParticipantId wartość. Ten punkt końcowy może mieć dwa dzienniki aktualizacji podsumowań wywołań.

Jak używać dzienników wywołań

Zalecamy zebranie wszystkich dostępnych dzienników wywołań w zasobie analizy dzienników, aby móc monitorować użycie i poprawić jakość połączeń, a także otrzymywać nowe dzienniki z usług Azure Communication Services w miarę ich wydawania.

Istnieją dwa główne narzędzia, których można użyć do monitorowania połączeń i poprawy jakości połączeń.

• Panel analizy głosu i wideo
• Diagnostyka połączeń

Zalecamy korzystanie z pulpitów nawigacyjnych informacji o głosie i wideo, aby rozpocząć badania jakości, oraz używanie diagnostyki połączeń, kiedy jest to wymagane, aby analizować poszczególne połączenia, gdy potrzebujesz szczegółowych informacji.

Pojęcia dotyczące danych

W przypadku używania schematu dziennika aktualizacji podsumowania wywołań należy zawsze odwoływać się do najwyższej CallUpdatesVersion liczby, aby mieć pewność, że masz najbardziej aktualne informacje. Za każdym razem, gdy dane wywołania są aktualizowane, tworzona jest nowa wersja dziennika zawierająca najbardziej aktualne informacje. Na przykład im większa CallUpdatesVersion liczba, im nowsza aktualizacja. Oznacza to, że wersja 3 jest nowsza i zawiera nowsze zmiany w porównaniu z wersją 1.

Więcej informacji na temat wersji dzienników i opóźnienia danych

Schemat dziennika aktualizacji podsumowania wywołań może wymagać około 60 minut po zakończeniu wywołania, aby dane zostały rozpropagowane. Większość dzienników może być dostępna w ciągu 40 minut.

Po zakończeniu wywołania początkowa wersja (wersja 1) dziennika jest wysyłana do tabel CallSummaryUpdates i CallDiagnosticUpdates. Wersje początkowe mogą zawierać null wartości. Jeśli dostępne stanie się więcej informacji, zostaną utworzone zaktualizowane wersje dzienników z bardziej kompletnymi informacjami. Na przykład dane klienta mogą być opóźnione z powodu problemów z łącznością sieciową między komputerem klienckim a naszymi serwerami, lub przez tak prozaiczne zdarzenie jak zamknięcie przez użytkownika pokrywy laptopa po zakończeniu rozmowy, zanim dane klienta zostały wysłane, i ponowne otwarcie go godzin (lub dni) później.

Ze względu na tego typu różnice w zbiorach, wersje przyrostowe mogą pojawić się nawet kilka godzin lub dni później. Wersje umożliwiają szybsze zrozumienie zasobu wywołującego niż oczekiwanie na odebranie wszystkich danych klienta zestawu SDK. Najlepszym scenariuszem jest zakończenie rozmów przez wszystkich uczestników oraz możliwość wysyłania danych do serwera za pomocą zestawu SDK do wywoływania.

Definicje danych

Schemat dziennika aktualizacji podsumowania wywołań

W tej tabeli opisano każdą właściwość.

Kody błędów

Właściwość participantEndReason zawiera wartość z zestawu kodów błędów Calling SDK. Możesz odwołać się do tych kodów, aby rozwiązać problemy wykryte podczas wywołania dla każdego punktu końcowego. Zobacz Rozwiązywanie problemów z kodami odpowiedzi zakończenia połączeń dla Calling SDK, Call Automation SDK, PSTN, Chat SDK i SMS SDK.

Przykładowe dane dla różnych typów wywołań

Połączenie P2P

Poniżej przedstawiono pola udostępnione dla wszystkich logów w połączeniu 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",

Dzienniki aktualizacji związanych z podsumowaniami połączeń

Podsumowanie wywołania aktualizuje dzienniki operacji udostępniania oraz informacje o kategoriach.

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

Oto podsumowanie wywołań dla użytkownika 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"
}

Oto podsumowanie wywołań dla użytkownika 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"
}

Oto dziennik aktualizacji podsumowania wywołań między dzierżawami dla użytkownika 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"
}

Oto podsumowanie dotyczące połączenia PSTN:

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

Rozmowy grupowe

Dane dla rozmowy grupowej są generowane w trzech dziennikach aktualizacji podsumowania połączeń i sześciu dziennikach diagnostyki połączeń. Poniżej znajdują się pola wspólne dla wszystkich dzienników w rozmowie telefonicznej:

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

Dzienniki aktualizacji związanych z podsumowaniami połączeń

Podsumowanie wywołania aktualizuje dzienniki operacji udostępniania oraz informacje o kategoriach.

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

Oto podsumowanie wywołań dla punktu końcowego 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"
}

Oto podsumowanie wywołań dla punktu końcowego 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"
}

Oto podsumowanie wywołań dla punktu końcowego PSTN 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"
}

Dziennik aktualizacji podsumowania połączeń międzynajemców:

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

Oto dziennik podsumowania wywołań między dzierżawami z botem jako uczestnik:

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

Często zadawane pytania

Jak mogę przechowywać dzienniki?

W poniższej sekcji opisano to wymaganie.

Dzienniki usług Azure Communication Services nie są domyślnie przechowywane na koncie na platformie Azure, więc musisz zacząć je przechowywać, aby narzędzia takie jak pulpit nawigacyjny analiz głosowych i wideo oraz diagnostyka połączeń mogły działać. Aby zebrać te dzienniki wywołań, należy włączyć ustawienie diagnostyczne kierujące dane wywołania do obszaru roboczego usługi Log Analytics.

Dane nie są przechowywane wstecznie, więc można rozpocząć przechwytywanie dzienników wywołań dopiero po skonfigurowaniu ustawienia diagnostycznego.

Postępuj zgodnie z instrukcjami, aby dodać ustawienia diagnostyczne zasobu w obszarze Włączanie dzienników za pomocą ustawień diagnostycznych w usłudze Azure Monitor. Zalecamy, aby początkowo zbierać wszystkie dzienniki. Po zapoznaniu się z możliwościami w usłudze Azure Monitor określ, które dzienniki chcesz zachować i jak długo. Po dodaniu ustawienia diagnostycznego zostanie wyświetlony monit o wybranie dzienników. Aby zebrać wszystkie logi, wybierz pozycję wszystkieLogi.

Wolumen danych, przechowywanie i użycie w usłudze Log Analytics w Azure Monitor są rozliczane za pośrednictwem istniejących mierników danych Azure. Zalecamy monitorowanie zasad użycia i przechowywania danych w celu uwzględnienia kosztów zgodnie z potrzebami. Aby uzyskać więcej informacji, zobacz Kontrolowanie kosztów.

Jeśli masz wiele identyfikatorów zasobów usług Azure Communications Services, musisz włączyć te ustawienia dla każdego identyfikatora zasobu.

Następne kroki

• Zapoznaj się z omówieniem wszystkich dzienników połączeń głosowych i wideo, zobacz: Omówienie dzienników wywołań usług Azure Communication Services

• Poznaj najlepsze rozwiązania dotyczące zarządzania jakością i niezawodnością połączeń, zobacz: Ulepszanie jakości połączeń i zarządzanie nimi

• Dowiedz się więcej na temat pulpitu analitycznego do monitorowania dzienników połączeń głosowych i wideo.

• Dowiedz się, jak używać dzienników wywołań do diagnozowania problemów z jakością i niezawodnością wywołań w diagnostyce połączeń, zobacz: Call Diagnostics (Diagnostyka połączeń)