Zoom アプリケーションのログの収集

最後の更新
PDFとして保存

このページでは、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