Metrics Explorer でグラフを作成する

このドキュメントでは、Metrics Explorer で一時グラフを作成して指標データを探索する方法について説明します。たとえば、仮想マシン（VM）の CPU 使用率を表示するには、Metrics Explorer を使用して最新のデータを表示するグラフを作成します。永続的なグラフが必要な場合は、Metrics Explorer を使用してグラフを作成し、カスタム ダッシュボードに保存できます。別の方法は、グラフ、ログ、インシデント、その他のコンテンツを表示できるカスタム ダッシュボードを作成してから、ダッシュボード インターフェースを使用してそのダッシュボードにグラフを追加することです。カスタム ダッシュボードの詳細については、カスタム ダッシュボードを作成して管理するをご覧ください。

1 つの指標タイプをグラフ化するようなグラフと、複数の指標タイプをグラフ化するような複雑なグラフを作成できます。Metrics Explorer でグラフを作成した後は、破棄、カスタム ダッシュボードへの保存、構成の保存、共有を行うことができます。

次のスクリーンショットは、Metrics Explorer ページにグラフ化された 1 つの指標タイプ（VM インスタンスの CPU 使用率）を示しています。

上のスクリーンショットは、複数の行を示しています。各行には、特定のゾーンにあるすべての VM の平均 CPU 使用率が表示されています。

単一の指標タイプをグラフ化する

単一の指標を表示するようにグラフを構成する手順は次のとおりです。

1. Google Cloud コンソールで、[leaderboardMetrics Explorer] ページに移動します。

   Metrics Explorer に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。

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

   メニュー形式インターフェース

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

      1. [指標] 要素で、[指標の選択] メニューを展開します。

         [指標を選択] メニューには、使用可能な指標タイプを探すのに役立つ機能が含まれています。

         • 特定の指標タイプを探すには、filter_list フィルタバーを使用します。たとえば、「util」と入力すると、util を含むエントリを表示するようにメニューが制限されます。エントリは、大文字と小文字を「区別しない」テストに合格した場合に表示されます。

         • データが存在しない指標も含めて、すべての指標タイプを表示するには、[done アクティブ] をクリックします。デフォルトでは、メニューにはデータを含む指標タイプのみが表示されます。

         たとえば、次のような選択を行います。

         1. [有効なリソース] メニューで、[VM インスタンス] を選択します。
         2. [アクティブな指標のカテゴリ] メニューで、[Uptime_check] を選択します。
         3. [ACTIVE METRICS] メニューで、[Request latency] を選択します。
         4. [適用] をクリックします。

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

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

   2. 時系列を結合して配置します。

      • すべての時系列を表示するには、[集計] 要素で最初のメニューを [未集計] に、2 番目のメニューを [なし] に設定します。

      • 時系列を結合するには、[集計] 要素で次の操作を行います。

        1. 最初のメニューを展開して関数を選択します。

           グラフが更新され、単一の時系列が表示されます。たとえば、[平均] を選択すると、表示される時系列はすべての時系列の平均になります。

        2. 同じラベル値を持つ時系列を結合するには、2 番目のメニューを開き、1 つ以上のラベルを選択します。

           グラフが更新され、ラベル値の一意の組み合わせごとに 1 つの時系列が表示されます。たとえば、ゾーンごとに時系列を表示するには、2 番目のメニューを [ゾーン] に設定します。

           2 番目のメニューが [なし] に設定されている場合、グラフには 1 つの時系列が表示されます。

      • 省略可: データポイントの間隔を構成するには、add [クエリ要素を追加] をクリックし、[最小間隔] を選択して、値を入力します。

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

   3. 省略可: 最大値または最小値を含む時系列のみを表示するには、[並べ替えと上限] 要素を使用します。

   MQL

   1. クエリビルダー ペインのツールバーで、名前が code [MQL] または code [PromQL] のボタンを選択します。
   2. [MQL] 切り替えで [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 の詳細については、次のドキュメントをご覧ください。

      • MQL の概要
      • MQL に対してコードエディタを使用する

   PromQL

   1. クエリビルダー ペインのツールバーで、名前が code [MQL] または code [PromQL] のボタンを選択します。
   2. [PromQL] で [PromQL] が選択されていることを確認します。言語切り替えボタンは、クエリの書式設定を行うのと同じツールバーにあります。

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

      avg(compute_googleapis_com:instance_cpu_utilization)
      

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

   モニタリング フィルタ

   1. [指標] 要素で、help_outline [ヘルプ] をクリックして、[ダイレクト フィルタモード] を選択します。

      [指標] 要素と [フィルタ] 要素が削除され、テキストを入力できる [フィルタ] 要素が作成されます。

      [ダイレクト フィルタモード] モードに切り替える前にリソースタイプ、指標、フィルタを選択した場合は、これらの設定が [フィルタ] 要素のフィールドに表示されます。

   2. [フィルタ] 要素のフィールドにモニタリング フィルタを入力します。

   3. 時系列を結合して配置します。

      • すべての時系列を表示するには、[集計] 要素で最初のメニューを [未集計] に、2 番目のメニューを [なし] に設定します。

      • 時系列を結合するには、[集計] 要素で次の操作を行います。

        1. 最初のメニューを展開して関数を選択します。

           グラフが更新され、単一の時系列が表示されます。たとえば、[平均] を選択すると、表示される時系列はすべての時系列の平均になります。

        2. 同じラベル値を持つ時系列を結合するには、2 番目のメニューを開き、1 つ以上のラベルを選択します。

           グラフが更新され、ラベル値の一意の組み合わせごとに 1 つの時系列が表示されます。たとえば、ゾーンごとに時系列を表示するには、2 番目のメニューを [ゾーン] に設定します。

           2 番目のメニューが [なし] に設定されている場合、グラフには 1 つの時系列が表示されます。

      • 省略可: データポイントの間隔を構成するには、add [クエリ要素を追加] をクリックし、[最小間隔] を選択して、値を入力します。

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

3. 選択した指標タイプに基づいてグラフの設定を更新します。

   • 割り当て指標の種類には、次の設定を使用します。

     • ツールバーで時間コントロールを 1 週間以上に設定します。割り当て指標は通常、1 日に 1 つのサンプルを報告します。
     • [表示] ペインで [ウィジェット タイプ] メニューを展開し、[積み上げ棒グラフ] を選択します。

   • 値の型が Distribution の指標タイプの場合は、[ウィジェット タイプ] メニューが [ヒートマップ グラフ] に設定されていることを確認します。詳細については、分布値の指標についてをご覧ください。

   • 他の指標タイプの場合は、[ウィジェット タイプ] メニューを使用して、データの表示方法を指定します。[ウィジェット タイプ] メニューには、使用可能なすべてのウィジェット タイプが一覧表示されます。ただし、一部のウィジェットは有効になっていない場合があります。複数の時系列を表示するグラフを想定して、各測定値が double であると仮定します。

     • 折れ線グラフ、積み上げ棒グラフ、積み上げ面グラフのウィジェットは、[互換] として一覧表示されます。これらのタイプは任意で選択できます。
     • [ヒートマップ] ウィジェットは、分布値のデータのみを表示するため、無効になっています。

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

   • グラフ オプション:

     • 分析モード メニュー: 折れ線グラフ、X 線、統計情報のいずれかを選択します。
     • [過去と比較] メニュー: 現在のデータを過去のデータと重ねて表示します。
     • [しきい値の線] メニュー: 参照しきい値を追加します。
     • [凡例のエイリアス] メニュー: 凡例列の名前を構成します。
     • [Y 軸の割り当て] メニュー、Y 軸のラベル] メニュー、Y 軸スケール] メニュー: Y 軸の割り当て、ラベル、スケールを構成します。

   • 表のオプション:

     • [値オプション] メニュー: 最新の値と集計値のどちらかを選択します。
     • [表示される列] メニュー: 表示される列を選択します。
     • [列の書式設定] メニュー: 列名、列内のデータの配置、単位、セルの色分けを設定します。
     • [指標ビュー] メニュー: 値を単独で表示するか、値の範囲に対して相対的に表示するかを選択します。
     • [凡例のエイリアス] メニュー: 凡例列の名前を構成します。

複数の指標タイプをグラフ化する

状況によっては、同じグラフに異なる指標タイプの時系列を表示したい場合があります。たとえば、VM で読み取りと書き込みの負荷を比較するには、読み取りバイト数と書き込みバイト数を表示するようにグラフを構成します。

複数の指標をグラフに表示するには、メニュー　ドリブン インターフェースを使用する必要があります。他のインターフェースでは、複数の指標のグラフ化はサポートされていません。

グラフに複数の指標を表示する方法は、次のとおりです。

1. Google Cloud コンソールで、[leaderboardMetrics Explorer] ページに移動します。

   Metrics Explorer に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。

2. グラフに表示するデータを指定します。

   メニュー形式インターフェース

   1. [指標] 要素で、データを表示する最初の指標タイプを選択します。この手順については、単一の指標タイプをグラフ化するをご覧ください。

      この選択のクエリには [A] 識別子が付いています。

   2. 追加タイプの指標ごとに、次の操作を行います。

      1. [クエリを追加] を選択します。新しいクエリが追加されます。たとえば、ラベル B が含まれるクエリが追加されるとします。

      2. 新しいクエリの [指標] 要素で、リソースタイプと指標タイプを選択します。フィルタの追加、時系列の結合、表示される時系列の並べ替えと制限もできます。

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

      

   3. 省略可: [ディスプレイ] ペインで [Y 軸] メニューを展開し、Y 軸を使用する各指標タイプについて構成します。

   MQL

   サポートされていません。

   PromQL

   サポートされていません。

   モニタリング フィルタ

   サポートされていません。

指標の比率をグラフ化する

報告されたエラーの数をモニタリングすることは有用ですが、エラーの発生率をモニタリングする必要がある可能性が高くなります。つまり、レスポンスの合計数に対するエラー発生数を確認する必要があります。この要件を満たすには、2 つの指標の比率を表示するようにグラフを構成します。指標の比率をグラフ化する際に発生することがある異常の例と情報については、指標の比率をご覧ください。

グラフに指標の比率を表示する手順は次のとおりです。

1. Google Cloud コンソールで、[leaderboardMetrics Explorer] ページに移動します。

   Metrics Explorer に移動

   検索バーを使用してこのページを検索する場合は、小見出しが [Monitoring] である結果を選択します。

2. グラフに表示するデータを指定します。

   メニュー形式インターフェース

   1. 分子を構成します。

      1. [指標] 要素で、メニューを使用してリソースタイプと指標タイプを選択します。この手順については、単一の指標タイプをグラフ化するをご覧ください。
      2. 集計フィールドを更新します。 デフォルトでは、すべての時系列を平均化します。
      3. 省略可: 時系列内のポイントを結合する固定時間の長さを更新します。このフィールドを変更するには、add [クエリ要素を追加] をクリックし、[最小間隔] を選択して、ダイアログを完了します。

   2. [クエリを追加] を選択し、分母を構成します。

      1. 新しいクエリの [指標] 要素で、リソースタイプと指標タイプを選択します。

         指標の種類が分子と同じ指標タイプを選択します。たとえば、分子の指標が GAUGE 指標の場合、分母に GAUGE 指標を選択します。

      2. 集計フィールドを更新します。

         分母指標タイプのラベルは、分子指標タイプの値と一致させることをおすすめします。たとえば、分子と分母に zone ラベルを選択します。

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

      3. add [クエリ要素を追加] をクリックして、[最小間隔] を選択し、このフィールドを分子で使用される値に設定します。

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

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

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

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

      

   4. 省略可: 分子と分母の指標を切り替えるには、[比率] 要素でメニューを展開し、選択を行います。

   MQL

   1. クエリビルダー ペインのツールバーで、名前が code [MQL] または code [PromQL] のボタンを選択します。
   2. [MQL] 切り替えで [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 の詳細については、次のドキュメントをご覧ください。

      • MQL の概要
      • コードエディタの使用
      • コンピューティング比率

   PromQL

   1. クエリビルダー ペインのツールバーで、名前が code [MQL] または code [PromQL] のボタンを選択します。
   2. [PromQL] で [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 をご覧ください。

   モニタリング フィルタ

   サポートされていません。

将来参照できるようにグラフを保存する

Metrics Explorer を使用すると、指標の探索に使用できるグラフを作成できます。ただし、このツールで作成したグラフは永続的ではありません。[Metrics Explorer] ページから移動すると、グラフは破棄されます。

将来参照できるように、Metrics Explorer で構成したグラフを保存するには、カスタム ダッシュボードにグラフを追加するか、グラフの URL を保存します。

• グラフをカスタム ダッシュボードに追加するには、次のいずれかを行います。

  • Google Cloud コンソールを使用してカスタム ダッシュボードを管理している場合は、Metrics Explorer ツールバーで [Save Chart] を選択し、ダイアログを完了します。グラフを既存のカスタム ダッシュボードに保存することも、ダッシュボードを作成することもできます。

  • Cloud Monitoring API を使用してカスタム ダッシュボードを管理する場合は、ダッシュボードとそのコンテンツを定義する JSON ファイルを更新します。JSON 表現にアクセスするには、グラフ ツールバーで code [JSON エディタ] をクリックします。

    API を使用したカスタム ダッシュボードの管理について詳しくは、API でダッシュボードを作成して管理するをご覧ください。

• グラフ構成への参照を保持するには、グラフ URL を保存します。グラフの URL によってグラフの構成がエンコードされているため、この URL をブラウザに貼り付けると、構成したグラフが表示されます。

  グラフの URL を取得するには、グラフ ツールバーの link [リンク] をクリックします。

グラフの構成を保存する

Cloud Monitoring API を使用してカスタム ダッシュボードを管理する場合、API に提供するデータの作成に役立つ Metrics Explorer を使用できます。

• ダッシュボードに追加するグラフの JSON 表現を生成するには、Metrics Explorer でグラフを構成します。その後、Metrics Explorer 内のオプションを使用して、グラフの JSON 表現を表示、コピーできます。

• Cloud Monitoring API で使用される Monitoring フィルタの構文を識別するには、Metrics Explorer のメニューに基づいたインターフェースを使用してグラフを構成します。指標とフィルタを選択したら、ダイレクト フィルタモードに切り替えて、同等の Monitoring フィルタを表示します。

グラフに表示されているデータを保存する

グラフに表示されたデータをローカル システムに保存するには、get_app [CSV 形式でダウンロード] をクリックします。

次のステップ

• グラフデータの確認
• Metrics Explorer で指標を選択する
• 指標の使用状況の表示と管理
• グラフの表示オプションを設定する