Voice-Metriken
Die Seite Metrics im Bird-Dashboard aggregiert die Call Legs, die Ihr Workspace getätigt und empfangen hat: wie viele verbunden wurden, wie lange sie dauerten, wie sie endeten und wohin sie gingen. Nutzen Sie sie für Call-Reporting über einen Zeitraum. Um einen einzelnen Anruf nachzuverfolgen, öffnen Sie das Call Log.
Ein Anruf kann mehrere Legs enthalten, etwa die Verbindungen, die durch Weiterleitung oder das Anrufen eines weiteren Teilnehmers entstehen. Jedes Leg wird in diesen Metriken separat gezählt.
Ein Leg wird dem Zeitpunkt zugeordnet, zu dem es begann, und erst nach seinem Ende aggregiert. Der jüngste Bucket füllt sich daher so lange weiter, wie noch Anrufe laufen. Die Seite erfordert sowohl Voice- als auch Analytics-Lesezugriff auf Ihrer Workspace-Rolle.
Metriken ablesen
Öffnen Sie Voice > Metrics. Vier Tabs teilen sich einen Zeitraum-Picker und eine Filterzeile: Overview, Call quality, Numbers and routing und Traffic patterns. Beim Tab-Wechsel bleiben Zeitraum und Filter erhalten.
Der Zeitraum-Picker bietet die letzten 24 Stunden oder 7, 30 oder 90 Tage an und startet mit 7 Tagen. Tagesbereiche werden nach Ihrem lokalen Kalendertag gruppiert; der 24-Stunden-Bereich ist ein rollendes Fenster aus 24 Stunden-Buckets. Ziehen Sie über ein Zeitdiagramm, um alle Karten auf der Seite auf diese Spanne einzugrenzen.
Vier Filter lassen sich kombinieren: Your number (Ihr Ende des Legs), Destination (das Zielland des Legs), SIP trunk und Outcome. Jeder angewendete Filter erhält ein eigenes entfernbares Filterfeld. Die meisten Karten enthalten eine Steuerung, die den Filter für die angezeigte Zeile anwendet.
Antwortrate und Gesprächsdauer
Der Tab Overview beginnt mit fünf Kacheln. Die ersten vier zeigen die Veränderung gegenüber dem vorangegangenen Fenster gleicher Länge:
- Answer-Seizure Ratio: beantwortete Legs geteilt durch alle Versuche im Zeitraum. Versuche ohne Antwort bleiben im Nenner, sodass die ASR sowohl sinkt, wenn eine Route nicht mehr durchstellt, als auch wenn die gewählten Nummern nicht abnehmen. Die Veränderung wird in Prozentpunkten angegeben.
- Average call duration: die mittlere abrechenbare Dauer beantworteter Legs. Unbeantwortete Legs sind ausgeschlossen, daher sagt ACD nichts darüber aus, wie oft eine Verbindung zustande kommt. Einige sehr lange Legs ziehen den Mittelwert über den Median; die Dauerverteilung auf dem Tab Call quality zeigt diese Streuung.
- Total legs und Answered legs: die beiden Zählwerte, aus denen ASR berechnet wird.
- Distinct numbers: wie viele verschiedene Nummern am anderen Ende waren, wobei jede Nummer einmal zählt, unabhängig von der Anzahl ihrer Legs. Im Vergleich zur Gesamtzahl der Legs zeigt dieser Wert, ob der Verkehr über viele Teilnehmer verteilt oder auf wenige konzentriert ist.
Anrufvolumen und Antwortrate im Zeitverlauf
Das Trenddiagramm stapelt beantwortete und andere Legs zum Gesamtvolumen des Zeitraums auf der linken Achse und zeigt ASR als Linie auf einer rechten Achse von 0 bis 100 %. Die Zeitintervalle folgen dem Bereich: stündlich für den 24-Stunden-Bereich, täglich für die übrigen. Beide zusammen unterscheiden Wachstum von Verschlechterung: Eine flache Linie unter einem wachsenden Stapel bedeutet mehr Verkehr auf einer Route, die weiterhin verbindet. Eine sinkende Linie unter einem flachen Stapel zeigt eine Route, die nicht mehr erfolgreich verbindet. View all legs unter der Karte öffnet das Leg-Protokoll für denselben Zeitraum.
Wie Anrufe endeten
Ein Ringdiagramm mit Legende teilt die Leg-Versuche im Zeitraum nach Endergebnis auf, jeweils mit Anzahl und Anteil an allen Legs:
| Ergebnis | Bedeutung |
|---|---|
| Answered | Das Leg wurde verbunden |
| No answer | Zeitüberschreitung, kein Beleg dafür, dass es klingelte |
| Failed | Von der Gegenstelle oder dem Netzwerk abgelehnt |
| Rejected | Von der Gegenstelle abgelehnt oder von Bird abgewiesen |
| Unknown | Das Ergebnis konnte nicht ermittelt werden |
| Other | Ein Ergebnis, das diese Liste noch nicht aufführt |
Ein Ergebnis ohne Legs im Zeitraum wird ausgelassen. Um herauszufinden, warum eine Ablehnung erfolgte statt nur wie oft, öffnen Sie die Legs selbst: Abgelehnte Anrufe erläutert den Grund, den Bird für jedes Leg speichert.
Top-Länder
Die Ländertabelle ordnet die 10 häufigsten Zielländer nach Leg-Volumen. Ihre Fußzeile zeigt, in wie vielen Ländern im Zeitraum Aktivität stattfand. Das Land ist das Ziel des Legs: bei einem ausgehenden Leg das angerufene Land, bei einem eingehenden das Land Ihrer eigenen Nummer.
Bei einem Zeitraum in Tagen zeigt die Fußzeile außerdem, welchen Anteil Ihrer Legs die Tabelle abdeckt. Jede Zeile stellt ihren Anteil als Balken dar. Im 24-Stunden-Bereich entfallen beide Angaben: Die Aufschlüsselung verwendet ganze lokale Kalendertage, während die Kacheln darüber rollierende 24 Stunden abdecken. Die beiden Summen bezeichnen daher unterschiedliche Mengen, und ein daraus berechneter Anteil wäre irreführend. Wechseln Sie zu 7 Tagen oder länger, wenn Sie die Abdeckung benötigen.
Jede Zeile enthält die Anzahl der Legs, die Aufteilung Out / In für dieses Land und die eigene ASR. Eine Länder-ASR deutlich unter dem Seitenwert ist meist das erste Anzeichen für ein Routingproblem, das auf ein Ziel beschränkt ist. Die Aufteilung erscheint als Strich, wenn sie nicht ermittelt werden konnte.
Anrufqualität
Der Tab Call quality enthält die Verbindungskennzahlen und die Dauerverteilung. Eine Kennzahl erscheint, wenn Bird sie im Zeitraum gemessen hat. Eine fehlende Kennzahl bedeutet, dass Bird nichts gemessen hat, was nicht mit einem schlechten Ergebnis gleichzusetzen ist:
- Ring delay, Median und 95. Perzentil: wie lange der Anrufer zwischen Wählen und Klingelton gewartet hat. Ein Abstand zwischen den beiden Werten deutet auf eine Route hin, die meistens schnell verbindet und manchmal nicht.
- Audio quality: der Mean Opinion Score, die Standardbewertung von 1 bis 5 für den Klang eines Anrufs, gemittelt über die Legs, bei denen er gemessen wurde. Eine normale Verbindung erreicht über 4. Filtern Sie bei niedrigeren Werten nach einem Trunk oder einem Ziel, um zu prüfen, ob der Rückgang auf eine Route beschränkt ist. Prüfen Sie auch kurze Legs auf demselben Tab, da eine Route, die verbindet, aber kein Audio überträgt, beide Werte beeinflusst.
- Short legs: beantwortete Legs, die nach weniger als 30 Sekunden endeten, als Anteil der beantworteten Legs. Bei ausgehendem Verkehr ist ein steigender Anteil meist ein Zeichen für eine Route, die verbindet, aber kein Audio überträgt.
How long legs run verteilt beantwortete Legs auf sechs Bereiche der abrechenbaren Dauer, von unter 30 Sekunden bis 10 Minuten und länger, mit der durchschnittlichen Dauer darüber. Abrechenbare Dauer ist die Zeit nach Annahme des Anrufs; diese Verteilung liegt daher Ihren Voice-Gebühren zugrunde.
Eingehender und ausgehender Verkehr
Der Tab Numbers and routing trennt die beiden Richtungen, die eine gemeinsame Ansicht verbirgt. Kacheln zählen Outbound legs und Inbound legs samt Veränderung gegenüber dem vorherigen Zeitraum. Daneben stehen Active numbers und Active trunks für die Nummern und Trunks, die Verkehr übertragen haben. Direction over time stapelt beide Richtungen pro Zeitintervall. So wird eine Änderung sichtbar, die nur eingehenden Verkehr betrifft und im gemeinsamen Trend abgeschwächt erscheint.
Unter dem Diagramm schlüsselt eine Tabelle den Zeitraum nach Ihrer Nummer, dem Land Ihrer Nummer, SIP-Trunk oder Richtung auf. Legs, beantwortete Legs, ASR und ACD stehen in sortierbaren Spalten. Das Land Ihrer Nummer bezeichnet Ihr Ende des Legs und ist eine andere Dimension als das Zielland auf dem Tab Overview. Trunk-Zeilen zeigen, welcher Trunk beeinträchtigt ist. Vergleichen Sie daher die ASR-Werte miteinander, statt nur einen zu betrachten. Nummern- und Trunk-Bezeichnungen verlinken den Datensatz. Die Nummernübersichten öffnen eine durchsuchbare, paginierte Ansicht aller Nummern, über die Legs liefen.
Traffic-Muster
Der Tab Traffic patterns zeigt das Profil, wann Anrufe eingehen, in Ihrer lokalen Zeitzone: Ihr verkehrsreichster Wochentag und Stunde, ein Wochentag-Stunde-Raster und ein Stundenprofil. Raster und Stundenprofil benötigen einen Zeitraum länger als einen Tag, und das Raster liest maximal die letzten 30 Tage, bei einem 90-Tage-Bereich wird das angezeigt. Das Wochentagsprofil erscheint, sobald der Zeitraum 14 Tage umfasst; darunter enthält jeder Wochentag nur eine Beobachtung.
Programmatischer Zugriff
Verwenden Sie die Statistik-Operationen von CLI oder MCP, um die Aggregate hinter dem Dashboard abzurufen. Diese Aggregat-Operationen haben noch keinen veröffentlichten öffentlichen HTTP- oder SDK-Vertrag. Für HTTP- oder SDK-Reporting verwenden Sie die unten beschriebenen öffentlichen Leg-Datensätze, um eigene Aggregate zu berechnen.
- Die CLI. bird voice stats summary gibt das Zeitraum-Aggregat zurück, das die Kacheln zeigen, und bird voice stats daily sowie bird voice stats hourly geben die Reihen hinter dem Trenddiagramm zurück. Die Aufschlüsselungen sind by-country, by-trunk, by-number, by-number-country, by-weekday, by-hour-of-day und by-response-code, das Anrufe nach finalem SIP-Code gruppiert und im Dashboard nicht als Diagramm dargestellt wird. Die Befehle verwenden dasselbe Fenster, dieselbe Zeitzone und dieselben Ziel-, Nummern-, Trunk- und Ergebnis-Filter wie die Seite, mit einer Ausnahme: by-response-code akzeptiert nur das Fenster, die Zeitzone und --direction, und sein Fenster sind Kalendertage statt Zeitpunkte, sodass es über eine breitere Population antwortet als eine gefilterte Seite. Der Lesezugriff, den ein einfaches bird auth login gewährt, reicht für alle aus. Lesen Sie die Anleitung Bird CLI zur Installation und Authentifizierung.
- Agenten. Der MCP-Server stellt dieselben Statistik-Abfragen als Tools bereit.
- Eigene Aggregate. Für individuelles Reporting oder ein Warehouse gibt GET /v1/voice/legs gefilterte Leg-Datensätze zurück, und der CSV-Export des Leg Logs deckt die Datensätze ab, die Ihren aktuellen Filtern entsprechen. Voice-Events senden Anrufübergänge an Ihren Endpoint. Gleichen Sie diese mit abgeschlossenen Leg-Datensätzen ab, da Events fehlen oder in falscher Reihenfolge eintreffen können.
Zahlen aus CLI und dem Dashboard stimmen für dasselbe Fenster überein, wenn sie dieselbe Zeitzone verwenden. Das Dashboard sendet bei jedem Lesevorgang Ihre gespeicherte Zeitzone; ein Befehl ohne --timezone gruppiert in UTC.
Nächste Schritte
| Seite | Inhalt |
|---|---|
| Anrufprotokoll | Die einzelnen Legs hinter diesen Aggregaten und warum eines abgelehnt wurde |
| Voice-Events | Die Anruf-Events für Ihr eigenes Reporting |
| Anrufe tätigen | Was Bird von einem INVITE abliest und wie ein Anruf bepreist wird |
| Fehlerbehebung | Von einem Symptom zur Ursache, wenn sich eine Metrik in die falsche Richtung bewegt |
Verwandte Ressourcen
Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema. Die Ressourcen sind auf Englisch.
Das Konzept verstehenWhat is a voice API?Die Funktion erkundenVoiceImplementierungsleitfadenVoice overview
Implementierungs-Briefing erhalten