Uitleg over Quality of Service-abonnement

Quality of Service-abonnement is een Add-on(s)-product dat vergadering, webinar en Phone QoS-datagegevens levert aan een eindpunt van derden van de klant.

Quality of Service-abonnement is een Add-on(s)-product dat bijna realtime QoS-telemetrie streamt voor Zoom Meetings, Webinars, en Zoom Phone via Evenement-abonnementen

Zoom’s Quality of Service-abonnement (QSS) is een Add-on(s)-product dat bijna realtime quality of service (QoS)-gegevens biedt voor Zoom Meetings, Webinars en telefoon­oproepen. QSS breidt de productfunctionaliteit van Zoom uit door participant-level QoS-events te verzenden met intervallen op minuut­niveau (snelheid en aggregatie kunnen variëren per configuratie). Klanten kunnen deze rijke gegevensstroom gebruiken om te bepalen of netwerkomgevingen de diensten van Zoom beïnvloeden.

QSS levert dezelfde onderliggende QoS-metrieken die worden gebruikt in Zoom Dashboards en API's, maar de bemonstering en timing verschillen

De bestaande Zoom Dashboard biedt netwerkprestatie- en gebruiksstatistieken, die klanten kunnen helpen te begrijpen hoe Zoom presteert in een netwerkomgeving. QSS biedt dezelfde Zoom QoS-gegevens, maar met een hogere frequentie. Door deze snellere bemonsteringsfrequentie zullen geaggregeerde QoS-statistieken andere waarden weergeven dan het hoofd-Dashboard van Zoom. Deze statistieken Toestaan echter nog steeds klanten om ze te Configureer in hun eigen dashboardweergaven om Zoom-gegevens te correleren met aanvullende systemen.

De onderstaande tabel beschrijft de QoS-gegevens die via QSS aan de eindpunten van een klant worden geleverd.

	QoS-gegevens geleverd via QSS
Kwaliteitsmetrieken	Bitsnelheid, latentie, jitter, pakketverlies, resolutie, framesnelheid, CPU-gebruik
Gebruiksmaten	Apparaat, netwerk, signaleringsregio, clientversie, Audio (I/O), Video (I/O)
Frequentie	Ongeveer 1 Evenement per minuut, per Deelnemer (per QoS-metriek of geaggregeerde set, afhankelijk van account Instellingen).
Gegevensretentie	Logs voor Evenement-levering worden 7 dagen bewaard via de Webhook Logs API; historische QoS-gegevens via API-Eindpunten kunnen langer bewaard blijven (afhankelijk van licentie).

Zoom Dashboard-gegevens mogen niet worden vergeleken met gegevens die via QSS naar een Eindpunt van een derde partij van een klant worden geleverd

QSS en het Zoom Dashboard bieden twee afzonderlijke mechanismen voor toegang tot Zoom QoS-gegevens die niet mogen worden vergeleken. Hoewel het Zoom Dashboard en QSS putten uit dezelfde pool van QoS-gegevens, zullen de gegevens in elk mechanisme niet overeenkomen vanwege verschillen in ophaaltijdstip en frequentie van gegevenslevering.

QSS ondersteunt realtime Evenement-gegevens voor vergaderingen, webinars en telefoongesprekken

QSS levert QoS-evenementgegevens voor alle gebruikers op een account voor Zoom Meetings en webinars, evenals voor Zoom Phone-oproepen. Omdat Zoom het laatste deel van oproepen niet beheert, levert QSS alleen QoS-evenementgegevens op accountniveau voor Zoom Phone-oproepen en kan het daarom geen volledig inzicht bieden in de geavanceerde deelnemergegevens van begin tot eind.

QSS-gegevens bevatten geen gegevens voor externe deelnemers

QSS biedt geen gegevens voor externe deelnemers aan vergaderingen. QSS kan echter helpen vast te stellen welke interne Deelnemer aan de vergadering een probleem had en wat dat probleem was, evenals de kwaliteits- en gebruiksstatistieken die Klanten nodig hebben om problemen op te lossen.

QSS stelt Klanten in staat om ruwe QoS-gegevens uit Zoom Dashboard in hun bestaande workflows te integreren

Hoewel Zoom-klanten historisch gezien tools zoals Zoom Dashboard of API's hebben kunnen gebruiken om Zoom QoS-gegevens te bekijken of op te halen, kunt u met QSS Zoom QoS-telemetrie streamen naar uw netwerkbeheer- en monitoringplatforms via evenementabonnementen (webhook of WebSocket).

QSS levert QoS-evenementen vrijwel in realtime aan uw geabonneerde Eindpunten, waardoor API-polling en impact op de snelheidslimiet worden verminderd

QSS-klanten kunnen zich abonneren op QoS-evenementen en gegevens in realtime die naar hun applicatie-Eindpunten worden gepusht, wat helpt om API-capaciteit vrij te maken en het netwerkgebruik te optimaliseren. QSS is een uitbreiding van Zoom’s standaard webhook-service omdat het ruwe QoS-gegevens kan verzenden naar een Eindpunt met een bijna realtime snelheid van 4 tot 6 keer per minuut.

QSS stelt Klanten in staat om toegang te krijgen tot QoS-gegevens in bijna realtime vanuit Zoom Dashboard zonder API-snelheidslimieten te overschrijden

API-services zijn gebaseerd op verzoeken en gebruiken een 'pull'-mechanisme om gegevens te verzamelen die door een app of gebruiker worden opgevraagd. API's zijn resource-intensiever dan webhooks omdat ze herhaalde aanroepen vereisen om gegevens op te halen van een API Eindpunt.

Klanten die Zoom API's om QoS-gegevens van Zoom Dashboard op te halen, kunnen te maken krijgen met snelheidslimieten, wat betekent dat ze het maximale aantal API-aanroepen hebben bereikt dat ze binnen een bepaalde periode kunnen doen. QSS verhoogt de API-snelheidslimieten niet, maar het vermindert de zorgen van klanten over snelheidslimieten door ruwe QoS-gegevens naar hun eindpunten te pushen in plaats van klanten te verplichten de gegevens zelf op te halen.

QSS stelt klanten in staat ruwe Zoom QoS-gegevens te gebruiken en problemen op te lossen met hun voorkeursnetwerkbeheersysteem

Bepaalde klanten moeten mogelijk hun netwerkprestaties op meerdere applicaties tegelijk beoordelen. QSS stelt hen in staat Zoom QoS-gegevens te monitoren in een dashboard naast andere gegevens in hun applicatiesuite, wat een flexibele, schaalbare manier biedt om Zoom QoS-gegevens te gebruiken en deze naadloos te integreren in aangepaste dashboards.

Zoom QoS-gegevens worden verzonden via TLS 1.2

QSS-gegevens worden tijdens transport versleuteld met TLS 1.2 of hoger. Eindpunten moeten een geldig certificaat van een certificaatautoriteit (CA) gebruiken. Webhookverzoeken bevatten een handtekeningheader en een challenge-response-controle voor Verificatie.

Voor extra beveiliging zullen klanten worden gevraagd om hun webhook-eindpunten te valideren met behulp van een Challenge-Response Check (CRC). De CRC bevestigt het eigenaarschap en de beveiliging van de URL's van het eindpunt voor evenementmeldingen.

Klanten kunnen beginnen met het gebruiken van QoS-gegevens door een applicatie te maken die QSS-gebeurtenissen kan ontvangen

Nadat een Klanten een QSS Add-on(s)-abonnement heeft aangeschaft, moet er ten minste één gebruiker op de account ontwikkelrechten hebben ingeschakeld. Klanten kunnen vervolgens de volgende drie stappen gebruiken om een webhook applicatie te maken die zich kan abonneren op QSS-gebeurtenissen.

Klanten kunnen ook het volgende nastreven Zoom Developer Pack met een ingeschakelde QSS-vlag, die QSS bundelt met andere ontwikkelaarstools.

1

Maak een app voor Evenementabonnement (Algemene of Server-to-Server OAuth). Inschakelen Evenementabonnementen en Selecteer QoS-evenementen

Klanten moeten eerst een Algemene of Server-to-Server OAuth app maken in de Zoom App Marketplace. Vervolgens zouden ze Evenement-abonnementen Inschakelen en de QoS-evenementen Selecteeren die ze willen ontvangen.

Volgende moeten Klanten de bestemming voor QSS-evenementmeldingen opgeven door de URL van het Eindpunt voor Melding van hun applicatie in te voeren

Voor deze configuratie is geen app die alleen webhook gebruikt vereist. Zoom raadt aan een algemene app te maken.

2

Abonneer u op QSS webhook-gebeurtenissen

Om je te abonneren op QSS-gebeurtenissen moeten Klanten gebeurtenissen Toevoegen en Kies uit de lijst met Beschikbaar QSS Evenementtypen. Klanten kunnen één of meer QSS-gebeurtenissen Selecteer voordat ze het proces voltooien en hun applicatie activeren.

Je kunt abonnementen ook beheren via de Marketplace-gebruikersinterface of met API-aanroepen:

• POST /Marketplace/app/Evenement_subscription – aanmaken

• PATCH /{id} – gebruikers/accounts abonneren

• DELETE /{id} – uitschrijven/verwijderen

• GET /marketplace/app/Evenement_subscription – lijst

Om via API te authenticeren, gebruik je een token uit de Client Credentials Grant.

3

Webhook-gebeurtenissen verifiëren

Nadat u Evenement-abonnementen hebt geconfigureerd, moet u ervoor zorgen dat zowel het eigendom van de webhook-URL als de authenticiteit van het Evenement correct worden gevalideerd.

• URL-validatie

  • Wanneer je voor het eerst evenementsabonnementen inschakelt, voert Zoom een Challenge–Response Check (CRC) uit om het eigendom van je webhook-Eindpunt te verifiëren. Dit proces zorgt ervoor dat Zoom gegevens verzendt naar een legitieme bestemming die wordt beheerd door je app. (Je kunt CRC-afhandeling desgewenst opnemen in een eerdere installatiestap.)

• Evenementvalidatie

  • Elke inkomende Evenement-melding moet door uw applicatie worden geverifieerd om te bevestigen dat deze afkomstig is van Zoom. De app kan inkomende verzoeken valideren met behulp van de handtekeningheader die in elk webhook-Evenement wordt verstrekt. Ontwikkelaars die de voorkeur geven aan een alternatief voor de Standaard handtekeningmethode, kunnen een van de andere ondersteunde Verificatie-opties gebruiken die worden beschreven in de Zoom Developer Docs.

  • Gebruik de Get Webhook Logs API om tot zeven dagen aan webhook-bezorggegevens te bekijken, inclusief status, aantal herhalingspogingen en trace-ID.

Voor volledige implementatiedetails verwijzen wij u naar de QSS-implementatiegids voor ontwikkelaars. Voor technische details, zie de Evenement Subscription API, Webhook Logs API en Client Credentials Grant authenticatiegidsen in Zoom Developer Docs.