Aracılığıyla paylaş

Çağrı özeti kayıt şeması

Arama özeti günlüğü, tüm çağrıların önemli özelliklerini belirlemenize yardımcı olacak veriler içerir. Çağrıdaki her participantId değeri (veya eşler arası [P2P] çağrılar için endpointId) için farklı bir çağrı özeti günlüğü oluşturulur.

İletişim Hizmetleri, bir çağrı içindeki her katılımcı için ayrı bir çağrı özeti günlüğü oluşturur. Birisi bir aramaya yeniden katılırsa, bu katılımcı aynı EndpointId değere ancak farklı ParticipantId bir değere sahiptir. Bu uç noktada daha sonra iki çağrı özeti günlüğü bulunabilir.

Arama günlüklerini nasıl kullanılır?

Arama kullanımınızı izleyebilmeniz, arama kalitenizi artırabilmeniz ve Azure İletişim Hizmetleri yeni günlükleri yayınladığında bu günlükleri alabilmeniz için tüm kullanılabilir arama günlüklerini bir log analytics kaynağında toplamanızı öneririz.

Aramalarınızı izlemek ve arama kalitesini artırmak için kullanabileceğiniz iki ana araç vardır.

Ses ve video içgörüleri panosunu kullanarak kalite araştırmalarına başlamanızı ve ayrıntılara ihtiyaç duyduğunuzda tek tek aramaları keşfetmek için gerektiğinde arama tanılamasını kullanmanızı öneririz.

Veri kavramları

Önemli

Günlükleri toplamanız gerekiyor, çünkü onları analiz etmek istiyorsanız. Daha fazla bilgi edinmek için bkz. Günlükleri Nasıl Depolarım?

Bu tanılama ayarlarını etkinleştirmediğiniz sürece Azure arama günlüğü verilerinizi depolamaz. Arama verileriniz geriye dönük olarak kullanılamaz. Tanılama Ayarlarını oluşturduktan sonra verileri biriktirirsiniz.

Veri tanımları

Çağrı özeti kayıt şeması

Önemli

Arama özeti günlüğündeki katılımcı bilgileri, katılımcının bağlı olduğu kiracıya göre değişir. Katılımcı, İletişim Hizmetleri kaynağıyla aynı kiracıda değilse (kiracılar arası olarak da adlandırılır), SDK sürümü ve işletim sistemi sürümü gizlenir. Tenantlar arası katılımcılar, bir kaynak kiracı tarafından bir arama sırasında katılmak ve işbirliği yapmak üzere davet edilen dış kullanıcılar olarak sınıflandırılır.

Bu tabloda her özellik açıklanmaktadır.

Emlak Açıklama
time Günlüğün oluşturulduğu tarih ve saat (UTC).
operationName Günlük kaydıyla ilişkili işlem.
operationVersion Eğer api-version işlemi bir API aracılığıyla gerçekleştirildiyse operationName işlemle ilişkili değerdir. Bu işleme karşılık gelen API yoksa, işlemle ilişkili özelliklerin gelecekte değişmesi durumunda sürüm işlemin sürümünü temsil eder.
category Olayın kayıt kategorisi. Bu özellik, kaynakta günlükleri etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz ayrıntı düzeyidir. Bir etkinliğin properties blobu içinde görünen özellikler, günlük kategorisi ve kaynak türünde aynıdır.
correlationId Çağrının benzersiz kimliği. Tek bir çağrı sırasında bağlanan tüm katılımcılardan ve uç noktalardan gelen bağıntılı olayları tanımlar ve bunu farklı günlüklerdeki verileri birleştirmek için kullanabilirsiniz. Microsoft ile bir destek olayı açmanız gerekirse, sorun giderdiğiniz çağrıyı kolayca tanımlamak için correlationId değerini kullanabilirsiniz.
identifier Kullanıcının benzersiz kimliği. Kimlik Azure İletişim Hizmetleri kullanıcı, Microsoft Entra kullanıcı kimliği, Teams anonim kullanıcı kimliği veya Teams bot kimliği olabilir. Kullanıcı olaylarını günlükler arasında ilişkilendirmek için bu kimliği kullanabilirsiniz.
callStartTime Herhangi bir uç noktadan yapılan ilk bağlantı girişimine bağlı olarak, çağrının başlangıcı için bir zaman damgası.
callDuration İlk denenen bağlantıya ve iki uç nokta arasındaki son bağlantının sonuna göre saniye cinsinden ifade edilen çağrının süresi.
callType Aramanın türü. ya da "P2P""Group"içerir. "P2P" Çağrı, yalnızca iki sunucu olmayan uç nokta arasındaki doğrudan 1:1 bağlantısıdır. "Group" Çağrı, ikiden fazla uç noktası olan veya bağlantıdan önce "Group" çağrısı olarak oluşturulan bir çağrıdır.
teamsThreadId Teams konu kimliği. Bu kimlik yalnızca çağrı bir Teams toplantısı olarak organize edildiğinde geçerlidir. Daha sonra Microsoft Teams ile Azure İletişim Hizmetleri arasında birlikte çalışabilirlik kullanım örneğini temsil eder.

Bu kimlik, operasyonel günlüklerde görünür. Bu kimliği Sohbet API'leri aracılığıyla da alabilirsiniz.
participantId Uç nokta ("Participant"endpointType = ) ile sunucu arasındaki "Server" iki yönlü bağlantıyı temsil etmek için oluşturulan kimlik. olduğunda callType = "P2P", iki uç nokta arasında doğrudan bağlantı olur ve hiçbir participantId değer oluşturulmaz.
participantStartTime Katılımcının ilk bağlantı girişiminin başlangıcı için zaman damgası.
participantDuration Bağlantının sona erdiği zaman damgasına kadar, her katılımcı bağlantısının participantStartTime anından itibaren saniye cinsinden süresi.
participantEndReason Katılımcı bağlantısının sona erme nedeni. Her participantId değeri için SDK'nın (uygun olduğunda) yaydığı Çağrı SDK hata kodlarını içerir.
endpointId Çağrıya endpointType bağlı her uç noktayı temsil eden ve uç nokta türünü tanımlayan benzersiz kimlik. değeri olduğundanull, bağlı varlık İletişim Hizmetleri sunucusudur (endpointType = "Server").

Aynı kullanıcı için endpointId değeri, yerel istemcilerle yapılan birden çok çağrıda (correlationId) bazen kalıcı olabilir. Değer sayısı endpointId , çağrı özeti günlüklerinin sayısını belirler. Her endpointId değer için ayrı bir özet günlük oluşturulur.
endpointType Bu değer, çağrıya bağlı her uç noktanın özelliklerini açıklar. "Server", "VOIP", "PSTN", "BOT" veya "Unknown" içerebilir.
sdkVersion İlgili uç noktaların kullandığı İletişim Hizmetleri Çağırma SDK'sı sürümünün sürüm dizesi (örneğin, "1.1.00.20212500").
osVersion Her uç nokta cihazının işletim sistemini ve sürümünü temsil eden bir dize.
participantTenantId Katılımcının kimliğiyle ilişkili olan Microsoft kiracısına ait kimlik. Kiracı, ya Azure İletişim Hizmetleri kaynağına sahip olan Azure kiracısı ya da bir Microsoft 365 kimliğinin Microsoft kiracısı olabilir. Bu alan, kiracılar arası belge düzenlemeye rehberlik etmek için kullanılır.
participantType Katılımcının, istemcisi (Azure İletişim Hizmetleri veya Teams) ve kimliği (Azure İletişim Hizmetleri veya Microsoft 365) kombinasyonu olarak tanımlanması. Olası değerler şunlardır: Azure İletişim Hizmetleri (Azure İletişim Hizmetleri kimlik ve Azure İletişim Hizmetleri SDK), Teams (Teams kimliği ve Teams istemcisi), Teams dış kullanıcısı olarak Azure İletişim Hizmetleri (Teams aramasında veya toplantısında Azure İletişim Hizmetleri kimliği ve Azure İletişim Hizmetleri SDK'sı) Azure İletişim Hizmetleri Microsoft 365 kullanıcısı (Microsoft 365 kimliği ve Azure İletişim Hizmetleri istemcisi) ve Teams Voice Apps olarak.
pstnParticipantCallType Acil durum çağrısı, doğrudan yönlendirme, aktarım, iletme vb. dahil olmak üzere PSTN katılımcılarının türünü ve yönünü temsil eder.
ParticipantEndSubCode SDK'nın her participantId değer için (uygun olduğunda) yaydığı Çağırma SDK'sı hata alt kodunu temsil eder.
ResultCategory Çağrıyı sonlandıran katılımcı kategorisini temsil eder. Şu dört değerden biri olabilir: Success, ExpectedError, UnexpectedClientError, UnexpectedServerError.
DiagnosticOptions Bu değer, geliştiricilerin istemci telemetrilerine özel etiketler eklemesine olanak tanır ve bu etiketler Daha sonra Arama Tanılama bölümünde görüntülenebilir. Bu, sorunları daha etkili bir şekilde tanımlamaya ve gidermeye yardımcı olur. Bu değere özel etiketler eklemeyi öğrenmek için bkz . İstemci telemetrinize özel etiketler ekleme öğreticisi
callDebuggingInfo Bu değer, Microsoft hata ayıklama amacıyla kullanılan çağrının iç özelliklerini temsil eden anahtar-değer çiftlerine sahip json nesnesini içerir.
TPE Bu değer, aramanın bir Teams Phone genişletilebilirlik senaryosuyla ilişkilendirildiğini gösterir.

Hata kodları

özelliği, participantEndReason Çağırma SDK'sı hata kodları kümesinden bir değer içerir. Her uç nokta için çağrı sırasında algılanan sorunları gidermek için bu kodlara başvurabilirsiniz. Bkz . Arama SDK'sı, Çağrı Otomasyonu SDK'sı, PSTN, Sohbet SDK'sı ve SMS SDK'sı için arama sonu yanıt kodlarının sorunlarını giderme.

Çeşitli çağrı türleri için örnek veriler

Not

Bu makalede, P2P ve grup çağrıları varsayılan olarak aynı kiracı içindedir. Kiracılar arası olan tüm çağrı senaryoları makalenin tamamında buna göre belirtilir.

P2P çağrısı

P2P çağrısındaki tüm günlükler için paylaşılan alanlar şöyledir:

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

Çağrı özeti kayıtları

Arama özeti günlükleri, paylaşılan işlem ve kategori bilgilerini içerir.

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

VoIP kullanıcısı 1 için bir arama özeti aşağıdadır:

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

VoIP kullanıcısı 2 için bir arama özeti aşağıdadır:

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

VoIP kullanıcısı 1 için kiracılar arası çağrı özet günlüğü aşağıdadır:

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

PSTN araması için arama özeti aşağıdadır:

Not

P2P veya grup çağrısı günlüklerinde, katılımcının kiracısı veya botun kiracısı olmasına bakılmaksızın işletim sistemi ve SDK sürümleri gizlenir.

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

Grup aramaları

Bir grup çağrısının verileri üç çağrı özeti günlüğünde ve altı çağrı tanılama günlüğünde oluşturulur. Çağrıdaki tüm günlükler için paylaşılan alanlar şunlardır:

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

Çağrı özeti kayıtları

Arama özeti günlükleri, paylaşılan işlem ve kategori bilgilerini içerir.

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

VoIP uç noktası 1 için bir çağrı özeti aşağıdadır:

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

VoIP uç noktası 3 için bir çağrı özeti aşağıdadır:

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

PSTN uç noktası 2 için bir çağrı özeti aşağıdadır:

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

Kiracılar arası çağrı özet günlüğü aşağıdadır:

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

Bir botu katılımcı olarak içeren kiracılar arası arama özet günlüğü aşağıdadır:


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

Sık sorulan sorular

Günlükleri nasıl depolarım?

Aşağıdaki bölümde bu gereksinim açıklanmaktadır.

Azure İletişim Hizmetleri günlükleri varsayılan olarak Azure hesabınızda depolanmaz, bu nedenle ses ve video içgörüleri panosu ve arama tanılama gibi araçlar için bunları depolamaya başlamanız gerekir. Bu arama günlüklerini toplamak için, arama verilerini Log Analytics çalışma alanına yönlendiren bir tanılama ayarını etkinleştirmeniz gerekir.

Veriler geriye dönük olarak depolanmaz, bu nedenle yalnızca tanılama ayarını yapılandırdıktan sonra çağrı günlüklerini yakalamaya başlarsınız.

Azure İzleyici'de Tanılama Ayarları aracılığıyla günlükleri etkinleştirme bölümünde kaynağınız için tanılama ayarları eklemek için yönergeleri izleyin. Başlangıçta tüm günlükleri toplamanızı öneririz. Azure İzleyici'deki özellikleri anladıktan sonra, hangi günlükleri ve ne kadar süreyle saklamak istediğinizi belirleyin. Tanılama ayarınızı eklediğinizde, günlükleri seçmeniz istenir. Tüm günlükleri toplamak için allLogs'ı seçin.

Azure İzleyici içindeki Log Analytics'teki veri hacminiz, saklamanız ve kullanımınız mevcut Azure veri ölçümleri aracılığıyla faturalandırılır. Maliyetle ilgili dikkat edilmesi gerekenler için veri kullanımı ve saklama ilkelerinizi izlemenizi öneririz. Daha fazla bilgi için bkz Maliyetleri denetleme.

Birden çok Azure Communications Services kaynak kimliğiniz varsa, her kaynak kimliği için bu ayarları etkinleştirmeniz gerekir.

Sonraki adımlar