Log Panggilan Suara dan Panggilan Video Azure Communication Services

Artikel
05/09/2024

Azure Communication Services menawarkan kemampuan pengelogan yang dapat Anda gunakan untuk memantau dan men-debug solusi Communication Services Anda. Anda mengonfigurasi 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 untuk correlationId unik untuk setiap panggilan, dan terikat waktu oleh callStartTime dan callDuration.
Peserta: Entitas ini mewakili koneksi antara titik akhir dan server. Peserta (participantId) hanya ada saat panggilan adalah panggilan grup.
Titik akhir: Ini adalah entitas paling unik, yang 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 menganalisis endpointType dan jumlah endpointId 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 baru endpointId untuk setiap panggilan baru.
Aliran: Ini adalah entitas yang paling terperinci. Ada satu aliran untuk setiap arah (masuk atau keluar) dan mediaType nilai (misalnya, Audio atau Video).

Definisi data

Skema log penggunaan

Properti	Deskripsi
`Timestamp`	Stempel waktu (UTC) saat log dihasilkan.
`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 masing-masing participantId (endpointId dalam kasus 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) saat log dihasilkan.
`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. Ini didasarkan pada koneksi percobaan pertama 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 non-server. 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 M365. 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 M365 dan klien Azure Communication Services), dan Teams Voice Apps.
`pstnPartcipantCallType`	Ini mewakili jenis dan arah peserta PSTN termasuk panggilan Darurat, perutean langsung, transfer, penerusan, dll.

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 non-unik 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, dampak kualitas negatif kemungkinan terjadi. 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 web SDK, 'JitterBufferSizeAvg' ini adalah nilai rata-rata 'jitterBufferDelay' selama panggilan, 'jitterBufferDelay' adalah durasi sampel audio atau bingkai video yang tetap berada di buffer jitter. Biasanya ketika nilai 'JitterBufferSizeAvg' lebih besar dari 200 ms, itu akan menyebabkan dampak kualitas negatif.
`JitterBufferSizeMax`	Ukuran buffer jitter maksimum yang diukur selama durasi setiap aliran media. Biasanya ketika nilai ini lebih besar dari 200 ms, itu akan menyebabkan dampak kualitas negatif.
`HealedDataRatioAvg`	Persentase rata-rata paket data yang hilang atau rusak yang 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 ini 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 streaming 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 streaming 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 streaming pembajakan layar.

Memanggil skema log operasi klien

Penting

Fungsionalitas yang dijelaskan dalam artikel ini saat ini dalam pratinjau publik. Versi pratinjau ini disediakan tanpa perjanjian tingkat layanan, dan tidak disarankan untuk beban kerja produksi. Fitur tertentu mungkin tidak didukung atau mungkin memiliki kemampuan terbatas. Untuk mengetahui informasi selengkapnya, lihat Ketentuan Penggunaan Tambahan untuk Pratinjau Microsoft Azure.

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 apa yang mungkin dilakukan 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 log diagnostik panggilan.
`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`	HTTP seperti kegagalan 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

Penting

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 pada uap media audio, video, dan screenshare antara peserta dengan interval agregasi default 10 detik. Log berisi informasi rangkaian waktu terperinci tentang jenis aliran media, arah, codec serta 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 log diagnostik panggilan.
`CallClientTimeStamp`	Tanda waktu ketika statistik media direkam.
`MetricName`	Nama statistik media, seperti Bitrate, JitterInMs, PacketsPerSecond dll.
`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. Ini dapat dikirim atau diterima
`MediaStreamType`	Jenis aliran media. Bisa berupa video, audio, atau layar.
`MediaStreamCodec`	Codec yang digunakan untuk mengodekan/mendekode aliran media, seperti H264, OPUS, VP8, dll.
`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. Perhatikan bahwa EndpointId saat ini tidak diinstrumentasikan dalam log ini. Saat diimplementasikan di masa mendatang, nilainya akan cocok dengan nilai 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 RemoteParticipantId yang berbeda.
`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 streamId akan cocok dengan di log CallDiagnostics.
`AggregationIntervalSeconds`	Interval waktu untuk menggabungkan statistik media. Saat ini dalam memanggil SDK, 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 paling banyak memiliki 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 dan participantDuration .

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 berbeda ParticipantId . 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 akan bergantung 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 non-server. 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 (ACS) juga akan ada 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 berapa lama panggilan.

Diagram yang memperlihatkan panggilan P2P dalam penyewa yang sama.

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 klien panggilan Azure Communication Services (ACS), log operasi klien panggilan sama dengan panggilan P2P. Untuk setiap peserta yang menggunakan SDK panggilan, akan ada serangkaian log operasi klien panggilan.

Untuk klien panggilan Azure Communication Services (ACS), log operasi klien panggilan dan log rangkaian waktu statistik media klien panggilan sama dengan panggilan P2P. Untuk setiap peserta yang menggunakan SDK panggilan, akan ada serangkaian log operasi klien panggilan dan memanggil log rangkaian waktu statistik media klien.

Diagram yang memperlihatkan panggilan grup dalam penyewa yang sama.

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

Diagram yang memperlihatkan panggilan P2P lintas penyewa.

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).

Diagram yang memperlihatkan panggilan grup lintas penyewa.

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

Log ringkasan panggilan memiliki informasi operasi dan kategori bersama:

"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

Log ringkasan panggilan memiliki informasi operasi dan kategori bersama:

"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. Berikut ini menyediakan beberapa 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. Kueri berikut dapat dijalankan di Analitik Log di portal Azure untuk mencantumkan semua kemungkinan Operasi dalam log operasi klien panggilan:

ACSCallClientOperations | distinct OperationName

Memanggil log rangkaian waktu statistik media klien

Berikut ini 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 Microsoft 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 Pemecahan Masalah di Azure Communication Services.

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

Share via

Log Panggilan Suara dan Panggilan Video Azure Communication Services

Konsep data

Entitas dan ID

Definisi data

Skema log penggunaan

Skema log ringkasan panggilan

Memanggil skema log diagnostik

Memanggil skema log operasi klien

Memanggil skema log rangkaian waktu statistik media klien

Panggilan P2P vs. grup

Struktur log

Contoh: Panggilan P2P

Contoh: Panggilan grup

Contoh: Panggilan P2P lintas penyewa

Contoh: Panggilan grup lintas penyewa

Data sampel

Panggilan P2P

Log ringkasan panggilan

Log diagnostik panggilan

Panggilan grup

Log ringkasan panggilan

Log diagnostik panggilan

Memanggil log operasi klien dan memanggil log statistik media klien untuk P2P dan panggilan grup

Memanggil log operasi klien

Memanggil log rangkaian waktu statistik media klien

Kode kesalahan

Langkah berikutnya

Sumber Daya Tambahan: