tjänstekvalitetsabonnemang förklarat

tjänstekvalitetsabonnemang är en tilläggsprodukt som levererar tjänstekvalitetsdata för möte, webbinarium och Phone till en kunds tredjepartsändpunkt.

tjänstekvalitetsabonnemang är ett tilläggsprodukt som strömmar QoS-telemetri i nära realtid för Zoom Meetings, webbinarier och Zoom Phone via händelseprenumerationer

Zooms tjänstekvalitetsabonnemang (QSS) är ett tilläggsprodukt som erbjuder data om tjänstekvalitet (QoS) i nära realtid för Zoom Meetings, webbinarier och telefonsamtal. QSS utökar Zooms produktfunktionalitet genom att skicka QoS-händelser på deltagarnivå med intervall på minutnivå (hastighet och aggregering kan variera beroende på konfiguration). Kunder kan använda denna rika dataström för att identifiera om nätverksmiljöer påverkar Zooms tjänster.

QSS levererar samma underliggande QoS-mätvärden som används i Zoom-kontrollpaneler och API:er, men sampling och tidsstyrning skiljer sig åt

Den befintliga Zoom kontrollpanel tillhandahåller nätverksprestanda- och användningsmätvärden, vilket kan hjälpa kunder att förstå hur Zoom fungerar i en nätverksmiljö. QSS erbjuder samma Zoom QoS-data, men med en snabbare takt. På grund av denna snabbare samplingshastighet kommer aggregerade QoS-mätvärden att visa värden som skiljer sig från den huvudsakliga Zoom-kontrollpanelen. Dessa mätvärden kan dock fortfarande tillåta kunder att konfigurera dem i sina egna kontrollpanelvyer för att korrelera Zoom-data med ytterligare system.

Tabellen nedan beskriver de QoS-data som levereras till en kunds slutpunkter via QSS.

	QoS-data som levereras via QSS
Kvalitetsmätvärden	Bitrate, latens, jitter, paketförlust, upplösning, bildfrekvens, CPU-användning
Användningsmått	Enhet, nätverk, signaleringsregion, klientversion, ljud (I/O), video (I/O)
Frekvens	Cirka 1 evenemang per minut, per deltagare (per QoS-mätvärde eller aggregerad uppsättning beroende på kontoinställningar).
Datalagring	Loggar för evenemangsleverans sparas i 7 dagar via webhook-loggarnas API; historiska QoS-data via API-ändpunkter kan sparas längre (beroende på licens).

Data i Zoom kontrollpanel bör inte jämföras med data som levereras via QSS till en kunds tredje parts ändpunkt

QSS och Zoom kontrollpanel tillhandahåller två separata mekanismer för åtkomst till Zoom QoS-data som inte bör jämföras. Även om Zoom kontrollpanel och QSS hämtar från samma pool av QoS-data kommer datan i respektive mekanism inte att stämma överens på grund av skillnader i hämtningstidpunkt och frekvens för dataleverans.

QSS stöder realtidsdata för evenemang för möten, webbinarier och telefonsamtal

QSS tillhandahåller QoS-evenemangsdata för alla användare på ett konto för Zoom Meetings och webbseminarier, samt för Zoom Phone-samtal. Eftersom Zoom inte hanterar den sista sträckan i samtal, tillhandahåller QSS endast QoS-evenemangsdata på kontonivå för Zoom Phone-samtal och kan därför inte ge full insyn i avancerade deltagardata från början till slut.

QSS-data inkluderar inte data för externa deltagare

QSS tillhandahåller inte data för externa mötesdeltagare. Däremot kan QSS hjälpa till att identifiera vilken intern mötesdeltagare som hade ett problem och vad det problemet var, samt de kvalitets- och användningsmått som Kunder behöver för att felsöka problem.

QSS gör det möjligt för Kunder att föra in rå QoS-data från Zoom kontrollpanel i sina befintliga arbetsflöden

Även om Zoom-kunder historiskt har kunnat använda verktyg som Zoom kontrollpanel eller API:er för att visa eller hämta Zoom QoS-data, låter QSS dig strömma Zoom QoS-telemetri till dina nätverkshanterings- och övervakningsplattformar via evenemangsprenumerationer (webhook eller WebSocket).

QSS levererar QoS-evenemang i nära realtid till dina prenumererade ändpunkter, vilket minskar API-polling och påverkan av hastighetsbegränsningar

QSS-kunder kan prenumerera på QoS-evenemang och data i realtid som skickas till deras applikation-ändpunkter, vilket hjälper till att frigöra API-kapacitet och optimera nätverksutnyttjandet. QSS är en utökning av Zooms standard webhook-tjänst eftersom den kan skicka rå QoS-data till en ändpunkt med en nära realtidsfrekvens på 4 till 6 gånger per minut.

QSS gör det möjligt för Kunder att få tillgång till QoS-data i nära realtid från Zoom kontrollpanel utan att slå i API:s hastighetsgränser

API-tjänster är begäranbaserade och använder en ”pull”-mekanism för att samla in data som efterfrågas av en app eller användare. API:er är mer resurskrävande än webhooks eftersom de kräver upprepade anrop för att hämta data från en API-ändpunkt.

Kunder som använder Zoom API:er för att hämta QoS-data från Zoom kontrollpanel kan stöta på hastighetsbegränsningar, vilket innebär att de har nått det maximala antalet API-anrop de kan göra inom en given tidsperiod. QSS ökar inte API-hastighetsbegränsningarna, men det minskar kundernas bekymmer kring hastighetsbegränsningar genom att skicka rå QoS-data till deras ändpunkter i stället för att kräva att kunderna hämtar datan själva.

QSS låter kunder konsumera rå Zoom QoS-data och felsöka med hjälp av deras föredragna nätverkshanteringssystem

Vissa kunder kan behöva bedöma sin nätverksprestanda i flera applikationer samtidigt. QSS låter dem övervaka Zoom QoS-data i en kontrollpanel tillsammans med annan data i deras svit av applikationer, vilket ger ett flexibelt och skalbart sätt att konsumera Zoom QoS-data och sömlöst integrera den i anpassade kontrollpaneler.

Zoom QoS-data överförs över TLS 1.2

QSS-data krypteras under överföring med TLS 1.2 eller högre. Ändpunkter måste använda ett giltigt certifikat från en certifikatutfärdare (CA). webhook-förfrågningar inkluderar en signaturhuvud och en challenge-response-kontroll för verifiering.

För extra säkerhet kommer kunder att uppmanas att validera sina webhook-ändpunkter using a Challenge-Response Check (CRC). The CRC kommer att bekräfta ägarskap och säkerhet för deras avisering av evenemangets ändpunkt-URL:er.

Kunder kan börja använda QoS-data genom att skapa en applikation som kan ta emot QSS-händelser

Efter att en kund har köpt tilläggsplanen QSS måste minst en användare på kontot ha utvecklarbehörigheter aktiverade. Kunder kan sedan använda följande tre steg för att skapa en webhook-applikation som kan prenumerera på QSS-händelser.

Kunder kan också fortsätta med Zoom-utvecklarpaket med en aktiverad QSS-flagga, vilket paketerar QSS tillsammans med andra utvecklarverktyg.

1

Skapa en app för evenemangsprenumeration (OAuth för allmänt bruk eller server-till-server). Aktivera evenemangsprenumerationer och markera QoS-evenemang

Kunder måste först skapa en generell eller Server-to-Server OAuth-app i Zoom App Marketplace. Sedan skulle de aktivera evenemangsprenumerationer och markera de QoS-evenemang de vill ta emot.

Nästa måste kunder ange destinationen för QSS-aviseringar för evenemang genom att ange URL:en för deras applikations ändpunkt för aviseringar om evenemang

En webhook-only app krävs inte för den här konfigurationen. Zoom rekommenderar att du skapar en allmän app.

2

Prenumerera på QSS webhook-händelser

För att prenumerera på QSS-händelser måste Kunder lägga till händelser och välja från listan över tillgänglig QSS Evenemangstyper. Kunder kan markera en eller flera QSS-händelser innan de slutför processen och aktiverar sin applikation.

Du kan också hantera prenumerationer via Marketplace-gränssnittet eller med API-anrop:

• POST /marketplace/app/evenemang_subscription – skapa

• PATCH /{id} – prenumerera användare/konton

• TA BORT /{id} – avsluta prenumeration/radera

• GET /marknadsplats/app/evenemang_subscription – lista

För att autentisera via API, använd en token från Client Credentials Grant.

3

Verifiera webhook-händelser

Efter att ha konfigurerat evenemangsprenumerationer, se till att både ägarskapet för webhook-URL:en och evenemangets äkthet valideras korrekt.

• URL-validering

  • När du först aktiverar eventprenumerationer utför Zoom en Challenge–Response Check (anslutningsprogram för molnrum (CRC)) för att verifiera ägarskap för din ändpunkt. Den här processen säkerställer att Zoom skickar data till en legitim destination som kontrolleras av din app. (Du kan inkludera CRC-hantering i ett tidigare konfigurationssteg om du föredrar det.)

• Validering av evenemang

  • Varje inkommande evenemangsavisering bör verifieras av din applikation för att bekräfta att den härstammar från Zoom. appen kan validera inkommande begäranden med hjälp av signaturhuvudet som tillhandahålls i varje webhook-evenemang. Utvecklare som föredrar ett alternativ till standardmetoden för signatur kan använda ett av de andra verifieringsalternativen som beskrivs i Zoom Developer Docs.

  • Använd API:t Get Webhook Logs för att granska upp till sju dagars webhook-leveransdata, inklusive status, antal återförsök och trace-ID.

För fullständiga implementeringsdetaljer, vänligen se QSS Implementeringsguide för utvecklare. För tekniska detaljer, se guiderna för evenemang Subscription API, webhook Loggar API och Client Credentials Grant autentisering i Zoom Developer Docs.