Metrics Explorer でグラフを作成する

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

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

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

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

注: ダッシュボード上のグラフを表示中にグラフの構成を表示する場合、またはグラフを別のダッシュボードにコピーする場合は、グラフのオプションでグラフの Metrics Explorer を表示できるかどうかを確認します。このオプションを選択すると、Metrics Explorer が開き、表示していたデータが表示されます。その後、構成を表示または変更したり、グラフをカスタム ダッシュボードに保存したりできます。

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

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

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

   Metrics Explorer に移動

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

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

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

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

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

         [指標を選択] メニューには、使用可能な指標タイプを見つける際に役立つ機能が用意されています。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   MQL

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

      • MQL の概要
      • MQL のコードエディタの使用

   PromQL

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

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

      avg(compute_googleapis_com:instance_cpu_utilization)
      

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

   モニタリング フィルタ

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

   • 割り当て指標タイプの場合は、次の設定を使用します。

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

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

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

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

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

   • X 線モードで表示する、または統計情報を表示するようにグラフを構成するには、 [分析モード] をクリックします。
   • 現在のデータと過去のデータを比較するには、 [過去と比較する] をクリックします。
   • 参照しきい値を追加するには、[しきい値行] をクリックします。
   • 凡例の列の名前を構成するには、[凡例エイリアス] をクリックします。
   • Y 軸の割り当て、ラベル、スケールを構成するには、Y 軸の割り当て、Y 軸のラベル、Y 軸のスケーリングのメニューを使用します。

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

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

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

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

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

   Metrics Explorer に移動

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

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

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

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

      この選択のクエリでは、A 識別子が使用されます。

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

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

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

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

      

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

   MQL

   非対応。

   PromQL

   非対応。

   モニタリング フィルタ

   非対応。

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

報告されたエラーの数をモニタリングすると、役に立つ場合があります。ただし、多くの場合、エラー率をモニタリングする必要があります。つまり、レスポンスの総数に対して測定されたエラーの数を知りたいとします。この要件を満たすために、2 つの指標の比率を表示するようにグラフを構成できます。指標の比率をグラフ化する際に発生することがある異常の例と情報については、指標の比率をご覧ください。

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

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

   Metrics Explorer に移動

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

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

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

   1. 分子を構成します。

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

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

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

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

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

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

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

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

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

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

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

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

      

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

   MQL

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

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

   PromQL

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

   モニタリング フィルタ

   非対応。

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

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

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

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

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

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

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

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

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

グラフの構成を保存する

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

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

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

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

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

次のステップ

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