このドキュメントでは、Google Cloud によって割り当てられた割り当てをモニタリングするためのアラート ポリシーとグラフの作成方法について説明し、いくつかの例を紹介します。Google Cloud では、プロジェクトや組織によって消費されるリソースを追跡および制限するために使用できる、さまざまな割り当てが確立されています。数量に基づく割り当てと頻度に基づく割り当てに関する情報など、割り当ての詳細については、割り当ての操作をご覧ください。
始める前に
このページは、時系列データとその操作に精通していることを前提としています。次のリソースでは、追加情報を提供しています。
- 時系列データを操作については、フィルタリングと集計をご覧ください。
- ゲージ、デルタ、累積という用語の定義については、指標の種類をご覧ください。
- 時系列の結合に使用する関数の詳細については、
AlignerとReducerをご覧ください。
割り当て管理
Cloud Monitoring では、次の 2 つの方法で割り当てを管理します。
コンシューマー割り当て: このタイプの割り当てでは、モニタリング対象リソースは
consumer_quotaです。このリソースの指標は、serviceruntime指標のサブセットです。このページに挙げた例の多くはユーザー割り当てです。
リソース固有の割り当て: 一部のサービスは、割り当てのリソース固有の指標を持つモニタリング対象リソースを提供します。これらの指標タイプは 3 つのグループに表示され、命名形式に従います。
service/quota/quota-type/exceededservice/quota/quota-type/limitservice/quota/quota-type/usage
たとえば、Compute Engine には
compute.googleapis.com/VpcNetworkリソースがあります。このリソースに関連付けられた割り当て関連の指標は、compute指標のcompute.googleapis.com/quotaサブセットです。「VPC ネットワークあたりのインスタンス数」の割り当てに関連する指標タイプは 3 つあります。quota/instances_per_vpc_network/exceededquota/instances_per_vpc_network/limitquota/instances_per_vpc_network/usage
割り当て指標と上限名を特定する
割り当て使用量に関する元データ（特にユーザー割り当ての場合）には、多数の異なる割り当て情報が含まれている可能性があります。グラフまたはアラート ポリシーの特定の割り当て情報を抽出するには、割り当てデータのサブセットを特定する必要があります。
ソースによっては、割り当てデータに、必要な情報を分離するために使用できるラベルが含まれている場合があります。ラベルには次のものが含まれます。
- 割り当て指標: 割り当て指標は、割り当てのタイプを示す識別子です。指標リストで説明されている指標タイプの 1 つではありません。たとえば、ユーザー割り当てデータはすべて、
quota/allocation/usageのようなserviceruntime.googleapis.com指標タイプとして記述されます。この指標タイプには、割り当て対使用量のデータなどで特定の割り当てをフィルタリングするときに使用できるquota_metricラベルがあります。 - 上限名: 上限名は、特定の割り当てタイプに対する上限を示します。1 つの割り当てに複数の上限を設定できます。たとえば、読み取り呼び出しの割り当てとして、
readsPerMinuteとreadsPerDayという上限名を付け、1 分あたりの上限が 100、1 日あたりの上限が 1,000 という 2 つ上限を設定できます。割り当て関連の指標タイプには、この値としてlimit_nameフィールドが含まれる場合があります。
quota_metric ラベルはすべての serviceruntime.googleapis.com/quota 指標タイプに含まれますが、limit_name ラベルを含むのはその中の一部のみです。リソース固有の割り当て指標タイプには、limit_name ラベルが含まれます。
割り当て指標をサポートしていない Google Cloud サービスもあります。サービスが割り当て指標をサポートしているかどうかを判断し、割り当て固有のラベルの値を確認するには、次の手順を使用します。
Google Cloud Console で、管理者の [割り当て] ページに移動します。
view_column [列を表示] をクリックし、割り当て表示に次の列を追加します。
- 指標: この列には
quota_metricラベルの値が表示されます。 - 上限名: この列には
limit_nameラベルの値が表示されます。 - モニタリング対象リソース: 割り当てに達すると、割り当てに記載されているモニタリング対象リソースが使用されます。空の場合、割り当てのモニタリング対象リソースは
consumer_quotaです。
- 指標: この列には
目的の割り当てを見つけます。
たとえば、Compute Engine API のサブネットワーク割り当てでは、指標は
compute.googleapis.com/subnetworksとして、上限名はSUBNETWORKS-per-projectとして一覧表示されます。また、モニタリング対象リソースは一覧表示されません。したがって、この割り当てのモニタリング対象リソースはconsumer_quotaです。
例: 特定のコンシューマー割り当て指標の使用状況を表示する
Compute Engine の合計ディスク ストレージ割り当てをリージョン別に表示するグラフを作成することが目標です。このユーザー割り当ての例では、quota/allocation/usage データを取得した後、特定の割り当て指標の割り当て使用量が表示されるようにデータをフィルタリングします。
Google Cloud Console で [Cloud Monitoring] を選択し、Metrics Explorer を選択します。
[CONFIGURATION] タブを選択します。
ツールバーで [1M] を選択して期間を月に設定します。
[折れ線グラフ] メニューを展開し、[積み上げ棒グラフ] を選択します。
数量に基づく割り当て使用量を表示するように Metrics Explorer を構成します。
- [指標を選択] をクリックし、filter_list [フィルタバー] に「
allocation」と入力します。 - リソースに [Consumer 割り当て] を選択します。
- 指標カテゴリの [割り当て] を選択します。
- 指標の [Allocation quota usage] を選択し、[Apply] をクリックします。
グラフには、割り当て使用量が 6 週間の棒グラフとして表示されます。凡例を表示すると、グラフに複数のサービスの割り当て使用量が表示されます。
Cloud Monitoring API を使用する場合、同等のフィルタ値は次のとおりです。
metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota"このフィルタ値を表示するには、[リソースタイプ] メニューを展開し、[ダイレクト フィルタモード] を選択します。
- [指標を選択] をクリックし、filter_list [フィルタバー] に「
グラフを Compute Engine サービスに制限するには、フィルタ
service = compute.googleapis.comを追加します。
Cloud Monitoring API を使用する場合、同等のフィルタ値は次のとおりです。
metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota" resource.label.service="compute.googleapis.com"Compute Engine 割り当てに割り当てられている割り当て使用量の時系列がグラフに表示されます。凡例には、表示されている各時系列の
quota_metricラベルの値が表示されます。この値は特定の割り当てを示します。たとえば、compute.googleapis.com/disks_total_storageは時系列が Compute Engine の合計ディスク ストレージ割り当て用であることを示します。グラフには、使用状況を記録した割り当ての割り当て使用量のみが表示されます。たとえば、プロジェクトに Compute Engine リソースがない場合、
compute.googleapis.comサービスをフィルタリングすると、データのないグラフが作成されます。Compute Engine の合計ディスク ストレージの割り当て使用量を表示するグラフを作成するには、フィルタ
quota_metric = compute.googleapis.com/disks_total_storageを使用します。
Cloud Monitoring API を使用する場合、同等のフィルタ値は次のとおりです。
metric.type="serviceruntime.googleapis.com/quota/allocation/usage" resource.type="consumer_quota" metric.label.quota_metric="compute.googleapis.com/disks_total_storage"前のグラフでは、リージョン
us-central1とus-east1の時系列と、ゾーンus-central1-aを含む複数のゾーンの時系列が表示されています。ゾーンのデータを表示せずにリージョンのデータのみを表示するようにグラフを改良するには、
locationラベルに基づくフィルタを追加します。この例で、両方のリージョンがus-で始まり1で終わる場合、正規表現location =~ ^us.*1$を使用するフィルタが正常に機能します。
ユーザー割り当ての場合、quota_metric ラベルの値は、サービスとモニタリング対象の特定の割り当て使用量の両方を識別します。特定の割り当て指標をモニタリングするグラフまたはアラート ポリシーを作成する場合は、その情報を使用します。
Cloud Monitoring のアラート ポリシー
アラート ポリシーは、割り当て上限の 85% に達した場合などに通知を受け取れるよう Cloud Monitoring を構成する方法です。
アラート ポリシーとは、次のような条件と通知情報の集合です。
- 条件では、モニタリング対象、そのリソースの時系列データの結合方法、およびアラートの生成のタイミングを記述します。アラート ポリシーには少なくとも 1 つの条件の指定が必要です。
- 通知チャネルは、アラートが発生したときの通知先と通知方法を指定します。たとえば、特定のユーザーまたはグループにメールを送信するようにアラート ポリシーを構成できます。
アラート ポリシー条件を作成するには、次の 2 つの方法があります。
モニタリング フィルタを使用してデータを選択し、操作します。 たとえば、グラフィカル インターフェースでアラート ポリシー条件を作成する場合、フィルタが作成されます。割り当て指標に関する作業に示す例では、フィルタを使用してグラフのデータを選択します。Monitoring API へのリクエストでフィルタを使用することもできます。
MQL を使用してデータを選択して操作するMQL はテキストベースのクエリ言語です。MQL Query Editor を使用すると、フィルタベースの手法では作成できないクエリを作成できます。比率ベースのアラート ポリシーの作成には、MQL を使用することをおすすめします。詳細については、MQL アラート ポリシーの例をご覧ください。
このページでは、両方の手法について説明します。いずれかの手法でグラフを作成することもできます。
フィルタ アラート ポリシーの例
このセクションの各サブセクションには、アラート ポリシーの JSON 表現と、Google Cloud Console でポリシーを構成する方法を説明する 2 つのテーブルがあります。
- 最初の表は、モニタリング対象とデータの結合方法を示しています。
- 2 番目の表は、アラートが生成されるタイミングを示しています。
以下の例は、フィルタベースのアプローチを対象としています。
これらのポリシーはいずれも比率を計算しません。比率ベースの例については、MQL アラート ポリシーの例をご覧ください。
quota/exceeded エラーのアラート
Google Cloud プロジェクトのいずれかのサービスが割り当て超過エラーを報告している場合に通知するアラート ポリシーを作成できます。 このタイプのポリシーを作成するには、Google Cloud Console または Cloud Monitoring API を使用します。
Google Cloud Console の使用
このサブセクションの以降の内容は、アラート ポリシーの [Conditions] ダイアログについて説明します。
次の表の設定を使用して、[新しい条件] ダイアログを完成させます。これらの設定では、Google Cloud プロジェクトのすべてのサービスの serviceruntime 指標 /quota/exceeded の時系列データのモニタリング、および割り当て上限によるデータのグループ化を指定します。
| [新しい条件] ダイアログ フィールド |
値 |
|---|---|
| リソースと指標 | [Resources] メニューで、[Consumer Quota] を選択します。 [指標カテゴリー] メニューで、[割り当て] を選択します。 [指標] メニューで [割り当て超過エラー] を選択します。 （ metric.type は serviceruntime.googleapis.com/quota/exceeded、resource.type は consumer_quota です）。
|
| フィルタ |
フィルタを追加することで、モニタリングするサービスのデータのみがグラフに表示されます。たとえば、Identity and Access Management サービスをモニタリングするには、以下のフィルタを追加します。service = iam.googleapis.com。 フィルタ フィールドが空の場合、利用可能なすべての指標データがグラフに含まれます。 |
| ローリング ウィンドウ | 1 m を選択する |
| ローリング ウィンドウ関数 | count true を選択する
この指標は、 この指標では、 |
| 時系列全体 時系列集計 |
[ データがグループ化されると、集計フィールドは自動的に |
| 時系列全体 時系列のグループ化の基準 |
[ このオプションでは、 |
次の設定を使用して、[トリガーの設定] ダイアログを完成させます。これらの設定では、割り当て超過エラーの数が 1 分間 0 を超えると、アラート ポリシーがアラートを作成します。ここでは、値 0 が選択されています。これは、割り当て超過エラーは予期せず、割り当てを増やす必要があること、または API リクエストを減らすためにサービスを変更する必要があることを示しているためです。より高いしきい値を使用することもできます。
| [トリガーの設定] ダイアログ フィールド |
値 |
|---|---|
| 条件タイプ | Threshold |
| アラート トリガー | Any time series violates |
| しきい値の位置 | Above threshold |
| しきい値 | 0 |
| 再テスト ウィンドウ | 1 m |
Cloud Monitoring API の使用
このアラート ポリシーは、API メソッド alertPolicies.create を使用して作成できます。Cloud Monitoring API を直接呼び出すには、Google Cloud CLI を使用するか、クライアント ライブラリを使用します。詳細については、ポリシーの作成をご覧ください。
JSON または YAML のアラート ポリシーの表現の詳細については、サンプル ポリシーをご覧ください。
JSON 形式のこのアラート ポリシーの表現は以下のとおりです。
{
"combiner": "OR",
"conditions": [
{
"conditionThreshold": {
"aggregations": [
{
"alignmentPeriod": "60s",
"crossSeriesReducer": "REDUCE_SUM",
"groupByFields": [
"metric.label.quota_metric"
],
"perSeriesAligner": "ALIGN_COUNT_TRUE"
}
],
"comparison": "COMPARISON_GT",
"duration": "60s",
"filter": "metric.type=\"serviceruntime.googleapis.com/quota/exceeded\" resource.type=\"consumer_quota\"",
"trigger": {
"count": 1
}
},
"displayName": "Quota exceeded error by label.quota_metric SUM",
}
],
"displayName": "Quota exceeded policy",
}
絶対値 quota/allocation/usage でのアラート
Google Cloud プロジェクトの特定のサービスの割り当て量の使用率の割り当てがユーザー指定のしきい値を超えた場合に通知するアラート ポリシーを作成できます。 このタイプのポリシーを作成するには、Google Cloud Console または Cloud Monitoring API を使用します。
Google Cloud Console の使用
このサブセクションの以降の内容は、アラート ポリシーの [Conditions] ダイアログです。
次の表の設定を使用して、[新しい条件] ダイアログを完成させます。これらの設定では、Google Cloud プロジェクトの 1 つのサービスの serviceruntime 指標 /quota/allocation/usage の時系列データのモニタリング、および割り当て上限によるデータのグループ化を指定します。
| [新しい条件] ダイアログ フィールド |
値 |
|---|---|
| リソースと指標 | [Resources] メニューで、[Consumer Quota] を選択します。 [指標カテゴリー] メニューで、[割り当て] を選択します。 [Metrics] メニューで、[Allocation quota usage] を選択します。 （ metric.type は serviceruntime.googleapis.com/quota/allocation/usage、resource.type は consumer_quota です）。
|
| フィルタ |
フィルタを追加することで、モニタリングするサービスのデータのみがグラフに表示されます。たとえば、Identity and Access Management サービスをモニタリングするには、以下のフィルタを追加します。service = iam.googleapis.com。 フィルタ フィールドが空の場合、利用可能なすべての指標データがグラフに含まれます。 |
| ローリング ウィンドウ | 1440 m を選択する期間はこの指標のサンプリング間隔に一致します。 |
| ローリング ウィンドウ関数 | next older を選択するこの |
| 時系列全体 時系列集計 |
[ データがグループ化されると、集計フィールドは自動的に |
| 時系列全体 時系列のグループ化の基準 |
[ このオプションでは、 |
次の設定を使用して、[トリガーの設定] ダイアログを完成させます。これらの設定により、時系列の値が 1,440 分あたり 2.5 を超える場合に、アラート ポリシーでアラートが作成されます。1,440 分 の値は、ローリング ウィンドウと一致します。 2.5 の値はテストシステムの通常値よりわずかに高いため、この例では 2.5 が選択されています。モニタリングするサービスに基づいて、指標の値の想定範囲の理解と併せて、しきい値を選択する必要があります。
| [トリガーの設定] ダイアログ フィールド |
値 |
|---|---|
| 条件タイプ | Threshold |
| アラート トリガー | Any time series violates |
| しきい値の位置 | Above threshold |
| しきい値 | 2.5 |
| 再テスト ウィンドウ | 1440 m |
Cloud Monitoring API の使用
このアラート ポリシーは、API メソッド alertPolicies.create を使用して作成できます。Cloud Monitoring API を直接呼び出すには、Google Cloud CLI を使用するか、クライアント ライブラリを使用します。詳細については、ポリシーの作成をご覧ください。
JSON または YAML のアラート ポリシーの表現の詳細については、サンプル ポリシーをご覧ください。
JSON 形式のこのアラート ポリシーの表現は以下のとおりです。
{
"combiner": "OR",
"conditions": [
{
"conditionThreshold": {
"aggregations": [
{
"alignmentPeriod": "86400s",
"crossSeriesReducer": "REDUCE_SUM",
"groupByFields": [
"metric.label.quota_metric"
],
"perSeriesAligner": "ALIGN_NEXT_OLDER"
}
],
"comparison": "COMPARISON_GT",
"duration": "86400s",
"filter": "metric.type=\"serviceruntime.googleapis.com/quota/allocation/usage\" resource.type=\"consumer_quota\" resource.label.\"service\"=\"iam.googleapis.com\"",
"thresholdValue": 2.5,
"trigger": {
"count": 1
}
},
"displayName": "Allocation quota usage for iam.googleapis.com by label.quota_metric SUM",
}
],
"displayName": "Absolute quota usage policy",
}
MQL アラート ポリシーの例
MQL はテキストベースのクエリ言語であり、パイプでリンクされた一連のオペレーションを使用します。MQL では、Monitoring フィルタよりも強力で柔軟なクエリを構築できます。比率ベースのアラート ポリシーの設定には、MQL を使用することをおすすめします。たとえば、MQL ではレート割り当て使用量の比率を設定できます。これには、ゲージ指標（上限）とデルタ指標（レート）の比率を計算する必要があります。
MQL ベースのアラート ポリシーを作成するには、Google Cloud コンソールまたは Monitoring API を使用します。
Google Cloud コンソール: アラートの条件を作成するには、MQL Query Editor を使用します。Query Editor を表示するには、条件パネルの [指標] タブで [code Query Editor] をクリックします。このエディタの使用の詳細については、Query Editorの使用をご覧ください。
Monitoring API: メソッド
alertPolicies.createを使用して、MonitoringQueryLanguageCondition型の条件を指定します。この条件型は、フィールド値として MQL クエリを受け取ります。Monitoring API と MQL の使用の詳細については、MQL アラート ポリシーの条件の作成をご覧ください。
MQL に固有の情報については、Monitoring Query Language の使用をご覧ください。MQL ベースのアラート ポリシーの一般的な情報については、MQL のアラート ポリシーをご覧ください。
1 つの上限に対する頻度に基づく割り当ての使用量についての比率アラート
次の MQL クエリパターンは、特定のリソース サービスの 1 分あたりのレートが指定の上限の 80% を超えたときにモニタリングするアラートを記述しています。
fetch consumer_quota
| filter resource.service == 'sample.googleapis.com'
| { metric serviceruntime.googleapis.com/quota/rate/net_usage
| align delta_gauge(1m)
| group_by [resource.project_id, metric.quota_metric, resource.location],
sum(value.net_usage)
; metric serviceruntime.googleapis.com/quota/limit
| filter metric.limit_name == 'myApiLimitPerDay'
| group_by [resource.project_id, metric.quota_metric, resource.location],
sliding(1m), max(val()) }
| ratio
| every 1m
| condition gt(val(), 0.8 '1')
このクエリパターンを使用するには、次の変更を行います。
sample.googleapis.comは、モニタリングするサービスに置き換えます。metric.limit_nameのmyApiLimitPerDayは、追跡する上限に置き換えます。上限名の検索については、割り当て指標と上限名の特定をご覧ください。delta_gauge関数とsliding関数の1mを、上限に適したウィンドウに置き換えます。
クエリ結果内のデータポイント間の距離を決定する every 1m オペレーションを変更しないでください。
フィルタを使用してこのクエリを作成することはできません。
ワイルドカードを使用した頻度に基づく割り当ての使用量に関するアラート
MQL では、ワイルドカード、正規表現、ブール論理を使用したフィルタリングがサポートされています。たとえば、MQL を使用して、複数の制限を追跡し、しきい値を超えた場合警告を出すアラートを作成できます。
次の MQL クエリパターンは、1 分ごとまたは 1 日あたりのリソース サービスの使用率が 80% を超えたことをモニタリングするアラートを記述するものです。
fetch consumer_quota
| filter resource.service =~ '.*'
| { { metric serviceruntime.googleapis.com/quota/rate/net_usage
| align delta_gauge(1m)
| group_by [resource.project_id, metric.quota_metric, resource.location],
sum(value.net_usage)
; metric serviceruntime.googleapis.com/quota/limit
| filter metric.limit_name =~ '.*PerMinute.*'
| group_by [resource.project_id, metric.quota_metric, resource.location],
sliding(1m), max(val()) }
| ratio
; { metric serviceruntime.googleapis.com/quota/rate/net_usage
| align delta_gauge(23h)
| group_by [resource.project_id, metric.quota_metric, resource.location],
sum(value.net_usage)
; metric serviceruntime.googleapis.com/quota/limit
| filter metric.limit_name =~ '.*PerDay.*'
| group_by [resource.project_id, metric.quota_metric, resource.location],
sliding(23h), max(val()) }
| ratio }
| union
| every 1m
| condition gt(val(), 0.8 '1')
前のクエリでは、delta_gauge 整列指定子の引数は 1 日ではなく 23 時間に設定されています。MQL で必要となるのは 23 時間 30 分のデータのみです。計算上、delta_gauge 整列指定子はアライメント ウィンドウに 1 時間を追加します。delta_gauge(1d) を使用すると、条件に 25 時間分のデータが必要なため、条件を保存できません。この動作は、アライメント ウィンドウをパディングしない next_older 整列指定子とは異なります。
このクエリパターンを使用するには、次の変更を行います。
resource.serviceの正規表現を、トラッキングするサービスの正規表現に置き換えます。- 1 つめの比率では、次のようになります。
metric.limit_nameの.*PerMinute.*を、トラッキングする最初の上限グループの正規表現に置き換えます。上限名の検索については、割り当て指標と上限名の特定をご覧ください。delta_gauge関数とsliding関数の1mを、上限に適したウィンドウに置き換えます。
- 2 つめの比率では、次のようになります。
metric.limit_nameの.*PerDay.*を、トラッキングする 2 番目の上限グループの正規表現に置き換えます。delta_gauge関数とsliding関数の23hを、上限に適したウィンドウに置き換えます。
クエリ結果内のデータポイント間の距離を決定する every 1m オペレーションを変更しないでください。
フィルタを使用してこのクエリを作成することはできません。
1 つの上限に対する数量に基づく割り当ての使用量についての比率アラート
次の MQL クエリパターンは、特定のリソース サービスの 1 日の数量に基づく割り当て使用量が特定の上限の 80% を超えたときにモニタリングするアラートを記述します。
fetch consumer_quota
| filter resource.service == 'sample.googleapis.com'
| { metric serviceruntime.googleapis.com/quota/allocation/usage
| align next_older(1d)
| group_by [resource.project_id, metric.quota_metric, resource.location],
max(val())
; metric serviceruntime.googleapis.com/quota/limit
| filter metric.limit_name == 'CPUs-per-project'
| align next_older(1d)
| group_by [resource.project_id, metric.quota_metric, resource.location],
min(val())
}
| ratio
| every 1m
| condition gt(val(), 0.8 '1')
このクエリパターンを使用するには、次の変更を行います。
sample.googleapis.comは、モニタリングするサービスに置き換えます。metric.limit_nameのCPUs-per-projectは、追跡する上限に置き換えます。上限名の検索については、割り当て指標と上限名の特定をご覧ください。
クエリ結果内のデータポイント間の距離を決定する every 1m オペレーションを変更しないでください。
例: 任意のリージョンでの CPU 使用率 75%
次のクエリで、Compute Engine VM インスタンスの CPU 使用量が、任意のリージョンで上限の 75% を超えたときに起動するアラート ポリシーを作成します。
fetch consumer_quota
| filter resource.service == 'compute.googleapis.com'
| { metric serviceruntime.googleapis.com/quota/allocation/usage
| align next_older(1d)
| group_by [resource.project_id, metric.quota_metric, resource.location],
max(val())
; metric serviceruntime.googleapis.com/quota/limit
| filter metric.limit_name == 'CPUS-per-project-region'
| align next_older(1d)
| group_by [resource.project_id, metric.quota_metric, resource.location],
min(val())
}
| ratio
| every 1m
| condition gt(val(), 0.75 '1')
このユーザー割り当てポリシーでは、Compute Engine API の「CPU」割り当てで CPUS-per-project-region の上限名を使用します。上限名を見つける方法については、割り当て指標と上限名の特定をご覧ください。
いずれかのサービスの数量に基づく割り当ての使用量に関する比率アラート
MQL では、ワイルドカード、正規表現、ブール論理を使用したフィルタリングがサポートされています。たとえば、MQL を使用して、複数の上限やサービスを追跡するアラートを作成し、しきい値を超えると警告が出るようにすることができます。
次の MQL クエリは、いずれかのリソース サービスの 1 日あたりの数量に基づく割り当て使用量が、割り当て上限の 80% を超えたときにモニタリングするアラートを記述します。
fetch consumer_quota
| filter resource.service =~ '.*'
| { metric serviceruntime.googleapis.com/quota/allocation/usage
| align next_older(1d)
| group_by [resource.project_id, metric.quota_metric, resource.location],
max(val())
; metric serviceruntime.googleapis.com/quota/limit
| align next_older(1d)
| group_by [resource.project_id, metric.quota_metric, resource.location],
min(val())
}
| ratio
| every 1m
| condition gt(val(), 0.8 '1')
このクエリをそのまま使用することも、resource.service の正規表現をトラッキングするサービスの正規表現に置き換えることもできます。特定のサービスでフィルタリングし、上限フィルタでワイルドカードを使用することもできます。
クエリ結果内のデータポイント間の距離を決定する every 1m オペレーションを変更しないでください。
例: 特定のゾーンの CPU 使用率が 50% を超えた
次のクエリで、Compute Engine VM インスタンスの CPU 使用率が任意の us-central1 ゾーンの上限の 50% を超えると起動するアラート ポリシーを作成します。このクエリは、limit データを上限名とリソース ロケーションでフィルタリングします。
fetch consumer_quota
| filter resource.service == 'compute.googleapis.com'
| { metric serviceruntime.googleapis.com/quota/allocation/usage
| align next_older(1d)
| group_by [resource.project_id, metric.quota_metric, resource.location],
max(val())
; metric serviceruntime.googleapis.com/quota/limit
| filter metric.limit_name == 'CPUS-per-project-zone' &&
resource.location =~ 'us-central1-.*'
| align next_older(1d)
| group_by [resource.project_id, metric.quota_metric, resource.location],
min(val())
}
| ratio
| every 1m
| condition gt(val(), 0.50 '1')
このユーザー割り当てポリシーでは、Compute Engine API の「CPU」割り当てで CPUS-per-project-zone の上限名を使用します。上限名を見つける方法については、割り当て指標と上限名の特定をご覧ください。
リソース固有の割り当てを使用する比率アラート
MQL を使用すると、リソース固有の割り当て関連指標の比率を設定できます。この場合、サービス固有のモニタリング対象リソースを指定して、リソース固有の割り当て関連指標のペアに占める比率を計算します。
次のクエリは、割り当ての使用量が上限の 80% を超えたことをモニタリングするアラートを記述します。
fetch sample.googleapis.com/SampleResource
| { metric sample.googleapis.com/quota/samplemetric/usage
| align next_older(1d)
| group_by [resource.label_1, ... , resource.label_n,
metric.label_1, ... , metric.label_n],
max(val())
; metric sample.googleapis.com/quota/samplemetric/limit
| align next_older(1d)
| group_by [resource.label_1, ... , resource.label_n,
metric.label_1, ... , metric.label_n],
min(val())
}
| ratio
| every 1m
| condition gt(val(), 0.8 '1')
このクエリパターンを使用するには、次の変更を行います。
sample.googleapis.comは、モニタリングするサービスに置き換えます。sampleResourceは、関連するモニタリング対象リソースに置き換えます。samplemetricは、指標タイプのグループの文字列に置き換えます。group_byオペレーションで、各リソースラベルと指標ラベルを一覧表示します。
例: 任意のリージョンでの CPU 使用率 75%
たとえば、次の MQL クエリは、任意のネットワーク ID の Compute Engine の instances_per_vpc_network 割り当てが 80% を超えたときにモニタリングするアラートを設定します。
fetch compute.googleapis.com/VpcNetwork
| { metric compute.googleapis.com/quota/instances_per_vpc_network/usage
| align next_older(1d)
| group_by [resource.resource_container, metric.limit_name,
resource.location, resource.network_id],
max(val())
; metric compute.googleapis.com/quota/instances_per_vpc_network/limit
| align next_older(1d)
| group_by [resource.resource_container, metric.limit_name,
resource.location, resource.network_id],
min(val())
}
| ratio
| every 1m
| condition gt(val(), 0.80 '1')
このクエリでは consumer_quota ではなくリソースタイプ compute.googleapis.com/VpcNetwork が使用されており、2 つの compute.googleapis.com/quota/instances_per_vpc_network 指標（usage と limit）の比率が取られます。
グラフの例
グラフには、時系列データが表示されます。Metrics Explorer を使用して、グラフを作成できます。 Metrics Explorer では、不要になったチャートの破棄や、ダッシュボードへの保存ができます。ダッシュボード ビューでは、グラフをダッシュボードに追加できます。
割り当てデータを表示するグラフのみを構成する場合は、[新しい条件] テーブルの設定を使用できます。アラート条件、Metrics Explorer、ダッシュボード エディタでは、若干異なる表記が使用されます。| [新しい条件] ダイアログの フィールド名 |
ダッシュボード エディタ （[詳細] タブ） |
Metrics Explorer |
|---|---|---|
| ローリング ウィンドウ関数 | アライメント関数 | 詳細オプション Aligner |
| ローリング ウィンドウ | アライメント期間 | 最小アライメント期間 |
| 時系列全体 時系列のグループ化の基準 |
グループ条件 | グループ条件 |
| 時系列全体 時系列集計 |
関数でグループ化 | Aggregator |
quota/allocation/usage の時間間隔あたりの最大使用量
Google Cloud プロジェクトのすべてのサービスで、データが割り当て指標の名前でグループ化され、25 時間間隔あたりの指標の最大値が表示されるように、serviceruntime 指標 quota/allocation/usage の時系列データを表示するには、次の設定を使用します。
| [新しい条件] ダイアログ フィールド |
値 |
|---|---|
| リソースと指標 | [Resources] メニューで、[Consumer Quota] を選択します。 [指標カテゴリー] メニューで、[割り当て] を選択します。 [Metrics] メニューで、[Allocation quota usage] を選択します。 （ metric.type は serviceruntime.googleapis.com/quota/allocation/usage、resoure.type は consumer_quota です）。
|
| フィルタ |
フィルタを追加することで、モニタリングするサービスのデータのみがグラフに表示されます。たとえば、Identity and Access Management サービスをモニタリングするには、以下のフィルタを追加します。service = iam.googleapis.com。 フィルタ フィールドが空の場合、利用可能なすべての指標データがグラフに含まれます。 |
| ローリング ウィンドウ | 1500 m を選択する期間（25 時間）は、この指標のサンプリング間隔よりわずかに長くなります。 |
| ローリング ウィンドウ関数 | [max] を選択します。セカンダリ アグリゲータ: sum
整列指定子は、アライメント期間中に測定された指標の最大値を表示するように設定されています。セカンダリ アグリゲータは、さまざまなサービスの時系列を 1 つの時系列に結合します。 |
| 時系列全体 時系列集計 |
[ データがグループ化されると、集計フィールドは自動的に |
| 時系列全体 時系列のグループ化の基準 |
[ このオプションでは、 |
quota/rate/net_usage の時系列
Google Cloud プロジェクトのすべてのサービスで、データが割り当て指標の名前でグループ化され、使用率が表示されるように、serviceruntime 指標 quota/rate/net_usage の時系列データを表示するには、次の設定を使用します。
| [新しい条件] ダイアログ フィールド |
値 |
|---|---|
| リソースと指標 | [Resources] メニューで、[Consumer Quota] を選択します。 [指標カテゴリー] メニューで、[割り当て] を選択します。 [指標] メニューで [レートに基づく割り当てを使用] を選択します。 （ metric.type は serviceruntime.googleapis.com/quota/rate/net_usage、resoure.type は consumer_quota です）。
|
| フィルタ |
フィルタを追加することで、モニタリングするサービスのデータのみがグラフに表示されます。たとえば、Identity and Access Management サービスをモニタリングするには、以下のフィルタを追加します。service = iam.googleapis.com。 フィルタ フィールドが空の場合、利用可能なすべての指標データがグラフに含まれます。 |
| ローリング ウィンドウ | 1 m を選択する1 分間の期間が、この指標のサンプリング間隔と一致します。 |
| ローリング ウィンドウ関数 | rate を選択する
整列指定子を |
| 時系列全体 時系列集計 |
[ データがグループ化されると、集計フィールドは自動的に |
| 時系列全体 時系列のグループ化の基準 |
[ このオプションでは、 |
quota/limit の時系列
Google Cloud プロジェクトのすべてのサービスで、25 時間以上のデータが集計されるように、serviceruntime 指標 quota/limit の時系列データを表示するには、次の設定を使用します。
| [新しい条件] ダイアログ フィールド |
値 |
|---|---|
| リソースと指標 | [Resources] メニューで、[Consumer Quota] を選択します。 [指標カテゴリー] メニューで、[割り当て] を選択します。 [Metrics] メニューで [Quota limit] を選択します。 （ metric.type は serviceruntime.googleapis.com/quota/limit、resoure.type は consumer_quota です）。
|
| フィルタ |
フィルタを追加することで、モニタリングするサービスのデータのみがグラフに表示されます。たとえば、Identity and Access Management サービスをモニタリングするには、以下のフィルタを追加します。service = iam.googleapis.com。 フィルタ フィールドが空の場合、利用可能なすべての指標データがグラフに含まれます。 |
| ローリング ウィンドウ | 1500 m を選択する |
| ローリング ウィンドウ関数 | next older を選択するこの |
| 時系列全体 時系列集計 |
none
|
| 時系列全体 時系列のグループ化の基準 |
空白のままにする。 |
quota/instances_per_vpc_network/limit の時系列
Google Cloud プロジェクトのすべてのネットワークについて compute.googleapis.com 指標 quota/instances_per_vpc_network/limit の時系列データを表示するには、次の設定を使用します。
| [新しい条件] ダイアログ フィールド |
値 |
|---|---|
| リソースと指標 | [リソースタイプ] メニューで、[VPC ネットワーク] を選択します。 [指標カテゴリ] メニューで、[割り当て] を選択します。 [Metric] メニューで [Instances per VPC Network quota limit] を選択します。 （ metric.type は compute.googleapis.com/quota/instances_per_vpc_network/limit、resource.type は compute.googleapis.com/VpcNetwork です）。
|
| フィルタ | 空白のままにする。 |
| ローリング ウィンドウ | 1 m を選択する期間はこの指標のサンプリング間隔に一致します。 |
| ローリング ウィンドウ関数 | mean を選択する |
| 時系列全体 時系列集計 |
none のままにします。
|
| 時系列全体 時系列のグループ化の基準 |
空白のままにする。 |
quota/instances_per_vpc_network/usage の時系列
Google Cloud プロジェクトのネットワークのうちの 1 つについて、compute.googleapis.com 指標 quota/instances_per_vpc_network/usage の時系列データを表示するには、次の設定を使用します。
| [新しい条件] ダイアログ フィールド |
値 |
|---|---|
| リソースと指標 | [リソースタイプ] メニューで、[VPC ネットワーク] を選択します。 [指標カテゴリ] メニューで、[割り当て] を選択します。 [Metric] メニューで [Instances per VPC Network quota usage] を選択します。 （ metric.type は compute.googleapis.com/quota/instances_per_vpc_network/usage、resource.type は compute.googleapis.com/VpcNetwork です）。
|
| 指標 | [Metric] メニューで [compute.googleapis.com/quota/instances_per_vpc_network/usage] を選択します。 |
| フィルタ |
すべてのデータのサブセットのみがグラフに表示されるよう、フィルタを追加します。たとえば、特定のネットワークの使用状況を表示するには、次のフィルタを追加します。network_id = identifier フィルタ フィールドが空の場合、利用可能なすべての指標データがグラフに含まれます。 |
| ローリング ウィンドウ | 1 m を選択する期間はこの指標のサンプリング間隔に一致します。 |
| ローリング ウィンドウ関数 | mean を選択する |
| 時系列全体 時系列集計 |
none のままにします。
|
| 時系列全体 時系列のグループ化の基準 |
空白のままにする。 |
MQL グラフ
MQL Query Editor を使用して、MQL クエリを使用してグラフを作成できます。たとえば、MQL アラート ポリシーの例に表示されているクエリを Query Editor に入力できます。各クエリで最後のオペレーション condition を省略できます。これは、アラート ポリシーの条件を作成する場合を除いて適用されます。グラフでは、condition オペレーションは何も行いません。
詳細については、Query Editor の使用と MQL の例をご覧ください。