Hizmet Kalitesi Aboneliği açıklayıcı

Hizmet Kalitesi Aboneliği, bir müşterinin üçüncü taraf uç noktasına toplantı, web semineri ve telefon QoS verileri sağlayan bir eklenti üründür.

Hizmet Kalitesi Aboneliği, Etkinlik abonelikleri aracılığıyla Zoom Meetings, web seminerleri ve Zoom Phone için neredeyse gerçek zamanlı QoS telemetrisi akışı sağlayan bir eklenti üründür.

Zoom’un Hizmet Kalitesi Aboneliği (QSS), Zoom Meetings, web seminerleri ve telefon görüşmeleri için neredeyse gerçek zamanlı Hizmet Kalitesi (QoS) verileri sunan bir eklenti üründür. QSS, katılımcı düzeyinde QoS Etkinlikleri'ni dakikalık aralıklarla göndererek Zoom’un ürün işlevselliğini genişletir (oran ve toplama, Yapılandırmaya göre değişebilir). Müşteriler bu zengin veri akışını, ağ ortamlarının Zoom’un hizmetlerini etkileyip etkilemediğini belirlemek için kullanabilir.

QSS, Zoom Panoları ve API'lerde kullanılan aynı temel QoS metriklerini sunar, ancak örnekleme ve zamanlama farklıdır

Mevcut Zoom Pano ağ performansı ve kullanım metrikleri sağlar; bu da müşterilerin Zoom’un bir ağ ortamında nasıl çalıştığını anlamalarına yardımcı olabilir. QSS aynı Zoom QoS verilerini sunar, ancak daha hızlı bir hızda. Bu daha hızlı örnekleme nedeniyle, birleştirilmiş QoS metrikleri ana Zoom Panosu'ndan farklı değerler Gösterir. Ancak bu metrikler yine de müşterilerin bunları kendi Pano görünümlerine Yapılandırmalarına İzin Verir ve Zoom verilerini ek sistemlerle ilişkilendirmelerine olanak tanır.

Aşağıdaki tablo, QSS aracılığıyla bir müşterinin uç noktalarına iletilen QoS verilerini açıklar.

	QSS aracılığıyla İletilen QoS Verileri
Kalite Metrikleri	Bit Hızı, Gecikme, Titreme, Paket Kaybı, Çözünürlük, Kare Hızı, CPU Kullanımı
Kullanım Metrikleri	Cihaz, Ağ, Sinyalleşme Bölgesi, İstemci Sürümü, ses (G/Ç), video (G/Ç)
Sıklık	Yaklaşık dakika başına, katılımcı başına 1 Etkinlik (hesap Ayarlarına bağlı olarak her QoS metriği veya toplu küme başına).
Veri Saklama	Etkinlik teslim günlükleri, Web kancası Günlükleri API'si aracılığıyla 7 gün boyunca saklanır; API uç noktaları üzerinden tarihsel QoS verileri daha uzun süre saklanabilir (lisanstan bağlı olarak).

Zoom Pano verileri, bir müşterinin üçüncü taraf uç noktasına QSS aracılığıyla iletilen verilerle karşılaştırılmamalıdır

QSS ve Zoom Pano, karşılaştırılmaması gereken Zoom QoS verilerine erişmek için iki ayrı mekanizma sağlar. Zoom Pano ve QSS aynı QoS veri havuzundan çekim yapsa da, alma zamanlaması ve veri teslim sıklığındaki farklılıklar nedeniyle her mekanizmadaki veriler eşleşmeyecektir.

QSS, Meetings, Webinars ve Phone görüşmeleri için gerçek zamanlı Etkinlik verilerini destekler

QSS, bir hesaptaki tüm kullanıcılar için Zoom Meetings ve Webinars'ın yanı sıra Zoom Phone aramaları için QoS Etkinlik verileri sağlar. Zoom aramaların son ayağını yönetmediğinden, QSS yalnızca Zoom Phone aramaları için hesap düzeyinde QoS Etkinlik verileri sağlar ve bu nedenle uçtan uca gelişmiş katılımcı verilerine tam görünürlük sağlayamaz.

QSS verileri dış katılımcılar için veri içermez

QSS, dış toplantı katılımcıları için veri sağlamaz. Ancak QSS, hangi dahili toplantı katılımcısının bir sorun yaşadığını ve bu sorunun ne olduğunu belirlemeye yardımcı olabilir; ayrıca müşterilerin sorunları gidermek için ihtiyaç duyacağı kalite ve kullanım metriklerini de sağlar.

QSS, müşterilerin Zoom Pano’dan ham QoS verilerini mevcut iş akışlarına getirmesine olanak tanır

Zoom müşterileri tarihsel olarak Zoom Pano veya API’ler gibi araçları kullanarak Zoom QoS verilerini görüntüleyebilmiş veya alabilmiş olsa da, QSS, Zoom QoS telemetrisini etkinlik abonelikleri (web kancası veya WebSocket) aracılığıyla ağ yönetimi ve izleme platformlarınıza aktarmanıza olanak tanır.

QSS, abone olduğunuz uç noktalara neredeyse gerçek zamanlı QoS Etkinlikleri sunarak API sorgulamasını ve oran sınırı etkisini azaltır

QSS müşterileri, uygulama uç noktalarına iletilecek neredeyse gerçek zamanlı QoS Etkinlikleri ve verilerine abone olabilir; bu da API kapasitesini boşaltmaya ve ağ kullanımını optimize etmeye yardımcı olur. QSS, Zoom’un standart web kancası hizmetinin bir genişletmesidir standart web kancası hizmeti çünkü ham QoS verilerini bir uç noktaya, dakikada 4 ila 6 kez olacak şekilde neredeyse gerçek zamanlı bir hızda gönderebilir.

QSS, müşterilerin API oran sınırlarına takılmadan Zoom Pano’dan neredeyse gerçek zamanlı QoS verilerine erişmesini sağlar

API hizmetleri istek tabanlıdır ve bir uygulama veya kullanıcı tarafından talep edilen verileri toplamak için bir “çekme” mekanizması kullanır. API’ler, verileri bir API uç noktasından çekmek için tekrarlanan çağrılar gerektirdiklerinden web kancalarından daha fazla kaynak tüketir.

Kullanan Müşteriler Zoom API'leri Zoom Pano'dan QoS verilerini çekmek için Zoom API'lerini kullananlar, hız sınırlarıyla karşılaşabilir; bu, belirli bir süre içinde yapabilecekleri maksimum API çağrısı sayısına ulaştıkları anlamına gelir. QSS, API hız sınırlarını artırmaz; ancak müşterilerin verileri kendilerinin çekmesini gerektirmek yerine ham QoS verilerini uç noktalarına göndererek müşterilerin hız sınırı endişelerini azaltır.

QSS, müşterilerin ham Zoom QoS verilerini kullanmasına ve tercih ettikleri ağ yönetim sistemini kullanarak sorun gidermesine olanak tanır

Bazı müşterilerin ağ performanslarını aynı anda birden fazla uygulamada değerlendirmesi gerekebilir. QSS, Zoom QoS verilerini uygulama paketlerindeki diğer verilerle birlikte bir Pano'da izlemelerine olanak tanıyarak, Zoom QoS verilerini kullanmaları ve bunları özel panolara sorunsuzca entegre etmeleri için esnek ve ölçeklenebilir bir yol sunar.

Zoom QoS Verileri TLS 1.2 üzerinden iletilir

QSS verileri, aktarım sırasında TLS 1.2 veya üzeri kullanılarak şifrelenir. Uç noktalar geçerli bir Sertifika Yetkilisi (CA) sertifikası kullanmalıdır. Web kancası istekleri, Doğrulama için bir imza başlığı ve sınama-yanıt denetimi içerir.

Ek güvenlik için müşterilerden şunu yapmaları istenecektir: web kancası uç noktalarını doğrulamak bir Sınama-Yanıt Denetimi (CRC) kullanarak. CRC, Etkinlik bildirim uç nokta URL'lerinin sahipliğini ve güvenliğini onaylayacaktır.

Müşteriler, QSS olaylarını alabilen bir uygulama oluşturarak QoS verilerini kullanmaya başlayabilir.

Bir müşteri QSS eklenti planını satın aldıktan sonra, hesaptaki en az bir kullanıcının geliştirici izinleri etkinleştirilmiş olmalıdır. Müşteriler ardından QSS etkinliklerine abone olabilen bir web kancası uygulaması oluşturmak için aşağıdaki üç adımı kullanabilir.

Müşteriler ayrıca şu seçeneği de sürdürebilir Zoom Geliştirici Paketi QSS bayrağı etkinleştirildiğinde, bu da QSS'yi diğer geliştirici araçlarıyla birlikte paketler.

1

Bir Etkinlik Aboneliği uygulaması oluşturun (Genel veya Server-to-Server OAuth). Etkinlik Aboneliklerini Etkinleştir ve QoS Etkinliklerini Seç

Müşteriler önce Genel veya Sunucudan Sunucuya OAuth uygulaması oluşturmalıdır Zoom App Marketplace. Sonra, onlar Etkinlik Aboneliklerini Etkinleştir ve almak istedikleri QoS Etkinliklerini Seç.

Sonraki, Müşteriler QSS Etkinlik Bildirimleri için hedefi, uygulamalarının Etkinlik bildirim uç nokta URL'sini girerek belirtmelidir

Bu yapılandırma için yalnızca web kancası olan bir uygulama gerekli değildir. Zoom, Genel bir uygulama oluşturmanızı önerir.

2

QSS web kancası Etkinliklerine abone olun

QSS Etkinliklerine abone olmak için, Müşteriler Etkinlikleri eklemeli ve Uygun QSS listesinden Seçmelidir Etkinlik türleri. Müşteriler, süreci tamamlamadan ve uygulamalarını etkinleştirmeden önce bir veya daha fazla QSS Etkinliğini Seçebilir.

Abonelikleri Marketplace kullanıcı arayüzü veya API çağrılarını kullanarak da yönetebilirsiniz:

• POST /marketplace/uygulama/Etkinlik_aboneliği – oluştur

• PATCH /{id} – kullanıcıları/hesapları abone et

• DELETE /{id} – aboneliği iptal et/sil

• GET /marketplace/uygulama/Etkinlik_aboneliği – listele

API üzerinden kimlik doğrula işlemi yapmak için, Client Credentials Grant'tan bir belirteç kullanın.

3

Web kancası Etkinliklerini Doğrulayın

Etkinlik aboneliklerini yapılandırdıktan sonra, hem web kancası URL sahipliğinin hem de Etkinlik özgünlüğünün doğru şekilde doğrulandığından emin olun.

• URL Doğrulaması

  • Etkinlik aboneliklerini ilk kez Etkinleştirirken, Zoom web kancası uç noktanızın sahipliğini doğrulamak için bir Challenge–Response Check (CRC) gerçekleştirir. Bu süreç, Zoom'un verileri uygulamanız tarafından denetlenen meşru bir hedefe gönderdiğinden emin olmanızı sağlar. (İsterseniz CRC işlemeyi daha önceki bir kurulum adımına dahil edebilirsiniz.)

• Etkinlik Doğrulaması

  • Gelen her Etkinlik Bildirimi, Zoom'dan kaynaklandığını doğrulamak için uygulamanız tarafından doğrulanmalıdır. uygulama, her web kancası Etkinliğinde sağlanan imza üstbilgisini kullanarak gelen istekleri doğrulayabilir. Varsayılan imza yöntemine alternatif tercih eden geliştiriciler, Zoom Developer Docs'ta açıklanan diğer desteklenen Doğrulama seçeneklerinden birini kullanabilir.

  • Web kancası Günlükleri API'sini kullanarak, durum, yeniden deneme sayısı ve izleme kimliği dahil olmak üzere en fazla yedi günlük web kancası teslimat verilerini gözden geçirin.

Tam uygulama ayrıntıları için lütfen şuraya bakın: QSS Uygulama Kılavuzu geliştiriciler için. Teknik ayrıntılar için, Zoom Geliştirici Dokümanları’ndaki Etkinlik Aboneliği API, web kancası Günlükleri API ve Client Credentials Grant kimlik doğrulama kılavuzlarına bakın.