カスタム ダッシュボードにグラフとテーブルを追加する

このドキュメントでは、Google Cloud コンソールを使用して、カスタム ダッシュボードにグラフ、テーブル、ゲージ、スコアカードを追加する方法について説明します。折れ線グラフ、積み上げ面グラフ、棒グラフ、ヒートマップ グラフを追加することで、一定期間内の指標データを表示できます。最新の測定値のみが必要な場合は、テーブル、円グラフ、ゲージ、スコアカードを追加します。ゲージとスコアカードの色は、最新の値と警告しきい値や危険しきい値との比較に基づいて変化します。

ダッシュボードに追加できる可視化は、まとめてウィジェットと呼ばれます。さまざまなウィジェット タイプに関する一般的な情報については、ダッシュボードの概要をご覧ください。

カスタム ダッシュボード上のグラフ、テーブル、ゲージ、スコアカードでは、数値または分布値を含む任意の指標タイプ（ユーザー定義の指標やログベースの指標など）を表示できます。文字列型データのグラフ化はできません。

このドキュメントでは、カスタム ダッシュボードにグラフ、テーブル、ゲージ、スコアカードを追加する方法について説明します。ダッシュボードに他のタイプのウィジェットを追加する方法については、次のドキュメントをご覧ください。

Cloud Monitoring API の詳細については、API でダッシュボードを管理をご覧ください。

準備

  • Google Cloud コンソールを使用してカスタム ダッシュボードを作成および変更するために必要な権限を取得するには、プロジェクトに対するモニタリング編集者（roles/monitoring.editor）の IAM ロールの付与を管理者に依頼してください。ロールの付与の詳細については、アクセスの管理をご覧ください。

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

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

  • ダッシュボードには最大で 40 のウィジェットを配置できます。

  • ダッシュボードにウィジェットを追加するには、可視化を選択してウィジェットを構成するか、最初にデータ型を選択して、可視化を構成します。

    たとえば、VM インスタンスの CPU 使用率を表示するテーブルをダッシュボードに追加するには、次のいずれかを行います。

    • [テーブル] ウィジェットを選択して、そのウィジェットを構成して VM インスタンスの CPU 使用率を表示します。
    • [指標] データ型を選択し、VM インスタンスの CPU 使用率を表示するようにウィジェットを構成して、ウィジェット タイプを [テーブル] に変更します。

    このページの手順では、最初にデータ型を選択してから、そのデータの表示方法を構成することを前提としています。

ダッシュボードにグラフとテーブルを追加する

このセクションでは、Google Cloud コンソールを使用してグラフとテーブルを構成する方法について説明します。

  • グラフは時間の経過に伴うデータを示し、次の 4 つのスタイルが用意されています。折れ線、積み上げ面、積み上げ棒、ヒートマップ。グラフが構成されたら、ウィジェット タイプを変更できます。特定のスタイルを選択する理由については、時系列でデータを表示するグラフをご覧ください。

    Cloud Monitoring API を使用してグラフを構成する方法については、XyChart ウィジェットを含むダッシュボードをご覧ください。

  • テーブルには、モニタリング対象の時系列ごとに 1 行が含まれ、最新の値のみが表示されます。テーブルには 2 つのスタイルがあります。[テーブル] ウィジェットには「25%」などの数値が表示されます。[トップ リスト] ウィジェットには、値と、可能な値の範囲と比較した値の視覚的なインジケーターの両方が表示されます。これらのウィジェットの種類は変更できます。詳細と例については、ダッシュボードに表形式のデータを表示するをご覧ください。

    Cloud Monitoring API を使用してテーブルを構成する方法の詳細ついては、TimeSeriesTable ウィジェットを含むダッシュボードをご覧ください。

ダッシュボードにグラフやテーブルを追加する手順は次のとおりです。

  1. Google Cloud コンソールで [Monitoring] を選択し、 [Dashboards] を選択するか、次のボタンをクリックします。

    ダッシュボードに移動する

  2. 次のいずれかを行います。

    • 新しいダッシュボードを作成するには、[ダッシュボードを作成] を選択します。
    • 既存のダッシュボードを更新するには、すべてのダッシュボードのリストでダッシュボードを見つけて、その名前を選択します。

  3. ツールバーで [ウィジェットを追加] をクリックします。

  4. [ウィジェットを追加] ダイアログで、 [指標] を選択します。

  5. グラフに表示するデータを指定します。メニュー形式のインターフェース、Monitoring Query Language（MQL）、PromQL を使用するか、モニタリング フィルタを入力できます。

    1. 表示する時系列データを選択します。

      1. [指標を選択] ペインの [指標] メニューを展開し、そのメニューを使用してリソースタイプと指標タイプを選択します。たとえば、次のような選択を行います。

        1. [Active resources] メニューで、[VM instance] を選択します。
        2. [アクティブな指標のカテゴリ] メニューで、[Uptime_check] を選択します。
        3. [ACTIVE METRICS] メニューで、[Request latency] を選択します。
        4. [Apply]（適用）をクリックします。

        メニューの選択肢の数を制限するには、フィルタバーに指標名またはリソース名を入力します。たとえば、VM インスタンスのリクエスト レイテンシをグラフ化するには、「latency」と入力します。

        選択すると、ペインのタイトルが変わります。たとえば、前述の提案を行った場合、ペインのタイトルは [リクエストのレイテンシ] になります。

      2. 省略可: 表示するデータの一部を指定するには、[フィルタを追加] を選択して、ダイアログを完了します。たとえば、フィルタを適用することで、1 つのゾーンのデータを表示できます。フィルタは複数追加できます。詳細については、グラフ化したデータをフィルタリングするをご覧ください。

      詳細については、グラフ化するデータの選択をご覧ください。

    2. 時系列をグループ化して配置します。

      • すべての時系列を表示するには、[グループ条件] エントリで [グループ化を削除] をクリックします。
      • 同じラベル値を持つ時系列を組み合わせるには、[ラベル] メニューを展開してラベル値を選択します。グループ化関数の値を変更することもできます。たとえば、グラフには時系列の平均値を表示できます。平均はゾーン単位で計算されます。
      • 省略可: データポイントの間隔を構成するには、 [その他のオプション] をクリックして、[データポイントのアライメント] フィールドを使用します。

      グループ化とアライメントの詳細については、グラフ化したデータの表示方法を選択するをご覧ください。

    3. 省略可: 最大値または最小値を含む時系列のみを表示するには、[ 並べ替えと上限を追加する] をクリックしてフォームに入力します。

    MQL

    1. [指標を選択] ペインのツールバーで、名前が Code で始まるボタンを選択します。
    2. [言語] 切り替えボタンの [MQL] を選択します。言語切り替えボタンは、クエリの書式設定を行うのと同じツールバーにあります。

    3. Query Editor にクエリを入力します。たとえば、Google Cloud プロジェクトの VM インスタンスの CPU 使用率をグラフ化するには、次のクエリを使用します。

      fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m

      MQL の詳細については、次のドキュメントをご覧ください。

    PromQL

    1. [指標を選択] ペインのツールバーで、名前が Code で始まるボタンを選択します。
    2. [言語] 切り替えボタンの [PromQL] を選択します。言語切り替えボタンは、クエリの書式設定を行うのと同じツールバーにあります。

    3. Query Editor にクエリを入力します。たとえば、Google Cloud プロジェクトの VM インスタンスの平均 CPU 使用率をグラフ化するには、次のクエリを使用します。

      avg(compute_googleapis_com:instance_cpu_utilization)

      PromQL の使用の詳細については、Cloud Monitoring の PromQL をご覧ください。

    モニタリング フィルタ

    1. [指標の選択] ペインのツールバーで、[指標] メニューの [ヘルプ] をクリックしてから、[Direct Filter Mode] を選択します。

      [モニタリング フィルタを入力] というラベルのテキスト ボックスが表示されます。[Direct Filter Mode] モードに切り替える前にリソースタイプ、指標、またはフィルタを選択した場合は、これらの設定がテキスト ボックスに表示されます。

    2. モニタリング フィルタを入力します。

    3. 時系列をグループ化して配置します。

      • すべての時系列を表示するには、[グループ条件] エントリで [グループ化を削除] をクリックします。
      • 同じラベル値を持つ時系列を組み合わせるには、[ラベル] メニューを展開してラベル値を選択します。グループ化関数の値を変更することもできます。たとえば、グラフには時系列の平均値を表示できます。平均はゾーン単位で計算されます。
      • 省略可: データポイントの間隔を構成するには、 [その他のオプション] をクリックして、[データポイントのアライメント] フィールドを使用します。

      グループ化とアライメントの詳細については、グラフ化したデータの表示方法を選択するをご覧ください。

  6. 省略可: 複数の指標タイプを表示するようにグラフを構成します。

    1. [クエリを追加] を選択します。

      新しい [指標を選択] ペインでは、以前に構成したクエリが非表示になります。

    2. [指標を選択する] ペインで、メニューを使用して、リソースタイプと指標タイプを選択します。メニューを使用してフィルタの追加、時系列のグループ化、アライメント フィールドの設定を行うこともできます。

    構成したすべての指標タイプを表示するには、表示中のペインのツールバーに移動して、 [折りたたみ] を選択します。

    次のスクリーンショットは、2 つの指標タイプがグラフ化されている場合の Metrics Explorer の表示を示しています。

    2 つの指標タイプを使用する Metrics Explorer の例。

    MQL

    非対応。

    PromQL

    非対応。

    モニタリング フィルタ

    非対応。

  7. 省略可: 指標タイプの比率を表示するようにグラフを構成します。

    1. 2 つの指標タイプを表示するようにグラフを構成します。
    2. [最小アライメント期間] フィールドの値が、両方の指標タイプで同じであることを確認します。 アライメント パラメータを表示するには、 [その他のオプション] をクリックします。

    3. グループ化フィールドを更新します。

      分母の指標タイプのグループ化フィールドが、分子の指標タイプの設定値と一致する状態を推奨します。たとえば、両方の指標タイプを zone ラベルでグループ化できます。

      両方の指標タイプに同じグループを使用する必要はありませんが、両方の指標タイプに共通のラベルでのみグループ化できます。

    4. クエリペインのツールバーで、[比率を作成] を選択して、ダイアログを完了します。

      比率を作成すると、次の 3 つのクエリが表示されます。

      • [A/B 比率] は、比率クエリを識別します。
      • [A] は分子のクエリを識別します。
      • [B] は分母のクエリを識別します。

      次の例は、ゾーンあたりのディスクに書き込まれたバイト数の合計をディスクに書き込まれた合計バイト数と比較した場合の比率を示しています。

      指標の比率の例。

    5. 省略可: 分子と分母の指標を切り替えるには、次のようにします。

      1. 名前が A/B で始まるクエリのツールバーで [開く] をクリックします。
      2. [分子と分母] メニューを開いて選択します。

    MQL

    1. [指標を選択] ペインのツールバーで、名前が Code で始まるボタンを選択します。
    2. [言語] 切り替えボタンの [MQL] を選択します。言語切り替えボタンは、クエリの書式設定を行うのと同じツールバーにあります。

    3. Query Editor にクエリを入力します。MQL を使用すると、2 つの異なる指標の比率を計算し、単一の指標をラベルでフィルタリングしてから比率を計算できます。次のクエリは、レスポンスの総数に対する値 500 のレスポンスの比率を計算します。

      fetch https_lb_rule::loadbalancing.googleapis.com/https/request_count
| {
    filter response_code_class = 500
  ;
    ident
  }
| group_by [matched_url_path_rule]
| outer_join 0
| div

      MQL の詳細については、次のドキュメントをご覧ください。

    PromQL

    1. [指標を選択] ペインのツールバーで、名前が Code で始まるボタンを選択します。
    2. [言語] 切り替えボタンの [PromQL] を選択します。言語切り替えボタンは、クエリの書式設定を行うのと同じツールバーにあります。

    3. Query Editor にクエリを入力します。たとえば、my_summary_latency_seconds 指標の平均レイテンシの比率をグラフ化するには、次のクエリを使用します。

      sum without (instance)(rate(my_summary_latency_seconds_sum[5m])) /
sum without (instance)(rate(my_summary_latency_seconds_count[5m]))

      PromQL の使用の詳細については、Cloud Monitoring の PromQL をご覧ください。

    モニタリング フィルタ

    非対応。

  8. 省略可: 可視化を変更するには、ディスプレイペインで [ウィジェット タイプ] をクリックして選択します。

    [ウィジェット タイプ] メニューには、同じデータタイプを表示可能なすべてのウィジェット タイプが一覧表示されます。ただし、一部のウィジェットは有効になっていない場合があります。たとえば、1 つの指標タイプを表示するように構成されたダッシュボードのグラフについて考えてみましょう。折れ線グラフには複数の時系列が表示され、各測定値は double になります。

    • 表、円グラフ、折れ線グラフ、積み上げ棒グラフ: 、積み上げ面グラフウィジェットは互換のように一覧表示されます。これらのタイプはすべて選択できます。

    • [スコアカード] ウィジェットと [ゲージ] ウィジェットは、単一の時系列のみを表示できるため、[Compatible with adjustments] としてリストに表示されます。これらのウィジェット タイプを有効にするには、グループ化構成を変更します。

    • [ヒートマップ] ウィジェットは、分布値のデータのみを表示できるため、無効になっています。

    • ログパネルには時系列データを表示できないため、ログパネルは表示されません。

  9. 省略可: 選択したデータをグラフで表示する方法を変更するには、[Display] ペインのオプションを使用します。

  10. 変更を保存するには、[適用] をクリックします。変更を破棄するには、[キャンセル] をクリックします。

最新のデータのみを表示する

Monitoring では、測定履歴を表示する代わりに、最新の測定値のみを可視化できます。

  • 各時系列の最新の値をグラフで表示するには、各値をすべての値の合計の比率として、円グラフを追加します。これらのグラフは、合計値を表示するように構成できます。

  • 各時系列の最新の値を表形式で表示するには、テーブルを追加します。 テーブルの行数を制限し、値の範囲と比較した値を表示するようにテーブルの行を構成できます。

  • 一連のしきい値と比較しながら最新の値を緑色、黄色、赤色で表示するには、ダッシュボードにゲージまたはスコアカードを追加します。

最新のデータを円グラフでグラフ化する

最新のデータを合計の割合として表示するには、円グラフを追加します。テーブルと同様に、円グラフには数値を持つ指標タイプが表示され、分布値の指標のパーセンタイルを表示できます。各時系列は 1 つのスライスを円グラフに加算します。

次のスクリーンショットは、[円グラフ] ウィジェットの 2 つの異なる構成を使用して、仮想マシン インスタンスの CPU 使用率を表示するダッシュボードを示しています。

**PieChart** ウィジェットの例。

ダッシュボードに円グラフを追加する方法については、次のドキュメントをご覧ください。

  • Google Cloud コンソール: このドキュメントのグラフとテーブルの追加というタイトルのセクションをご覧ください。

    • グラフ化するデータを選択したら、[Display] ペインで [Widget type] フィールドを [円グラフ] に設定します。
    • 合計値を表示するには、[グラフの種類] フィールドを [Donut] に設定します。

  • Cloud Monitoring API: PieChart ウィジェットを含むダッシュボードを確認する。

最新のデータを表形式で表示する

最新のデータを表形式で表示するには、テーブルを追加します。 テーブルには、数値を持つ任意の指標タイプを表示でき、そして分布値の指標のパーセンタイルを表示できます。テーブルにはゲージとスコアカードの動作と同様に、最新の値のみが表示されます。ただし、ゲージやスコアカードとは異なり、モニタリング対象の時系列ごとに 1 つの行がテーブルに含まれます。

テーブルには 2 つのスタイルがあります。[トップリスト] ウィジェットは、2 列で構成され、行数を制限するように事前構成されています。トップリスト ウィジェットの 1 つの列には instance_id のようなラベルが表示され、もう 1 つの列には値と、可能な値の範囲と比較した値の視覚的なインジケーターの両方が表示されます。可能な値。[テーブル] ウィジェットは、複数の一意の値、各時系列ごとに 1 行、「25%」などの数値を持つラベルごとに 1 つの列を表示するように事前構成されています。

どちらのウィジェットも同じデータ構造で表されます。したがって、これらのウィジェットのいずれかをダッシュボードに追加した後、表示される行数を制限し、テーブルに表示される列を変更して、値の表示方法を変更できます。

次のスクリーンショットは、[トップ リスト] ウィジェットと [テーブル] ウィジェットを使用して、仮想マシン インスタンスの CPU 使用率を表示するダッシュボードを示しています。

**トップリスト** と **テーブル** のウィジェットのサンプル。

ダッシュボードにテーブルを追加する方法については、次のドキュメントをご覧ください。

テーブルの並べ替えとフィルタリング

テーブルに表示される行の順序は変更できます。また、テーブルの内容をフィルタリングして、特定の行のみを表示できます。 これらの設定は永続的ではありません。ダッシュボード ページから移動するかダッシュボードを再読み込みすると、適用した並べ替えとフィルタリングのオプションは破棄されます。

並べ替えとフィルタのオプションには、次のものがあります。

  • テーブルを列で並べ替えるには、列ヘッダーをクリックします。

  • テーブルの列を変更するには、 [列を表示] をクリックし、変更してから [OK] をクリックします。

  • 特定の行のみを表示するには、フィルタを 1 つ以上追加します。フィルタは複数追加できます。2 つのフィルタの間に OR 演算子を指定しない場合、論理 AND はフィルタを結合します。

    フィルタを追加するには、Enter property name or value をクリックし、メニューからプロパティを選択して、値を入力するか、値メニューから選択します。たとえば、プロパティ Name をフィルタリングして値 demo を入力すると、Name フィールドにdemo 値を含む行のみがテーブルに表示されます。

最新のデータを警告またはエラーとともに表示する

色分けされたしきい値と対比しながら最新の測定値を表示する場合は、ゲージまたはスコアカードを追加します。ゲージには最新の測定値のみが表示され、スコアカードには最近の測定値の履歴も表示されます。 これらのウィジェットの背景色も色分けされています。最新の値が想定範囲内にある場合、ウィジェットの色は白になります。値が警告範囲内にあると、ウィジェットは黄色になります。同様に、値が危険範囲内になると、ウィジェットは赤色になります。

どちらのウィジェットも 1 つの時系列を表示します。次のスクリーンショットは、最新の測定値が警告しきい値と危険しきい値より小さい場合のゲージの例を示しています。

ゲージの例。

このセクションの残りの部分は、Google Cloud コンソールに関するものです。Cloud Monitoring API の使用方法については、基本的な Scorecard を含むダッシュボードをご覧ください。

ゲージやスコアカードをダッシュボードに追加する手順は次のとおりです。

  1. Google Cloud コンソールで [Monitoring] を選択し、 [Dashboards] を選択するか、次のボタンをクリックします。

    ダッシュボードに移動する

  2. 次のいずれかを行います。

    • 新しいダッシュボードを作成するには、[ダッシュボードを作成] を選択します。
    • 既存のダッシュボードを更新するには、すべてのダッシュボードのリストでダッシュボードを見つけて、その名前を選択します。

  3. ツールバーで [ウィジェットを追加] をクリックします。

  4. [ウィジェットを追加] ダイアログで、 [指標] を選択します。

  5. グラフに表示するデータを指定します。メニュー形式のインターフェース、Monitoring Query Language（MQL）、PromQL を使用するか、モニタリング フィルタを入力できます。

    1. 表示する時系列データを選択します。

      1. [指標を選択] ペインの [指標] メニューを展開し、そのメニューを使用してリソースタイプと指標タイプを選択します。たとえば、次のような選択を行います。

        1. [Active resources] メニューで、[VM instance] を選択します。
        2. [アクティブな指標のカテゴリ] メニューで、[Uptime_check] を選択します。
        3. [ACTIVE METRICS] メニューで、[Request latency] を選択します。
        4. [Apply]（適用）をクリックします。

        メニューの選択肢の数を制限するには、フィルタバーに指標名またはリソース名を入力します。たとえば、VM インスタンスのリクエスト レイテンシをグラフ化するには、「latency」と入力します。

        選択すると、ペインのタイトルが変わります。たとえば、前述の提案を行った場合、ペインのタイトルは [リクエストのレイテンシ] になります。

      2. 省略可: 表示するデータの一部を指定するには、[フィルタを追加] を選択して、ダイアログを完了します。たとえば、フィルタを適用することで、1 つのゾーンのデータを表示できます。フィルタは複数追加できます。詳細については、グラフ化したデータをフィルタリングするをご覧ください。

      詳細については、グラフ化するデータの選択をご覧ください。

    2. 時系列をグループ化して配置します。

      • [ラベル] メニューは空のままにします。
      • 省略可: [グループ化関数] の値を変更します。

    MQL

    1. [指標を選択] ペインのツールバーで、名前が Code で始まるボタンを選択します。
    2. [言語] 切り替えボタンの [MQL] を選択します。言語切り替えボタンは、クエリの書式設定を行うのと同じツールバーにあります。

    3. Query Editor にクエリを入力します。集計フィールドがすべての時系列を結合するように設定されている必要があります。たとえば、Google Cloud プロジェクトの VM インスタンスの CPU 使用率をグラフ化するには、次のクエリを使用します。

      fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m
| group_by [], [value_utilization_mean_mean: mean(value_utilization_mean)

      MQL の詳細については、次のドキュメントをご覧ください。

    PromQL

    1. [指標を選択] ペインのツールバーで、名前が Code で始まるボタンを選択します。
    2. [言語] 切り替えボタンの [PromQL] を選択します。言語切り替えボタンは、クエリの書式設定を行うのと同じツールバーにあります。

    3. Query Editor にクエリを入力します。たとえば、Google Cloud プロジェクトの VM インスタンスの平均 CPU 使用率をグラフ化するには、次のクエリを使用します。

      avg(compute_googleapis_com:instance_cpu_utilization)

      PromQL の使用の詳細については、Cloud Monitoring の PromQL をご覧ください。

    モニタリング フィルタ

    1. [指標の選択] ペインのツールバーで、[指標] メニューの [ヘルプ] をクリックしてから、[Direct Filter Mode] を選択します。

      [モニタリング フィルタを入力] というラベルのテキスト ボックスが表示されます。[Direct Filter Mode] モードに切り替える前にリソースタイプ、指標、またはフィルタを選択した場合は、これらの設定がテキスト ボックスに表示されます。

    2. モニタリング フィルタを入力します。

    3. 時系列をグループ化して配置します。

      • [ラベル] メニューは空のままにします。
      • 省略可: [グループ化関数] の値を変更します。

  6. [表示] ペインで、ゲージまたはスコアカードを構成します。

    1. [ウィジェット タイプ] をクリックし、[ゲージ] または [スコアカード] を選択します。

    2. ゲージ ウィジェットの場合は、 [ゲージの範囲] をクリックし、最小値と最大値を設定します。ゲージに割合が表示されたら、これらの値をそれぞれ 0 と 1 に設定します。

    3. [ゲージしきい値] をクリックし、警告しきい値と危険しきい値を設定します。空のしきい値フィールドは使用されません。

      前に表示されたゲージには、2 つのしきい値が設定されます。0.9 より大きい値は危険範囲内であることを示します。0.7 より大きい値は危険範囲にあり、警告の範囲内にあります。

    4. スコアカードの場合は、 [Spark グラフビュー] をクリックし、オプションのメニューを開いて表示スタイルを選択します。

  7. 変更を保存するには、[適用] をクリックします。変更を破棄するには、[キャンセル] をクリックします。

次のステップ

次のウィジェットをカスタム ダッシュボードに追加することもできます。

グラフデータの確認とダッシュボードのフィルタリングについては、次のドキュメントをご覧ください。