Dienstgüte-Abonnement (QSS) Erklärung

Dienstgüte-Abonnement (QSS) ist ein Add-on-Produkt, das Meeting, Webinar und Telefon-QoS-Daten an einen Kunden-Endpunkt eines Drittanbieters liefert.

Dienstgüte-Abonnement (QSS) ist ein Add-on-Produkt, das nahezu in Echtzeit Dienstgüte (QoS)-Telemetriedaten für Zoom Meetings, Webinare und Zoom Phone über Event-Abonnements bereitstellt

Zoom’s Dienstgüte-Abonnement (QSS) ist ein Add-on-Produkt, das nahezu in Echtzeit Dienstgüte (QoS)-Daten für Zoom Meetings, Webinare und Telefonanrufe bereitstellt. QSS erweitert die Produktfunktionalität von Zoom, indem es QoS-Ereignisse auf Teilnehmer-Ebene in Intervallen auf Minutenebene sendet (Rate und Aggregation können je nach Konfiguration variieren). Kunden können diesen reichhaltigen Datenstrom nutzen, um zu erkennen, ob Netzwerkumgebungen Zoom’s Dienste beeinträchtigen.

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

Die vorhandene Zoom Dashboard liefert Netzwerkleistungs- und Nutzungsmetriken, die Kunden dabei helfen können zu verstehen, wie Zoom in einer Netzwerkumgebung funktioniert. QSS bietet dieselben Zoom QoS-Daten, jedoch mit einer höheren Rate. Aufgrund dieser schnelleren Stichprobenrate werden aggregierte QoS-Metriken Werte anzeigen, die sich vom Haupt-Dashboard von Zoom unterscheiden. Diese Metriken zulassen Kunden jedoch weiterhin, sie in ihre eigenen Dashboard-Ansichten zu Konfigurieren, um Zoom-Daten mit zusätzlichen Systemen zu korrelieren.

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

	QoS-Daten, bereitgestellt über QSS
Qualitätsmetriken	Bitrate, Latenz, Jitter, Paketverlust, Auflösung, Bildrate, CPU-Auslastung
Nutzungsmetriken	Gerät, Netzwerk, Signalisierungsregion, Client-Version, Audio (I/O), Video (I/O)
Häufigkeit	Ca. 1 Event pro Minute, pro Teilnehmer (pro QoS-Metrik oder aggregiertem Satz, abhängig von den Einstellungen des Kontos).
Datenspeicherung	Protokolle zur Event-Zustellung werden über die Webhook Logs API 7 Tage lang aufbewahrt; historische QoS-Daten über API-Endpunkte können länger gespeichert bleiben (abhängig von der Lizenz).

Daten des Zoom Dashboard sollten nicht mit Daten verglichen werden, die über QSS an einen Endpunkt eines Drittanbieters des Kunden übermittelt werden

QSS und das Zoom Dashboard bieten zwei separate Mechanismen für den Zugriff auf Zoom QoS-Daten, die nicht verglichen werden sollten. Während das Zoom Dashboard und QSS aus demselben Pool von QoS-Daten abrufen, stimmen die Daten in jedem Mechanismus aufgrund von Unterschieden im Abrufzeitpunkt und in der Häufigkeit der Datenübermittlung nicht überein.

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

QSS stellt QoS-Eventdaten für alle Benutzer auf einem Konto für Zoom Meetings und Webinare sowie für Zoom Phone-Anrufe bereit. Da Zoom den letzten Abschnitt von Anrufen nicht verwaltet, liefert QSS für Zoom Phone-Anrufe nur QoS-Eventdaten auf Kontoebene und kann daher keine vollständige Transparenz in die erweiterten End-to-End-Teilnehmerdaten bieten.

QSS-Daten enthalten keine Daten für externe Teilnehmer

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

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

Während Zoom-Kunden in der Vergangenheit Tools wie das Zoom Dashboard oder APIs verwenden konnten, um Zoom-QoS-Daten anzuzeigen oder abzurufen, können Sie mit QSS Zoom-QoS-Telemetriedaten per Event-Abonnements (Webhook oder WebSocket) in Ihre Plattformen für Netzwerkverwaltung und Monitoring streamen.

QSS liefert QoS-Events nahezu in Echtzeit an Ihre abonnierten Endpunkte und reduziert so das API-Abfragen und die Auswirkungen von Ratenlimits

QSS-Kunden können sich für QoS-Events und -Daten in Echtzeit anmelden, die an ihre Anwendung-Endpunkte gepusht werden, was dazu beiträgt, API-Kapazität freizusetzen und die Netzwerkauslastung zu optimieren. QSS ist eine Ergänzung zum Zooms standard webhook service da es rohe QoS-Daten nahezu in Echtzeit mit einer Rate von 4 bis 6 Mal pro Minute an einen Endpunkt senden kann.

QSS ermöglicht es Kunden, nahezu in Echtzeit auf QoS-Daten aus dem Zoom Dashboard zuzugreifen, ohne API-Ratenlimits zu überschreiten

API-Services sind anforderungsbasiert und verwenden einen „Pull“-Mechanismus, um Daten abzurufen, die von einer App oder einem Benutzer angefordert werden. APIs sind ressourcenintensiver als Webhooks, da sie wiederholte Aufrufe erfordern, um Daten von einem API-Endpunkt abzurufen.

Kunden, die Zoom APIs verwenden, um QoS-Daten von Zoom Dashboard abzurufen, können auf Rate Limits stoßen, was bedeutet, dass sie die maximale Anzahl an API-Aufrufen erreicht haben, die sie innerhalb eines bestimmten Zeitraums durchführen können. QSS erhöht die API-Rate-Limits nicht, verringert jedoch die Bedenken der Kunden hinsichtlich Rate Limits, indem es Roh-QoS-Daten an ihre Endpunkte sendet, anstatt die Kunden aufzufordern, die Daten selbst abzurufen.

QSS ermöglicht es Kunden, rohe Zoom QoS-Daten zu nutzen und Fehlerbehebung mithilfe ihres bevorzugten Netzwerkmanagementsystems durchzuführen

Bestimmte Kunden müssen möglicherweise ihre Netzwerkleistung in mehreren Anwendungen gleichzeitig bewerten. QSS ermöglicht es ihnen, Zoom QoS-Daten in einem Dashboard zusammen mit anderen Daten in ihrer Anwendungssuite zu überwachen und bietet so eine flexible, skalierbare Möglichkeit, Zoom QoS-Daten zu nutzen und nahtlos in benutzerdefinierte Dashboards zu integrieren.

Zoom QoS-Daten werden über TLS 1.2 übertragen

QSS-Daten werden während der Übertragung mit TLS 1.2 oder höher verschlüsselt. Endpunkte müssen ein gültiges Zertifikat einer Zertifizierungsstelle (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 eines Challenge-Response Checks (CRC). Der CRC bestätigt den Besitz und die Sicherheit ihrer Event-Benachrichtigungs-Endpunkt-URLs.

Kunden können mit dem Nutzen von QoS-Daten beginnen, indem sie eine Anwendung erstellen, die QSS-Ereignisse empfangen kann

Nachdem ein Kunde den QSS Add-on-Plan kauft, muss mindestens ein Benutzer auf dem Konto über aktivierte Entwicklerberechtigungen verfügen. Kunden können dann die folgenden drei Schritte verwenden, um eine Anwendung zu erstellen, die Webhook verwendet, um sich für QSS-Ereignisse zu abonnieren.

Kunden können auch die Zoom Entwicklerpaket mit aktiviertem QSS-Flag, das QSS mit anderen Entwicklertools bündelt.

1

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

Kunden müssen zuerst eine allgemeine oder Server-to-Server-OAuth-App in der Zoom App Marketplace. Dann würden sie Event-Abonnements Aktivieren und die QoS-Events auswählen, die sie erhalten möchten.

Als Nächstes müssen Kunden das Ziel für Benachrichtigungen zu QSS-Events angeben, indem sie die URL des Event-Benachrichtigungs-Endpunkts ihrer Anwendung eingeben

Für diese Konfiguration ist keine nur-Webhook-App erforderlich. Zoom empfiehlt, eine Allgemeine App zu erstellen.

2

QSS-Webhook-Events abonnieren

Um QSS-Events zu abonnieren, müssen Kunden Events hinzufügen und aus der Liste der verfügbaren QSS auswählen Event-Typen. Kunden können einen oder mehrere QSS-Events auswählen, bevor sie den Prozess abschließen und ihre Anwendung aktivieren.

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} – Abonnement aufheben/löschen

• GET /marketplace/app/event_subscription – Liste

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

3

Webhook-Events verifizieren

Stellen Sie nach der Konfiguration der Event-Abonnements sicher, dass sowohl das Eigentum an der Webhook-URL als auch die Authentizität der Events ordnungsgemäß validiert werden.

• URL-Validierung

  • Wenn Sie Event-Abonnements zum ersten Mal aktivieren, führt Zoom einen Challenge–Response Check (CRC) durch, um das Eigentum an Ihrem Webhook-Endpunkt zu verifizieren. Dieser Prozess stellt sicher, dass Zoom Daten an ein legitimes Ziel sendet, das von Ihrer App gesteuert wird. (Sie können die CRC-Behandlung bei Bedarf in einen früheren Einrichtungsschritt integrieren.)

• Event-Validierung

  • Jede eingehende Event-Benachrichtigung sollte von Ihrer Anwendung verifiziert werden, um zu bestätigen, dass sie von Zoom stammt. Die App kann eingehende Anfragen anhand des Signatur-Headers validieren, der in jedem Webhook-Event bereitgestellt wird. Entwickler, die eine Alternative zur standardmäßigen 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-Zustellungsdaten zu prüfen, einschließlich Status, Wiederholungsanzahl und Trace-ID.

Für vollständige Implementierungsdetails lesen Sie bitte den QSS Implementierungsleitfaden für Entwickler. Technische Details finden Sie in den Anleitungen zur Event Subscription API, Webhook Logs API und zur Authentifizierung mit dem Client Credentials Grant in den Zoom Developer Docs.