Voice-statistieken
De pagina Metrics in het Bird-dashboard aggregeert de call legs die je werkruimte heeft geplaatst en ontvangen: hoeveel er verbonden werden, hoe lang ze duurden, hoe ze eindigden en waarheen ze gingen. Gebruik de pagina voor gespreksrapportage over een periode. Om één specifiek gesprek te volgen, open je het gesprekslogboek.
Een gesprek kan meerdere legs bevatten, zoals de verbindingen die ontstaan door doorschakelen of het bellen van een andere deelnemer. Elke leg telt afzonderlijk mee in deze statistieken.
Een leg telt mee op het tijdstip waarop hij startte en wordt geaggregeerd zodra hij eindigt, dus de meest recente bucket blijft bijgevuld zolang er nog gesprekken lopen. De pagina vereist zowel voice- als analytics-leestoegang op je werkruimterol.
Je statistieken bekijken
Open Voice > Metrics. Vier tabbladen delen één bereikkiezer en één filterrij: Overview, Call quality, Numbers and routing en Traffic patterns. Wisselen van tabblad behoudt je bereik en filters.
De bereikkiezer biedt de laatste 24 uur of 7, 30 of 90 dagen, en begint op 7 dagen. Dagbereiken groeperen op je lokale kalenderdag; het 24-uursbereik is een rollend venster van 24 buckets van elk één uur. Slepen over een tijdgrafiek beperkt elke kaart op de pagina tot dat bereik.
Vier filters werken samen: Your number (jouw kant van de leg), Destination (het bestemmingsland van de leg), SIP trunk en Outcome. Elk toegepast filter krijgt een eigen verwijderbare chip en de meeste kaarten hebben een bedieningselement dat het filter toepast voor de rij die je bekijkt.
Antwoordpercentage en gespreksduur
Het tabblad Overview begint met vijf tegels. De eerste vier tonen de verandering ten opzichte van het vorige venster van gelijke lengte:
- Answer-seizure ratio: het aantal beantwoorde legs gedeeld door het totale aantal pogingen in het bereik. Pogingen die eindigden zonder antwoord blijven in de noemer, dus ASR daalt zowel wanneer een route stopt met verbinden als wanneer de nummers die je belt niet opnemen. De verandering is een verschil in procentpunten.
- Average call duration: de gemiddelde factureerbare duur van beantwoorde legs. Onbeantwoorde legs zijn uitgesloten, dus ACD zegt niets over hoe vaak je verbinding maakt. Een handvol zeer lange legs trekt het gemiddelde boven de mediaan; de duurverdeling op het tabblad Call quality toont die spreiding.
- Total legs en Answered legs: de twee aantallen waarop ASR is gebaseerd.
- Distinct numbers: hoeveel verschillende nummers aan de andere kant stonden, waarbij elk nummer één keer telt ongeacht het aantal legs. Vergeleken met het totale aantal legs maakt dit onderscheid tussen verkeer verspreid over veel deelnemers en verkeer geconcentreerd op enkele deelnemers.
Gespreksvolume en antwoordpercentage in de tijd
De trendgrafiek stapelt beantwoorde en andere legs tot het totale volume van de periode op de linkeras en toont ASR als lijn op een rechteras van 0 tot 100%. De tijdsindeling volgt het bereik: per uur voor het 24-uursbereik, per dag voor de overige bereiken. Samen maken ze onderscheid tussen groei en achteruitgang: een vlakke lijn onder een stijgende stapel betekent meer verkeer op een route die nog steeds verbindt. Een dalende lijn onder een vlakke stapel wijst op een route die niet meer succesvol verbindt. View all legs onder de kaart opent het leg-logboek voor hetzelfde tijdvenster.
Hoe gesprekken eindigden
Een ringdiagram met legenda verdeelt de leg-pogingen in het bereik naar uiteindelijke uitkomst, met voor elke uitkomst een aantal en een aandeel van het totale aantal legs:
| Resultaat | Wat het betekent |
|---|---|
| Answered | De leg is verbonden |
| No answer | Time-out, wat geen bewijs is dat de telefoon overging |
| Failed | Geweigerd door de andere kant of het netwerk |
| Rejected | Afgewezen door de andere kant, of geweigerd door Bird |
| Unknown | Het resultaat kon niet worden vastgesteld |
| Other | Een resultaat dat deze lijst nog niet benoemt |
Een uitkomst zonder legs in het bereik wordt weggelaten. Open de legs zelf om te achterhalen waarom een weigering plaatsvond in plaats van hoe vaak: Geweigerde gesprekken beschrijft de reden die Bird voor elke leg vastlegt.
Toplanden
De landentabel rangschikt de 10 belangrijkste bestemmingslanden op leg-volume en de voetregel vermeldt hoeveel landen activiteit hadden in het bereik. Het land is de bestemming van de leg: het land dat je belde bij een uitgaande leg en het land van je eigen nummer bij een inkomende leg.
Bij een bereik in dagen geeft de voetregel ook aan welk aandeel van je legs de tabel dekt en toont elke rij zijn aandeel als een balk. Bij het 24-uursbereik ontbreken beide: de uitsplitsing gebruikt volledige lokale kalenderdagen, terwijl de tegels erboven een voortschrijdende periode van 24 uur dekken. De twee totalen zijn dus verschillende grootheden en een aandeel daartussen zou misleidend zijn. Schakel over naar 7 dagen of langer wanneer je de dekkingswaarde nodig hebt.
Elke rij bevat het aantal legs, de verdeling Out / In voor dat land en de eigen ASR. Een ASR per land die ver onder die van de pagina ligt, is meestal het eerste teken van een routingprobleem beperkt tot één bestemming. De verdeling wordt als een streepje weergegeven als die niet kon worden bepaald.
Gesprekskwaliteit
Het tabblad Call quality bevat de verbindingsmaten en de duurdistributie. Een maat verschijnt wanneer Bird deze in het bereik heeft gemeten, en een afwezige maat betekent dat Bird niets heeft gemeten, wat iets anders is dan een slechte score:
- Ring delay, mediaan en 95e percentiel: hoe lang de beller wachtte tussen het kiezen en het horen van de beltoon. Een verschil tussen beide wijst op een route die meestal snel verbindt en soms niet.
- Audio quality: de mean opinion score, de standaardscore van 1 tot 5 voor hoe een gesprek klonk, gemiddeld over de legs waarvoor die is gemeten. Een normale verbinding scoort boven 4. Filter bij een lagere score op één trunk of bestemming om te zien of de daling beperkt is tot een route. Controleer ook korte legs op hetzelfde tabblad, want een route die verbindt zonder audio door te geven beïnvloedt beide.
- Short legs: beantwoorde legs die na minder dan 30 seconden eindigden, weergegeven als aandeel van de beantwoorde legs. Bij uitgaand verkeer duidt een stijgend aandeel meestal op een route die verbindt maar geen audio doorgeeft.
How long legs run verdeelt beantwoorde legs over zes categorieën voor factureerbare duur, van minder dan 30 seconden tot 10 minuten en langer, met de gemiddelde duur erboven. Factureerbare duur is de tijd na beantwoording, dus dit is de verdeling waarop je Voice-kosten zijn gebaseerd.
Inkomend en uitgaand verkeer
Het tabblad Numbers and routing scheidt de twee richtingen die een gecombineerd overzicht verbergt. Tegels tellen Outbound legs en Inbound legs, met de verandering ten opzichte van het vorige tijdvenster. Daarnaast staan Active numbers en Active trunks voor de nummers en trunks die verkeer afhandelden. Direction over time stapelt beide per tijdvak, zodat een verandering die alleen inkomend verkeer betreft zichtbaar is waar de gecombineerde trend die afvlakt.
Onder de grafiek splitst één tabel de periode uit naar je nummer, het land van je nummer, SIP-trunk of richting, met legs, beantwoorde legs, ASR en ACD in sorteerbare kolommen. Het land van je nummer is jouw kant van de leg, een andere dimensie dan het bestemmingsland op het tabblad Overview. Trunk-rijen laten zien welke trunk achteruitgaat, dus vergelijk ASR tussen de trunks in plaats van één waarde los te bekijken. Nummer- en trunklabels linken naar het record en de nummeroverzichten openen een doorzoekbare, gepagineerde weergave van elk nummer dat legs afhandelde.
Verkeerspatronen
Het tabblad Traffic patterns profileert wanneer gesprekken binnenkomen, in je lokale tijdzone: je drukste weekdag en uur, een weekdag-per-uur-raster en een uur-van-de-dag-profiel. Het raster en het uurprofiel vereisen een bereik langer dan een dag, en het raster leest maximaal de laatste 30 dagen, dus bij een bereik van 90 dagen wordt dat vermeld. Het weekdagprofiel verschijnt zodra het bereik 14 dagen beslaat; daaronder bevat elke weekdag één waarneming.
Programmatische toegang
Gebruik de CLI- of MCP-statistiekbewerkingen om de aggregaten achter het dashboard op te halen. Deze aggregaatbewerkingen hebben nog geen gepubliceerd publiek HTTP- of SDK-contract. Voor HTTP- of SDK-rapportage gebruik je de publieke leg-records die hieronder worden beschreven om je eigen aggregaten te berekenen.
- De CLI. bird voice stats summary retourneert het periode-aggregaat dat de tegels tonen, en bird voice stats daily en bird voice stats hourly retourneren de reeks achter de trendgrafiek. De uitsplitsingen zijn by-country, by-trunk, by-number, by-number-country, by-weekday, by-hour-of-day en by-response-code, die gesprekken groepeert op uiteindelijke SIP-code en niet in het dashboard wordt weergegeven. De commando's accepteren hetzelfde venster, dezelfde tijdzone en dezelfde bestemmings-, nummer-, trunk- en resultaatfilters die de pagina toepast, met één uitzondering: by-response-code accepteert alleen het venster, de tijdzone en --direction, en het venster bestaat uit kalenderdagen in plaats van momenten, dus het beantwoordt over een bredere populatie dan een gefilterde pagina. De alleen-lezen-toegang die een kale bird auth login verleent, is voldoende voor allemaal. Zie de handleiding Bird CLI voor installatie en authenticatie.
- Agents. De MCP-server stelt dezelfde statistiekleesbewerkingen beschikbaar als tools.
- Je eigen aggregaten. Voor aangepaste rapportage of een warehouse retourneert GET /v1/voice/legs gefilterde leg-records, en de CSV-export van het leg-logboek dekt de records die overeenkomen met je huidige filters. Voice-events sturen gesprekstransities naar je endpoint. Reconcilieer ze met voltooide leg-records, want events kunnen ontbreken of in de verkeerde volgorde aankomen.
Cijfers van de CLI en het dashboard komen overeen voor hetzelfde venster wanneer ze dezelfde tijdzone gebruiken. Het dashboard stuurt je opgeslagen tijdzone mee bij elke leesbewerking; een commando zonder --timezone groepeert in UTC.
Vervolgstappen
| Pagina | Wat het behandelt |
|---|---|
| Gesprekslogboek | De individuele legs achter deze aggregaten, en waarom er één werd geweigerd |
| Voice-events | De gespreksgebeurtenissen om te consumeren voor je eigen rapportage |
| Gesprekken plaatsen | Wat Bird afleest van een INVITE, en hoe een gesprek wordt geprijsd |
| Probleemoplossing | Van een symptoom naar een oorzaak werken wanneer een statistiek de verkeerde kant op beweegt |
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.