このページでは、グラフに表示するデータを指定する方法について説明します。グラフのスタイルを構成する方法については、表示オプションの設定をご覧ください。
表示するデータの選択
グラフにデータを挿入するには、少なくとも 1 つの値のペアを指定する必要があります。
モニタリング対象リソースから収集できる測定値を識別する指標タイプ。これには、測定対象および測定値がどのように解釈されるかについての説明が含まれます。指標タイプは指標とも呼ばれます。コンセプトについては、指標タイプをご覧ください。
モニタリング対象リソースは、指標データを取得するリソースを指定します。モニタリング対象リソースは、モニタリング対象リソースタイプまたはリソースとも呼ばれます。コンセプトについては、モニタリング対象リソースをご覧ください。
Monitoring では、多くの事前定義済み指標タイプやモニタリング対象リソースが利用できます。また、カスタム指標を指定することもできます。
定義済みの指標タイプの詳細は、指標の一覧をご覧ください。指標はサービスの種類別に表示されます。たとえば、Google Cloud の指標ページには、Google Cloud サービスごとに 1 つずつ、一連のテーブルが含まれます。
使用可能なモニタリング対象リソースのタイプについては、モニタリング対象リソースのリストをご覧ください。
独自の指標の定義については、カスタム指標の使用をご覧ください。
指標の指定用フィールド
ダッシュボード エディタ
ウィジェットをウィジェット ライブラリからグラフ領域にドラッグすると、事前に選択されたリソースタイプと指標によるグラフが表示されます。
グラフに表示するデータを指定する方法は複数あります。
- グラフをすばやく構成するには、基本モードを使用します。この選択肢には、最小限の構成オプションが用意されています。基本構成は、常に他のモードで表すことができます。詳しくは、基本モードまたは詳細モードの使用をご覧ください。
すべてのグラフ構成フィールドにアクセスするには、詳細モードを使用します。このモードは、ほとんどの集計フィールドにアクセスできます。詳しくは、基本モードまたは詳細モードの使用をご覧ください。
クエリ言語を使用してグラフを構成するには、MQL モードを使用します。このモードでは、クエリエディタにアクセスできます。MQL を使用する場合、前述の構成は他のモードで表現できません。MQL の詳細については、MQL の概要をご覧ください。
基本モードまたは詳細モードの使用
[リソースタイプ] メニューには、指標データが存在するすべてのモニタリング対象リソースが一覧表示されます。[指標] メニューは、[リソースタイプ] での選択によって異なります。
メニューで特定のエントリを検索するには、スクロールバーを使用するか、メニューの「Filter」filter_list エリアにテキストを入力します。テキストを入力すると、メニュー エントリは、入力されたテキストが含まれるエントリに限られます。
次のスクリーンショットは、[指標] フィールドの展開されたメニューを示しています。フィルタバーには
lat
というテキストが含まれているため、このメニューにはその文字列を含むエントリだけが一覧表示されます。上記のスクリーンショットでは、指標
Late Boot Validation
がハイライト表示されています。エントリの上にポインタを置くと、ペインが開き、前述の指標に関する詳細情報が表示されます。図に示すように、とりわけこのペインには、指標の種類、値の型、説明フィールドが一覧表示されます。
まだデータが存在しないリソースタイプまたは指標にアクセスする場合は、デフォルトの動作を変更する必要があります。
任意のリソースタイプを選択できるようにするには、[Resource type] メニューを展開して [Only show active] をオフにします。
データが存在しない指標も含めて、選択したリソースタイプのすべての指標を表示するには、[Metric] メニューを展開して、[Only show active] をオフにします。
任意の指標を選択できるようにするには、[Resource type] メニューで「Close」close をクリックして、目的のエントリを見つけます。リソースタイプで「Close」をクリックすると、[Metric] メニューに指標がすべて表示されます。
Cloud Monitoring API で使用するリソースタイプ、指標、フィルタ設定を表示または編集するには、[リソースタイプ] メニューの [ダイレクト フィルタ モード] をクリックします。
以前のダッシュボード エディタ
指標を選択するには、[Find resource type and metric] フィールドを使用して、モニタリング対象リソースと指標タイプを 1 つずつ選択します。どちらが先でもかまいません。開始するには、フィールドのヘルプテキストをクリックすると、以前の選択内容に応じて 1 つまたは 2 つのセクションを含むリストが表示されます。次のスクリーンショットのように、セクションはヘッダー、リソースタイプ、指標で示されます。
リソースタイプと指標の選択を完了するには、次のいずれかを行います。
値を入力またはリストから選択します。
リストは、入力したテキストに基づいてフィルタリングされます。たとえば、「
CPU Usage
」と入力すると、リストのすべてのメンバーにCPU
とusage
が含まれます。次の手順に沿って指標フィルタを入力します。
- [Find resource type and metric] の隣にある、[Help] help_outlineをクリックします。
[ヘルプ] ペインで [Direct filter mode] をクリックします。
[Direct filter mode] が有効な場合、[Find resource type and metric] オプションが [Resource type, metric, and filter] という名前の編集可能なテキスト ボックスに置き換わります。
[Direct filter mode] を選択する前にリソースタイプ、指標、フィルタを選択した場合、これらの設定が [Resource type, metric, and filter] テキスト ボックスへの事前入力に使用されます。
[Resource type, metric, and filter] テキスト ボックスに指標フィルタを入力します。フィルタには、指標タイプとリソースタイプを含める必要があります。また、ラベルフィルタを含めることもできます。フィルタの文法については、モニタリング フィルタをご覧ください。
たとえば、
us-east1-b
ゾーンのすべての Google Cloud VM インスタンスのログエントリを表示するには、以下を入力します。metric.type="logging.googleapis.com/log_entry_count" resource.type="gce_instance" resource.label."zone"="us-east1-b"
ダイレクト フィルタ モードを使用してグラフやアラート ポリシーを構成していて、データが利用できない場合、グラフにエラー メッセージが表示されます。正確なエラー メッセージは、入力したフィルタによって変わります。たとえば、一般的なメッセージは
Chart definition invalid
です。「No data is available for the selected time frame.
」というメッセージが表示されることもあります。
メニュー エントリの詳細を表示するには、項目の上にポインタを置きます。指標タイプまたはモニタリング対象リソースの記述子については、指標の一覧、モニタリング対象リソースの一覧をそれぞれご覧ください。
他の構成を行わず、選択した指標とリソースでグラフを表示すると、次のスクリーンショットのようなグラフが表示されます。
このグラフに含まれているデータは、表示できる量を超えています。グラフに表示できる線の数は最大 300 です。データの量を減らすには、フィルタを適用するか、集計を適用するか、外れ値モードを使用します。
データのフィルタリング
フィルタ条件を指定する、集計を適用する、または外れ値モードを使用することで、グラフ化するデータの量を減らすことができます。フィルタにより、一定の条件を満たす時系列のみが使用されるようになります。フィルタを適用すると、グラフ上の線が減少し、グラフのパフォーマンスが向上します。
複数のフィルタ条件を指定すると、対応するグラフには、すべての条件を満たす時系列(論理 AND
)だけが表示されます。
ダッシュボード エディタ
このセクションでは、基本モードまたは詳細モードを選択した場合にフィルタを構成する方法について説明します。MQLモードを選択した場合は、クエリエディタを使用します。
通常、リソース グループ、名前、リソースラベル、ゾーン、指標ラベルでフィルタできます。
フィルタを追加するには、[フィルタを追加] をクリックし、フィルタラベル、比較演算子、値または値の範囲を指定します。
[ラベル] をクリックし、メニューからエントリを選択します。
特定のラベルを見つけるには、スクロールバーを使用するか、[フィルタ] filter_list テキスト領域にテキストを入力します。テキストを入力すると、メニュー エントリは、入力されたテキストが含まれるエントリに限られます。
次のスクリーンショットでは、特定の指標のラベルでフィルタリングを設定しています。
[Comparison] をクリックし、メニューからエントリを選択するか、デフォルト値のままにします。演算子は、等しい(
=
)、等しくない(!=
)、正規表現一致(=~
)、正規表現に一致しない(!=~
)の 4 つから選択できます。[値] をクリックして、次のいずれかを行います。
=
または!=
の直接比較を選択した場合は、メニューから選択するか、[編集] edit をクリックして値を入力します。us-central1-a
のような単純な値を入力できます。あるいは、starts_with
またはends_with
で始まるフィルタ文字列を作成することもできます。たとえば、任意のus-central1
ゾーンのデータを表示するには、フィルタ文字列starts_with("us-central1")
を入力します。フィルタ文字列に関する詳細については、モニタリング フィルタをご覧ください。メニュー エントリは受信した時系列から派生しているため、モニタリング対象リソースで選択した指標のデータが生成されない場合は、ラベルの値を入力する必要があります。
次のスクリーンショットは、
zone
リソースラベルが選択されたとき、特定のプロジェクトに表示される値メニューを示しています。正規表現比較
=~
または!=~
を選択した場合は、値に RE2 正規表現を入力します。たとえば、正規表現us-central1-.*
はすべてのus-central1
ゾーンと一致します。「a」で終わる US ゾーンと一致させるには、正規表現
^us.*.a$
を使用します。正規表現を使用して
project_id
リソースラベルをフィルタすることはできません。たとえば、
us-central1
ゾーンのいずれか 1 つから時系列のみを表示するには、zone="starts_with("us-central1")"
フィルタまたはzone=~"us-central1.*"
フィルタを適用します。
フィルタ条件は複数指定できます。また、同じラベルを複数回使用することもできます。これにより、ある範囲の値をフィルタリングできます。
すべてのフィルタ条件を満たす必要があり、論理演算子 AND
を使用します。たとえば、次の構成では、starts_with
と ends_with
の両方のフィルタ文字列を使用して US 内の「a」ゾーンのみを表示できます。
以前のダッシュボード エディタ
Google Cloud Console でフィルタを追加するには、[フィルタ] フィールドをクリックします。これにより、フィルタ条件のリストを含むパネルが開きます。たとえば、リソース グループ、名前、リソースラベル、ゾーン、指標ラベルでフィルタリングできます。
次のスクリーンショットでは、特定の指標のラベルでフィルタリングを設定しています。
条件をリストから選択することも、直接入力することもできます。まだ表示されていないデータのフィルタを作成することもできます。このようなフィルタ条件は選択リストに表示されませんが、今後有効になることがわかっている場合は手動で指定できます。
フィルタリングするラベルを選択したら、フィルタの残りの部分(値または値の範囲と比較演算子)を指定します。
たとえば、次のスクリーンショットには zone
リソースラベルに設定したフィルタが示されています。[Filter] フィールドで使用できる比較演算子には、等式 =
と =~
のペアと、不等式 !=
と !=~
のペアがあります。各ペアの 2 番目の項目は、値として正規表現を取ります。デフォルトは、単純な等式(=
)です。
比較演算子のリストの下にあるのは、使用可能な値のリストです。次のスクリーンショットには、プロジェクト内のゾーンの名前が示されています。
[Value] フィールドでは、プルダウン リストにあるいずれかの項目を選択できます。あるいは、複数の項目と一致する式を入力することもできます。
=
または!=
を使用して直接比較する場合は、starts_with
のようなフィルタ文字列を作成できます。たとえば、フィルタ文字列starts_with("us-central")
は任意のus-central
ゾーンと一致します。フィルタ文字列に関する詳細については、モニタリング フィルタをご覧ください。
=~
または!=~
を選択する場合は、値として RE2 正規表現を入力します。たとえば、正規表現us-central1-.*
は任意のus-central1
ゾーンと一致します。正規表現
^us.*.a$
は、名前が「a」で終わる任意の US ゾーンと一致します。
フィルタ条件は複数指定できます。また、同じラベルを複数回使用することもできます。これにより、ある範囲の値をフィルタリングできます。さらにフィルタを追加するには、フィルタ フィールドの下部にある [Add a filter] をクリックします。現時点では、すべてのフィルタ条件を満たす必要があるため、論理演算子 AND
を使用した場合と同じになります。たとえば、starts_with
と ends_with
の両方のフィルタ文字列を使用して、米国の「a」ゾーンのみを表示できます。
zone="starts_with("asia-east1")"
フィルタまたは zone=~"asia-east1.*"
フィルタを使用すると、asia-east1
ゾーンのいずれかからのデータを含む時系列のみが表示されます。
データの表示方法の選択
時系列データを選択したら、次にデータの表示方法を決定します。たとえば、各時系列を表示するか、時系列を組み合わせるかなどです。
データの表示方法を指定するには、集計オプションを設定します。集計は時系列データのアラインメントを行い、異なる時系列を組み合わせます。時系列の結合は任意です。
集計の詳細については、フィルタリングと集計: 時系列の操作をご覧ください。
データのアラインメント
アライメントは、Monitoring によって受信された時系列データを、固定間隔でデータポイントを持つ新しい時系列に変換するプロセスです。アライメントのプロセスは、一定時間内に受信したすべてのデータポイントを収集し、それらのデータポイントを結合する関数を適用し、結果にタイムスタンプを割り当てます。この関数では、すべてのサンプルの平均を計算することも、すべてのサンプルの最大値を抽出することもできます。
[Alignment Period](ダッシュボード エディタ)または [Period] フィールド(以前のダッシュボード エディタ)には、時系列データをアライメントするときに使用する最小時間間隔を指定します。選択した表示期間でグラフに表示するデータポイントが多すぎる場合は、すべてのデータポイントが集計されるように、アライメント期間が自動的に増加します。このフィールドのデフォルト設定は 1 分です。たとえば、サンプリング期間が 1 分の指標について考えてみましょう。グラフが 1 時間のデータを表示するように構成されている場合、グラフには 60 個のデータポイントすべてを表示できます。アライメント期間が 10 minutes
に設定されている場合、グラフには 6 個のデータポイントが表示されます。ただし、1 週間のデータを表示するようにグラフを構成した場合、グラフに表示するポイントが多すぎるため、期間が自動的に変更されます。この例では、アライメント期間が 1 時間に変更されます。
[Alignment function] フィールド(ダッシュボード エディタ)または [Aligner] フィールド(以前のダッシュボード エディタ)には、アライメント期間内のすべてのデータポイントを結合するために使用する関数を指定します。Aligner のほとんどは、一般的な数学関数を実行します。たとえば [min] を選択した場合、データポイントは、アライメント期間内のすべてのデータポイントの最小値にアライメントされます。一部の Aligner は、より複雑なアクションを実行します。
次の古い: アライメント期間内に最新のサンプルのみを保持するには、次の古い Aligner を使用します。この Aligner は、稼働時間チェックでよく使用されます。最新の値のみを対象とする場合は、適切な選択肢です。
この Aligner は、ゲージ指標にのみ有効です。
パーセンタイル: 折れ線グラフ、積み上げ面グラフ、積み上げ棒グラフなどのプロトタイプで分布指標を表示するには、表示する分布でのパーセンタイルを選択する必要があります。このパーセンタイルを指定する方法の 1 つに、パーセンタイル Aligner の選択があります。5、50、95、99 パーセンタイルを選択できます。アライメントされるデータポイントは、アライメント期間内のすべてのデータポイントを使用して指定されたパーセンタイルを計算することで決定されます。
この Aligner は、分布データ型を持つゲージ指標とデルタ指標に対してのみ有効です。
デルタ: 累積指標またはデルタ指標を、アライメント期間ごとのサンプルが 1 つであるデルタ指標に変換するには、この Aligner を使用します。この Aligner によって、データ補間が発生する可能性があります。例については、種類、タイプ、変換をご覧ください。
この Aligner は、累積指標とデルタ指標にのみ有効です。
レート: 累積指標またはデルタ指標をゲージ指標に変換するには、この Aligner を使用します。この Aligner を選択した場合、時系列がデルタ Aligner と同様に変換され、アライメント期間で除算されると考えることができます。たとえば、元の時系列の単位が MiB で、アライメント期間の単位が秒の場合、この Aligner ではグラフの単位が MiB/秒 になります。詳細については、種類、タイプ、変換をご覧ください。
この Aligner は、累積指標とデルタ指標にのみ有効です。
使用可能な Aligner についての詳細は、API リファレンスの Aligner
をご覧ください。
アライメント フィールドにアクセスするには、次の手順を実行します。
ダッシュボード エディタ
基本モード: すべてのアライメント フィールドが事前構成されています。
詳細モード: リソースタイプと指標を選択すると、すべてのアライメント オプションにアクセスできます。これらのフィールドのデフォルト値を指定します。ただし、この選択は変更できます。
MQL モード: すべてのアライメント オプションが利用可能です。
以前のダッシュボード エディタ
リソースタイプと指標を選択すると、メインパネルにアライメント期間が表示されます。
アライメント関数を表示するには、[詳細設定を表示] をクリックします。
次のスクリーンショットは、特定の Google Cloud プロジェクトの Compute Engine VM インスタンスの CPU 使用率を示しています。この画像では、アライメント フィールドがデフォルト値になっています。アライメント関数は mean
に設定され、アライメント期間は 1 minute
に設定されています。
比較のため、次のスクリーンショットでは、期間を 1 minute
から 5 minutes
に変更した場合の影響を示しています。
期間を増やすことにより、結果のグラフのポイントが少なくなり、時系列あたり 60 ポイントから時系列あたり 10 ポイントに減ります。グラフの各ポイントは、アライメント期間内の時系列ポイントを平均することで計算されます。アライメント期間を増やすことにより、平均するポイントが増え、プロットするデータが滑らかになる効果が得られます。
時系列の結合
異なる時系列を組み合わせることで、指標に対して返されるデータの量を減らすことができます。複数の時系列を組み合わせるには、通常、グループ化と関数を指定します。グループ化はラベル値で行います。関数は、グループ内のすべての時系列を新しい時系列に結合する方法を定義します。
ダッシュボード エディタ
時系列をグループ化して結合するには、次のいずれかを行います。
基本モード:
時系列をグループ化する方法を決定します。
- すべての時系列を表示するには、[Grouped] をオフのままにします。
- ラベル値で時系列をグループ化するには、[Grouped] をオンにしてから [Group by] メニューを使用してグループ化に使用するラベルを選択します。選択したら、[OK] をクリックします。
データポイントを組み合わせる方法を決定します。
ラジオボタンにパーセンタイルのみが記載されている場合は、分布値を持つ指標が選択されています。ラジオボタンを使用して、表示する分布のパーセンタイルを選択します。
ラジオボタンに
mean
、min
、max
が記載されている場合は、数値を持つ指標が選択されています。このボタンを使用すると、グラフ作成プロセスの一環として、データポイントの組み合わせ方法を指定できます。この組み合わせの動作を理解するために、グラフで 60 個のデータポイントを表示できるとし、データレートが 1 分あたり 1 ポイントであるとします。1 時間のデータを表示すると、グラフですべてのポイントが表示されます。ただし、3 時間のデータを表示する場合は、180 個のデータポイントを 60 個(グラフで表示できるポイントの数)に減らす必要があります。データを減らす方法の 1 つは、隣接する 3 つのサンプルの平均を計算することで、もう 1 つは最小値をとることです。
詳細モード:
すべての時系列を単一の時系列に結合するには、[グループ条件] が空になっていることを確認し、[Group by function] メニューを使用して時系列を結合する方法を選択します。
すべての時系列を表示するには、次のいずれかを行います。
- [Group by] が空になっていることを確認し、[Group by function] で [
none
] を選択します。 - [Group by] メニューをクリックして [Add all] を選択し、[Group by function] を選択します。数値を格納する指標の場合は、group-by 関数を選択しても、表示内容が異なるグラフが生成されない場合があります。
- [Group by] が空になっていることを確認し、[Group by function] で [
時系列を特定のラベル値でグループ化するには、[Group by] をクリックし、グループ化に使用するラベルを選択します。時系列の結合方法を指定するには、[Group by function] メニューを使用して関数を選択します。
MQL モード:
Monitoring のクエリ言語の詳細については、クエリエディタの使用をご覧ください。
次のスクリーンショットは、group-by 関数が sum
のデフォルト値に設定された、user_labels.version
によるグループ化を示しています。この選択により、user_labels.version
の値ごとに 1 つの時系列が生成されます。各時系列のデータポイントは、特定バージョンの個別の時系列のすべての値の合計から計算されます。
以前のダッシュボード エディタ
グループを追加するには、[Group by] テキスト ボックス内のテキストをクリックし、メニューから選択します。メニューは、選択したリソースと指標の時系列データに基づいて動的に作成されます。グループ化とフィルタリングでは、同じラベルセットを使用します。
最初のラベルを追加すると、次のようになります。
- アグリゲータが選択されます。選択される関数は、表示されるデータのタイプによって決まります。ただし、この関数は変更できます。
- アグリゲータは、同じラベル値を持つ時系列を 1 つの時系列に結合する方法を決定します。
- グラフには、[Group by] テキスト ボックスに記載されているラベルの値ごとに 1 つの時系列が表示されます。
複数のラベルでグループ化した場合、アグリゲータは指定されたラベルついて、同じ値を持つ時系列を結合します。
グループ化オプションを指定せずにアグリゲータを指定すると、関数は選択したすべての時系列に適用され、1 つの時系列になります。
次のスクリーンショットは、アグリゲータが sum
のデフォルト値に設定された、user_labels.version
によるグループ化を示しています。
この選択により、user_labels.version
の値ごとに 1 つの時系列が生成されます。各時系列のデータポイントは、特定バージョンの個別の時系列のすべての値の合計から計算されます。
複数のラベルでグループ化できます。複数のグループ化オプションがある場合は、ラベル値の組み合わせごとに時系列がグループ化され、group-by 関数(ダッシュボード エディタ)またはアグリゲータ(以前のダッシュボード エディタ)が各グループに適用されます。結果のグラフには、ラベル値の組み合わせごとに 1 つの時系列が表示されます。ラベルを指定する順序は問題になりません。
たとえば、次のスクリーンショットは、user_labels.version
と system_labels.machine_image
によるグループ化を示しています。
図のように、両方のラベルでグループ化すると、値のペアごとに 1 つの時系列が取得されます。この方法では、ラベルの組み合わせごとに時系列が作成されるため、1 つのグラフに作成する場合よりも多くのデータが作成されます。
グループ化を指定するか、group-by 関数(ダッシュボード エディタ)またはアグリゲータ(以前のダッシュボード エディタ)を選択する場合、グラフ化された時系列には、プロジェクト識別子などの必要なラベルと、グループ化で指定されたラベルのみが含まれます。
グループ別条件の削除
ダッシュボード エディタ
group-by 条件をすべて削除するには、次のいずれかを行います。
基本モード: [グループ化] をオフにします。
詳細モード: 次の操作を行います。
- [Group by] メニューで [すべて削除] をクリックしてから、[OK] をクリックします。
- [Group by 関数] メニューで、[
none
] を選択します。
MQL モード: グループ化コマンドを削除します。
Monitoring のクエリ言語の詳細については、クエリエディタの使用をご覧ください。
以前のダッシュボード エディタ
グループ別条件を削除するには、次の操作を行います。
- グループ別ラベルを削除します。
- アグリゲータを
none
に設定します。
二次集計
ダッシュボード エディタ
基本モードと詳細モード: ダッシュボード エディタは、次の情報を使用して、集計の選択を Cloud Monitoring API で指定されたプライマリとセカンダリの集計フィールドにマッピングする方法を決定します。
- ウィジェット タイプ
- 指標の種類
- 指標の値の型
- ウィジェットの構成に使用するモード
カスタム ダッシュボードのグラフのマッピングを確認するには、
gcloud
コマンドライン ツールを使用してダッシュボードの構成を取得します。詳細については、ダッシュボードの一覧表示をご覧ください。MQL モード: これらのフィールドはアクセス可能です。
以前のダッシュボード エディタ
[Group By] オプションの例にあるように、すでに複数の時系列で集計が表されている場合は、[Secondary Aggregator] を選択すると時系列をさらに集計できます。
二次集計を行うことで、グラフのすべての時系列を 1 つに削減できます。
次のスクリーンショットでは、フィルタリングされたデータセットをグループ化した結果として、複数の時系列が表示されています。グループ化を使用するには集計が必要で、各行のグループが 1 つにまとめられます。次のスクリーンショットでは、ゾーンでグループ化した時系列が表示されています。
次のスクリーンショットは、二次集計を使用して、グループ化された時系列の平均値を求めた結果を表しています。
次のステップ
モニタリング対象リソースの詳細については、モニタリング対象リソースを参照してください。
定義済みの指標の一覧については、指標をご覧ください。
独自の指標の定義については、カスタム指標の使用をご覧ください。
凡例テンプレートの使用方法については、凡例テンプレートの構成をご覧ください。
外れ値モードを含む表示オプションの詳細については、表示オプションの設定をご覧ください。
グラフの使い方の詳細については、グラフデータの確認をご覧ください。