ダッシュボード ウィジェットの指標を選択する

このページでは、グラフに表示するデータを指定する方法について説明します。グラフのスタイルを構成する方法については、表示オプションの設定をご覧ください。

表示するデータを選択する

グラフにデータを挿入するには、少なくとも 1 つの値のペアを指定する必要があります。

  • [指標] フィールドは、モニタリング対象リソースから収集される測定値を識別します。これには、測定対象および測定値がどのように解釈されるかについての説明が含まれます。指標 は、指標タイプの短縮形です。コンセプトについては、指標タイプをご覧ください。

  • [リソースタイプ] フィールドは、指標データがキャプチャされるリソースを指定します。リソースタイプは、モニタリング対象リソースタイプまたはリソースとも呼ばれます。コンセプトについては、モニタリング対象リソースをご覧ください。

Monitoring では、多くの事前定義済み指標タイプやモニタリング対象リソースが利用できます。また、カスタム指標を指定することもできます。

  • 定義済みの指標タイプの詳細は、指標の一覧をご覧ください。各ドキュメントには、サービスの種類別に指標が列挙されます。たとえば、Google Cloud の指標ページには、Google Cloud サービスごとに 1 つずつ、一連のテーブルが含まれます。

  • 使用可能なモニタリング対象リソースのタイプについては、モニタリング対象リソースのリストをご覧ください。

  • 独自の指標の定義については、カスタム指標の使用をご覧ください。

指標の指定用フィールド

ウィジェットをウィジェット ライブラリからグラフ領域にドラッグすると、事前に選択されたリソースタイプと指標によるグラフが表示されます。

新規に作成した折れ線グラフの例。

グラフに表示するデータを指定する方法は複数あります。

  • グラフをすばやく構成するには、基本モードを使用します。この選択肢には、最小限の構成オプションが用意されています。基本構成は、常に他のモードで表すことができます。詳しくは、基本モードまたは詳細モードの使用をご覧ください。

  • すべてのグラフ構成フィールドにアクセスするには、詳細モードを使用します。このモードは、ほとんどの集計フィールドにアクセスできます。詳しくは、基本モードまたは詳細モードの使用をご覧ください。

  • モニタリング フィルタを入力するには、ダイレクト フィルタモードをご覧ください。

  • クエリ言語を使用してグラフを構成するには、MQL モードを使用します。このモードでは、Query Editor にアクセスできます。MQL を使用する場合、その構成を他のモードで表示することはできません。MQL については、MQL の概要をご覧ください。

基本モードや詳細モードを使用する

[リソースタイプ] メニューには、指標データが存在するすべてのモニタリング対象リソースが一覧表示されます。[指標] メニューは、[リソースタイプ] での選択によって異なります。

  • メニューで特定のエントリを検索するには、スクロールバーを使用するか、メニューの「Filter エリアにテキストを入力します。テキストを入力すると、メニュー エントリは、入力されたテキストが含まれるエントリに限られます。

    次のスクリーンショットは、[指標] フィールドの展開されたメニューを示しています。フィルタバーには lat というテキストが含まれているため、このメニューにはその文字列を含むエントリだけが一覧表示されます。

    指標フィルタバーを表示します。

    上記のスクリーンショットでは、指標 Late Boot Validation がハイライト表示されています。エントリの上にポインタを置くと、ペインが開き、前述の指標に関する詳細情報が表示されます。図に示すように、とりわけこのペインには、指標の種類、値の型、説明フィールドが一覧表示されます。

まだデータが存在しないリソースタイプまたは指標にアクセスする場合は、デフォルトの動作を変更する必要があります。

  • 任意のリソースタイプを選択できるようにするには、[リソースタイプ] メニューを展開して [有効な場合のみ表示] をオフにします。

  • データが存在しない指標も含めて、選択したリソースタイプのすべての指標を表示するには、[Metric] メニューを展開して、[Only show active] をオフにします。

  • 任意の指標を選択できるようにするには、[Resource type] メニューで「Close をクリックして、目的のエントリを見つけます。リソースタイプで「Close」をクリックすると、[Metric] メニューに指標がすべて表示されます。

  • Cloud Monitoring API で使用するリソースタイプ、指標、フィルタ設定を表示または編集するには、[リソースタイプ] メニューの [ダイレクト フィルタ モード] をクリックします。

ダイレクト フィルタモードを使用する

次のいずれかをグラフ化する場合は、ダイレクト フィルタモードを使用します。

  • サービスレベル目標(SLO)。
  • 仮想マシン(VM)で実行されているプロセスの数。
  • まだデータがないカスタム指標。

ダイレクト フィルタ モードを使用する場合は、グラフ化する時系列を指定する Monitoring フィルタを入力します。次の Monitoring フィルタの結果は、us-east1-b ゾーンのすべての Google Cloud 仮想マシン インスタンスのログエントリ数を示すグラフになります。

metric.type="logging.googleapis.com/log_entry_count"
resource.type="gce_instance" resource.label."zone"="us-east1-b"

指標フィルタを入力する方法は次のとおりです。

  1. [基本] モードまたは [詳細] モードを選択します。
  2. [リソースタイプ] メニューで、[ダイレクト フィルタ モード] をクリックします。

グラフ化されたデータのフィルタ

フィルタ条件を指定する、集計を適用する、または外れ値モードを使用することで、グラフ化するデータの量を減らすことができます。フィルタにより、一定の条件を満たす時系列のみが使用されるようになります。フィルタを適用すると、グラフ上の線が減少し、グラフのパフォーマンスが向上します。

複数のフィルタ条件を指定すると、対応するグラフには、すべての条件を満たす時系列(論理 AND)だけが表示されます。 通常、リソース グループ、名前、リソースラベル、ゾーン、指標ラベルでフィルタできます。

[MQL] モードを選択した場合は、Query Editor を使用してフィルタを指定します。

基本モードまたは詳細モードを選択してフィルタを追加するには、[フィルタを追加] をクリックして、フィルタラベル、比較演算子、値または値の範囲を指定します。

  1. [Label] をクリックし、メニューからエントリを選択します。

    特定のラベルを検索するには、スクロールバーを使用するか、[フィルタ] テキスト領域にテキストを入力します。テキストを入力すると、メニューには、入力したテキストを含むエントリのみが表示されます。

    次のスクリーンショットでは、特定の指標のラベルでフィルタリングを設定しています。

    フィルタラベルのリストの例。

  2. [Comparison] をクリックして、メニューからエントリを選択します。演算子は、等しい(=)、等しくない(!=)、正規表現一致(=~)、正規表現に一致しない(!=~)の 4 つから選択できます。

    フィルタ比較演算子のリスト。

  3. [] をクリックして、次のいずれかを行います。

    • 直接比較(= または !=)を選択した場合は、メニューから選択するか、値を入力して [DONE] をクリックします。入力する値は、us-central1-a などの単純な値にすることも、starts_withends_with で始まるフィルタ文字列を作成することもできます。たとえば、任意の us-central1 ゾーンのデータを表示するには、フィルタ文字列「starts_with("us-central1")」を入力します。フィルタ文字列に関する詳細については、モニタリング フィルタをご覧ください。

      メニュー エントリは受信した時系列から導出されるため、モニタリング対象リソースが選択した指標のデータを生成しない場合は、ラベルの値を入力する必要があります。

      次のスクリーンショットは、zone リソースラベルが選択されたとき、特定のプロジェクトに表示される値メニューを示しています。

      フィルタラベルのリストの例。

    • 正規表現比較(=~ または !=~)を選択した場合は、[Value] フィールドに RE2 の正規表現を入力して [Done] をクリックします。たとえば、正規表現 us-central1-.* はすべての us-central1 ゾーンと一致します。

      「a」で終わる US ゾーンと一致させるには、正規表現「^us.*.a$」を使用します。

      正規表現を使用して project_id リソースラベルをフィルタすることはできません。

      たとえば、us-central1 ゾーンのいずれか 1 つから時系列のみを表示するには、zone="starts_with("us-central1")" フィルタまたは zone=~"us-central1.*" フィルタを適用します。

      フィルタリングされた時系列が表示されます。

フィルタ条件は複数指定できます。また、同じラベルを複数回使用することもできます。こうした機能により、値の範囲のフィルタを指定できます。すべてのフィルタ条件が満たされる必要があり、これらは論理 AND を構成します。たとえば、次の構成では、starts_withends_with の両方のフィルタ文字列を使用して US 内の「a」ゾーンのみを表示できます。

複数フィルタの使用例。

グラフ化されたデータの表示方法を選択する

時系列データを選択したら、次にデータの表示方法を決定します。たとえば、各時系列を表示するか、時系列を組み合わせるかなどです。

データの表示方法を指定するには、集計オプションを設定します。集計は時系列データのアラインメントを行い、異なる時系列を組み合わせます。時系列の結合は任意です。

集計の詳細については、フィルタリングと集計: 時系列の操作をご覧ください。

データを配置する

アライメントは、Monitoring によって受信された時系列データを、固定間隔でデータポイントを持つ新しい時系列に変換するプロセスです。アライメントのプロセスは、一定時間内に受信したすべてのデータポイントを収集し、それらのデータポイントを結合する関数を適用し、結果にタイムスタンプを割り当てます。この関数では、すべてのサンプルの平均を計算することも、すべてのサンプルの最大値を抽出することもできます。

[アライメント期間] で、時系列データをアライメントするために使用される最小期間を指定します。選択した表示期間でグラフに表示するデータポイントが多すぎる場合は、すべてのデータポイントが集計されるように、アライメント期間が自動的に増加します。このフィールドのデフォルト設定は 1 分です。

たとえば、サンプリング期間が 1 分の指標について考えてみましょう。グラフが 1 時間のデータを表示するように構成されている場合、グラフには 60 個のデータポイントすべてを表示できます。アライメント期間が 10 minutes に設定されている場合、グラフには 6 個のデータポイントが表示されます。ただし、1 週間のデータを表示するようにグラフを構成した場合、グラフに表示するポイントが多すぎるため、期間が自動的に変更されます。この例では、アライメント期間が 1 時間に変更されます。

[アライメント関数] フィールドは、アライメント期間内のすべてのデータポイントを組み合わせるために使用される関数を指定します。Aligner のほとんどは、一般的な数学関数を実行します。たとえば [min] を選択した場合、整列データポイントは、アライメント期間内のすべてのデータポイントの最小値です。一部の Aligner は、より複雑なアクションを実行します。

  • 次の古い: アライメント期間内に最新のサンプルのみを保持するには、次の古い Aligner を使用します。この Aligner は、稼働時間チェックでよく使用されます。最新の値のみを対象とする場合は、適切な選択肢です。

    この Aligner は、ゲージ指標にのみ有効です。

  • パーセンタイル: 折れ線グラフ、積み上げ面グラフ、積み上げ棒グラフなどのプロトタイプで分布指標を表示するには、表示する分布でのパーセンタイルを選択する必要があります。このパーセンタイルを指定する方法の 1 つに、パーセンタイル Aligner の選択があります。5、50、95、99 パーセンタイルを選択できます。整列データポイントは、アライメント期間内のすべてのデータポイントを使用して指定されたパーセンタイルを計算して決定されます。

    この Aligner は、分布データ型を持つゲージ指標とデルタ指標に対してのみ有効です。

  • デルタ: 累積指標またはデルタ指標を、アライメント期間ごとのサンプルが 1 つであるデルタ指標に変換するには、この Aligner を使用します。この Aligner によって、データ補間が発生する可能性があります。例については、種類、タイプ、変換をご覧ください。

    この Aligner は、累積指標とデルタ指標にのみ有効です。

  • レート: 累積指標またはデルタ指標をゲージ指標に変換するには、この Aligner を使用します。この Aligner を選択した場合、時系列がデルタ Aligner と同様に変換され、アライメント期間で除算されると考えることができます。たとえば、元の時系列の単位が MiB で、アライメント期間の単位が秒の場合、グラフの単位は MiB/秒になります。詳細については、種類、タイプ、変換をご覧ください。

    この Aligner は、累積指標とデルタ指標にのみ有効です。

使用可能な Aligner についての詳細は、API リファレンスの Aligner をご覧ください。

アライメント フィールドにアクセスするには、次の手順を実行します。

  • 基本モード: すべてのアライメント フィールドが事前構成されています。

  • 詳細モード: リソースタイプと指標を選択すると、すべてのアライメント オプションにアクセスできます。これらのフィールドのデフォルト値を指定します。ただし、この選択は変更できます。

  • MQL モード: すべてのアライメント オプションを利用可能です。

次のスクリーンショットは、特定の Google Cloud プロジェクトの Compute Engine VM インスタンスの CPU 使用率を示しています。この画像では、アライメント フィールドがデフォルト値になっています。アライメント関数は mean に設定され、アライメント期間は 1 minute に設定されています。

デフォルトのアライメント設定を使用する VM インスタンスの CPU 使用率。

比較のため、次のスクリーンショットでは、期間を 1 minute から 5 minutes に変更した場合の影響を示しています。

アライメント期間が 5 分である VM インスタンスの CPU 使用率

期間を増やすことにより、結果のグラフのポイントが少なくなり、時系列あたり 60 ポイントから時系列あたり 10 ポイントに減ります。グラフの各ポイントは、アライメント期間内の時系列ポイントを平均することで計算されます。アライメント期間を増やすことにより、平均するポイントが増え、プロットするデータが滑らかになる効果が得られます。

時系列を結合する

異なる時系列を組み合わせることで、指標に対して返されるデータの量を減らすことができます。複数の時系列を組み合わせるには、通常、グループ化と関数を指定します。グループ化はラベル値で行います。関数は、グループ内のすべての時系列を新しい時系列に結合する方法を定義します。

時系列をグループ化して結合するには、次のいずれかを行います。

  • 基本モード:

    1. 時系列をグループ化する方法を決定します。

      • すべての時系列を表示するには、[グループ化済み] をオフのままにします。
      • ラベル値で時系列をグループ化するには、[Grouped] をオンにしてから [Group by] メニューを使用してグループ化するラベルを選択します。選択したら、[OK] をクリックします。
    2. データポイントを組み合わせる方法を決定します。

      • ラジオボタンにパーセンタイルのみが表示される場合は、分布値を持つ指標が選択されています。ラジオボタンを使用して、分布から表示するパーセンタイルを選択します。

      • ラジオボタンに meanminmax が記載されている場合は、数値を持つ指標が選択されています。このボタンを使用すると、グラフ作成プロセスの一環として、データポイントの組み合わせ方法を指定できます。この組み合わせの動作を理解するために、グラフで 60 個のデータポイントを表示できるとし、データレートが 1 分あたり 1 ポイントであるとします。1 時間のデータを表示すると、グラフですべてのポイントが表示されます。ただし、3 時間のデータを表示する場合は、180 個のデータポイントを 60 個(グラフで表示できるポイントの数)に減らす必要があります。データを減らす方法の 1 つは、隣接する 3 つのサンプルの平均を計算することで、もう 1 つは最小値をとることです。

  • 詳細モード:

    • すべての時系列を単一の時系列に結合するには、[グループ条件] が空になっていることを確認し、[Group by function] メニューを使用して時系列を結合する方法を選択します。

    • すべての時系列を表示するには、次のいずれかを行います。

      • [グループ条件] が空になっていることを確認し、[Group by function] で [none] を選択します。
      • [Group by] メニューをクリックして [Add all] を選択し、[Group by function] を選択します。数値を格納する指標の場合は、group-by 関数を選択しても、表示内容が異なるグラフが生成されない場合があります。
    • 時系列を特定のラベル値でグループ化するには、[Group by] をクリックし、グループ化に使用するラベルを選択します。時系列の結合方法を指定するには、[Group by function] メニューを使用して関数を選択します。

  • MQL モード:

    Monitoring のクエリ言語の詳細については、クエリエディタの使用をご覧ください。

次のスクリーンショットは、group-by 関数が sum のデフォルト値に設定された、user_labels.version によるグループ化を示しています。この選択により、user_labels.version の値ごとに 1 つの時系列が生成されます。各時系列のデータポイントは、特定バージョンの個別の時系列のすべての値の合計から計算されます。

user_labels.version でグループ化された時系列の表示

複数のラベルでグループ化できます。グループ化の選択肢が複数ある場合は、選択したラベルに対して同じ値を持つ一連の時系列に group-by 関数が適用されます。

結果のグラフには、ラベル値の組み合わせごとに 1 つの時系列が表示されます。ラベルを指定する順序は問題になりません。

たとえば、次のスクリーンショットは、user_labels.versionsystem_labels.machine_image によるグループ化を示しています。

バージョンとマシンイメージでグループ化された時系列。

図のように、両方のラベルでグループ化すると、値のペアごとに 1 つの時系列が取得されます。この方法では、ラベルの組み合わせごとに時系列が作成されるため、1 つのグラフに作成する場合よりも多くのデータが作成されます。

グループ化を指定した場合、または group-by 関数を選択した場合、グラフ化された時系列には、プロジェクト識別子などの必要なラベルと、グループ化で指定されたラベルのみが含まれます。

グループ別条件を削除する

group-by 条件をすべて削除するには、次のいずれかを行います。

  • 基本モード: [グループ化] をオフにします。

  • 詳細モード: 次の操作を行います。

    1. [Group by] メニューで [すべて削除] をクリックしてから、[OK] をクリックします。
    2. [Group by 関数] メニューで、[none] を選択します。
  • MQL モード: グループ化コマンドを削除します。

    Monitoring のクエリ言語の詳細については、クエリエディタの使用をご覧ください。

二次集計

選択したタブによって集計オプションが決定されます。

  • 基本モードと詳細モード: ダッシュボード エディタは、次の情報を使用して、集計の選択を Cloud Monitoring API で指定されたプライマリとセカンダリの集計フィールドにマッピングする方法を決定します。

    • ウィジェット タイプ
    • 指標の種類
    • 指標の値の型
    • ウィジェットの構成に使用するモード

    カスタム ダッシュボードのグラフのマッピングを確認するには、gcloud コマンドライン ツールを使用してダッシュボード構成を取得します。詳細については、ダッシュボードの一覧表示をご覧ください。

  • MQL モード: これらのフィールドはアクセス可能です。

次のステップ