Log Panggilan Suara dan Panggilan Video Azure Communication Services
Azure Communication Services menyediakan kemampuan pengelogan yang dapat Anda gunakan untuk memantau dan men-debug solusi Communication Services Anda. Konfigurasikan kemampuan ini melalui portal Azure.
Konten dalam artikel ini mengacu pada log yang diaktifkan melalui Azure Monitor (lihat juga FAQ). Untuk mengaktifkan log ini untuk Communication Services, lihat Mengaktifkan pengelogan di pengaturan diagnostik.
Konsep data
Deskripsi konsep data tingkat tinggi berikut ini khusus untuk Panggilan Suara dan Panggilan Video. Konsep-konsep ini penting untuk ditinjau sehingga Anda dapat memahami arti data yang diambil dalam log.
Entitas dan ID
Kenali istilah-istilah berikut:
Panggilan: Seperti yang diwakili dalam data, panggilan adalah abstraksi yang digambarkan oleh
correlationId
. Nilai untukcorrelationId
unik untuk setiap panggilan, dan terikat waktu berdasarkancallStartTime
dancallDuration
.Peserta: Mewakili koneksi antara titik akhir dan server. Peserta (
participantId
) hanya ada saat panggilan adalah panggilan grup.Titik akhir: Entitas paling unik, diwakili oleh
endpointId
. Setiap panggilan adalah peristiwa yang berisi data dari dua titik akhir atau lebih. Titik akhir mewakili peserta dalam panggilan.EndpointType
memberi tahu Anda apakah titik akhir adalah pengguna manusia (PSTN atau VoIP), bot, atau server yang mengelola beberapa peserta dalam panggilan.endpointType
Saat nilai adalah"Server"
, titik akhir tidak diberi ID unik. Anda dapat menganalisisendpointType
dan jumlahendpointId
nilai untuk menentukan berapa banyak pengguna dan peserta nonhuman lainnya (bot dan server) bergabung dalam panggilan.SDK asli untuk Android dan iOS menggunakan kembali nilai yang sama
endpointId
untuk pengguna di beberapa panggilan, sehingga Anda bisa mendapatkan pemahaman tentang pengalaman di seluruh sesi. Proses ini berbeda dari titik akhir berbasis web, yang selalu menghasilkan nilai baruendpointId
untuk setiap panggilan baru.Aliran: Entitas yang paling terperinci. Ada satu aliran untuk setiap arah (masuk atau keluar) dan
mediaType
nilai (misalnya,Audio
atauVideo
).
Definisi data
Skema log penggunaan
Properti | Deskripsi |
---|---|
Timestamp |
Stempel waktu (UTC) ketika log dibuat. |
Operation Name |
Operasi yang dikaitkan dengan catatan log. |
Operation Version |
Nilai api-version yang terkait dengan operasi, jika Operation Name operasi dilakukan melalui API. Jika tidak ada API yang sesuai dengan operasi ini, versi mewakili versi operasi, jika properti yang terkait dengan perubahan operasi di masa mendatang. |
Category |
Kategori log kejadian. Kategorinya adalah granularitas di mana Anda dapat mengaktifkan atau menonaktifkan log pada sumber daya. Properti yang muncul dalam properties blob peristiwa sama dalam kategori log dan jenis sumber daya. |
Correlation ID |
ID untuk kejadian berkorelasi. Anda dapat menggunakannya untuk mengidentifikasi peristiwa yang berkorelasi antara beberapa tabel. |
Properties |
Data lain yang berlaku untuk berbagai mode Communication Services. |
Record ID |
ID unik untuk rekaman penggunaan. |
Usage Type |
Mode penggunaan (misalnya, Obrolan, PSTN, atau NAT). |
Unit Type |
Jenis unit yang digunakan didasarkan pada mode penggunaan (misalnya, menit, megabyte, atau pesan). |
Quantity |
Jumlah unit yang digunakan atau dikonsumsi untuk rekaman ini. |
Skema log ringkasan panggilan
Log ringkasan panggilan berisi data untuk membantu Anda mengidentifikasi properti utama semua panggilan. Log ringkasan panggilan yang berbeda dibuat untuk setiap participantId
nilai (atau endpointId
untuk panggilan peer-to-peer [P2P] ) dalam panggilan.
Penting
Informasi peserta dalam log ringkasan panggilan bervariasi berdasarkan penyewa peserta. Versi SDK dan versi OS diredaksi jika peserta tidak berada dalam penyewa yang sama (juga disebut lintas penyewa) sebagai sumber daya Communication Services. Peserta lintas penyewa diklasifikasikan sebagai pengguna eksternal yang diundang oleh penyewa sumber daya untuk bergabung dan berkolaborasi selama panggilan.
Properti | Deskripsi |
---|---|
time |
Stempel waktu (UTC) ketika log dibuat. |
operationName |
Operasi yang dikaitkan dengan catatan log. |
operationVersion |
Nilai api-version yang terkait dengan operasi, jika operationName operasi dilakukan melalui API. Jika tidak ada API yang sesuai dengan operasi ini, versi mewakili versi operasi, jika properti yang terkait dengan perubahan operasi di masa mendatang. |
category |
Kategori log kejadian. Properti ini adalah granularitas di mana Anda dapat mengaktifkan atau menonaktifkan log pada sumber daya. Properti yang muncul dalam properties blob peristiwa sama dalam kategori log dan jenis sumber daya. |
correlationId |
ID unik untuk panggilan. Ini mengidentifikasi peristiwa berkorelasi dari semua peserta dan titik akhir yang terhubung selama satu panggilan, dan Anda dapat menggunakannya untuk menggabungkan data dari log yang berbeda. Jika Anda perlu membuka kasus dukungan dengan Microsoft, Anda dapat menggunakan nilai untuk correlationId dengan mudah mengidentifikasi panggilan yang Sedang Anda pecahkan masalahnya. |
identifier |
ID unik untuk pengguna. Identitas dapat berupa pengguna Azure Communication Services, ID pengguna Microsoft Entra, ID pengguna anonim Teams, atau ID bot Teams. Anda dapat menggunakan ID ini untuk menghubungkan peristiwa pengguna di seluruh log. |
callStartTime |
Stempel waktu untuk awal panggilan, berdasarkan koneksi pertama yang dicoba dari titik akhir apa pun. |
callDuration |
Durasi panggilan, dinyatakan dalam hitungan detik, berdasarkan koneksi pertama yang dicoba dan akhir koneksi terakhir antara dua titik akhir. |
callType |
Jenis panggilan. Ini berisi atau "P2P" "Group" . Panggilan "P2P" adalah koneksi langsung 1:1 antara hanya dua titik akhir nonserver. Panggilan "Group" adalah panggilan yang memiliki lebih dari dua titik akhir atau dibuat sebagai "Group" panggilan sebelum koneksi. |
teamsThreadId |
ID utas Teams. ID ini hanya relevan ketika panggilan diatur sebagai rapat Teams. Kemudian mewakili kasus penggunaan interoperabilitas antara Microsoft Teams dan Azure Communication Services. ID ini dihosting dalam log operasional. Anda juga bisa mendapatkan ID ini melalui API Obrolan. |
participantId |
ID yang dihasilkan untuk mewakili koneksi dua arah antara "Participant" titik akhir (endpointType = "Server" ) dan server. Ketika callType = "P2P" , ada koneksi langsung antara dua titik akhir, dan tidak ada participantId nilai yang dihasilkan. |
participantStartTime |
Stempel waktu untuk awal upaya koneksi pertama peserta. |
participantDuration |
Durasi setiap koneksi peserta dalam hitungan detik, dari participantStartTime ke stempel waktu saat koneksi berakhir. |
participantEndReason |
Alasan berakhirnya koneksi peserta. Ini berisi kode kesalahan Calling SDK yang dikeluarkan SDK (jika relevan) untuk setiap participantId nilai. |
endpointId |
ID unik yang mewakili setiap titik akhir yang tersambung ke panggilan, di mana endpointType menentukan jenis titik akhir. Ketika nilainya null , entitas yang tersambung adalah server Layanan Komunikasi (endpointType = "Server" ). Nilai endpointId terkadang dapat bertahan untuk pengguna yang sama di beberapa panggilan (correlationId ) untuk klien asli. Jumlah endpointId nilai menentukan jumlah log ringkasan panggilan. Log ringkasan yang berbeda dibuat untuk setiap endpointId nilai. |
endpointType |
Nilai ini menjelaskan properti setiap titik akhir yang tersambung ke panggilan. Ini dapat berisi "Server" , "VOIP" , "PSTN" , "BOT" , atau "Unknown" . |
sdkVersion |
String versi untuk versi SDK Panggilan Communication Services yang digunakan setiap titik akhir yang relevan (misalnya, "1.1.00.20212500" ). |
osVersion |
String yang mewakili sistem operasi dan versi setiap perangkat titik akhir. |
participantTenantId |
ID penyewa Microsoft yang terkait dengan identitas peserta. Penyewa dapat menjadi penyewa Azure yang memiliki sumber daya Azure Communication Services atau penyewa Microsoft dari identitas Microsoft 365. Bidang ini digunakan untuk memandu redaksi lintas penyewa. |
participantType |
Deskripsi peserta sebagai kombinasi kliennya (Azure Communication Services atau Teams), dan identitasnya (Azure Communication Services atau Microsoft 365). Nilai yang mungkin termasuk: Azure Communication Services (identitas Azure Communication Services dan Azure Communication Services SDK), Teams (identitas Teams dan klien Teams), Azure Communication Services sebagai pengguna eksternal Teams (identitas Azure Communication Services dan Azure Communication Services SDK dalam panggilan atau rapat Teams), Azure Communication Services sebagai pengguna Microsoft 365 (identitas Microsoft 365 dan klien Azure Communication Services), dan Teams Voice Apps. |
pstnPartcipantCallType |
Mewakili jenis dan arah peserta PSTN termasuk panggilan Darurat, perutean langsung, transfer, penerusan, dan sebagainya. |
ParticipantEndSubCode |
Mewakili subkode kesalahan SDK Panggilan yang dikeluarkan SDK (jika relevan) untuk setiap participantId nilai. |
ResultCategory |
Mewakili kategori peserta yang mengakhiri panggilan. Ini bisa menjadi salah satu dari 4 nilai ini: Success, ExpectedError, UnexpectedClientError, UnexpectedServerError. |
Memanggil skema log diagnostik
Log diagnostik panggilan memberikan informasi penting tentang titik akhir dan transfer media untuk setiap peserta. Mereka juga menyediakan pengukuran yang membantu Anda memahami masalah kualitas.
Untuk setiap titik akhir dalam panggilan, log diagnostik panggilan yang berbeda dibuat untuk aliran media keluar (audio atau video, misalnya) di antara titik akhir. Dalam panggilan P2P, setiap log berisi data yang berkaitan dengan setiap aliran keluar yang terkait dengan setiap titik akhir. Dalam panggilan grup, participantId
berfungsi sebagai pengidentifikasi kunci untuk menggabungkan log keluar terkait ke dalam koneksi peserta yang berbeda. Log diagnostik panggilan tetap utuh dan sama terlepas dari penyewa peserta.
Catatan
Dalam artikel ini, panggilan P2P dan grup berada dalam penyewa yang sama, secara default, untuk semua skenario panggilan yang lintas penyewa. Mereka ditentukan sesuai di seluruh artikel.
Properti | Deskripsi |
---|---|
operationName |
Operasi yang dikaitkan dengan catatan log. |
operationVersion |
Nilai api-version yang terkait dengan operasi, jika operationName operasi dilakukan melalui API. Jika tidak ada API yang sesuai dengan operasi ini, versi mewakili versi operasi, jika properti yang terkait dengan perubahan operasi di masa mendatang. |
category |
Kategori log kejadian. Properti ini adalah granularitas di mana Anda dapat mengaktifkan atau menonaktifkan log pada sumber daya. Properti yang muncul dalam properties blob peristiwa sama dalam kategori log dan jenis sumber daya. |
correlationId |
ID unik untuk panggilan. Ini mengidentifikasi peristiwa yang berkorelasi dari semua peserta dan titik akhir yang terhubung selama satu panggilan. Jika Anda perlu membuka kasus dukungan dengan Microsoft, Anda dapat menggunakan nilai untuk correlationId dengan mudah mengidentifikasi panggilan yang Sedang Anda pecahkan masalahnya. |
participantId |
ID yang dihasilkan untuk mewakili koneksi dua arah antara "Participant" titik akhir (endpointType = "Server" ) dan server. Ketika callType = "P2P" , ada koneksi langsung antara dua titik akhir, dan tidak ada participantId nilai yang dihasilkan. |
identifier |
ID unik untuk pengguna. Identitas dapat menjadi pengguna Azure Communication Services, ID pengguna Microsoft Entra, ID objek Teams, atau ID bot Teams. Anda dapat menggunakan ID ini untuk menghubungkan peristiwa pengguna di seluruh log. |
endpointId |
ID unik yang mewakili setiap titik akhir yang tersambung ke panggilan, di mana endpointType menentukan jenis titik akhir. Ketika nilainya adalah null , entitas yang terhubung adalah server Communication Services. EndpointId dapat bertahan untuk pengguna yang sama di beberapa panggilan (correlationId ) untuk klien asli tetapi unik untuk setiap panggilan ketika klien adalah browser web. |
endpointType |
Nilai yang menjelaskan properti setiap endpointId instans. Ini dapat berisi "Server" , , "PSTN" "VOIP" , "BOT" , "Voicemail" , "Anonymous" , atau "Unknown" . |
mediaType |
Nilai string yang menjelaskan jenis media yang sedang ditransmisikan di antara titik akhir dalam setiap aliran. Nilai yang mungkin termasuk "Audio" , "Video" , "VBSS" (berbagi layar berbasis video), dan "AppSharing" . |
streamId |
Bilangan bulat nonunique yang, bersama dengan mediaType , Anda dapat menggunakan untuk mengidentifikasi aliran dengan nilai yang sama participantId secara unik. |
transportType |
Nilai string yang menjelaskan protokol transportasi jaringan untuk setiap participantId nilai. Ini dapat berisi "UDP" , , "TCP" atau "Unrecognized" . "Unrecognized" menunjukkan bahwa sistem tidak dapat menentukan apakah jenis transportasi adalah TCP atau UDP. |
roundTripTimeAvg |
Waktu rata-rata yang diperlukan untuk mendapatkan paket IP dari satu titik akhir ke titik akhir lainnya dalam satu participantDuration periode. Penundaan penyebaran jaringan ini terkait dengan jarak fisik antara dua titik, kecepatan cahaya, dan overhead apa pun yang diambil berbagai router di antaranya. Latensi diukur sebagai waktu satu arah atau waktu pulang pergi (RTT). Nilainya dinyatakan dalam milidetik. RTT yang lebih besar dari 500 ms berdampak negatif pada kualitas panggilan. |
roundTripTimeMax |
RTT maksimum (dalam milidetik) diukur untuk mencapai aliran media selama participantDuration periode dalam panggilan grup atau selama callDuration periode dalam panggilan P2P. |
jitterAvg |
Jitter adalah perubahan rata-rata dalam penundaan kedatangan antara paket yang terjadi berturut-turut. Azure Communication Services dapat beradaptasi dengan beberapa tingkat jitter melalui buffering. Ketika jitter melebihi buffering, yang kira-kira pada jitterAvg waktu yang lebih besar dari 30 ms, itu dapat berdampak negatif pada kualitas. Paket yang tiba dengan kecepatan yang berbeda menyebabkan suara pembicara terdengar seperti robot. Metrik ini diukur untuk setiap aliran media selama participantDuration periode dalam panggilan grup atau selama callDuration periode dalam panggilan P2P. |
jitterMax |
Nilai jitter maksimum yang diukur antara paket untuk setiap aliran media. Ledakan dalam kondisi jaringan dapat menyebabkan masalah dalam arus lalu lintas audio/video. |
packetLossRateAvg |
Persentase rata-rata paket yang hilang. Kehilangan paket secara langsung memengaruhi kualitas audio. Paket kecil yang hilang hampir tidak berdampak, sedangkan kerugian semburan back-to-back menyebabkan audio dipotong sepenuhnya. Paket yang dijatuhkan dan tidak tiba di tujuan yang dimaksudkan menyebabkan kesenjangan di media. Situasi ini menghasilkan suku kata dan kata yang terlewat, bersama dengan video dan berbagi yang terpotong. Tingkat kehilangan paket yang lebih besar dari 10% (0,1) kemungkinan memiliki dampak kualitas negatif. Metrik ini diukur untuk setiap aliran media selama participantDuration periode dalam panggilan grup atau selama callDuration periode dalam panggilan P2P. |
packetLossRateMax |
Nilai ini menunjukkan tingkat kehilangan paket maksimum (persentase) untuk setiap aliran media selama participantDuration periode dalam panggilan grup atau selama callDuration periode dalam panggilan P2P. Ledakan dalam kondisi jaringan dapat menyebabkan masalah dalam arus lalu lintas audio/video. |
JitterBufferSizeAvg |
Ukuran rata-rata buffer jitter selama durasi setiap aliran media. Buffer jitter adalah area data bersama tempat paket suara dapat dikumpulkan, disimpan, dan dikirim ke prosesor suara dalam interval yang merata. Buffer jitter digunakan untuk melawan efek jitter. Buffer jitter bisa statis atau dinamis. Buffer jitter statis diatur ke ukuran tetap, sementara buffer jitter dinamis dapat menyesuaikan ukurannya berdasarkan kondisi jaringan. Tujuan dari buffer jitter adalah untuk memberikan aliran data audio dan video yang lancar dan tidak terganggu kepada pengguna. Di SDK web, ini JitterBufferSizeAvg adalah nilai jitterBufferDelay rata-rata selama panggilan. jitterBufferDelay adalah durasi sampel audio atau bingkai video yang tetap berada di buffer jitter. Biasanya ketika JitterBufferSizeAvg nilai lebih besar dari 200 ms, nilai tersebut berdampak negatif pada kualitas. |
JitterBufferSizeMax |
Ukuran buffer jitter maksimum yang diukur selama durasi setiap aliran media. Biasanya ketika nilai ini lebih besar dari 200 ms, nilai ini berdampak negatif pada kualitas. |
HealedDataRatioAvg |
Persentase rata-rata paket data yang hilang atau rusak berhasil direkonstruksi atau dipulihkan oleh penyembuh selama durasi aliran audio. Rasio data yang disembuhkan adalah ukuran efektivitas teknik koreksi kesalahan yang digunakan dalam sistem VoIP. Ketika nilai ini lebih besar dari 0,1 (10%), kami menganggap aliran sebagai kualitas buruk. |
HealedDataRatioMax |
Rasio data maksimum yang disembuhkan diukur selama durasi setiap aliran media. Ketika nilai ini lebih besar dari 0,1 (10%), kami menganggap aliran sebagai kualitas buruk. |
VideoFrameRateAvg |
Jumlah rata-rata bingkai video yang ditransmisikan per detik selama panggilan video/screensharing. Kecepatan bingkai video dapat berdampak pada kualitas dan kelancaran aliran video, dengan kecepatan bingkai yang lebih tinggi umumnya menghasilkan gerakan yang lebih halus dan lebih lancar. Kecepatan bingkai standar untuk video WebRTC biasanya 30 bingkai per detik (fps), meskipun kecepatan bingkai dapat bervariasi tergantung pada implementasi dan kondisi jaringan tertentu. Kualitas streaming dianggap buruk ketika nilai ini kurang dari 7 untuk streaming video, atau kurang dari 1 untuk aliran berbagi layar. |
RecvResolutionHeight |
Rata-rata ukuran vertikal aliran video masuk yang ditransmisikan selama panggilan video/screensharing. Ini diukur dalam piksel dan merupakan salah satu faktor yang menentukan resolusi keseluruhan dan kualitas aliran video. Resolusi spesifik yang digunakan dapat bergantung pada kemampuan perangkat dan kondisi jaringan yang terlibat dalam panggilan. Kualitas streaming dianggap buruk ketika nilai ini kurang dari 240 untuk streaming video, atau kurang dari 768 untuk aliran berbagi layar. |
RecvFreezeDurationPerMinuteInMs |
Durasi pembekuan rata-rata dalam milidetik per menit untuk streaming video/screensharing masuk. Pembekuan biasanya karena kondisi jaringan yang buruk dan dapat menurunkan kualitas aliran. Kualitas streaming dianggap buruk ketika nilai ini lebih besar dari 6.000 ms untuk streaming video, atau lebih besar dari 25.000 ms untuk aliran berbagi layar. |
PacketUtilization |
Paket dikirim atau diterima untuk aliran media tertentu. Biasanya semakin lama panggilan, semakin tinggi nilainya. Jika nilai ini nol, itu bisa menunjukkan bahwa media tidak mengalir. |
VideoBitRateAvg |
Laju bit rata-rata (bit per detik) untuk streaming video atau screenshare. Nilai laju bit rendah dapat menunjukkan masalah jaringan yang buruk. Laju bit minimum (bandwidth) yang diperlukan dapat ditemukan di sini: Bandwidth jaringan. |
VideoBitRateMax |
Laju bit maksimum (bit per detik) untuk streaming video atau screenshare. Nilai laju bit rendah dapat menunjukkan masalah jaringan yang buruk. Laju bit minimum (bandwidth) yang diperlukan dapat ditemukan di sini: Bandwidth jaringan. |
StreamDirection |
Arah aliran media. Ini adalah Masuk atau Keluar. |
CodecName |
Nama codec yang digunakan untuk memproses aliran media. Bisa OPUS, G722, H264S, SATIN, dan sebagainya. |
Memanggil skema log operasi klien
Log operasi klien panggilan menyediakan informasi sisi klien tentang titik akhir panggilan dan peserta yang terlibat dalam panggilan. Log ini saat ini dalam pratinjau dan menampilkan peristiwa klien yang terjadi dalam panggilan dan tindakan mana yang diambil pelanggan selama panggilan.
Log ini menyediakan informasi terperinci tentang tindakan yang diambil selama panggilan dan dapat digunakan untuk memvisualisasikan dan menyelidiki masalah panggilan dengan menggunakan Diagnostik Panggilan untuk Sumber Daya Azure Communication Services Anda. Pelajari selengkapnya tentang Diagnostik Panggilan
Properti | Deskripsi |
---|---|
CallClientTimeStamp |
Tanda waktu ketika pada operasi terjadi pada SDK di UTC. |
OperationName |
Nama operasi yang dipicu pada SDK panggilan. |
CallId |
ID unik untuk panggilan. Ini mengidentifikasi peristiwa berkorelasi dari semua peserta dan titik akhir yang terhubung selama satu panggilan, dan Anda dapat menggunakannya untuk menggabungkan data dari log yang berbeda. Ini mirip dengan correlationId dalam log ringkasan panggilan dan memanggil log diagnostik. |
ParticipantId |
Pengidentifikasi unik untuk setiap kaki panggilan (dalam panggilan Grup) atau peserta panggilan (dalam panggilan Peer to Peer). ID ini adalah titik korelasi utama antara log CallSummary, CallDiagnostic, CallClientOperations, dan CallClientMediaStats. |
OperationType |
Panggil Operasi Klien. |
OperationId |
GGUID unik yang mengidentifikasi operasi SDK. |
DurationMs |
Waktu yang diperlukan oleh operasi SDK Panggilan gagal atau berhasil. |
ResultType |
Bidang yang menjelaskan keberhasilan atau kegagalan operasi. |
ResultSignature |
Kegagalan seperti HTTP atau kode keberhasilan (200, 500). |
SdkVersion |
Versi SDK Panggilan yang digunakan. |
UserAgent |
String agen pengguna standar berdasarkan browser atau platform Calling SDK digunakan. |
ClientInstanceId |
GGUID unik yang mengidentifikasi objek CallClient. |
EndpointId |
ID unik yang mewakili setiap titik akhir yang tersambung ke panggilan, di mana endpointType menentukan jenis titik akhir. Ketika nilai null, entitas yang terhubung adalah server Communication Services (endpointType = "Server"). Nilai endpointId terkadang dapat bertahan untuk pengguna yang sama di beberapa panggilan (correlationId) untuk klien asli. Jumlah nilai endpointId menentukan jumlah log ringkasan panggilan. Log ringkasan yang berbeda dibuat untuk setiap nilai endpointId. |
OperationPayload |
Payload dinamis yang bervariasi berdasarkan operasi yang memberikan detail spesifik operasi yang lebih spesifik. |
Memanggil skema log rangkaian waktu statistik media klien
Log rangkaian waktu statistik media klien panggilan menyediakan informasi sisi klien tentang aliran media antara masing-masing peserta yang terlibat dalam panggilan. Log ini saat ini berada dalam pratinjau terbatas dan menyediakan data rangkaian waktu terperinci tentang audio, video, dan uap media berbagi layar antara peserta dengan interval agregasi default 10 detik. Log berisi informasi rangkaian waktu terperinci tentang jenis aliran media, arah, codec, dan properti laju bit (misalnya, maks, min, rata-rata).
Log ini memberikan informasi yang lebih rinci daripada log Diagnostik Panggilan untuk memahami kualitas uap media antar peserta. Ini dapat digunakan untuk memvisualisasikan dan menyelidiki masalah kualitas untuk panggilan Anda melalui Diagnostik Panggilan untuk Sumber Daya Azure Communication Services Anda. Pelajari selengkapnya tentang Diagnostik Panggilan
Properti | Deskripsi |
---|---|
OperationName |
Operasi yang dikaitkan dengan catatan log. |
CallId |
ID unik untuk panggilan. Ini mengidentifikasi peristiwa berkorelasi dari semua peserta dan titik akhir yang terhubung selama satu panggilan, dan Anda dapat menggunakannya untuk menggabungkan data dari log yang berbeda. Ini mirip dengan correlationId dalam log ringkasan panggilan dan memanggil log diagnostik. |
CallClientTimeStamp |
Tanda waktu ketika statistik media direkam. |
MetricName |
Nama statistik media, seperti , , JitterInMs PacketsPerSecond , dan sebagainyaBitrate . |
Count |
Jumlah titik data yang diambil sampelnya pada tanda waktu tertentu. |
Sum |
Jumlah nilai metrik dari semua titik data yang diambil sampelnya. |
Average |
Nilai metrik rata-rata dari titik data yang diambil sampelnya. Rata-rata = Jumlah/Hitungan. |
Minimum |
Minimum nilai metrik dari semua titik data yang diambil sampelnya. |
Maximum |
Maksimum nilai metrik dari semua titik data yang diambil sampelnya. |
MediaStreamDirection |
Arah aliran media. Bisa atau send receive . |
MediaStreamType |
Jenis aliran media. Bisa berupa video , audio , atau screen . |
MediaStreamCodec |
Codec yang digunakan untuk mengodekan/mendekode aliran media, seperti H264 , , VP8 OPUS , dan sebagainya. |
ParticipantId |
ID unik yang dihasilkan untuk mewakili setiap titik akhir dalam panggilan. |
ClientInstanceId |
ID unik yang mewakili objek Klien Panggilan yang dibuat di SDK panggilan. |
EndpointId |
ID unik yang mewakili setiap titik akhir yang tersambung ke panggilan. EndpointId dapat bertahan untuk pengguna yang sama di beberapa panggilan (callIds ) untuk klien asli tetapi unik untuk setiap panggilan ketika klien adalah browser web. EndpointId saat ini tidak diinstrumentasikan dalam log ini. Saat diimplementasikan, nilainya cocok dengan dalam log CallSummary/Diagnostics |
RemoteParticipantId |
ID unik yang mewakili titik akhir jarak jauh di aliran media. Misalnya, pengguna dapat merender beberapa aliran video untuk pengguna lain dalam panggilan yang sama. Setiap aliran video memiliki yang berbeda RemoteParticipantId . |
RemoteEndpointId |
Sama seperti EndpointId , tetapi mewakili pengguna di sisi jarak jauh aliran. |
MediaStreamId |
ID unik yang mewakili setiap aliran media dalam panggilan. MediaStreamId saat ini tidak diinstrumentasikan dalam klien. Saat diimplementasikan, kolom cocok dengan streamId kolom di log CallDiagnostics. |
AggregationIntervalSeconds |
Interval waktu untuk menggabungkan statistik media. Saat ini di SDK Panggilan, metrik media diambil sampelnya setiap 1 detik, dan ketika kami melaporkan dalam log, kami menggabungkan semua sampel setiap 10 detik. Jadi setiap baris dalam tabel ini memiliki, paling banyak, 10 titik pengambilan sampel. |
Panggilan P2P vs. grup
Ada dua jenis panggilan, seperti yang diwakili oleh callType
:
Panggilan Peer to Peer (P2P): Koneksi antara hanya dua titik akhir, tanpa titik akhir server. Panggilan P2P dimulai sebagai panggilan antara titik akhir tersebut dan tidak dibuat sebagai peristiwa panggilan grup sebelum koneksi.
Panggilan grup: Setiap panggilan yang memiliki lebih dari dua titik akhir tersambung. Panggilan grup mencakup titik akhir server dan koneksi antara setiap titik akhir dan server. Panggilan P2P yang menambahkan titik akhir lain selama panggilan berhenti menjadi P2P, dan mereka menjadi panggilan grup. Anda dapat menentukan garis waktu kapan setiap titik akhir bergabung dengan panggilan dengan menggunakan
participantStartTime
metrik danparticipantDuration
.
Struktur log
Azure Communication Services membuat empat jenis log:
Log ringkasan panggilan: Berisi informasi dasar tentang panggilan, termasuk semua ID, stempel waktu, titik akhir, dan informasi SDK yang relevan. Untuk setiap peserta dalam panggilan, Communication Services membuat log ringkasan panggilan yang berbeda.
Jika seseorang bergabung kembali dengan panggilan, peserta tersebut memiliki nilai yang sama
EndpointId
tetapi nilai yang berbedaParticipantId
. Titik akhir tersebut kemudian dapat memiliki dua log ringkasan panggilan.Log diagnostik panggilan: Berisi informasi tentang aliran, bersama dengan serangkaian metrik yang menunjukkan kualitas pengukuran pengalaman. Untuk setiap
EndpointId
dalam panggilan (termasuk server), Azure Communication Services membuat log diagnostik panggilan yang berbeda untuk setiap aliran media (audio atau video, misalnya) di antara titik akhir.Memanggil log operasi klien: Berisi peristiwa klien panggilan terperinci. Peristiwa log ini dihasilkan untuk masing-masing
EndpointId
dalam panggilan dan jumlah log peristiwa yang dihasilkan tergantung pada operasi yang dilakukan peserta selama panggilan.Memanggil log statistik media klien: Berisi nilai aliran media terperinci. Log ini dihasilkan untuk setiap aliran media dalam panggilan. Untuk setiap
EndpointId
dalam panggilan (termasuk server), Azure Communication Services membuat log yang berbeda untuk setiap aliran media (audio atau video, misalnya) di antara titik akhir. Volume data yang dihasilkan di setiap log tergantung pada durasi panggilan dan jumlah uap media dalam panggilan.
Dalam panggilan P2P, setiap log berisi data yang berkaitan dengan setiap aliran keluar yang terkait dengan setiap titik akhir. Dalam panggilan grup, setiap aliran yang terkait dengan endpointType
= "Server"
membuat log yang berisi data untuk aliran masuk. Semua aliran lain membuat log yang berisi data untuk aliran keluar untuk semua titik akhir nonserver. Dalam panggilan grup, gunakan participantId
nilai sebagai kunci untuk menggabungkan log masuk dan keluar terkait ke dalam koneksi peserta yang berbeda.
Contoh: Panggilan P2P
Diagram berikut mewakili dua titik akhir yang tersambung langsung dalam panggilan P2P. Dalam contoh ini, Communication Services membuat dua log ringkasan panggilan (satu untuk setiap participantID
nilai) dan empat log diagnostik panggilan (satu untuk setiap aliran media).
Untuk peserta klien panggilan Azure Communication Services, ada juga serangkaian log operasi klien panggilan dan memanggil log rangkaian waktu statistik media klien. Jumlah pasti log ini tergantung pada jenis operasi SDK apa yang dipanggil dan durasi panggilan.
Contoh: Panggilan grup
Diagram berikut mewakili contoh panggilan grup dengan tiga participantId
nilai (yang berarti tiga peserta) dan titik akhir server. Beberapa nilai untuk endpointId
berpotensi muncul di beberapa peserta--misalnya, ketika mereka bergabung kembali dengan panggilan dari perangkat yang sama. Communication Services membuat satu log ringkasan panggilan untuk setiap participantId
nilai. Ini membuat empat log diagnostik panggilan: satu untuk setiap aliran media per participantId
.
Untuk peserta klien panggilan Azure Communication Services, log operasi klien panggilan sama dengan panggilan P2P. Untuk setiap peserta yang menggunakan SDK panggilan, ada serangkaian log operasi klien panggilan.
Untuk peserta klien panggilan Azure Communication Services, log operasi klien panggilan dan log rangkaian waktu statistik media klien panggilan sama dengan panggilan P2P. Untuk setiap peserta yang menggunakan SDK panggilan, ada serangkaian log operasi klien panggilan dan memanggil log rangkaian waktu statistik media klien.
Contoh: Panggilan P2P lintas penyewa
Diagram berikut mewakili dua peserta di beberapa penyewa yang tersambung langsung dalam panggilan P2P. Dalam contoh ini, Communication Services membuat satu log ringkasan panggilan (satu untuk setiap peserta) dengan versi OS dan SDK yang diredaksi. Communication Services juga membuat empat log diagnostik panggilan (satu untuk setiap aliran media). Setiap log berisi data yang berkaitan dengan aliran keluar .participantID
Contoh: Panggilan grup lintas penyewa
Diagram berikut mewakili contoh panggilan grup dengan tiga participantId
nilai di beberapa penyewa. Communication Services membuat satu log ringkasan panggilan untuk setiap peserta dengan versi OS dan SDK yang diredaksi. Communication Services juga membuat empat log diagnostik panggilan yang terkait dengan setiap participantId
nilai (satu untuk setiap aliran media).
Catatan
Rilis ini hanya mendukung log diagnostik keluar. Versi OS dan SDK yang terkait dengan bot dan peserta dapat diredaksi karena Communication Services memperlakukan identitas peserta dan bot dengan cara yang sama.
Data sampel
Panggilan P2P
Berikut adalah bidang bersama untuk semua log dalam panggilan 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": "8d1a8374-344d-4502-b54b-ba2d6daaf0ae",
Log ringkasan panggilan
Informasi operasi dan kategori log ringkasan panggilan:
"operationName": "CallSummary",
"operationVersion": "1.0",
"category": "CallSummary",
Berikut adalah ringkasan panggilan untuk pengguna 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"
}
Berikut adalah ringkasan panggilan untuk pengguna 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"
}
Berikut adalah log ringkasan panggilan lintas penyewa untuk pengguna 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"
}
Berikut adalah ringkasan panggilan untuk panggilan PSTN:
Catatan
Log panggilan P2P atau grup memiliki versi OS dan SDK yang diredaksi terlepas dari apakah itu penyewa peserta atau penyewa bot.
"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"
}
Log diagnostik panggilan
Log diagnostik panggilan berbagi informasi operasi:
"operationName": "CallDiagnostics",
"operationVersion": "1.0",
"category": "CallDiagnostics",
Berikut adalah log diagnostik untuk aliran audio dari titik akhir VoIP 1 ke titik akhir VoIP 2:
"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"
}
Berikut adalah log diagnostik untuk aliran audio dari titik akhir VoIP 2 ke titik akhir VoIP 1:
"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"
}
Berikut adalah log diagnostik untuk aliran video dari titik akhir VoIP 1 ke titik akhir VoIP 2:
"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"
}
Panggilan grup
Data untuk panggilan grup dihasilkan dalam tiga log ringkasan panggilan dan enam log diagnostik panggilan. Berikut adalah bidang bersama untuk semua log dalam panggilan:
"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",
Log ringkasan panggilan
Informasi operasi dan kategori log ringkasan panggilan:
"operationName": "CallSummary",
"operationVersion": "1.0",
"category": "CallSummary",
Berikut adalah ringkasan panggilan untuk titik akhir 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"
}
Berikut adalah ringkasan panggilan untuk titik akhir 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"
}
Berikut adalah ringkasan panggilan untuk titik akhir 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"
}
Berikut adalah log ringkasan panggilan lintas penyewa:
"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"
}
Berikut adalah log ringkasan panggilan lintas penyewa dengan bot sebagai peserta:
"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"
}
Log diagnostik panggilan
Log diagnostik panggilan berbagi informasi operasi:
"operationName": "CallDiagnostics",
"operationVersion": "1.0",
"category": "CallDiagnostics",
Berikut adalah log diagnostik untuk aliran audio dari titik akhir VoIP 1 ke titik akhir server:
"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"
}
Berikut adalah log diagnostik untuk aliran audio dari titik akhir server ke titik akhir VoIP 1:
"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"
}
Berikut adalah log diagnostik untuk aliran audio dari titik akhir VoIP 3 ke titik akhir server:
"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"
}
Berikut adalah log diagnostik untuk aliran audio dari titik akhir server ke titik akhir VoIP 3:
"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",
Memanggil log operasi klien dan memanggil log statistik media klien untuk P2P dan panggilan grup
Untuk log operasi klien panggilan dan log rangkaian waktu statistik media klien panggilan, tidak ada perbedaan antara skenario panggilan P2P dan grup dan jumlah log tergantung pada operasi SDK dan durasi panggilan. Kode berikut adalah sampel generik yang menunjukkan skema log ini.
Memanggil log operasi klien
Berikut adalah log operasi klien panggilan untuk operasi "CreateView":
"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"
}
Setiap peserta dapat memiliki banyak metrik yang berbeda untuk panggilan. Anda dapat menjalankan kueri berikut di Analitik Log di portal Azure untuk mencantumkan semua operasi yang mungkin dalam log operasi klien panggilan:
ACSCallClientOperations | distinct OperationName
Memanggil log rangkaian waktu statistik media klien
Berikut adalah contoh log rangkaian waktu statistik media. Ini menunjukkan metrik Jitter peserta untuk menerima aliran audio pada tanda waktu tertentu.
"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"
}
Setiap peserta dapat memiliki banyak metrik statistik media yang berbeda untuk panggilan. Kueri berikut dapat dijalankan di Analitik Log di portal Azure untuk menampilkan semua metrik yang mungkin dalam log ini:
ACSCallClientMediaStatsTimeSeries | distinct MetricName
Kode kesalahan
Properti participantEndReason
berisi nilai dari kumpulan kode kesalahan SDK Panggilan. Anda dapat merujuk ke kode ini untuk memecahkan masalah selama panggilan, untuk setiap titik akhir. Lihat Memecahkan masalah kode respons akhir panggilan untuk Memanggil SDK, Call Automation SDK, PSTN, Chat SDK, dan SMS SDK.
Langkah berikutnya
Pelajari tentang dasbor wawasan untuk memantau log dan metrik Panggilan Suara dan Panggilan Video.
Pelajari praktik terbaik untuk mengelola kualitas dan keandalan panggilan Anda, lihat: Meningkatkan dan mengelola kualitas panggilan
Pelajari cara menggunakan log panggilan untuk mendiagnosis masalah kualitas dan keandalan panggilan dengan Diagnostik Panggilan, lihat: Diagnostik Panggilan