Chrome Management Telemetry API をご利用の管理者、パートナー事業者対象。
Chrome の管理者は、Chrome Telemetry API を使用して、ChromeOS デバイスの操作と稼働状況のモニタリングを行うことができます。これは、根本原因の分析とトラブルシューティングに役立ちます。
Chrome Management Telemetry API の通知を使用すると、Google Cloud Pub/Sub を使用して、Telemetry API のイベント通知に登録し、通知を受け取ることができます。
詳しくは、Chrome Management Telemetry API をご覧ください。
Google Cloud Pub/Sub
Google Cloud Pub/Sub を使用すると、イベントのプロデューサー(パブリッシャー)とコンシューマー(サブスクライバー)のシステムを作成できます。このシステムは、アナリティクスとデータ統合パイプラインをストリーミングすることで、データを受信および配信します。
パブリッシャーは、イベントをブロードキャストすることによってサブスクライバーと非同期に通信します。イベントは、いつどのように処理されるかにかかわらず、Pub/Sub サービスに送信されます。Pub/Sub は、受信したイベントをそれらを必要とするすべてのサービスに配信します。Pub/Sub はサブスクライバーがデータを受信するのを待つ必要がないため、システムの柔軟性が増します。
始める前に
Chrome Management Telemetry API の通知を Google Cloud Pub/Sub に接続する前に、以下の事項を確認してください。
- Google 管理コンソールへの特権管理者アクセス権がある。これには、管理対象の Google アカウントと所有権を証明済みのドメインが必要です。詳しくは、管理対象の Chrome 組織に参加するをご覧ください。
- ChromeOS デバイスが、管理コンソールへのアクセスに使用するドメインに登録されている。詳しくは、ChromeOS デバイスを登録するをご覧ください。
- 通知用に Pub/Sub を有効にする Google Cloud プロジェクトがある。
手順 1: Chrome Management Telemetry の通知を有効にする
-
-
管理コンソールで、メニュー アイコン [デバイス] [Chrome] [設定] [デバイスの設定] に移動します。
- すべてのユーザーと登録済みブラウザに設定を適用する場合は、最上位の組織部門を選択したままにします。それ以外の場合は、子組織部門を選択します。
- [ユーザーとデバイスのレポート] に移動します。
- [デバイスのテレメトリーを報告] をクリックします。
- [すべてのテレメトリーのレポートを有効にする] を選択します。
- [保存] をクリックします。
テレメトリーのレポートを有効にすると、組織の ChromeOS デバイスで発生する各種イベントに対するサブスクリプションを作成できます。これらのイベントの通知は、設定された Pub/Sub トピックに送信されます。
手順 2: Google Cloud プロジェクトで Pub/Sub トピックを作成する
詳しくは、Chrome ブラウザ クラウド管理で Google Cloud Pub/Sub と Chrome ブラウザを連携させるをご覧ください。
- Google Cloud Platform にログインします。
- [Pub/Sub] セクションで、[トピック] ページに移動します。
- 既存のトピックを選択するか、[トピックを作成] をクリックします。
- [トピック ID] を入力し、[トピックを作成] をクリックします。
- Chrome からのイベント受信用に作成したトピックを選択します。
- [権限] の下の [メンバーを追加] をクリックします。
- [新しいプリンシパル] の下に「cloud-pub-sub-publisher@chrome-reporting.iam.gserviceaccount.com」と入力します。
Google サーバーは、このアカウントを使用して Pub/Sub トピックの Publish API を呼び出します。トピックは、このアカウントに公開アクセスを許可する必要があります。 - [ロール] から [Pub/Sub パブリッシャー] を選択します。
- [保存] をクリックします。
- トピックのフルパスをコピーして、管理コンソールでの次の手順用に保存します。
手順 3: Pub/Sub トピックを登録して通知設定を作成する
通知設定を作成するには、Chrome Management Telemetry API を呼び出す必要があります。必要に応じて、以下に示すリンクから追加情報をご確認ください。
- Chrome Management Telemetry API へのアクセス方法については、こちらの一般的なガイドをご覧ください。
- 通知設定の作成方法については、こちらをご覧ください。テレメトリ通知 API を呼び出して通知設定を作成するには、POST リクエストを送信します。
- 本文の google_cloud_pubsub_topic を設定するトピックに置き換えます。
たとえば、USB の追加と削除に関するイベント通知を設定するには、次のように設定します。
- 本文の google_cloud_pubsub_topic を設定するトピックに置き換えます。
{
"google_cloud_pubsub_topic": "projects/your-project/topics/your-topic",
"filter": {
"telemetry_event_notification_filter": {
"event_types": [
"USB_ADDED",
"USB_REMOVED"
]
}
}
}
手順 4: Chrome Management Telemetry API の通知の受信を開始する
通知は次の方法で受信できます。