このドキュメントでは、ダッシュボードのグラフにイベントを表示する方法について説明します。イベントは、システムのオペレーションに影響するデプロイやクラッシュなどのアクティビティです。イベントを表示すると、問題をトラブルシューティングするときに、さまざまなソースのデータを関連付けることができます。
特定のイベントタイプについては、Google Cloud プロジェクトで生成されたログまたは Google Cloud プロジェクトに直接転送されたログにクエリを実行することでイベントが特定されます。他の Google Cloud プロジェクトのログには、現在の Google Cloud プロジェクトのログバケットに保存されていても、クエリは実行されません。提供されたクエリは、ログ エクスプローラとログベースのアラート ポリシーで使用できます。イベントと対応するクエリの一覧については、イベントタイプのページをご覧ください。
イベントを表示するようにダッシュボードを構成する場合、それらのイベントが発生すると、ダッシュボードのグラフにアノテーションが付けられます。 ダッシュボードに表示されるデータを制限するダッシュボード フィルタは、通常、時系列データとイベントの両方をフィルタリングします。
次のスクリーンショットは、1 つのアノテーションが表示されているグラフで、アノテーションが有効になったツールチップを示しています。
各アノテーションでは複数のイベントを一覧表示できます。前のスクリーンショットでは、GKE のデプロイのイベントが表示されています。
始める前に
グラフとログを表示し、アラート ポリシーを作成するために必要な権限を取得するには、プロジェクトに対する次の IAM ロールの付与を管理者に依頼してください。
-
グラフを表示し、アラート ポリシーを表示および作成するには: モニタリング編集者（
roles/monitoring.editor）。 -
Google Cloud プロジェクトで作成されたデータアクセス ログを除くすべてのログを表示します:
ログビューア（
roles/logging.viewer）。 -
Google Cloud プロジェクトで作成されたデータアクセス ログを表示します。
プライベート ログビューア（
roles/logging.privateLogViewer）
ロールの付与の詳細については、アクセスの管理をご覧ください。
必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。
イベントを表示
ログ エクスプローラまたはログベースのアラート ポリシーで使用できるイベントタイプ、トラブルシューティングのリファレンス、クエリの一覧については、イベントタイプのページをご覧ください。
コンソール
イベントを表示する方法は次のとおりです。
-
Google Cloud コンソールのナビゲーション パネルで、[Monitoring] を選択してから、
[ダッシュボード] を選択します。
- 表示するダッシュボードを選択します。
ダッシュボードのツールバーで、
[Events] 切り替えボタンがオンになっていることを確認します。 [Events] 切り替えボタンが表示されない場合、ダッシュボードでイベントの表示がサポートされません。表示するイベントタイプごとに、ダッシュボード ツールバーで [Add event] をクリックし、メニューからイベントタイプを選択します。
たとえば、「GKE ワークロードのデプロイ」イベントを表示するようにダッシュボードを構成できます。
イベントタイプを追加すると、Cloud Monitoring はログデータをクエリします。これには少し時間がかかります。その後、ダッシュボードのグラフにアノテーションを追加します。
- info 情報: 情報メッセージ。
- warning 警告: 再起動やクラッシュなどの障害を示します。
- notifications アラート: インシデントが開かれたことを示します。
イベントの概要を表示するか、またはログへのリンクにアクセスするには、ポインタを使用してツールチップを有効にします。
イベントのログを表示する
イベント アノテーションを示すグラフを表示している場合、イベントに関連付けられたログにアクセスできます。
特定のイベントのログを表示するには、ポインタを使用して、イベントを一覧表示するアノテーションに対してツールチップを有効にして、イベントに移動し、[ログを表示] をクリックします。
アノテーションによって識別されたすべてのイベントのログを表示するには、ポインタを使用してアノテーションのツールチップを有効にし、ツールチップの概要行に移動し、[ログを表示] をクリックします。
別のブラウザタブで、ログ エクスプローラが開き、特定のイベントまたはイベントのコレクションをクエリするように設定されたクエリ パラメータが表示されます。
アラート ポリシーを作成する
ログにイベントが表示されたときに通知を受け取るには、ログベースのアラートを構成します。ログベースのアラート ポリシーは、ログを受け取るとクエリを実行します。クエリで空でない結果が返されると、インシデントが作成され、通知が送信されます。
コンソール
ログベースのアラートを作成するには、次の操作を行います。
通知チャンネルを構成していない場合は、次の手順を行います。
-
Google Cloud コンソールのナビゲーション パネルで、[Monitoring] を選択してから、notifications [アラート] を選択します。
- [Edit notification channel] をクリックします。
- 構成する通知チャネルの種類に移動し、[Add new] をクリックして、ダイアログを完了します。
-
-
Google Cloud コンソールのナビゲーション パネルで、[Logging] を選択してから、[ログ エクスプローラ] を選択します。
ツールバーで [Create Alert] を選択します。
アラート ポリシーの名前を入力し、[Next] をクリックします。
[Define log entries to alert on] セクションでクエリを入力するか、[Create Alert] を選択したときに [Query] ペインからコピーしたクエリを更新します。
イベントタイプのページには、イベントタイプごとに、ログベースのアラートで使用するのに適したクエリが一覧表示されます。
ダイアログを完成させて、[Save] をクリックします。
イベントを非表示
コンソール
すべてのイベントを非表示にするには、ダッシュボード ツールバーで toggle_off [Events] 切り替えボタンがオフになっていることを確認します。
1 種類のイベントを非表示にするには、そのイベントタイプの切り替えボタンをオフの位置に設定します。