Zoom アプリケーションのログの収集
このページでは、Zoom アプリケーションのイベント収集を設定する方法について説明します。
このページでは、Zoom アプリケーションのイベント収集を設定する方法について説明します。Zoom は、次のコア イベント タイプにグループ化されている Webhook イベントを利用します。
- Meeting Events (ミーティング イベント)
- Webinar Events (ウェビナー イベント)
- Recording Events (記録イベント)
- Zoom Room Events (Zoom Room イベント)
- User Events (ユーザ イベント)
- Account Events (アカウント管理イベント)
Zoom Webhook イベントの詳細については、こちらの Zoom Web ページを参照してください。
収集プロセスの概要
Zoom のイベント収集の設定は、以下の作業から構成されます。
-
Hosted Collector と HTTP Source を追加する。
-
イベント収集用の Webhook を設定する。
ステップ 1.Hosted Collector と HTTP Source を追加する
このセクションでは、Zoom のログを収集するために、Sumo Logic の Hosted Collector と HTTP ログ Source を追加する方法を説明します。
Hosted Collector と HTTP Source を追加するには、次の手順を実行します。
- 次のいずれかを実行します。
- Sumo Logic の Hosted Collector がすでに作成されている場合は、使用する Collector を選択します。
- 「Hosted Collector の設定」ドキュメントの説明に従って Hosted Collector を新規作成します。
- 「HTTP Metrics and Logs Source (HTTP メトリクスとログ Source)」ドキュメントの説明に従って、ログ用の HTTP Source を追加します。
ステップ 2.イベント収集用の Webhook の設定
このセクションでは、Zoom からイベントを収集するように Webhook を設定する方法を説明します。詳細については、Zoom ページの「Create a Webhook-Only App (Webhook 専用アプリケーションの作成)」を参照してください。
Zoom イベント収集用に Webhook を設定するには、次の手順を実行します。
- https://marketplace.zoom.us/ に移動してログインします。
- 右上隅で [Develop (開発)] > [Build App (アプリケーションのビルド)] をクリックします。
- Webhook 専用アプリケーションを作成します。
- 次のアプリケーション情報を指定します。
- App Name (アプリケーション名)
- Short Description (簡単な説明)
- Company Name (会社名)
- Developer Name (開発者名)
- Developer Email Address (開発者のメール アドレス)
- [Continue (続行)] をクリックして、[Event Subscriptions (イベント サブスクリプション)] を有効にします。
- [Add new event subscription (新規イベント サブスクリプションの追加)] をクリックして、次の情報を入力します。
- Subscription Name (サブスクリプション名) (例: Sumo Logic)
- Event notification endpoint URL (イベント通知エンドポイント URL)。ステップ 1 からの Sumo Logic エンドポイント URL を入力します。
- [Add events (イベントの追加)] をクリックし、すべての Webhook イベントにサブスクライブします。
- [Save (保存)] をクリックして、[Continue (続行)] をクリックします。
- 新規作成した Webhook 専用アプリケーションをアクティブ化します。
ログ メッセージのサンプル
{ "event":"meeting.participant_left", "payload":▼{ "account_id":"eSqnB7aCS0KKx0_adadb1HQ", "object":▼{ "duration":60, "start_time":"2020-04-01T19:24:06Z", "timezone":"America/Denver", "topic":"My Meeting", "id":"981802874", "type":2, "uuid":"/m84vL38R3exBtjhvdWxMad==", "participant":▼{ "leave_time":"2020-04-01T19:24:20Z", "id":"FDGHUPeiSZGAa6pmYTlpiA", "user_id":"16778240", "user_name":"Test User" }, "host_id":"FDGHUPeiSZADa6pmYTlpiA" } } }
クエリのサンプル
_sourceCategory=zoom | json "event", "payload.object.start_time", "payload.object.topic", "payload.object.uuid", "payload.object.id", "payload.object.type", "payload.object.duration" as event, meeting_start_time, topic, meeting_instance_id, meeting_number, meeting_type, meeting_duration nodrop | where event = "meeting.started" | "Unknown" as meeting_type_desc | if (meeting_type == 1, "Instant Meeting", meeting_type_desc) as meeting_type_desc | if (meeting_type == 2, "Scheduled Meeting", meeting_type_desc) as meeting_type_desc | if (meeting_type == 3, "Recurring Meeting with No Fixed Time", meeting_type_desc) as meeting_type_desc | if (meeting_type == 4, "Meeting started with Personal Meeting ID", meeting_type_desc) as meeting_type_desc | if (meeting_type == 8, "Recurring Meeting with Fixed Time", meeting_type_desc) as meeting_type_desc | count by meeting_instance_id | count