Erklärung zum Quality of Service-Abonnement

Quality of Service Subscription ist ein Add-on-Produkt, das Meeting-, Webinar- und Phone-QoS-Daten an einen Drittanbieterschnittstelle des Kunden liefert.

Das Quality of Service Subscription ist ein Add-on-Produkt, das nahezu Echtzeit-QoS-Telemetrie für Zoom Meetings, Webinare und Zoom Phone über Ereignis-Subscriptions bereitstellt

Zooms Quality of Service Subscription (QSS) ist ein Add-on-Produkt, das nahezu Echtzeit-Daten zur Dienstgüte (QoS) für Zoom Meetings, Webinare und Telefonanrufe bietet. QSS erweitert die Produktfunktionalität von Zoom, indem es QoS-Ereignisse auf Teilnehmerebene in Intervallen von etwa einer Minute sendet (Rate und Aggregation können je nach Konfiguration variieren). Kunden können diesen umfangreichen Datenstrom nutzen, um festzustellen, ob Netzwerkumgebungen die Zoom-Dienste beeinträchtigen.

QSS liefert dieselben zugrunde liegenden QoS-Metriken, die in den Zoom-Dashboards und -APIs verwendet werden, aber die Stichprobenahme und das Timing unterscheiden sich

Das bestehende Zoom Dashboard bietet Netzwerkleistungs- und Nutzungsmetriken, die Kunden dabei helfen können zu verstehen, wie Zoom in einer Netzwerkumgebung arbeitet. QSS bietet dieselben Zoom-QoS-Daten, jedoch mit höherer Frequenz. Aufgrund dieser höheren Abtastrate zeigen aggregierte QoS-Metriken Werte, die sich vom Haupt-Zoom-Dashboard unterscheiden. Diese Metriken ermöglichen es Kunden jedoch weiterhin, sie in ihre eigenen Dashboard-Ansichten zu integrieren, um Zoom-Daten mit zusätzlichen Systemen zu korrelieren.

Die nachstehende Tabelle beschreibt die QoS-Daten, die über QSS an die Endpunkte eines Kunden geliefert werden.

	Über QSS gelieferte QoS-Daten
Qualitätsmetriken	Bitrate, Latenz, Jitter, Paketverlust, Auflösung, Bildrate, CPU-Auslastung
Nutzungsmetriken	Gerät, Netzwerk, Signalisierungsregion, Client-Version, Audio (Ein-/Ausgabe), Video (Ein-/Ausgabe)
Frequenz	Ca. 1 Ereignis pro Minute und Teilnehmer (pro QoS-Metrik oder aggregierter Satz, abhängig von den Kontoeinstellungen).
Datenaufbewahrung	Ereignis-Zustellprotokolle werden über die Webhook Logs API für 7 Tage aufbewahrt; historische QoS-Daten über API-Endpunkte können länger vorgehalten werden (abhängig von der Lizenz).

Daten aus dem Zoom Dashboard sollten nicht mit Daten verglichen werden, die über QSS an Drittanbieter-Endpunkte eines Kunden geliefert werden

QSS und das Zoom Dashboard bieten zwei separate Mechanismen zum Zugriff auf Zoom-QoS-Daten, die nicht miteinander verglichen werden sollten. Obwohl das Zoom Dashboard und QSS aus demselben Pool von QoS-Daten ziehen, stimmen die Daten in den beiden Mechanismen aufgrund von Unterschieden im Abrufzeitpunkt und in der Häufigkeit der Datenlieferung nicht überein.

QSS unterstützt Echtzeit-Ereignisdaten für Meetings, Webinare und Telefonanrufe

QSS liefert QoS-Ereignisdaten für alle Benutzer eines Kontos für Zoom Meetings und Webinare sowie für Zoom Phone-Anrufe. Da Zoom das letzte Segment von Anrufen nicht verwaltet, stellt QSS für Zoom Phone-Anrufe nur QoS-Ereignisdaten auf Kontoebene bereit und kann daher keine vollständige Sichtbarkeit der End-to-End-Advanced-Teilnehmerdaten bieten.

QSS-Daten enthalten keine Daten für externe Teilnehmer

QSS stellt keine Daten für externe Meeting-Teilnehmer bereit. QSS kann jedoch helfen festzustellen, welcher interne Meeting-Teilnehmer ein Problem hatte und worin dieses Problem bestand, sowie die Qualitäts- und Nutzungsmetriken liefern, die Kunden zur Fehlerbehebung benötigen.

QSS ermöglicht Kunden, rohe QoS-Daten aus dem Zoom Dashboard in ihre bestehenden Workflows zu integrieren

Während Zoom-Kunden historisch Tools wie das Zoom Dashboard oder APIs nutzen konnten, um Zoom-QoS-Daten anzusehen oder abzurufen, ermöglicht QSS das Streamen der Zoom-QoS-Telemetrie in Netzwerkmanagement- und Überwachungsplattformen über Ereignis-Subscriptions (Webhook oder WebSocket).

QSS liefert nahezu Echtzeit-QoS-Ereignisse an Ihre abonnierten Endpunkte und reduziert API-Polling sowie Auswirkungen auf Rate-Limits

QSS-Kunden können sich für Echtzeit-QoS-Ereignisse und -Daten anmelden, die an ihre Anwendungsendpunkte gepusht werden, was dazu beiträgt, API-Kapazitäten freizugeben und die Netzwerkauslastung zu optimieren. QSS ist eine Erweiterung des Zoom- Standard-Webhook-Dienstes da es rohe QoS-Daten mit einer nahezu Echtzeit-Rate von 4 bis 6 Mal pro Minute an einen Endpunkt senden kann.

QSS ermöglicht Kunden den Zugriff auf nahezu Echtzeit-QoS-Daten aus dem Zoom Dashboard, ohne API-Rate-Limits zu überschreiten

API-Dienste sind anfragenbasiert und verwenden einen Pull-Mechanismus, um von einer App oder einem Benutzer angeforderte Daten zu sammeln. APIs sind ressourcenintensiver als Webhooks, da sie wiederholte Aufrufe erfordern, um Daten von einem API-Endpunkt abzurufen.

Kunden, die Zoom APIs nutzen, um QoS-Daten aus dem Zoom Dashboard abzurufen, können auf Rate-Limits stoßen, was bedeutet, dass sie die maximale Anzahl von API-Aufrufen innerhalb eines bestimmten Zeitraums erreicht haben. QSS erhöht die API-Rate-Limits nicht, reduziert jedoch die Bedenken der Kunden hinsichtlich von Rate-Limits, indem rohe QoS-Daten an ihre Endpunkte gepusht werden, anstatt dass die Kunden die Daten selbst abrufen müssen.

QSS ermöglicht Kunden, rohe Zoom-QoS-Daten zu konsumieren und mit ihrem bevorzugten Netzwerkmanagementsystem Fehler zu beheben

Bestimmte Kunden müssen möglicherweise die Netzwerkleistung mehrerer Anwendungen gleichzeitig bewerten. QSS ermöglicht es ihnen, Zoom-QoS-Daten in einem Dashboard neben anderen Daten aus ihrer Anwendungs-Suite zu überwachen und bietet eine flexible, skalierbare Möglichkeit, Zoom-QoS-Daten zu konsumieren und nahtlos in benutzerdefinierte Dashboards zu integrieren.

Zoom-QoS-Daten werden über TLS 1.2 übertragen

QSS-Daten werden während der Übertragung mittels TLS 1.2 oder höher verschlüsselt. Endpunkte müssen ein gültiges Zertifikat einer Certificate Authority (CA) verwenden. Webhook-Anfragen enthalten einen Signatur-Header und eine Challenge-Response-Prüfung zur Verifizierung.

Für zusätzliche Sicherheit werden Kunden aufgefordert, ihre Webhook-Endpunkte zu validieren mithilfe einer Challenge-Response-Prüfung (CRC). Die CRC bestätigt den Besitz und die Sicherheit der URLs ihrer Event-Benachrichtigungsendpunkte.

Kunden können damit beginnen, QoS-Daten zu konsumieren, indem sie eine Anwendung erstellen, die QSS-Ereignisse empfangen kann

Nachdem ein Kunde den QSS-Add-on-Plan erworben hat, muss mindestens ein Benutzer im Konto über aktivierte Entwicklerberechtigungen verfügen. Kunden können dann die folgenden drei Schritte nutzen, um eine Webhook-Anwendung zu erstellen, die sich für QSS-Ereignisse anmelden kann.

Kunden können auch das Zoom Developer Pack mit aktiviertem QSS-Flag in Anspruch nehmen, das QSS mit anderen Entwickler-Tools bündelt.

1

Erstellen Sie eine Event-Subscription-App (General oder Server-to-Server OAuth). Aktivieren Sie Event Subscriptions und wählen Sie QoS-Ereignisse aus

Kunden müssen zunächst eine General- oder Server-to-Server-OAuth-App im Zoom App Marketplace. Erstellen. Dann aktivieren sie Event Subscriptions und wählen die QoS-Ereignisse aus, die sie empfangen möchten.

Als Nächstes müssen Kunden das Ziel für QSS-Ereignisbenachrichtigungen angeben, indem sie die Event-Benachrichtigungs-Endpunkt-URL ihrer Anwendung eingeben

Eine Webhook-only-App ist für diese Konfiguration nicht erforderlich. Zoom empfiehlt die Erstellung einer General App.

2

Für QSS Webhook-Ereignisse abonnieren

Um QSS-Ereignisse zu abonnieren, müssen Kunden Ereignisse hinzufügen und aus der Liste der verfügbaren QSS Ereignistypenwählen. Kunden können vor Abschluss des Prozesses und der Aktivierung ihrer Anwendung ein oder mehrere QSS-Ereignisse auswählen.

Sie können Abonnements auch über die Marketplace-Benutzeroberfläche oder mithilfe von API-Aufrufen verwalten:

• POST /marketplace/app/event_subscription – erstellen

• PATCH /{id} – Benutzer/Konten abonnieren

• DELETE /{id} – abmelden/löschen

• GET /marketplace/app/event_subscription – auflisten

Um sich über die API zu authentifizieren, verwenden Sie ein Token aus dem Client Credentials Grant.

3

Webhook-Ereignisse verifizieren

Nachdem Sie Event Subscriptions konfiguriert haben, stellen Sie sicher, dass sowohl der Besitz der Webhook-URL als auch die Authentizität der Ereignisse ordnungsgemäß validiert werden.

• URL-Validierung

  • Wenn Sie Event Subscriptions erstmals aktivieren, führt Zoom eine Challenge–Response-Prüfung (CRC) durch, um den Besitz Ihres Webhook-Endpunkts zu verifizieren. Dieser Prozess stellt sicher, dass Zoom Daten an ein legitimes Ziel sendet, das von Ihrer App kontrolliert wird. (Sie können die CRC-Behandlung bei Bedarf in einem früheren Einrichtungsschritt einbinden.)

• Ereignisvalidierung

  • Jede eingehende Ereignisbenachrichtigung sollte von Ihrer Anwendung verifiziert werden, um zu bestätigen, dass sie von Zoom stammt. Die App kann eingehende Anfragen mithilfe des in jedem Webhook-Ereignis bereitgestellten Signatur-Headers validieren. Entwickler, die eine Alternative zur Standard-Signaturmethode bevorzugen, können eine der anderen unterstützten Verifizierungsoptionen verwenden, die in den Zoom Developer Docs beschrieben sind.

  • Verwenden Sie die Get Webhook Logs API, um bis zu sieben Tage an Webhook-Zustelldaten zu prüfen, einschließlich Status, Anzahl der Wiederholungsversuche und Trace-ID.

Für vollständige Implementierungsdetails verweisen wir auf das QSS Implementation Guide für Entwickler. Für technische Details siehe die Event Subscription API, die Webhook Logs API und die Anleitungen zur Authentifizierung mit dem Client Credentials Grant in den Zoom Developer Docs.