カスタムダッシュボードに一時フィルタを追加する

このドキュメントでは、一時的なグループと一時フィルタを追加して、各ウィジェットを変更することなく、カスタムダッシュボードに表示するデータを変更する方法について説明します。ダッシュボード全体のグループまたはフィルタを追加すると、そのグループまたはフィルタのメニュー項目がダッシュボードツールバーに表示されます。

トラブルシューティングでは、一時的なグループまたはフィルタを追加することで、ダッシュボードに表示されるデータを変更できます。たとえば、インシデントを調査していて、ダッシュボードに特定の仮想マシン（VM）のデータのみを表示させる場合は、一時フィルタを追加します。

一時的なグループとフィルタは、ページを再読み込みすると自動的に削除されます。ただし、手動で削除することもできます。

永続フィルタを作成する方法については、カスタムダッシュボードに永続フィルタを追加するをご覧ください。

ダッシュボードフィルタの仕組み

ダッシュボードフィルタはラベルと値を指定します。ダッシュボードに表示される時系列によって、フィルタリングに使用できるラベルが決まります。ウィジェットがダッシュボード全体のフィルタをサポートする方法は、ウィジェットに表示されるデータの種類とウィジェットの構成によって異なります。

折れ線グラフなどの時系列データを表示するウィジェットには、次のルールが適用されます。
- ウィジェットに表示される時系列がフィルタのラベルをサポートしていない場合、ダッシュボード全体のフィルタによって表示されるデータは変更されません。
  
  たとえば、ラベル instance_id にフィルタを追加しても、ダッシュボードのグラフに instance_id ラベルが付いている場合、フィルタによって表示される内容は変更されません。
- ウィジェットでラベルの値が指定されている場合、ダッシュボード全体のフィルタによって表示されるデータは変更されません。
  
  たとえば、ラベル instance_id のフィルタを追加しても、ダッシュボードのグラフに instance_id ラベルに基づくフィルタが含まれている場合、ダッシュボード全体のフィルタによって表示される内容は変更されません。
- それ以外の場合、グラフは表示するデータを、ダッシュボード全体のフィルタを満たす時系列のみにフィルタリングします。
ログパネルウィジェットの場合、リソースラベルに基づくダッシュボード全体のフィルタによってクエリが更新されます。たとえば、ダッシュボード全体のフィルタ cluster_name: mycluster を追加すると、クエリが更新され、 resource.labels."cluster_name"="mycluster" が含まれます。

ダッシュボード全体のフィルタは複数追加できます。これらのフィルタは論理 AND で結合されます。

始める前に

Google Cloud コンソールを使用して一時フィルタを追加または変更するために必要な権限を取得するには、プロジェクトに対するモニタリング閲覧者（roles/monitoring.viewer）IAM ロールを付与するよう管理者に依頼してください。ロールの付与の詳細については、アクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

ロールの詳細については、Identity and Access Management を使用してアクセスを制御するをご覧ください。

一時グループを作成または変更する

ダッシュボード全体のグループを追加すると、ダッシュボードのウィジェットには、グループのラベルに同じ値を持つ時系列セットごとに 1 つの時系列が表示されます。デフォルトでは、各セットの平均が表示されます。ただし、ウィジェットでグループ化関数を定義すると、その関数が使用されます。

たとえば、ダッシュボードに VM インスタンスの CPU 使用率を表示するグラフが含まれているとします。特定のゾーンにさらに VM をデプロイする必要があるかどうかを判断するには、ダッシュボードとそのグラフを編集してグループ化オプションを変更します。もう一つの方法は、ゾーンでダッシュボードを一時的にグループ化し、CPU 使用率グラフを表示することです。

一時グループを作成または変更するには、次の手順を行います。

Google Cloud コンソールで [ダッシュボード] ページに移動します。
[ダッシュボード] に移動

検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
グループ条件メニューを展開し、グループ化のラベルを選択します。
[OK] をクリックします。

ダッシュボードから移動すると、作成したグループはすべて破棄されます。

一時フィルタを作成する

インシデントを調査する際には、特定の方法でデータを調べることをおすすめします。たとえば、特定の仮想マシンまたは特定のリージョン内のリソースの時系列のみを表示できます。一時フィルタを作成すると、すべてのダッシュボードウィジェットがそのフィルタに一致するデータを表示するように変更されます。たとえば、特定の VM インスタンスの時系列のみを表示するようにすべてのグラフを構成するには、ラベル instance_id に基づいてフィルタを作成します。同様に、特定のゾーンの時系列のみを表示するようにダッシュボードを構成するには、ラベル zone に基づくフィルタを作成します。

一時フィルタを作成する手順は次のとおりです。

Google Cloud コンソールで [ダッシュボード] ページに移動します。
[ダッシュボード] に移動

検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
ダッシュボードのフィルタバーで [ダッシュボードをフィルタ] をクリックし、メニューからラベルを選択します。

メニューには、ダッシュボードに表示されるすべての時系列のラベルが一覧表示されます。

ラベルを選択すると、ダッシュボードのツールバーにフィルタが追加されます。フィルタの名前は選択した名前と同じ名前で、その値は * に設定されており、すべての値に一致します。たとえば、zone を選択すると、ツールバーに zone: * が表示されます。
一致する特定の値を選択するには、フィルタをクリックします。たとえば、zone: * をクリックし、メニューから値を選択します。メニューオプションの数を減らすには、値の一部を [フィルタ] 領域に入力します。

ダッシュボードから移動すると、作成したフィルタはすべて破棄されます。

時系列に一致する一時フィルタを追加する

グラフに表示される特定の時系列に関する詳細情報が必要な場合は、グラフの凡例を使用して一時フィルタを適用できます。時系列の特定のラベルに一致するフィルタ、時系列のリソースと一致するフィルタ、指標のラベルのみに一致するフィルタを適用できます。このセクションでは、これらのオプションについて説明します。

ダッシュボードの例

さまざまなオプションの動作を説明するために、Compute Engine VM インスタンスの CPU utilization 指標と Disk read bytes 指標を表示するダッシュボードを検討してください。次のスクリーンショットは、1 つのシステムのこのダッシュボードを示しています。

ダッシュボードの例の表示。

時系列のすべてのラベルでフィルタする

最も制限の厳しいラベルのセットを適用する場合は、すべてのラベルでフィルタします。このオプションでは、ラベルは一意のリソースと指標のラベルの一意の値のセットを識別します。

グラフで特定の時系列を識別する一時フィルタを適用するには、次の手順に従います。

Google Cloud コンソールで [ダッシュボード] ページに移動します。
[ダッシュボード] に移動

検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
グラフを特定して凡例を開き、 [凡例を開く] をクリックして詳細を表示します。
目的の時系列が見つかるまで凡例をスクロールします。 [この期間の操作] をクリックし、[ダッシュボードをすべてのラベルに合わせてフィルタ] を選択します。

たとえば、これらのステップをダッシュボードの例の CPU utilization 指標を表示するグラフに適用すると、次のフィルタが追加されます。

指標ラベル: instance_name。
Compute Engine VM インスタンスのリソースラベル:
- project_id
- instance_id
- zone

結果は、次のスクリーンショットのようになります。

CPU 使用率時系列のすべてのラベルのフィルタを含むダッシュボードの例。

上の図では、CPU utilization 指標が表示されているグラフに単一の時系列が表示されています。これは、時系列のラベルと一致するフィルタを追加したためです。ただし、Disk read bytes 指標を表示するグラフには、複数の時系列が表示されています。Disk read bytes 指標にはラベル instance_name に加えて 3 つのラベルが含まれているため、このグラフで複数の時系列が同じインスタンスを参照できます。

比較のために、ダッシュボードの例の Disk read bytes 指標を表示するグラフに前のステップを適用すると、次のフィルタが追加されます。

指標ラベル:
- instance_name
- device_name
- storage_type
- device_type
Compute Engine VM インスタンスのリソースラベル:
- project_id
- instance_id
- zone

ディスク読み取りバイト時系列のすべてのラベルのフィルタを含むダッシュボードの例の表示。

上のスクリーンショットに示すように、両方のグラフで 1 つの時系列が表示されるようになりました。

時系列のリソースラベルでフィルタする

すべてのリソースラベルでフィルタする場合は、特定のリソースの時系列を表示するようにダッシュボードを制限します。そのリソースのみの指標を表示できるようになりました。不要な時系列は一時的に表示されなくなります。

グラフに表示される特定の時系列のリソースを識別する一時フィルタを適用するには、次のようにします。

Google Cloud コンソールで [ダッシュボード] ページに移動します。
[ダッシュボード] に移動

検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
グラフを特定して凡例を開き、 [凡例を開く] をクリックして詳細を表示します。
目的の時系列が見つかるまで凡例をスクロールします。 [この期間の操作] をクリックし、[ダッシュボードをリソースラベルに合わせてフィルタ] を選択します。

たとえば、これらのステップがダッシュボードの例の CPU utilization 指標を表示するグラフで実行される場合、3 つのフィルタが追加されます。これらのフィルタは、リソース（VM インスタンス）のラベルに対応しています。

CPU 使用率時系列のリソースラベルのフィルタを含むダッシュボードの例の表示。

上のスクリーンショットに示すように、リソースでフィルタリングすると、グラフに複数の時系列が表示されることがあります。

[ダッシュボードをリソースラベルに合わせてフィルタ] オプションは、一時フィルタバーにリソースラベルのみが適用されるため、いずれのグラフからこのオプションを選択しても結果は同じです。

時系列の指標ラベルでフィルタする

このオプションを使用すると、指標のラベルの値と一致するフィルタを適用できます。たとえば、負荷分散の指標の表示中に、特定のプロトコルのみの時系列を表示できます。

グラフに表示される特定の時系列の指標を識別する一時フィルタを適用するには、次のようにします。

Google Cloud コンソールで [ダッシュボード] ページに移動します。
[ダッシュボード] に移動

検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。
グラフを特定して凡例を開き、 [凡例を開く] をクリックして詳細を表示します。
目的の時系列が見つかるまで凡例をスクロールします。 [この期間の操作] をクリックし、[ダッシュボードを指標ラベルに合わせてフィルタ] を選択します。

たとえば、これらのステップがダッシュボードの例の CPU utilization 指標を表示するグラフで実行されると、ラベル instance_name に基づくフィルタが追加されます。この場合、instance_name ラベルの値は構成できるため、両方のグラフに複数の時系列を表示できます。つまり、instance_name ラベルに同じ値を持つ複数の VM を作成できます。

比較のために、ダッシュボードの例の Disk read bytes 指標を表示するグラフに前のステップを適用すると、4 つのフィルタが追加されます。これらのフィルタは、Disk read bytes 指標のラベルに対応しています。

一時フィルタに指標フィルタのみが含まれている場合、時系列が書き込まれたリソースに関係なく、その指標の時系列が表示されます。時系列は特定のリソースに限定されないため、グラフに複数の時系列が表示されることがあります。上のスクリーンショットでは、両方のグラフに 2 つの時系列が表示されています。

一時フィルタを変更または削除する

ダッシュボードから移動すると、一時フィルタは自動的に削除されます。一時フィルタを手動で削除するには、そのフィルタで [削除] をクリックします。

カスタム ダッシュボードに一時フィルタを追加する

ダッシュボード フィルタの仕組み