Sesli Arama ve Görüntülü Arama günlüklerini Azure İletişim Hizmetleri
Azure İletişim Hizmetleri, İletişim Hizmetleri çözümünüzü izlemek ve hatalarını ayıklamak için kullanabileceğiniz günlük özellikleri sağlar. Bu özellikleri Azure portalı aracılığıyla yapılandırın.
Bu makaledeki içerik, Azure İzleyici aracılığıyla etkinleştirilen günlükleri ifade eder (ayrıca bkz. SSS). İletişim Hizmetleri için bu günlükleri etkinleştirmek için bkz . Tanılama ayarlarında günlüğü etkinleştirme.
Veri kavramları
Veri kavramlarının aşağıdaki üst düzey açıklamaları Sesli Arama ve Görüntülü Arama'ya özeldir. Günlüklerde yakalanan verilerin anlamını anlayabilmek için bu kavramları gözden geçirmeniz önemlidir.
Varlıklar ve Kimlikler
Aşağıdaki terimleri tanıyın:
Çağrı: Verilerde gösterildiği gibi, çağrı tarafından
correlationIdgösterilen bir soyutlamadır.correlationIddeğerleri her çağrı için benzersizdir ve vecallDurationtemelindecallStartTimezamana bağlıdır.Katılımcı: Uç nokta ile sunucu arasındaki bağlantıyı temsil eder. Bir katılımcı (
participantId) yalnızca arama bir grup çağrısı olduğunda bulunur.Uç nokta: tarafından
endpointIdtemsil edilen en benzersiz varlık. Her çağrı, iki veya daha fazla uç noktadan veri içeren bir olaydır. Uç noktalar, çağrıdaki katılımcıları temsil eder.EndpointTypeuç noktanın bir insan kullanıcı (PSTN veya VoIP), bot veya bir çağrı içinde birden çok katılımcıyı yöneten sunucu olup olmadığını bildirir. BirendpointTypedeğer olduğunda"Server"uç noktaya benzersiz bir kimlik atanmamış olur. Bir aramaya kaç kullanıcının veendpointIddiğer insan dışı katılımcıların (botlar ve sunucular) katıldığını belirlemek için değerleri ve değerleri analizendpointTypeedebilirsiniz.Android ve iOS için yerel SDK'lar, bir kullanıcı için aynı
endpointIddeğeri birden çok çağrıda yeniden kullandığından, oturumlardaki deneyimleri anlayabilirsiniz. Bu işlem, her yeni çağrı için her zaman yeniendpointIdbir değer oluşturan web tabanlı uç noktalardan farklıdır.Akış: En ayrıntılı varlık. Her yön (gelen veya giden) ve
mediaTypedeğer (örneğin,AudioveyaVideo) için bir akış vardır.
Veri tanımları
Kullanım günlüğü şeması
| Özellik | Açıklama |
|---|---|
Timestamp |
Günlüğün oluşturulduğu zaman damgası (UTC). |
Operation Name |
Günlük kaydıyla ilişkili işlem. |
Operation Version |
İşlem api-version bir API aracılığıyla gerçekleştirildiyse Operation Name işlemle ilişkili değer. 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 günlük kategorisi. Kategori, kaynakta günlükleri etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz ayrıntı düzeyidir. Bir olayın blobu properties içinde görünen özellikler, günlük kategorisi ve kaynak türü içinde aynıdır. |
Correlation ID |
bağıntılı olayların kimliği. Birden çok tablo arasındaki bağıntılı olayları tanımlamak için bunu kullanabilirsiniz. |
Properties |
Çeşitli İletişim Hizmetleri modları için geçerli olan diğer veriler. |
Record ID |
Kullanım kaydının benzersiz kimliği. |
Usage Type |
Kullanım modu (örneğin, Sohbet, PSTN veya NAT). |
Unit Type |
Kullanımın bir kullanım modu (örneğin, dakika, megabayt veya iletiler) için temel alındığı birim türü. |
Quantity |
Bu kayıt için kullanılan veya kullanılan birim sayısı. |
Çağrı özeti günlük ş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 bir değer (veya endpointId eşler arası [P2P] çağrıları için) farklı bir çağrı özeti günlüğü oluşturulur.
Önemli
Arama özeti günlüğündeki katılımcı bilgileri, katılımcı kiracısı temelinde 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ü yeniden uygulanır. Kiracılar arası katılımcılar, bir arama sırasında katılmak ve işbirliği yapmak üzere bir kaynak kiracısı tarafından davet edilen dış kullanıcılar olarak sınıflandırılır.
| Özellik | Açıklama |
|---|---|
time |
Günlüğün oluşturulduğu zaman damgası (UTC). |
operationName |
Günlük kaydıyla ilişkili işlem. |
operationVersion |
İşlem api-version bir API aracılığıyla gerçekleştirildiyse operationName işlemle ilişkili değer. 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 günlük kategorisi. Bu özellik, kaynakta günlükleri etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz ayrıntı düzeyidir. Bir olayın blobu properties içinde görünen özellikler, günlük kategorisi ve kaynak türü içinde aynıdır. |
correlationId |
Aramanı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ı correlationId kolayca tanımlamak için 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 çağrı olarak "Group" oluşturulan bir çağrıdır. |
teamsThreadId |
Teams iş parçacığı kimliği. Bu kimlik yalnızca arama Bir Teams toplantısı olarak düzenlendiğ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, işlem günlüklerinde kullanıma sunulur. Bu kimliği Sohbet API'leri aracılığıyla da alabilirsiniz. |
participantId |
Uç nokta (endpointType = "Server") ile sunucu arasındaki "Participant" 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ğinde zaman damgasına kadar her katılımcı bağlantısının saniye participantStartTime cinsinden süresi. |
participantEndReason |
Katılımcı bağlantısının sona erme nedeni. Her değer için participantId SDK'nın yaydığı (uygun olduğunda) Çağrı SDK'sı 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"). Değer endpointId bazen aynı kullanıcı için yerel istemciler için birden çok çağrıda (correlationId) 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. , , "VOIP", "PSTN""BOT"veya "Unknown"içerebilir"Server". |
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 Microsoft kiracısının kimliği. Kiracı, Azure İletişim Hizmetleri kaynağına sahip olan Azure kiracısı veya bir Microsoft 365 kimliğinin Microsoft kiracısı olabilir. Bu alan, kiracılar arası yeniden eyleme yol göstermek için kullanılır. |
participantType |
Katılımcının, istemcisinin (Azure İletişim Hizmetleri veya Teams) ve kimliğinin (Azure İletişim Hizmetleri veya Microsoft 365) birleşimi olarak açıklaması. 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. |
pstnPartcipantCallType |
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 4 değerden biri olabilir: Success, ExpectedError, UnexpectedClientError, UnexpectedServerError. |
Tanılama günlüğü şemasını çağırma
Arama tanılama günlükleri, her katılımcı için uç noktalar ve medya aktarımları hakkında önemli bilgiler sağlar. Ayrıca kalite sorunlarını anlamanıza yardımcı olacak ölçümler sağlar.
Bir çağrı içindeki her uç nokta için, uç noktalar arasında giden medya akışları (örneğin ses veya video) için ayrı bir çağrı tanılama günlüğü oluşturulur. P2P çağrısında her günlük, her uç noktayla ilişkili giden akışların her biriyle ilişkili verileri içerir. Grup çağrılarında, participantId ilgili giden günlükleri ayrı bir katılımcı bağlantısına eklemek için anahtar tanımlayıcı işlevi görür. Çağrı tanılama günlükleri olduğu gibi kalır ve katılımcı kiracısı ne olursa olsun aynıdır.
Not
Bu makalede, P2P ve grup çağrıları, kiracılar arası olan tüm çağrı senaryoları için varsayılan olarak aynı kiracı içindedir. Bunlar makale boyunca buna göre belirtilir.
| Özellik | Açıklama |
|---|---|
operationName |
Günlük kaydıyla ilişkili işlem. |
operationVersion |
İşlem api-version bir API aracılığıyla gerçekleştirildiyse operationName işlemle ilişkili değer. 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 günlük kategorisi. Bu özellik, kaynakta günlükleri etkinleştirebileceğiniz veya devre dışı bırakabileceğiniz ayrıntı düzeyidir. Bir olayın blobu properties içinde görünen özellikler, günlük kategorisi ve kaynak türü içinde aynıdır. |
correlationId |
Aramanın benzersiz kimliği. Tek bir çağrı sırasında bağlanan tüm katılımcılardan ve uç noktalardan bağıntılı olayları tanımlar. Microsoft ile bir destek olayı açmanız gerekirse, sorun giderdiğiniz çağrıyı correlationId kolayca tanımlamak için değerini kullanabilirsiniz. |
participantId |
Bir uç nokta (endpointType = "Server") ile sunucu arasındaki "Participant" 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. |
identifier |
Kullanıcının benzersiz kimliği. Kimlik Azure İletişim Hizmetleri kullanıcı, Microsoft Entra kullanıcı kimliği, Teams nesne 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. |
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ğunda null, bağlı varlık İletişim Hizmetleri sunucusudur. EndpointId yerel istemciler için birden çok çağrıda (correlationId) aynı kullanıcı için kalıcı olabilir, ancak istemci bir web tarayıcısı olduğunda her çağrı için benzersizdir. |
endpointType |
Her endpointId örneğin özelliklerini açıklayan değer. , , "VOIP", , , "BOT", "Voicemail""Anonymous"veya "Unknown"içerebilir"Server""PSTN". |
mediaType |
Her akıştaki uç noktalar arasında iletilen medya türünü açıklayan dize değeri. Olası değerler , , "Video""VBSS" (video tabanlı ekran paylaşımı) ve "AppSharing"değerlerini içerir"Audio". |
streamId |
ile mediaTypebirlikte, aynı participantId değerin akışlarını benzersiz olarak tanımlamak için kullanabileceğiniz bir nonunique tamsayı. |
transportType |
Her participantId değer için ağ aktarım protokollerini açıklayan dize değeri. , veya "TCP""Unrecognized"içerebilir"UDP". "Unrecognized" , sistemin aktarım türünün TCP mi yoksa UDP mi olduğunu belirleyemediğini gösterir. |
roundTripTimeAvg |
Bir süre içinde participantDuration bir uç noktadan diğerine BIR IP paketi almak için geçen ortalama süre. Bu ağ yayma gecikmesi, iki nokta arasındaki fiziksel uzaklık, ışık hızı ve çeşitli yönlendiricilerin aralarında aldığı herhangi bir ek yükle ilgilidir. Gecikme süresi tek yönlü zaman veya gidiş dönüş süresi (RTT) olarak ölçülür. Değeri milisaniye cinsinden ifade edilir. 500 ms'den büyük bir RTT çağrı kalitesini olumsuz etkiliyor. |
roundTripTimeMax |
Ölçülen maksimum RTT (milisaniye cinsinden) bir grup çağrısındaki bir participantDuration dönem veya P2P çağrısındaki bir callDuration süre boyunca medya akışına ulaşır. |
jitterAvg |
Ardışık paketler arasındaki gecikme ortalaması. Azure İletişim Hizmetleri arabelleğe alma yoluyla bazı değişim düzeylerine uyarlanabilir. Değişim, yaklaşık 30 ms'nin üzerinde olan jitterAvg arabelleğe alma işlemini aştığında kaliteyi olumsuz etkileyebilir. Farklı hızlarda gelen paketler, konuşmacının sesinin robot sesine neden olur. Bu ölçüm, bir grup çağrısındaki participantDuration dönem boyunca veya P2P çağrısındaki callDuration süre boyunca her medya akışı için ölçülür. |
jitterMax |
Her medya akışı için paketler arasında ölçülen maksimum değişim değeri. Ağ koşullarındaki ani artışlar ses/video trafik akışında sorunlara neden olabilir. |
packetLossRateAvg |
Kaybedilen paketlerin ortalama yüzdesi. Paket kaybı ses kalitesini doğrudan etkiler. Küçük, tek tek kayıp paketlerin neredeyse hiçbir etkisi olmazken, arka arkaya patlama kayıpları sesin tamamen kesilmesine neden olur. Bırakılan ve hedeflenen hedeflerine ulaşılmayan paketler medyada boşluklara neden olur. Bu durum, yanlış heceler ve sözcüklerin yanı sıra dalgalı video ve paylaşımla sonuçlanır. %10'dan (0,1) büyük bir paket kaybı oranı, kaliteyi olumsuz etkileyebilir. Bu ölçüm, bir grup çağrısındaki participantDuration dönem boyunca veya P2P çağrısındaki callDuration süre boyunca her medya akışı için ölçülür. |
packetLossRateMax |
Bu değer, bir grup çağrısındaki dönem boyunca veya P2P çağrısındaki süre boyunca participantDuration callDuration her medya akışı için en yüksek paket kaybı oranını (yüzde) temsil eder. Ağ koşullarındaki ani artışlar ses/video trafik akışında sorunlara neden olabilir. |
JitterBufferSizeAvg |
Her medya akışının süresi boyunca ortalama değişim arabelleği boyutu. Değişim arabelleği, ses paketlerinin eşit aralıklarla toplandığı, depolanabildiği ve ses işlemcisine gönderilebildiği paylaşılan bir veri alanıdır. Değişim arabelleği, titremenin etkilerini önlemek için kullanılır. Değişim arabellekleri statik veya dinamik olabilir. Statik dalgalanma arabellekleri sabit bir boyuta ayarlanırken dinamik dalgalanma arabellekleri ağ koşullarına göre boyutlarını ayarlayabilir. Titreşim arabelleğinin amacı, kullanıcıya sorunsuz ve kesintisiz bir ses ve video veri akışı sağlamaktır. Web SDK'sında bu JitterBufferSizeAvg , çağrı sırasında değerinin jitterBufferDelay ortalama değeridir. jitterBufferDelay, bir ses örneğinin veya titreşim arabelleğinde kalan bir video çerçevesinin süresidir. Normalde değer 200 ms'den büyük olduğunda JitterBufferSizeAvg kaliteyi olumsuz etkiler. |
JitterBufferSizeMax |
Her medya akışının süresi boyunca ölçülen maksimum titreşim arabellek boyutu. Normalde bu değer 200 ms'den büyük olduğunda kaliteyi olumsuz etkiler. |
HealedDataRatioAvg |
Kayıp veya zarar görmüş veri paketlerinin ortalama yüzdesi, ses akışı süresince iyileyici tarafından başarıyla yeniden derlendi veya kurtarıldı. İyileştirilmiş veri oranı, VoIP sistemlerinde kullanılan hata düzeltme tekniklerinin etkinliğinin bir ölçüsüdür. Bu değer 0,1 'den (%10) büyük olduğunda akışı kötü kalite olarak değerlendiririz. |
HealedDataRatioMax |
Her medya akışının süresi boyunca ölçülen en yüksek iyileştirilmiş veri oranı. Bu değer 0,1 'den (%10) büyük olduğunda akışı kötü kalite olarak değerlendiririz. |
VideoFrameRateAvg |
Bir video/ekran paylaşımı çağrısı sırasında saniyede iletilen ortalama video karesi sayısı. Video kare hızı, video akışının kalitesini ve düzgünlüğünü etkileyebilir ve daha yüksek kare hızları genellikle daha yumuşak ve daha akıcı hareketle sonuçlanır. WebRTC videosu için standart kare hızı genellikle saniyede 30 karedir (fps), ancak kare hızı belirli uygulama ve ağ koşullarına bağlı olarak değişebilir. Bu değer video akışı için 7'den az veya ekran paylaşım akışı için 1'den az olduğunda akış kalitesi düşük kabul edilir. |
RecvResolutionHeight |
Bir video/ekran paylaşımı çağrısı sırasında iletilen gelen video akışının dikey boyutunun ortalaması. Piksel cinsinden ölçülür ve video akışının genel çözünürlüğünü ve kalitesini belirleyen faktörlerden biridir. Kullanılan belirli çözüm, cihazların özelliklerine ve çağrıya dahil olan ağ koşullarına bağlı olabilir. Bu değer video akışı için 240'tan az veya ekran paylaşım akışı için 768'den az olduğunda akış kalitesi düşük kabul edilir. |
RecvFreezeDurationPerMinuteInMs |
Gelen video/ekran paylaşımı akışı için dakika başına milisaniye cinsinden ortalama dondurma süresi. Donmalar genellikle hatalı ağ durumundan kaynaklanabilir ve akış kalitesini düşürebilir. Bu değer video akışı için 6.000 ms'den büyükse veya ekran paylaşım akışı için 25.000 ms'den büyükse akış kalitesi düşük kabul edilir. |
PacketUtilization |
Belirli bir medya akışı için gönderilen veya alınan paketler. Genellikle çağrı ne kadar uzun olursa değer o kadar yüksek olur. Bu değer sıfırsa, medyanın akmadığını gösterebilir. |
VideoBitRateAvg |
Video veya ekran paylaşımı akışı için ortalama bit hızı (saniye başına bit sayısı). Düşük bit hızı değeri, düşük ağ sorununa işaret edebilir. Gereken en düşük bit hızı (bant genişliği) burada bulunabilir: Ağ bant genişliği. |
VideoBitRateMax |
Video veya ekran paylaşımı akışı için maksimum bit hızı (saniye başına bit sayısı). Düşük bit hızı değeri, düşük ağ sorununa işaret edebilir. Gereken en düşük bit hızı (bant genişliği) burada bulunabilir: Ağ bant genişliği. |
StreamDirection |
Medya akışının yönü. Gelen veya Giden'dir. |
CodecName |
Medya akışlarını işlemek için kullanılan codec'in adı. OPUS, G722, H264S, SATIN vb. olabilir. |
İstemci işlemleri günlük şemasını çağırma
Çağrı istemcisi işlemleri günlüğü, çağrı yapan uç noktalar ve bir çağrıya katılan katılımcılar hakkında istemci tarafı bilgileri sağlar. Bu günlükler şu anda önizleme aşamasındadır ve bir çağrıda gerçekleşen istemci olaylarını ve bir müşterinin arama sırasında hangi eylemleri gerçekleştirdiğini gösterir.
Bu günlük, bir arama sırasında yapılan eylemler hakkında ayrıntılı bilgi sağlar ve Azure İletişim Hizmetleri Kaynağınız için Arama Tanılaması kullanılarak arama sorunlarını görselleştirmek ve araştırmak için kullanılabilir. Arama Tanılama hakkında daha fazla bilgi edinin
| Özellik | Açıklama |
|---|---|
CallClientTimeStamp |
UTC'de SDK'da ne zaman açık işleminin gerçekleştiğine ilişkin zaman damgası. |
OperationName |
Çağrı SDK'sı üzerinde tetiklenen işlemin adı. |
CallId |
Aramanı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. Çağrı özet günlüğündeki ve çağrı tanılama günlüğündeki bağıntı Kimliğine benzer. |
ParticipantId |
Her arama bacağının (Grup çağrılarında) veya çağrı katılımcısının (Eşler Arası aramalarda) benzersiz tanımlayıcısı. Bu kimlik, CallSummary, CallDiagnostic, CallClientOperations ve CallClientMediaStats günlükleri arasındaki ana bağıntı noktasıdır. |
OperationType |
İstemci İşlemi'ne çağrı yapma. |
OperationId |
SDK işlemini tanımlayan benzersiz bir GGUID. |
DurationMs |
Çağrı SDK'sı işleminin başarısız olması veya başarılı olması için geçen süre. |
ResultType |
Bir işlemin başarısını veya başarısızlığını açıklayan alan. |
ResultSignature |
HTTP benzeri hata veya başarı kodu (200, 500). |
SdkVersion |
Çağrı SDK'sının kullanılmakta olan sürümü. |
UserAgent |
Tarayıcıyı veya platform Çağırma SDK'sını temel alan standart kullanıcı aracısı dizesi kullanılır. |
ClientInstanceId |
CallClient nesnesini tanımlayan benzersiz bir GGUID. |
EndpointId |
Çağrıya bağlı her uç noktayı temsil eden benzersiz kimlik; burada endpointType uç nokta türünü tanımlar. Değer null olduğunda, bağlı varlık İletişim Hizmetleri sunucusudur (endpointType = "Sunucu"). EndpointId değeri bazen aynı kullanıcı için yerel istemciler için birden çok çağrıda (correlationId) kalıcı olabilir. EndpointId değerlerinin sayısı, çağrı özeti günlüklerinin sayısını belirler. Her endpointId değeri için ayrı bir özet günlük oluşturulur. |
OperationPayload |
daha fazla işleme özgü ayrıntı sağlayan işleme bağlı olarak değişen dinamik bir yük. |
İstemci medya istatistikleri zaman serisi günlük şemasını çağırma
Çağrı istemcisi medya istatistikleri zaman serisi günlüğü, bir aramaya katılan tek tek katılımcılar arasındaki medya akışları hakkında istemci tarafı bilgileri sağlar. Bu günlükler şu anda sınırlı önizleme aşamasındadır ve varsayılan 10 saniyelik toplama aralığına sahip katılımcılar arasında ses, video ve ekran paylaşımı medyası üzerinde ayrıntılı zaman serisi verileri sağlar. Günlükler medya akışı türü, yönü, codec'i ve bit hızı özellikleri (örneğin, maksimum, min, ortalama) hakkında ayrıntılı zaman serisi bilgileri içerir.
Bu günlük, katılımcılar arasındaki medya buharlarının kalitesini anlamak için Çağrı Tanılama günlüğünden daha ayrıntılı bilgiler sağlar. Azure İletişim Hizmetleri Kaynağınız için Arama Tanılama aracılığıyla aramalarınızın kalite sorunlarını görselleştirmek ve araştırmak için kullanılabilir. Arama Tanılama hakkında daha fazla bilgi edinin
| Özellik | Açıklama |
|---|---|
OperationName |
Günlük kaydıyla ilişkili işlem. |
CallId |
Aramanı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. Çağrı özet günlüğündeki ve çağrı tanılama günlüğündeki bağıntı Kimliğine benzer. |
CallClientTimeStamp |
Medya istatistiklerinin kaydedildiğinde zaman damgası. |
MetricName |
, , PacketsPerSecondvb. gibi BitrateJitterInMsmedya istatistiklerinin adı. |
Count |
Belirli bir zaman damgasında örneklenen veri noktası sayısı. |
Sum |
Örneklenen tüm veri noktalarının ölçüm değerlerinin toplamı. |
Average |
Örneklenen veri noktalarının ortalama ölçüm değeri. Ortalama = Toplam / Sayı. |
Minimum |
Örneklenen tüm veri noktalarının ölçüm değerlerinin en düşük değeri. |
Maximum |
Örneklenen tüm veri noktalarının ölçüm değerlerinin üst sınırı. |
MediaStreamDirection |
Medya akışının yönü. veya receiveolabilirsend. |
MediaStreamType |
Medya akışının türü. , veya screenolabilirvideoaudio. |
MediaStreamCodec |
Medya akışını kodlamak/kodunu çözmek için kullanılan codec, örneğin H264, OPUS, VP8vb. |
ParticipantId |
Çağrıdaki her uç noktayı temsil etmek için oluşturulan benzersiz kimlik. |
ClientInstanceId |
Çağrı SDK'sında oluşturulan Çağrı İstemcisi nesnesini temsil eden benzersiz kimlik. |
EndpointId |
Çağrıya bağlı her uç noktayı temsil eden benzersiz kimlik. EndpointId yerel istemciler için birden çok çağrıda (callIds) aynı kullanıcı için kalıcı olabilir, ancak istemci bir web tarayıcısı olduğunda her çağrı için benzersizdir. EndpointId şu anda bu günlükte izlenmez. Uygulandığında, CallSummary/Diagnostics günlüklerindeki değerlerle eşleşir |
RemoteParticipantId |
Medya akışındaki uzak uç noktayı temsil eden benzersiz kimlik. Örneğin, bir kullanıcı aynı çağrıdaki diğer kullanıcılar için birden çok video akışı işleyebilir. Her video akışının farklı RemoteParticipantIdbir . |
RemoteEndpointId |
ile EndpointIdaynıdır, ancak akışın uzak tarafındaki kullanıcıyı temsil eder. |
MediaStreamId |
Çağrıdaki her medya akışını temsil eden benzersiz bir kimlik. MediaStreamId şu anda istemcilerde izlenmez. Uygulandığında CallDiagnostics günlüklerindeki sütunla eşleşir streamId . |
AggregationIntervalSeconds |
Medya istatistiklerini toplama zaman aralığı. Şu anda Arama SDK'sında medya ölçümleri 1 saniyede bir örneklenir ve günlükte rapor ettiğimizde tüm örnekleri 10 saniyede bir toplarız. Bu nedenle bu tablodaki her satırda en fazla 10 örnekleme noktası vardır. |
P2P ve grup çağrıları karşılaştırması
tarafından callTypetemsil edilen iki tür çağrı vardır:
Eşler Arası (P2P) çağrısı: Sunucu uç noktası olmayan yalnızca iki uç nokta arasındaki bağlantı. P2P çağrıları bu uç noktalar arasında bir çağrı olarak başlatılır ve bağlantıdan önce grup çağrısı olayı olarak oluşturulmaz.
Grup çağrısı: İkiden fazla uç noktanın bağlı olduğu tüm çağrılar. Grup çağrıları bir sunucu uç noktası ve her uç nokta ile sunucu arasındaki bağlantıyı içerir. Çağrı sırasında başka bir uç nokta ekleyen P2P çağrıları P2P olmaktan çıkıp bir grup çağrısına dönüşür. ve
participantDurationölçümlerini kullanarak her uç noktanın çağrıya ne zaman katıldığınıparticipantStartTimebelirleyebilirsiniz.
Günlük yapısı
Azure İletişim Hizmetleri dört günlük türü oluşturur:
Arama özeti günlükleri: Tüm ilgili kimlikler, zaman damgaları, uç noktalar ve SDK bilgileri dahil olmak üzere aramayla ilgili temel bilgileri içerir. İ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ı
EndpointIddeğere ancak farklıParticipantIdbir değere sahiptir. Bu uç noktanın iki çağrı özeti günlüğü olabilir.Çağrı tanılama günlükleri: Deneyim ölçümlerinin kalitesini gösteren bir dizi ölçümle birlikte akış hakkındaki bilgileri içerir. Bir çağrıdaki (sunucu dahil) her
EndpointIdbir kişi için Azure İletişim Hizmetleri, uç noktalar arasında her medya akışı (örneğin ses veya video) için ayrı bir çağrı tanılama günlüğü oluşturur.İstemci işlemleri günlüklerini çağır: Ayrıntılı çağrı istemcisi olaylarını içerir. Bu günlük olayları bir çağrıdaki her
EndpointIdbiri için oluşturulur ve oluşturulan olay günlüklerinin sayısı, katılımcının çağrı sırasında gerçekleştirdiği işlemlere bağlıdır.İstemci medya istatistikleri günlüklerini çağırma: Ayrıntılı medya akışı değerlerini içerir. Bu günlükler bir çağrıdaki her medya akışı için oluşturulur. Bir çağrıdaki (sunucu dahil) her
EndpointIdbir kişi için Azure İletişim Hizmetleri uç noktalar arasındaki her medya akışı (örneğin ses veya video) için ayrı bir günlük oluşturur. Her günlükte oluşturulan veri hacmi, çağrının süresine ve çağrıdaki medya buharlarının sayısına bağlıdır.
P2P çağrısında her günlük, her uç noktayla ilişkili giden akışların her biriyle ilişkili verileri içerir. Grup çağrısında, ile endpointType = "Server" ilişkilendirilmiş her akış, gelen akışlar için veri içeren bir günlük oluşturur. Diğer tüm akışlar, tüm sunucu olmayan uç noktalar için giden akışlar için veri içeren günlükler oluşturur. Grup çağrılarında, ilgili gelen ve giden günlükleri ayrı bir katılımcı bağlantısında birleştirmek için anahtar olarak değerini kullanın participantId .
Örnek: P2P çağrısı
Aşağıdaki diyagram, doğrudan bir P2P çağrısına bağlı iki uç noktayı temsil eder. Bu örnekte, İletişim Hizmetleri iki çağrı özeti günlüğü (her participantID değer için bir günlük) ve dört çağrı tanılama günlüğü (her medya akışı için bir tane) oluşturur.
Azure İletişim Hizmetleri çağrı istemcisi katılımcıları için bir dizi çağrı istemcisi işlem günlüğü ve çağrı istemcisi medya istatistikleri zaman serisi günlükleri de vardır. Bu günlüklerin tam sayısı, ne tür SDK işlemlerinin çağrıldığına ve çağrı süresine bağlıdır.
Örnek: Grup araması
Aşağıdaki diyagram, üç participantId değere (üç katılımcı anlamına gelir) ve bir sunucu uç noktasına sahip bir grup çağrısı örneğini temsil eder. için endpointId birden çok değer birden çok katılımcıda (örneğin, aynı cihazdan bir aramaya yeniden katıldıklarında) görünebilir. İletişim Hizmetleri her participantId değer için bir çağrı özeti günlüğü oluşturur. Dört çağrı tanılama günlüğü oluşturur: her medya akışı için bir tane.participantId
Azure İletişim Hizmetleri çağrı istemcisi katılımcıları için, çağrı istemcisi işlem günlükleri P2P çağrıları ile aynıdır. Çağrı SDK'sını kullanan her katılımcı için bir dizi çağrı istemcisi işlem günlüğü vardır.
Azure İletişim Hizmetleri çağrı istemcisi katılımcıları için çağrı istemci işlemleri günlükleri ve çağrı istemcisi medya istatistikleri zaman serisi günlükleri P2P çağrılarıyla aynıdır. Çağrı SDK'sını kullanan her katılımcı için bir dizi çağrı istemcisi işlem günlüğü ve çağrı istemcisi medya istatistikleri zaman serisi günlükleri vardır.
Örnek: Kiracılar arası P2P çağrısı
Aşağıdaki diyagram, doğrudan bir P2P çağrısına bağlanan birden çok kiracıdaki iki katılımcıyı temsil eder. Bu örnekte, İletişim Hizmetleri yeniden işlem yapılmış işletim sistemi ve SDK sürümleriyle bir çağrı özeti günlüğü (her katılımcı için bir tane) oluşturur. İletişim Hizmetleri ayrıca dört arama tanılama günlüğü (her medya akışı için bir günlük) oluşturur. Her günlük, giden akışıyla participantIDilgili veriler içerir.
Örnek: Kiracılar arası grup çağrısı
Aşağıdaki diyagram, birden çok kiracıda üç participantId değer içeren bir grup çağrısı örneğini temsil eder. İletişim Hizmetleri, yeniden işlem yapılan işletim sistemi ve SDK sürümlerine sahip her katılımcı için bir çağrı özeti günlüğü oluşturur. İletişim Hizmetleri ayrıca her değerle (her participantId medya akışı için bir tane) ilgili dört çağrı tanılama günlüğü oluşturur.
Not
Bu sürüm yalnızca giden tanılama günlüklerini destekler. İletişim Hizmetleri katılımcıların ve botların kimliklerini aynı şekilde değerlendirdiğinden bot ve katılımcıyla ilişkili işletim sistemi ve SDK sürümleri yeniden kullanılabilir.
Örnek veriler
P2P çağrısı
P2P çağrısındaki tüm günlükler için paylaşılan alanlar şunlardır:
"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": "8d1a8374-344d-4502-b54b-ba2d6daaf0ae",
Arama özeti günlükleri
Arama özeti günlükleri paylaşım işlemi ve kategori bilgileri:
"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 yeniden işlemden çıkarılır.
"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"
}
Arama tanılama günlükleri
Arama tanılama günlükleri işlem bilgilerini paylaşır:
"operationName": "CallDiagnostics",
"operationVersion": "1.0",
"category": "CallDiagnostics",
VoIP uç noktası 1'den VoIP uç noktası 2'ye bir ses akışı için tanılama günlüğü aşağıdadır:
"properties": {
"identifier": "acs:61fddbe3-0003-4066-97bc-6aaf143bbb84_0000000b-4fee-66cf-ac00-343a0d003158",
"participantId": "null",
"endpointId": "570ea078-74e9-4430-9c67-464ba1fa5859",
"endpointType": "VoIP",
"mediaType": "Audio",
"streamId": "1000",
"transportType": "UDP",
"roundTripTimeAvg": "82",
"roundTripTimeMax": "88",
"jitterAvg": "1",
"jitterMax": "1",
"packetLossRateAvg": "0",
"packetLossRateMax": "0"
}
VoIP uç noktası 2'den VoIP uç noktası 1'e bir ses akışı için tanılama günlüğü aşağıdadır:
"properties": {
"identifier": "acs:7af14122-9ac7-4b81-80a8-4bf3582b42d0_06f9276d-8efe-4bdd-8c22-ebc5434903f0",
"participantId": "null",
"endpointId": "a5bd82f9-ac38-4f4a-a0fa-bb3467cdcc64",
"endpointType": "VoIP",
"mediaType": "Audio",
"streamId": "1363841599",
"transportType": "UDP",
"roundTripTimeAvg": "78",
"roundTripTimeMax": "84",
"jitterAvg": "1",
"jitterMax": "1",
"packetLossRateAvg": "0",
"packetLossRateMax": "0"
}
VoIP uç noktası 1'den VoIP uç noktası 2'ye video akışı için tanılama günlüğü aşağıdadır:
"properties": {
"identifier": "acs:61fddbe3-0003-4066-97bc-6aaf143bbb84_0000000b-4fee-66cf-ac00-343a0d003158",
"participantId": "null",
"endpointId": "570ea078-74e9-4430-9c67-464ba1fa5859",
"endpointType": "VoIP",
"mediaType": "Video",
"streamId": "2804",
"transportType": "UDP",
"roundTripTimeAvg": "103",
"roundTripTimeMax": "143",
"jitterAvg": "0",
"jitterMax": "4",
"packetLossRateAvg": "3.146336E-05",
"packetLossRateMax": "0.001769911"
}
Grup araması
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": "341acde7-8aa5-445b-a3da-2ddadca47d22",
Arama özeti günlükleri
Arama özeti günlükleri paylaşım işlemi ve kategori bilgileri:
"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"
}
Arama tanılama günlükleri
Arama tanılama günlükleri işlem bilgilerini paylaşır:
"operationName": "CallDiagnostics",
"operationVersion": "1.0",
"category": "CallDiagnostics",
VoIP uç noktası 1'den sunucu uç noktasına ses akışı için tanılama günlüğü aşağıdadır:
"properties": {
"identifier": "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-729f-ac00-343a0d00d975",
"participantId": "04cc26f5-a86d-481c-b9f9-7a40be4d6fba",
"endpointId": "5ebd55df-ffff-ffff-89e6-4f3f0453b1a6",
"endpointType": "VoIP",
"mediaType": "Audio",
"streamId": "14884",
"transportType": "UDP",
"roundTripTimeAvg": "46",
"roundTripTimeMax": "48",
"jitterAvg": "0",
"jitterMax": "1",
"packetLossRateAvg": "0",
"packetLossRateMax": "0"
}
Sunucu uç noktasından VoIP uç noktasına 1 ses akışının tanılama günlüğü aşağıdadır:
"properties": {
"identifier": null,
"participantId": "04cc26f5-a86d-481c-b9f9-7a40be4d6fba",
"endpointId": null,
"endpointType": "Server",
"mediaType": "Audio",
"streamId": "2001",
"transportType": "UDP",
"roundTripTimeAvg": "42",
"roundTripTimeMax": "44",
"jitterAvg": "1",
"jitterMax": "1",
"packetLossRateAvg": "0",
"packetLossRateMax": "0"
}
VoIP uç noktası 3'ten sunucu uç noktasına ses akışı için tanılama günlüğü aşağıdadır:
"properties": {
"identifier": "acs:1797dbb3-f982-47b0-b98e-6a76084454f1_0000000b-1531-57c6-ac00-343a0d00d972",
"participantId": "1a9cb3d1-7898-4063-b3d2-26c1630ecf03",
"endpointId": "5ebd55df-ffff-ffff-ab89-19ff584890b7",
"endpointType": "VoIP",
"mediaType": "Audio",
"streamId": "13783",
"transportType": "UDP",
"roundTripTimeAvg": "45",
"roundTripTimeMax": "46",
"jitterAvg": "1",
"jitterMax": "2",
"packetLossRateAvg": "0",
"packetLossRateMax": "0"
}
Sunucu uç noktasından VoIP uç noktası 3'e ses akışının tanılama günlüğü aşağıdadır:
"properties": {
"identifier": "null",
"participantId": "1a9cb3d1-7898-4063-b3d2-26c1630ecf03",
"endpointId": null,
"endpointType": "Server"
"mediaType": "Audio",
"streamId": "1000",
"transportType": "UDP",
"roundTripTimeAvg": "45",
"roundTripTimeMax": "46",
"jitterAvg": "1",
"jitterMax": "4",
"packetLossRateAvg": "0",
P2P ve grup çağrıları için istemci işlemleri günlüğünü çağırın ve istemci medya istatistikleri günlüklerini çağırın
Çağrı istemci işlemleri günlüğü ve çağrı istemcisi medya istatistikleri zaman serisi günlüğü için, P2P ile grup çağrısı senaryoları arasında bir fark yoktur ve günlük sayısı SDK işlemlerine ve çağrı süresine bağlıdır. Aşağıdaki kod, bu günlüklerin şemasını gösteren genel bir örnektir.
İstemci işlemleri günlüğünü çağırma
"CreateView" işlemi için bir çağrı istemcisi işlem günlüğü aşağıdadır:
"properties": {
"TenantId": "4e7403f8-515a-4df5-8e13-59f0e2b76e3a",
"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"
}
Her katılımcının arama için birçok farklı ölçümü olabilir. Çağrı istemcisi işlem günlüğündeki tüm olası İşlemleri listelemek için Azure portalındaki Log Analytics'te aşağıdaki sorguyu çalıştırabilirsiniz:
ACSCallClientOperations | distinct OperationName
İstemci medya istatistikleri zaman serisi günlüğünü çağırma
Medya istatistikleri zaman serisi günlüğü örneği aşağıda verilmiştir. Belirli bir zaman damgasında bir ses akışı almak için katılımcının Titreşim ölçümünü gösterir.
"properties": {
"TenantId": "4e7403f8-515a-4df5-8e13-59f0e2b76e3a",
"TimeGenerated": "2024-01-10T07:36:51.771Z",
"OperationName": "CallClientMediaStatsTimeSeries" ,
"CallId": "92d800c4-abde-40be-91e9-3814ee786b19",
"CallClientTimeStamp": "2024-01-09T15:07:56.066Z",
"MetricName": "JitterInMs",
"Count": "2",
"Sum": "34",
"Average": "17",
"Minimum": "10",
"Maximum": "25",
"MediaStreamDirection": "recv",
"MediaStreamType": "audio",
"MediaStreamCodec": "OPUS",
"ParticipantId": "2656fd6c-6d4a-451d-a1a5-ce1baefc4d5c",
"ClientInstanceId": "d08a3d05-db90-415f-88a7-87ae74edc1dd",
"AggregationIntervalSeconds": "10",
"Type": "ACSCallClientMediaStatsTimeSeries"
}
Her katılımcının arama için birçok farklı medya istatistikleri ölçümü olabilir. Bu günlükteki tüm olası ölçümleri göstermek için Azure portalında Log Analytics'te aşağıdaki sorgu çalıştırılabilir:
ACSCallClientMediaStatsTimeSeries | distinct MetricName
Hata kodları
özelliği, participantEndReason Çağırma SDK'sı hata kodları kümesinden bir değer içerir. Çağrı sırasında her uç noktayla ilgili 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.
Sonraki adımlar
Sesli Arama ve Görüntülü Arama günlüklerini ve ölçümlerini izlemeye yönelik içgörüler panosu hakkında bilgi edinin.
Arama kalitenizi ve güvenilirliğinizi yönetmek için en iyi yöntemleri öğrenin, bkz. Arama kalitesini iyileştirme ve yönetme
Arama Tanılama ile ilgili arama kalitesi ve güvenilirlik sorunlarını tanılamak için arama günlüklerini kullanmayı öğrenin, bkz. Arama Tanılama