Metryki głosowe

Strona Metrics w dashboardzie Bird agreguje etapy połączeń wykonanych i odebranych przez Twój obszar roboczy: ile się połączyło, jak długo trwały, jak się zakończyły i dokąd trafiały. Używaj jej do raportowania połączeń w wybranym okresie. Aby prześledzić jedno konkretne połączenie, otwórz dziennik połączeń.

Połączenie może zawierać kilka etapów, takich jak połączenia tworzone przez przekierowanie lub wybranie numeru innego uczestnika. Każdy etap jest liczony w tych metrykach oddzielnie.

Etap jest przypisywany do momentu rozpoczęcia i agregowany po zakończeniu, więc najnowszy przedział czasowy uzupełnia się tak długo, jak trwają aktywne połączenia. Strona wymaga uprawnień do odczytu zarówno głosu, jak i analityki w roli Twojego obszaru roboczego.

Odczytuj metryki

Otwórz Voice > Metrics. Cztery zakładki współdzielą jeden selektor zakresu i jeden wiersz filtrów: Overview, Call quality, Numbers and routing i Traffic patterns. Przełączanie zakładek zachowuje wybrany zakres i filtry.

Selektor zakresu oferuje ostatnie 24 godziny lub 7, 30 albo 90 dni i domyślnie ustawia 7 dni. Zakresy dzienne grupują dane według Twojego lokalnego dnia kalendarzowego; zakres 24-godzinny to ruchome okno złożone z 24 przedziałów godzinowych. Przeciągnięcie po wykresie czasowym zawęża wszystkie karty na stronie do tego wycinka.

Łączą się cztery filtry: Your number (Twój koniec etapu), Destination (kraj docelowy etapu), trunk SIP oraz Outcome. Każdy zastosowany filtr otrzymuje osobną etykietę, którą możesz usunąć, a większość kart zawiera kontrolkę stosującą filtr dla oglądanego wiersza.

Wskaźnik odpowiedzi i czas trwania połączenia

Zakładka Overview zaczyna się od pięciu kafelków. Pierwsze cztery pokazują zmianę względem poprzedniego okna o równej długości:

• Answer-seizure ratio: odebrane etapy podzielone przez wszystkie próby w zakresie. Próby zakończone bez odpowiedzi pozostają w mianowniku, więc ASR spada zarówno wtedy, gdy trasa przestaje realizować połączenia, jak i wtedy, gdy wybierane numery nie odbierają. Zmiana jest wyrażona w punktach procentowych.
• Average call duration: średni płatny czas trwania odebranych etapów. Nieodebrane etapy są wykluczone, więc ACD nie mówi, jak często udaje się zestawić połączenie. Kilka bardzo długich etapów podnosi średnią powyżej mediany; rozkład czasu trwania na karcie Call quality pokazuje ten rozrzut.
• Total legs i Answered legs: dwie liczby używane do obliczania ASR.
• Distinct numbers: liczba różnych numerów po drugiej stronie, z których każdy jest liczony raz, niezależnie od liczby powiązanych etapów. W zestawieniu z łączną liczbą etapów odróżnia ruch rozłożony na wielu uczestników od ruchu skupionego na kilku.

Wolumen połączeń i wskaźnik odpowiedzi w czasie

Wykres trendu układa odebrane i pozostałe etapy w słupki odpowiadające łącznemu wolumenowi okresu na lewej osi, a ASR pokazuje jako linię na prawej osi od 0 do 100%. Szczegółowość zależy od zakresu: godzinowa dla 24 godzin, dzienna dla pozostałych. Wspólna analiza obu danych odróżnia wzrost od pogorszenia: płaska linia przy rosnących słupkach oznacza większy ruch na trasie, która nadal realizuje połączenia, a spadająca linia przy stałych słupkach oznacza trasę, która przestała je realizować. View all legs pod kartą otwiera dziennik etapów dla tego samego okna.

Jak zakończyły się połączenia

Wykres pierścieniowy i legenda dzielą próby etapów w zakresie według końcowego wyniku, podając dla każdego liczbę i udział w łącznej liczbie etapów:

Wynik bez etapów w zakresie jest pomijany. Aby ustalić przyczynę odmowy, a nie tylko jej częstotliwość, otwórz same etapy: Odrzucone połączenia opisują powód zapisywany przez Bird dla każdego z nich.

Najczęstsze kraje

Tabela krajów szereguje 10 najważniejszych krajów docelowych według liczby etapów, a stopka podaje liczbę krajów z aktywnością w zakresie. Kraj to miejsce docelowe etapu: kraj wybieranego numeru dla etapu wychodzącego, a kraj Twojego numeru dla przychodzącego.

Dla zakresu w dniach stopka podaje też udział Twoich etapów uwzględnionych w tabeli, a każdy wiersz przedstawia swój udział jako pasek. Zakres 24-godzinny pomija oba elementy: rozbicie obejmuje całe lokalne dni kalendarzowe, a kafelki powyżej ruchome 24 godziny. Obie sumy opisują więc różne wielkości, a wyliczenie udziału między nimi byłoby mylące. Wybierz 7 dni lub więcej, gdy potrzebujesz informacji o pokryciu.

Każdy wiersz zawiera liczbę etapów, podział Out / In dla kraju oraz jego ASR. ASR kraju znacznie niższy niż ASR całej strony jest zwykle pierwszym sygnałem problemu z routingiem ograniczonego do jednego kierunku. Gdy nie można ustalić podziału, widoczny jest myślnik.

Jakość połączeń

Zakładka Call quality zawiera miary połączenia i rozkład czasu trwania. Miara pojawia się, gdy Bird zmierzył ją w zakresie, a jej brak oznacza, że Bird nic nie zmierzył, co różni się od słabego wyniku:

• Ring delay, mediana i 95. percentyl: jak długo dzwoniący czekał między wybraniem numeru a usłyszeniem dzwonienia. Różnica między nimi wskazuje trasę, która zwykle łączy szybko, a czasami nie.
• Audio quality: średnia ocena opinii, czyli standardowa ocena brzmienia połączenia od 1 do 5, uśredniona dla etapów, na których ją zmierzono. Normalne połączenie uzyskuje wynik powyżej 4. Przy niższym wyniku przefiltruj dane do jednego trunka lub kierunku, aby sprawdzić, czy spadek dotyczy jednej trasy. Sprawdź też krótkie etapy na tej samej karcie, ponieważ trasa, która łączy bez przesyłania dźwięku, wpływa na obie metryki.
• Short legs: odebrane etapy zakończone w mniej niż 30 sekund, pokazane jako udział odebranych etapów. W ruchu wychodzącym rosnący udział zwykle oznacza trasę, która zestawia połączenie, ale nie przesyła dźwięku.

How long legs run rozdziela odebrane etapy na sześć przedziałów płatnego czasu trwania, od poniżej 30 sekund do 10 minut i więcej, ze średnią długością powyżej. Płatny czas trwania to czas od odebrania, więc ten rozkład odpowiada naliczanym opłatom za połączenia głosowe.

Ruch przychodzący i wychodzący

Karta Numbers and routing rozdziela dwa kierunki ukryte w widoku łącznym. Kafelki zliczają Outbound legs i Inbound legs wraz ze zmianą względem poprzedniego okna, obok Active numbers i Active trunks dla numerów i trunków, które przenosiły ruch. Direction over time układa oba kierunki w słupki dla każdego przedziału, dzięki czemu zmiana ograniczona do ruchu przychodzącego jest widoczna tam, gdzie łączny trend ją wygładza.

Pod wykresem tabela dzieli okres według Twojego numeru, kraju Twojego numeru, trunka SIP lub kierunku, z etapami, odebranymi etapami, ASR i ACD w sortowalnych kolumnach. Kraj Twojego numeru to Twój koniec etapu, inny wymiar niż kraj docelowy na karcie Overview. Wiersze trunków wskazują trunk o pogorszonej jakości, więc porównuj ASR między nimi zamiast odczytywać jeden osobno. Etykiety numerów i trunków prowadzą do rekordu, a podsumowania numerów otwierają przeszukiwalny, stronicowany widok wszystkich numerów, które uczestniczyły w etapach.

Wzorce ruchu

Zakładka Traffic patterns profiluje, kiedy nadchodzą połączenia, w Twojej lokalnej strefie czasowej: najruchliwszy dzień tygodnia i godzinę, siatkę dzień tygodnia × godzina oraz profil godzinowy. Siatka i profil godzinowy wymagają zakresu dłuższego niż jeden dzień, a siatka odczytuje co najwyżej ostatnie 30 dni, więc przy zakresie 90-dniowym informuje o tym. Profil dnia tygodnia pojawia się, gdy zakres obejmuje 14 dni; poniżej tego każdy dzień tygodnia ma tylko jedną obserwację.

Dostęp programowy

Użyj operacji statystycznych CLI lub MCP, aby pobrać agregaty stojące za dashboardem. Te operacje agregujące nie mają jeszcze opublikowanego publicznego kontraktu HTTP ani SDK. Do raportowania HTTP lub SDK użyj publicznych rekordów etapów opisanych poniżej, aby obliczać własne agregaty.

• CLI. bird voice stats summary zwraca agregat okresu wyświetlany na kafelkach, a bird voice stats daily i bird voice stats hourly zwracają serie stojące za wykresem trendu. Rozbicia to by-country, by-trunk, by-number, by-number-country, by-weekday, by-hour-of-day i by-response-code, które grupuje połączenia według końcowego kodu SIP i nie jest przedstawiane na wykresie w panelu. Polecenia przyjmują to samo okno, strefę czasową oraz filtry miejsca docelowego, numeru, łącza trunkingowego i wyniku stosowane na stronie, z jednym wyjątkiem: by-response-code przyjmuje tylko okno, strefę czasową i --direction, a jego okno to dni kalendarzowe zamiast punktów czasowych, więc odpowiada na pytania o szerszą populację niż przefiltrowana strona. Dostęp tylko do odczytu przyznawany przez sam bird auth login wystarcza do nich wszystkich. Zajrzyj do przewodnika Bird CLI, aby zainstalować i uwierzytelnić.
• Agenty. Serwer MCP udostępnia te same odczyty statystyk jako narzędzia.
• Własne agregaty. Do niestandardowego raportowania lub hurtowni danych GET /v1/voice/legs zwraca przefiltrowane rekordy etapów, a eksport CSV dziennika etapów obejmuje rekordy pasujące do bieżących filtrów. Zdarzenia głosowe wysyłają przejścia połączeń do Twojego endpointu. Uzgadniaj je z ukończonymi rekordami etapów, ponieważ zdarzenia mogą być brakujące lub nadchodzić w niewłaściwej kolejności.

Liczby z CLI i dashboardu zgadzają się dla tego samego okna, gdy używają tej samej strefy czasowej. Dashboard wysyła Twoją zapisaną strefę czasową przy każdym odczycie; komenda bez --timezone grupuje w UTC.

Następne kroki