このドキュメントでは、イベント アノテーションを表示するようにダッシュボードを構成する方法について説明します。イベントは、システムのオペレーションに影響するデプロイやクラッシュなどのアクティビティです。イベント アノテーションを表示すると、問題のトラブルシューティングでさまざまなソースのデータを関連付けることができます。
イベント アノテーションについて
Google Cloud コンソールの [ダッシュボード] ページに一覧表示されているほとんどのダッシュボードでイベントを表示できます。同様に、Compute Engine や Google Kubernetes Engine などのサービス固有の [オブザーバビリティ] タブを構成して、イベントを表示できます。ダッシュボードまたは [オブザーバビリティ] タブに表示されるイベントタイプを構成するには、Google Cloud コンソールを使用します。作成したダッシュボード（カスタム ダッシュボードと分類）で Cloud Monitoring API を使用することもできます。
Cloud Monitoring API を使用するか、イベントタイプの選択を保存するアクションを実行しない限り、選択は現在のセッションにのみ適用されます。Google Cloud コンソールを使用する場合は、選択した項目を固定すると保存されます。
イベントタイプのリスト、トラブルシューティングのリファレンスなどの情報については、イベントタイプのページをご覧ください。
推奨イベントタイプ
イベントタイプを選択していない場合でも、ダッシュボードまたは [オブザーバビリティ] タブに次のイベントタイプが表示されることがあります。
- 開始状態のアラート。
- Personalized Service Health インシデント（Service Health API が有効になっている場合）。
- ダッシュボードに表示されるデータを持つリソースのタイプごとに、1 つのイベントタイプ。
自動的に追加されたイベントタイプは、推奨イベントタイプになります。これらのイベントタイプを推奨状態のままにするか、ダッシュボード JSON に保存するか、却下して推奨事項を削除します。保存されているイベントタイプを確認するには、[イベントタイプを選択] メニューを開き、[固定] セクションを表示します。
イベントの識別方法
ダッシュボードでは、さまざまなデータのソースに対してクエリを実行し、ダッシュボードに表示するイベントを特定します。
アラート イベントは Monitoring によって識別されます。アラート イベントは、インシデントが開かれた日時に関する情報を提供します。
Personalized Service Health イベントは、Monitoring が Service Health API に送信するクエリによって識別されます。 これらのイベントは、Google Cloud サービスの停止が発生したことを示します。
他のすべてのイベントタイプは、Google Cloud プロジェクトで Cloud Logging シンクを通過するログエントリを分析することで特定されます。これらのログエントリには、プロジェクトによって生成されたログエントリと、プロジェクトにルーティングされたログエントリが含まれます。これらのイベントのいずれかが発生したときに通知を受け取るには、ログベースのアラート ポリシーを作成します。アラート ポリシーで、[イベントの種類] ページに表示されているクエリを使用します。
イベントの表示方法
すべてのイベントについて、それらのイベントが発生すると、ダッシュボードのグラフにアノテーションが付けられます。ログエントリの分析によって特定されたイベントは、1 つの時間参照で表示されます。 一方、Service Health イベントは開始時間とともに表示され、イベントの期間中はグラフの背景が変更されます。これらのイベントにはハート形アイコンも表示されます。
次のスクリーンショットは、ログエントリを分析して特定された複数のイベントと 1 つの Service Health イベントを示すグラフを示しています。
上のスクリーンショットに示すように、イベントのツールチップには次のような情報が含まれています。
- イベント名。
- イベントの日付と開始時刻。
- Service Health イベントの場合、影響を受けるプロダクトとロケーションの数を示すチップ。影響を受けるプロダクトまたはロケーションを一覧表示するには、対応するチップの上にポインタを置きます。
- [表示] ボタンを選択すると、イベントに関する詳細情報を表示するページが開きます。たとえば、ログ エクスプローラを開いてログエントリを表示できるようにする、または Service Health イベントの詳細ページを開きます。
ダッシュボード フィルタは、ダッシュボードに表示されるデータを制限します。通常、時系列データとイベントの両方がフィルタリングされます。
始める前に
-
ダッシュボードでイベントを表示および表示するために必要な権限を取得し、アラート ポリシーを作成するには、プロジェクトに対する次の IAM ロールの付与を管理者に依頼してください。
-
ダッシュボードとアラート ポリシーを表示および作成するには: モニタリング編集者（
roles/monitoring.editor）。 -
Google Cloud プロジェクトで作成されたデータアクセス以外のログエントリから識別されたイベントを確認または表示する:
ログビューア（
roles/logging.viewer）。 -
Google Cloud プロジェクトで作成されたログエントリから識別されたイベントを確認または表示する: プライベート ログビューア（
roles/logging.privateLogViewer）。 -
Service Health イベントを表示する: Personalized Service Health 閲覧者 （
roles/servicehealth.viewer）
ロールの付与の詳細については、アクセス権の管理をご覧ください。
-
ダッシュボードとアラート ポリシーを表示および作成するには: モニタリング編集者（
ダッシュボードに Service Health イベントを表示する場合は、Service Health API を有効にします。
イベントを表示
このセクションでは、イベントを表示するためにダッシュボードまたは [オブザーバビリティ] タブを構成する方法について説明します。
イベントを表示するようにダッシュボードを構成する
このセクションでは、Google Cloud コンソールの [ダッシュボード] ページに表示される、イベントを表示するダッシュボードを構成する方法について説明します。
ログ エクスプローラまたはログベースのアラート ポリシーで使用できるイベントタイプ、トラブルシューティングのリファレンス、クエリのリストについては、イベントタイプのページをご覧ください。
Console
ダッシュボードにイベントを表示する方法は次のとおりです。
-
Google Cloud コンソールで [
ダッシュボード] ページに移動します。検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
- 表示するダッシュボードを選択します。
ダッシュボードのツールバーで、
[Events] 切り替えボタンがオンになっていることを確認します。 [Events] 切り替えボタンが表示されない場合、ダッシュボードにイベントを表示できません。[イベントタイプを選択] をクリックし、ダッシュボードに表示するイベントタイプを選択して、次のいずれかを行います。
カスタム ダッシュボードを表示して、イベントタイプの選択内容を保存する場合は、[選択内容を固定] をクリックします。ダッシュボードで自動保存を無効にしている場合は、ダッシュボードのツールバーに移動して [保存] をクリックします。
選択内容を固定すると、ダッシュボードの JSON 定義が変更されます。したがって、ダッシュボードを再度開くと、選択内容が読み込まれ、対応するイベントタイプのアノテーションがダッシュボードに表示されます。
そうでない場合は、[OK] をクリックします。
表示するイベントタイプのリストを更新すると、Cloud Monitoring がクエリを発行します。これには少し時間がかかります。その後、ダッシュボードのグラフにアノテーションが追加されます。
イベントの概要を表示するか、またはログエントリへのリンクにアクセスするには、ポインタを使用してツールチップを有効にします。
API
イベントを表示するようにカスタム ダッシュボードを構成するには、Dashboard オブジェクトに annotations フィールドを含めます。annotations フィールドには、DashboardAnnotations オブジェクトのインスタンスが含まれており、次の 2 つのフィールドが含まれています。
defaultResourceNameフィールドには、イベントを検索する Google Cloud プロジェクトのダッシュボード レベルのデフォルトが表示されます。このフィールドを指定しない場合は、選択したプロジェクトが検索されます。EventAnnotationオブジェクトの配列。各オブジェクトには次が含まれます。displayNameフィールド。イベント固有の切り替えでラベルを定義できます。このフィールドが指定されていない場合、またはこのフィールドの値が空の文字列の場合は、イベントのデフォルト名が表示されます。enabledフィールド。イベントの切り替え値を制御します。trueの場合、切り替えはonの位置にあり、イベントがダッシュボードに表示されます。falseの場合、切り替えはoffの位置にあります。eventTypeフィールド。EventType列挙型の値が含まれます。filterフィールド。イベント固有のクエリに追加するクエリを指定できます。このフィールドの値が空の文字列の場合、イベント固有のクエリが使用されます。resourceNamesフィールド。イベントを検索する Google Cloud プロジェクトのリストを定義できます。このフィールドが空の配列の場合は、選択したプロジェクトが検索されます。
以下は、クラスタ更新イベントの annotations オブジェクトの例です。この例の filter フィールドは、イベントを特定のクラスタに制限します。
"annotations": {
"defaultResourceNames": [],
"eventAnnotations": [
{
"displayName": "",
"enabled": true,
"eventType": "GKE_CLUSTER_UPDATE",
"filter": "resource.labels.cluster_name=my-cluster",
"resourceNames": []
}
]
}
Cloud Monitoring API を使用してダッシュボードを作成する方法の詳細については、API を使用してダッシュボードを作成、管理すると例: ダッシュボードでイベントを有効にするをご覧ください。
[オブザーバビリティ] タブを構成してイベントを表示する
このセクションでは、イベントを表示するように [オブザーバビリティ] タブを構成する方法について説明します。Compute Engine や Google Kubernetes Engine などの一部のサービスでは、指標とログデータを表示する [オブザーバビリティ] タブを備えています。
Console
イベントを表示するように [オブザーバビリティ] タブを構成する手順は次のとおりです。
サービスまたはプロダクトの [オブザーバビリティ] タブに移動します。
たとえば、[Kubernetes クラスタ] ページに移動して、[オブザーバビリティ] タブを選択します。同様に、[Kubernetes ワークロード] ページまたは仮想マシン（VM）インスタンスの詳細ページに移動し、[オブザーバビリティ] タブを選択します。
[ダッシュボード] メニューが [事前定義] に設定されていることを確認します。 イベントはカスタム ダッシュボードには表示できません。
ツールバーで event_available [Select Events] をクリックし、ダイアログを完了します。
表示するイベントのリストを更新すると、イベントデータを取得するためにクエリが発行され、ダッシュボードが更新されます。
event_available [イベントを選択] ボタンが表示されない場合、タブはイベントを表示するように構成できません。
API
利用できません。
イベントの詳細を表示する
イベントのアノテーションが表示されているグラフを表示している場合、ツールチップ内のリンクを使用して追加情報にアクセスできます。
特定のイベントの詳細を表示するには、[表示] をクリックします。
[表示] ボタンによって開かれる Google Cloud コンソール ページは、イベントタイプによって決まります。たとえば、稼働時間チェック イベントの場合、このボタンを押すと、稼働時間チェックのダッシュボードが開きます。イベントの種類によっては、ログ エクスプローラが開く場合があります。
アラート ポリシーを作成する
Google Cloud プロジェクトで Cloud Logging シンクを通過するログエントリを分析してイベントが識別されると、それらのイベントが発生したときにログベースのアラートの設定] をタップすることで通知を受け取ることができます。ログベースのアラート ポリシーは、ログエントリを受け取るとクエリを実行します。クエリで空でない結果が返されると、インシデントが作成され、通知が送信されます。
Console
ログベースのアラートを作成するには、次の操作を行います。
通知チャンネルを構成していない場合は、次の手順を行います。
-
Google Cloud コンソールで、notifications [アラート] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
- [通知チャネルを編集] をクリックします。
- 構成する通知チャネルの種類に移動し、[Add new] をクリックして、ダイアログを完了します。
-
-
Google Cloud コンソールで、[ログ エクスプローラ] ページに移動します。
検索バーを使用してこのページを検索する場合は、小見出しが [Logging] である結果を選択します。
ツールバーで [アラートを作成] を選択します。
アラート ポリシーの名前を入力し、[Next] をクリックします。
[Define log entries to alert on] セクションでクエリを入力するか、[Create Alert] を選択したときに [Query] ペインからコピーしたクエリを更新します。
イベントタイプのページには、イベントタイプごとに、ログベースのアラート ポリシーで使用するのに適したクエリが一覧表示されます。
ダイアログの項目を入力し、[保存] をクリックします。
API
Cloud Monitoring API を使用してログベースのアラート ポリシーを作成するには、次の操作を行います。
アラート ポリシーの条件に含めるクエリを特定します。イベントタイプのページには、イベントタイプごとに、ログベースのアラート ポリシーで使用するのに適したクエリが一覧表示されます。
アラート ポリシーの表現を含む JSON ファイルを作成します。この手順と例の詳細については、アラート ポリシーの設計をご覧ください。
alertPolicies.create API メソッドを呼び出します。 たとえば、
gcloud alpha monitoring policies createコマンドを実行します。
イベントを非表示
Console
すべてのイベントを非表示にするには、ダッシュボード ツールバーで toggle_off [Events] 切り替えボタンがオフになっていることを確認します。
1 種類のイベントを非表示にするには、そのイベントタイプの切り替えボタンをオフの位置に設定します。
API
カスタム ダッシュボードで 1 種類のイベントを非表示にするには、イベントタイプの EventAnnotation オブジェクトを見つけてから、enabled フィールドを false に設定します。
Cloud Monitoring API の使用方法の詳細については、API を使用してダッシュボードを作成、管理するをご覧ください。