Teilen Sie:
){kind=small}
Michael ist der kahlköpfige, bärtige Baumeister. Mit seiner 20-jährigen Erfahrung in der Software-Entwicklung und DevOps verbringt er seine Tage damit, anderen zum Erfolg zu verhelfen.
Integrieren Sie erweiterte Einblicke zur Überwachung der Videoqualität
Lesedauer: 5 Minuten
Gesundheitswesen. Bildung. Kollaboration. Die Chancen stehen gut, dass Sie immer häufiger über Online-Videokonferenzen kommunizieren. Die von Kunden der Vonage Video API genutzten Minuten sind allein von Februar bis März um 232 % gestiegen. In der Gesundheitsbranche stiegen die Videominuten um 727 %.
Angesichts dieser zunehmenden Belastung ist es wichtiger denn je, zu wissen, welche Art von Servicequalität Sie Ihren Kunden bieten. Können die Schüler von Herrn Pates ihre Lektionen gut sehen und hören? Ist Dr. Sanchez in der Lage, ihren Patienten die nötige Qualität zu bieten? Wenn Probleme auftreten, sollten Sie Antworten haben.
Aus diesem Grund hat Vonage die Insights und Advanced Insights APIs. Diese GraphQL-APIs helfen Ihnen, skalierbare, zuverlässige Lösungen für Ihre Endbenutzer zu erstellen. Es ist jedoch wichtig zu wissen, welche Daten bereitgestellt werden, wann sie verfügbar sind und wie lange sie zugänglich sind.
Mit der Insights-API können Sie die Metadaten Ihrer Sitzungen auf Projektebene untersuchen. Diese Metadaten umfassen Metriken wie:
Nutzung: Informationen über veröffentlichte Stream-Minuten, abonnierte Stream-Minuten, Archivnutzung, Broadcast-Nutzung und SIP-Nutzung
Qualität: Informationen zur Videoqualität
Fehler: Die Fehlerquoten für die Verbindung zu Sitzungen, die Veröffentlichung und das Abonnieren
Example GraphQL code used with the Insights API
Die API ermöglicht es Ihnen, die Daten nach SDK-Typ, SDK-Version, Land, Region, Browser und Browserversion zu filtern und zu gruppieren und zusätzlich die Daten in täglichen, wöchentlichen oder monatlichen Abständen zu segmentieren.
Die Insights-Daten werden täglich auf Projektebene aggregiert. Aus diesem Grund sind sie nicht in Echtzeit verfügbar. Insights API-Daten haben eine erwartete Verfügbarkeitslatenz von 36 bis 48 Stunden.
Timeline displaying retention spans of the Insights API
Für 60 Tage sind die Insights-Daten in täglichen aggregierten Segmenten verfügbar. Danach und bis zu 12 Monate lang sind sie in monatlichen Aggregaten verfügbar. Nach 12 Monaten werden die Daten nicht von der Insights-API aufbewahrt.
Die Advanced Insights API liefert Daten auf Sitzungs- und Stream-Ebene. Sitzungen werden in Besprechungen unterteilt, und jede Sitzung kann aus mehreren Sitzungen bestehen. Eine neue Sitzung wird erstellt, wenn jemand der Sitzung beitritt und sie in den letzten 10 Minuten keine Teilnehmer hatte.
Die Sitzungsdaten umfassen:
Metadaten: Medienmodus, veröffentlichte Minuten und abonnierte Minuten
Besprechungen: Ein Array mit allen Besprechungen, die während des für diese Sitzung angegebenen Zeitrahmens stattgefunden haben. Es umfasst:
Verbindungen: Ein Array von Verbindungen, das jeden Client definiert, der der Sitzung während des Meetings beigetreten ist. Es enthält das verwendete SDK, den verwendeten Browser, Informationen über Verleger/Abonnenten und mehr
Metadaten: Veröffentlichte Protokolle, abonnierte Protokolle und wann die Besprechung erstellt und zerstört wurde
Verleger: Eine Liste der Verleger, die während der Sitzung anwesend waren. Sie enthält Daten über ihre Streams, Abonnenten und Stream-Statistiken
Abonnenten: Ein Array von Teilnehmern, die während der Besprechung anwesend waren. Es enthält Informationen über den Stream des Teilnehmers und Stream-Statistiken
Example GraphQL query for the Advanced Insights API
Die Stärke von Advanced Insights liegt in den In-Stream-Statistiken. Diese Daten umfassen 30-Sekunden-Schnappschüsse von Audio- und Videolatenz, Bitrate, Paketverlustrate und Codecs. Sie enthalten auch Informationen zur Videoauflösung und dazu, ob ein Stream zum Zeitpunkt des Snapshots Audio und/oder Video enthielt.
Anhand dieser Informationen können Sie die gesamte Erfahrung des Nutzers in Bezug auf die Qualität seines Streams überprüfen und diese Daten über Metriken wie SDK, Browser, Tageszeit und mehr vergleichen. Mit diesem Einblick können Sie Ihre Applications plattformübergreifend optimieren, um Ihren Kunden das bestmögliche Erlebnis zu bieten.
Advanced Insights-Daten sind 21 Tage lang verfügbar. Der Aufbewahrungszeitraum basiert auf dem Erstellungszeitpunkt eines Meetings innerhalb einer Sitzung. Die Daten haben eine erwartete Verfügbarkeitslatenz von 5 Minuten ab dem Ende der Besprechung.
Timeline displaying retention spans of the Advanced Insights API
Während unserer regelmäßigen Datenbank-Wartungsfenster sind die Advanced Insights-Daten möglicherweise nicht zugänglich. Alle Daten werden kurz nach dem angegebenen Wartungszeitraum wieder eingepflegt.
| Day | Time | Data Available By | |
|---|---|---|---|
| Daily database maintenance | Monday - Sunday | 9pm - 11pm PT | 11:30pm PT |
| Weekly database maintenance | Sunday | 4am - 7am PT | 8am PT |
In vielen Fällen werden Sie den Zugriff auf Ihre Insights- und Advanced Insights-Daten länger aufrechterhalten wollen, als unsere Aufbewahrungsrichtlinien vorsehen. Ob Sie serverlose Funktionen oder geplante Aufgaben verwenden, Sie werden die API-Endpunkte in regelmäßigen Abständen abfragen wollen, um die Daten abzurufen und in Ihre Datenbank zu laden. Die langfristige Speicherung dieser Daten in der Datenbank Ihrer Wahl bietet Ihnen die Möglichkeit, Ihrem Team und/oder Ihren Kunden nahtlos Einblicke zu gewähren und Metriken über größere Zeiträume zu vergleichen.
Denken Sie daran, dass die Daten in beiden APIs unter Verwendung der Pazifischen Zeit aggregiert werden. Achten Sie also darauf, dass Sie bei der Bestimmung der Tageszeit, zu der Sie Ihre Abfragen durchführen, alle Zeitzonenabweichungen berücksichtigen.
Da die Insights-API täglich aggregiert wird, sollten Sie sie nicht mehr als einmal täglich abfragen. Es reicht aus, diese Daten jeden Tag oder sogar alle paar Tage abzufragen und zu speichern.
Advanced Insights-Daten für eine Besprechung sind 5 Minuten nach Beendigung der Besprechung verfügbar. Der richtige Zeitpunkt für die Abfrage dieser Daten hängt davon ab, ob Ihre Applications Daten in Echtzeit benötigen. Achten Sie darauf, dass Sie die oben angegebenen Wartungszeiträume für die Advanced Insights-Datenbank berücksichtigen.
Mit den Insights- und Advanced Insights-Daten können Sie Trends bei Client-Plattformen und Browsern erkennen und Ihr Team in die Lage versetzen, Probleme mit Paketverlusten, Benutzer-Bitraten und Latenzzeiten innerhalb von Minuten zu identifizieren. Um mehr über die Insights & Advanced Insights APIs zu erfahren und darüber, wie Sie damit fundiertere Entscheidungen treffen können, klicken Sie auf die untenstehenden Links: