このページでは、指標選択ツールを使用してアラート ポリシーのターゲット指標を指定する方法について説明します。[Target] リージョンの横にあるグラフでは、ターゲットによってキャプチャされたデータに関する視覚的フィードバックが提供されます。
[Target] リージョンでは、Metrics Explorer およびグラフの作成で使用されているのと同じ指標セレクタが使用されます。すでに指標セレクタに慣れている場合は、このページをスキップできます。
指標の選択
指標を選択するには、[Find resource type and metric] フィールドを使用して、リソースタイプと指標タイプを 1 つずつ選択します。どちらを先に選択してもかまいません。まず、フィールドをクリックします。前の選択に応じて、1 つまたは 2 つのリストが表示されます。次のスクリーンショットのように、リストのヘッダーに Resource types または Metrics が表示されます。
次のいずれかの方法でエントリを選択します。
- リストからエントリを選択する。
- 直接入力して候補リストを検索する（カスタム指標を含む）。
カスタム指標を検索するには、検索ボックスに「custom」と入力します。
いずれかのリストの項目にカーソルを合わせるとツールチップが開き、その項目の記述子に含まれる情報が表示されます。指標タイプまたはモニタリング対象リソースの記述子については、指標の一覧、モニタリング対象リソースの一覧をそれぞれご覧ください。
リソースタイプと指標のペアを 1 つ以上選択すると、グラフには使用可能なすべての時系列が表示されます。[Metric] タブには、指定した指標の下に追加項目が表示されます。次のスクリーンショットは、1 つの指標を指定した後の [Metric] タブを示しています。
フィルタリング
フィルタ条件を指定すると、指標に対して返されるデータの量を減らし、一定の条件を満たす時系列のみを使用できます。フィルタリングを行うとフィルタ条件を満たしていない時系列が除外されるため、グラフのデータを削減できます。その結果、この指標を表示するグラフ上の線が減り、グラフのパフォーマンスが向上します。
複数のフィルタ条件を指定できます。対応するグラフには、条件をすべて満たす（論理 AND）時系列だけが表示されます。
[Filter] フィールド内をクリックすると、フィルタ条件のリストが含まれているパネルが表示されます。大まかに言うと、リソース グループ、名前、リソースラベル、指標ラベルでフィルタリングできます。
次のスクリーンショットでは、プロジェクトのラベルでフィルタリングを設定しています。
条件をリストから選択することも、直接入力することもできます。まだ表示されていないデータのフィルタを作成することもできます。このようなフィルタ条件は選択リストに表示されませんが、今後有効になることがわかっている場合は手動で指定できます。
フィルタリングするラベルを選択したら、フィルタの残りの部分（値または値の範囲と比較演算子）を指定します。
たとえば、次のスクリーンショットには zone リソースラベルに設定したフィルタが示されています。[Filter] フィールドで使用できる比較演算子には、等式 = と =~ のペアと、不等式 != と !=~ のペアがあります。各ペアの 2 番目の項目は、値として正規表現を取ります。デフォルトは、単純な等式（=）です。
比較演算子のリストの下にあるのは、使用可能な値のリストです。次のスクリーンショットには、プロジェクト内のゾーンの名前が示されています。
[Value] フィールドでは、プルダウン リストにあるいずれかの項目を選択できます。あるいは、複数の項目と一致する式を入力することもできます。
=または!=を使用して直接比較する場合は、starts_withのようなフィルタ文字列を作成できます。たとえば、フィルタ文字列starts_with("us-central")は任意のus-centralゾーンと一致します。
フィルタ文字列に関する詳細については、モニタリング フィルタをご覧ください。
=~または!=~を選択する場合は、値に正規表現を含めることができます。たとえば、正規表現us-central1-.*は任意のus-central1ゾーンと一致します。
正規表現
^us.*.a$は、名前が「a」で終わる任意の US ゾーンと一致します。
複数のフィルタ条件を指定できます。また、同じラベルを複数回使用することもできます。これにより、特定の値の範囲をフィルタリングできます。さらにフィルタを追加するには、フィルタ フィールドの下部にある [Add a filter] をクリックします。現時点では、すべてのフィルタ条件を満たす必要があるため、論理演算子 AND を使用した場合と同じになります。たとえば、フィルタ文字列 starts_with と ends_with の両方を使用して、US 内の「a」ゾーンのみを表示できます。
グループ化
類似の時系列のデータを結合すると、指標に対して返されるデータの量を削減できます。
フィルタリングと同様に、グループ化でも操作するデータの量を少なくできます。フィルタリングは一部の時系列を除外することでデータ量を削減しますが、グループ化では、特定の条件を満たす時系列セットを見つけて結合（集計）することでデータ量を削減します。
グループ化はラベルに基づいて行われます。[Group By] フィールドをクリックすると、フィルタリングに使用できるものと同じラベルが表示されます。
[Group By] オプションを使用すると、リソースと指標のラベル別に時系列をグループ化し、それぞれのグループ内でデータを結合できます。これにより、グループ別の値の組み合わせごとに 1 つの新しい時系列が作成され、その新しい時系列がグループのすべてのメンバーを表します。
たとえば、ロギングの負荷を調査するときに、リージョン単位でのみテストを行う場合について考えてみましょう。ここでは、特定のサーバーからのエントリ数は考慮しません。時系列をゾーンでグループ化すると、各ゾーンの合計、平均または他の尺度をグラフに表示できます。
[Group By] を使用すると、グループ化するデータの種類に基づいてデフォルトの集計関数が選択されますが、この選択は変更できます。他の選択項目については、集計をご覧ください。
次のスクリーンショットでは、ゾーンでグループ化を行っています。[Aggregator] の下にある [sum] がデフォルトの選択項目です。
これにより、各ゾーンに新しい時系列が作成され、そのゾーンの個々の時系列のすべての値が合計されます。
また、複数のラベルでグループ化することもできます。複数のラベルでグループ化すると、ラベルの組み合わせごとに時系列が作成されます。ラベルの指定順序は関係ありません。
グループ別条件を削除するには、次の操作を行います。
- グループ別ラベルを削除します。
- 集計メソッドを
noneに戻します。
集計
[Aggregator] オプションを選択すると、共通の関数を使用して時系列を結合できます。その結果、指標を表示するグラフ上の線が少なくなり、グラフのパフォーマンスが向上します。
[Aggregator] フィールドをクリックすると、選択可能な集計オプションの一覧が表示されます。この一覧に表示されるのは、時系列の結合に使用できる関数（レデューサ）です。
使用可能な削減関数は指標で収集される値の種類によって異なりますが、通常は、平均、最大または最小、標準偏差、パーセンタイルなどの選択肢があります。関数の依存関係の詳細については、指標、時系列、リソースをご覧ください。
グループ化を行わないと、選択したすべての時系列に削減関数が適用され、すべての時系列で計算された平均、合計などの尺度から構成される単一の時系列に結合されます。グループ化を行うと、各グループ内の時系列に関数が適用されます。
集計の詳細については、API リファレンスの Aggregation をご覧ください。
[Group By] オプションを使用すると、集計が自動的に適用され、各グループ内の統計が計算されます。Group By グラフの線は、すでに集計を表しています。[Group By] を使用すると、グループ化するデータの種類に基づいてデフォルトの集計関数が選択されますが、この選択は変更できます。
集計は、すでにフィルタリングした時系列セットにも適用できます。フィルタリングされた時系列の集計では、フィルタリングされていない時系列と同様に、グループ化を併用していない限り、選択した集計関数が反映されて行が 1 つに削減されます。
指標を選択するための追加オプションも用意されています。追加オプションにはデフォルト値が設定されていますが、このオプションを確認してデフォルトをオーバーライドできます。追加オプションを確認するには、[Show advanced options] をクリックしてください。
アライメント
時系列とは、データポイントを時間順にまとめたものです。時系列をアライメントするには、データポイントを一定の時間間隔（アライメント期間）に分割します。複数の時系列を結合する前に、アライメントを行う必要があります。
アライメントは時系列の集計の前提条件であり、各時系列に別々に適用されます。アライメントはデータをグラフ化する際の前提条件であるため、Stackdriver によりデフォルト値を使用して自動的に適用されます。デフォルトをオーバーライドするには、アライメント オプションの [Aligner] と [Alignment Period] を使用します。
Alignment Period: アライメント期間は、時系列をさらに細かく分割するための時間の長さを決定します。たとえば、1 つの時系列を 1 分単位や 1 時間単位に分割できます。各期間のデータは要約され、単一の値でその期間が表されるようになります。デフォルトのアライメント期間は 1 分です。
データのアライメント間隔を設定できますが、グラフに表示する時間間隔やズームレベルを変更すると、時系列がアライメントし直される場合があります。
Aligner:
整列指定子は、各アライメント期間でのデータの要約方法を決定する機能です。整列指定子には合計や平均などが含まれます。整列指定子の有効な選択肢は、時系列で格納する指標データの種類によって異なります。つまり、整列指定子の選択肢は時系列の MetricKind と ValueType に依存します。
一部の整列指定子は、データの整列と別の種類の指標への変換の両方を行います。使用可能な整列指定子の詳細については、API リファレンスの Aligner をご覧ください。
二次集計
[Group By] オプションの例にあるように、すでに複数の時系列で集計が表されている場合は、[Secondary Aggregator] を選択すると時系列をさらに集計できます。
二次集計を行うことで、グラフのすべての時系列を 1 つに削減できます。
凡例テンプレート
[Legend Template] フィールドを使用すると、グラフの時系列の説明をカスタマイズできます。この説明は、グラフのポップアップ カードや [Name] 列のグラフの凡例に表示されます。
デフォルトでは、この説明は時系列のさまざまなラベルの値から自動的に作成されます。システムによってラベルが選択されるため、結果が適切ではない場合があります。このフィールドを使用すると、説明のテンプレートを自分で作成できます。
[Legend Template] フィールドに入力できる内容は次のとおりです。
- 書式なしテキスト
- 時系列のラベルを表す変数。使用可能なラベルはグラフ化する時系列によって異なりますが、通常、変数の構文は
${resource.labels.project_id}のようになります。${}と表記することで、変数が説明の中で評価されます。
テキストだけを指定すると、グラフ上の時系列の説明はどれも同じになります。変数を使用することで、時系列のラベルから説明に値を pull できます。
変数名がわかっている場合は、テンプレート フィールドに手動で入力できます。フィールド内の [+ Add a filter] ウイジェットを使用して、使用可能なラベルの変数を選択することもできます。この方法を使うと、変数の構文を正しく入力できます。
次のスクリーンショットは、1 つの文字列と 1 つの変数で構成されるテンプレートを示しています。
グラフの凡例では、テンプレートから生成された値は [Name] という見出しの列に表示されます。この値はポップアップ カードにも表示されます。
次のスクリーンショットは、テンプレートから生成された [Name] の値とポップアップ カードを示しています。
複数の文字列と変数を使用するテンプレートも作成できますが、ポップアップ カードの表示スペースには制限があります。