Metrik voice
Halaman Metrik di dashboard Bird mengagregasi leg panggilan yang ditempatkan dan diterima workspace Anda: berapa yang tersambung, berapa lama berlangsung, bagaimana berakhir, dan ke mana tujuannya. Gunakan untuk pelaporan panggilan dalam suatu periode. Untuk melacak satu panggilan tertentu, buka log panggilan.
Satu panggilan dapat memiliki beberapa leg, seperti sambungan yang dibuat saat mengalihkan panggilan atau menghubungi pihak lain. Setiap leg dihitung secara terpisah dalam metrik ini.
Sebuah leg dihitung berdasarkan waktu mulainya dan diagregasi setelah berakhir, sehingga bucket terbaru terus terisi selama masih ada panggilan aktif. Halaman ini memerlukan akses baca voice dan analytics pada peran workspace Anda.
Baca metrik Anda
Buka Voice > Metrik. Empat tab berbagi satu pemilih rentang dan satu baris filter: Ringkasan, Kualitas panggilan, Nomor dan perutean, dan Pola trafik. Berpindah tab mempertahankan rentang dan filter Anda.
Pemilih rentang menyediakan 24 jam terakhir atau 7, 30, atau 90 hari, dan dimulai pada 7 hari. Rentang hari dikelompokkan menurut hari kalender lokal Anda; rentang 24 jam adalah jendela bergulir berisi 24 bucket per jam. Menyeret di sepanjang grafik waktu mempersempit setiap kartu di halaman ke rentang tersebut.
Empat filter digabungkan: Nomor Anda (sisi Anda pada leg), Tujuan (negara tujuan leg), Trunk SIP, dan Hasil. Setiap filter yang diterapkan memiliki chip tersendiri yang dapat Anda hapus, dan sebagian besar kartu memiliki kontrol untuk menerapkan filter bagi baris yang sedang Anda lihat.
Rasio jawab dan durasi panggilan
Tab Ringkasan diawali dengan lima tile. Empat tile pertama menampilkan perubahan terhadap jendela sebelumnya dengan panjang yang sama:
- Rasio jawab terhadap upaya: jumlah leg yang dijawab dibagi jumlah seluruh upaya dalam rentang. Upaya yang berakhir tanpa jawaban tetap masuk penyebut, sehingga ASR turun saat rute gagal menyambungkan panggilan maupun saat nomor yang Anda hubungi tidak mengangkat. Perubahannya dinyatakan sebagai selisih dalam poin persentase.
- Durasi panggilan rata-rata: rata-rata durasi yang dapat ditagih dari leg yang dijawab. Leg yang tidak dijawab tidak disertakan, jadi ACD tidak menunjukkan seberapa sering panggilan tersambung. Beberapa leg yang sangat panjang menaikkan rata-rata di atas median; distribusi durasi pada tab Kualitas panggilan menunjukkan sebaran tersebut.
- Total leg dan Leg yang dijawab: dua jumlah yang digunakan untuk menghitung ASR.
- Nomor unik: jumlah nomor berbeda di sisi lain, masing-masing dihitung sekali berapa pun jumlah leg yang menggunakannya. Jika dibandingkan dengan total leg, angka ini membedakan trafik yang tersebar ke banyak pihak dari trafik yang terkonsentrasi pada beberapa pihak.
Volume panggilan dan rasio jawab dari waktu ke waktu
Grafik tren menumpuk leg yang dijawab dan leg lainnya hingga mencapai volume total periode pada sumbu kiri, serta menampilkan ASR sebagai garis pada sumbu kanan dari 0 hingga 100%. Interval bucket mengikuti rentang: per jam untuk rentang 24 jam, per hari untuk rentang lainnya. Membaca keduanya bersama-sama membedakan pertumbuhan dari penurunan kualitas: garis datar di bawah tumpukan yang naik berarti trafik bertambah pada rute yang tetap berhasil menyambungkan panggilan, sedangkan garis menurun di bawah tumpukan datar berarti rute mulai gagal menyambungkan panggilan. Lihat semua leg di bawah kartu membuka log leg untuk jendela waktu yang sama.
Bagaimana panggilan berakhir
Grafik donat dan legenda membagi upaya leg dalam rentang menurut hasil akhir, masing-masing dengan jumlah dan bagiannya dari total leg:
| Hasil | Artinya |
|---|---|
| Dijawab | Leg tersambung |
| Tidak dijawab | Waktu habis, yang bukan bukti bahwa telepon berdering |
| Gagal | Ditolak oleh ujung lain atau jaringan |
| Ditolak | Ditolak oleh ujung lain, atau ditolak oleh Bird |
| Tidak diketahui | Hasil tidak dapat ditentukan |
| Lainnya | Hasil yang belum tercantum dalam daftar ini |
Hasil tanpa leg dalam rentang tidak ditampilkan. Untuk mengetahui alasan penolakan, bukan sekadar frekuensinya, buka leg tersebut: Panggilan yang ditolak menjelaskan alasan yang dicatat Bird pada setiap leg.
Negara teratas
Tabel negara mengurutkan 10 negara tujuan teratas berdasarkan volume leg, dan catatan di bawahnya menunjukkan berapa negara yang memiliki aktivitas dalam rentang tersebut. Negara ini adalah tujuan leg: negara yang Anda hubungi pada leg keluar dan negara nomor Anda sendiri pada leg masuk.
Pada rentang harian, catatan di bawah tabel juga menunjukkan bagian leg Anda yang tercakup, dan setiap baris menampilkan bagiannya sebagai batang. Rentang 24 jam tidak menampilkan keduanya: rincian dibaca untuk hari kalender lokal penuh, sedangkan kartu di atas mencakup 24 jam bergulir, sehingga kedua totalnya mengukur hal berbeda dan menghitung bagian di antara keduanya akan menyesatkan. Beralihlah ke rentang 7 hari atau lebih jika Anda memerlukan angka cakupan.
Setiap baris memuat jumlah leg, pembagian Keluar / Masuk untuk negara tersebut, dan ASR-nya sendiri. ASR suatu negara yang jauh di bawah ASR halaman biasanya menjadi tanda awal masalah perutean yang terbatas pada satu tujuan. Pembagian ditampilkan sebagai tanda hubung jika tidak dapat ditentukan.
Kualitas panggilan
Tab Kualitas panggilan menampilkan ukuran koneksi dan distribusi durasi. Sebuah ukuran muncul ketika Bird mengukurnya dalam rentang, dan ukuran yang tidak ada berarti Bird tidak mengukur apa pun, yang berbeda dari skor buruk:
- Jeda dering, median dan persentil ke-95: berapa lama pemanggil menunggu antara menekan nomor dan mendengar dering. Kesenjangan antara keduanya menunjukkan rute yang biasanya tersambung cepat dan terkadang tidak.
- Kualitas audio: mean opinion score, penilaian standar 1 hingga 5 atas suara panggilan, dirata-ratakan pada leg yang diukur. Sambungan normal mendapat skor di atas 4. Jika lebih rendah, filter ke satu trunk atau satu tujuan untuk mengetahui apakah penurunan terbatas pada satu rute, dan periksa leg singkat di tab yang sama, karena rute yang tersambung tanpa membawa audio memengaruhi keduanya.
- Leg singkat: leg yang dijawab dan berakhir dalam waktu kurang dari 30 detik, ditampilkan sebagai bagian dari leg yang dijawab. Pada trafik keluar, bagian yang meningkat biasanya menandakan rute yang tersambung tetapi tidak membawa audio.
Lama leg berlangsung membagi leg yang dijawab ke dalam enam kelompok durasi yang dapat ditagih, dari kurang dari 30 detik hingga 10 menit atau lebih, dengan durasi rata-rata di atasnya. Durasi yang dapat ditagih adalah waktu setelah panggilan dijawab, jadi distribusi ini mendasari biaya Voice Anda.
Lalu lintas masuk dan keluar
Tab Nomor dan perutean memisahkan dua arah yang tidak terlihat dalam tampilan gabungan. Kartu menghitung Leg keluar dan Leg masuk, beserta perubahannya dibanding jendela sebelumnya, di samping Nomor aktif dan Trunk aktif untuk nomor dan trunk yang membawa trafik. Arah dari waktu ke waktu menumpuk keduanya per bucket, sehingga perubahan yang terbatas pada trafik masuk terlihat meski tertutupi dalam tren gabungan.
Di bawah grafik, satu tabel merinci periode berdasarkan nomor Anda, negara nomor Anda, trunk SIP, atau arah, dengan kolom leg, leg yang dijawab, ASR, dan ACD yang dapat diurutkan. Negara nomor Anda merupakan sisi Anda pada leg, sumbu yang berbeda dari negara tujuan pada tab Ringkasan. Baris trunk menunjukkan trunk yang menurun kualitasnya, jadi bandingkan ASR di antara trunk alih-alih membaca satu saja. Label nomor dan trunk menautkan ke catatannya, dan ringkasan nomor membuka tampilan berhalaman yang dapat ditelusuri untuk setiap nomor yang membawa leg.
Pola lalu lintas
Tab Pola trafik menunjukkan kapan panggilan masuk, dalam zona waktu lokal Anda: hari dan jam tersibuk, grid berdasarkan hari dalam seminggu dan jam, serta profil jam dalam sehari. Grid dan profil jam memerlukan rentang lebih panjang dari satu hari, dan grid membaca paling banyak 30 hari terakhir, sehingga pada rentang 90 hari ditampilkan keterangan tersebut. Profil per hari dalam seminggu muncul setelah rentang mencakup 14 hari; pada rentang yang lebih pendek, setiap hari dalam seminggu hanya memiliki satu observasi.
Akses programatik
Gunakan operasi statistik CLI atau MCP untuk mengambil agregat di balik dashboard. Operasi agregat ini belum memiliki kontrak HTTP atau SDK publik yang dipublikasikan. Untuk pelaporan HTTP atau SDK, gunakan rekaman leg publik yang dijelaskan di bawah untuk menghitung agregat Anda sendiri.
- CLI. bird voice stats summary mengembalikan agregat periode yang ditampilkan tile, dan bird voice stats daily serta bird voice stats hourly mengembalikan seri di balik grafik tren. Breakdown-nya adalah by-country, by-trunk, by-number, by-number-country, by-weekday, by-hour-of-day, dan by-response-code, yang mengelompokkan panggilan berdasarkan kode SIP akhir dan tidak ditampilkan dalam grafik di dashboard. Perintah-perintah ini menerima jendela, zona waktu, serta filter tujuan, nomor, trunk, dan hasil yang sama dengan yang diterapkan halaman, dengan satu pengecualian: by-response-code hanya menerima jendela, zona waktu, dan --direction, dan jendelanya berupa hari kalender alih-alih instan, sehingga menjawab atas populasi yang lebih luas daripada halaman yang difilter. Akses baca saja yang diberikan oleh bird auth login dasar sudah cukup untuk semuanya. Lihat panduan Bird CLI untuk menginstal dan melakukan autentikasi.
- Agen. Server MCP menyediakan pembacaan statistik yang sama sebagai tools.
- Agregat Anda sendiri. Untuk pelaporan kustom atau warehouse, GET /v1/voice/legs mengembalikan rekaman leg yang difilter, dan ekspor CSV dari log leg mencakup rekaman yang sesuai dengan filter Anda saat ini. Peristiwa Voice mengirimkan transisi panggilan ke endpoint Anda. Rekonsiliasikan dengan rekaman leg yang telah selesai karena event bisa hilang atau tiba tidak berurutan.
Angka dari CLI dan dashboard cocok untuk jendela yang sama jika menggunakan zona waktu yang sama. Dashboard mengirimkan zona waktu tersimpan Anda pada setiap pembacaan; perintah tanpa --timezone menggunakan bucket dalam UTC.
Langkah selanjutnya
| Halaman | Yang dicakup |
|---|---|
| Log panggilan | Leg individual di balik agregat ini, dan alasan satu leg ditolak |
| Peristiwa Voice | Event panggilan yang dapat dikonsumsi untuk pelaporan Anda sendiri |
| Melakukan panggilan | Apa yang dibaca Bird dari INVITE, dan bagaimana panggilan ditarifkan |
| Pemecahan masalah | Menelusuri dari gejala ke penyebab saat metrik bergerak ke arah yang salah |
Sumber daya terkait
Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.