ツール: get_alert_policy
特定のアラート ポリシーに関する情報を取得する主なツールとして使用します。アラート ポリシーは、サービスの問題について通知を受け取る条件を定義します。これは、特定のアラート構成の詳細を把握するのに役立ちます。
次のコードサンプルは、curl を使用して get_alert_policy MCP ツールを呼び出す方法を示しています。
| Curl リクエスト |
|---|
curl --location 'https://monitoring.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "get_alert_policy", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
入力スキーマ
GetAlertPolicy リクエストのプロトコル。
GetAlertPolicyRequest
| JSON 表現 |
|---|
{ "name": string } |
| フィールド | |
|---|---|
name |
必須。取得するアラート ポリシー。書式は次のとおりです。 |
出力スキーマ
システムのある側面を「異常」とみなす条件と、その状態を人やサービスに通知する方法の説明。アラート ポリシーの概要については、アラートの概要をご覧ください。
AlertPolicy
| JSON 表現 |
|---|
{ "name": string, "displayName": string, "documentation": { object ( |
| フィールド | |
|---|---|
name |
ID。ポリシーが存在する場合は必須です。このポリシーのリソース名。書式は次のとおりです。
|
displayName |
ダッシュボード、通知、インシデントでポリシーを識別するために使用される略称またはフレーズ。混乱を避けるため、同じプロジェクト内の複数のポリシーに同じ表示名を使用しないでください。名前は 512 文字の Unicode 文字に制限されています。 PrometheusQueryLanguageCondition の display_name の慣例は「{rule group name}/{alert name}」です。{rule group name} と {alert name} は、対応する Prometheus 構成ファイルから取得する必要があります。この規則は強制ではありません。いずれにしても、display_name は AlertPolicy の一意のキーではありません。 |
documentation |
このポリシーに関連する通知とインシデントに含まれるドキュメント。ベスト プラクティスは、アラート ポリシーで検出された根本的な問題を理解、軽減、エスカレーション、修正する際に役立つ情報をドキュメントに含めることです。容量が制限されている通知チャネルでは、このドキュメントが表示されないことがあります。 |
userLabels |
このフィールドには最大 64 個のエントリを含めることができます。各キーと値は、63 個の Unicode 文字または 128 バイトのいずれか小さいほうに制限されます。ラベルと値には、英小文字、数字、アンダースコア、ダッシュのみを使用できます。キーの先頭は文字にする必要があります。 Prometheus の {alert name} は有効な Prometheus ラベル名ですが、Prometheus の {rule group} は制限のない UTF-8 文字列です。ユーザーラベルの値として使用できない文字が含まれている可能性があるため、そのままユーザーラベルに保存することはできません。
|
conditions[] |
ポリシーの条件のリスト。条件は、 |
combiner |
複数の条件の結果を組み合わせて、インシデントを開く必要があるかどうかを判断する方法。 |
enabled |
ポリシーが有効かどうか。書き込み時に、未設定の場合のデフォルトの解釈は、ポリシーが有効になっていることです。読み取り時に、状態が入力されていない場合、クライアントは状態について何も想定してはなりません。フィールドの投影で削除が指定されていない限り、このフィールドは List オペレーションと Get オペレーションで常に設定されます。 |
validity |
アラート ポリシーが無効である理由の説明(読み取り専用)。このフィールドは、アラート ポリシーが無効な場合にのみ設定されます。無効なアラート ポリシーではインシデントは生成されません。 |
notificationChannels[] |
インシデントが開かれたとき、閉じられたとき、またはすでに開いているインシデントで新しい違反が発生したときに通知を送信する通知チャネルを特定します。この配列の各要素は、 |
creationRecord |
アラート ポリシーの作成の読み取り専用レコード。作成または更新の呼び出しで指定された場合、このフィールドは無視されます。 |
mutationRecord |
アラート ポリシーに対する最新の変更の読み取り専用レコード。作成または更新の呼び出しで指定された場合、このフィールドは無視されます。 |
alertStrategy |
このアラート ポリシーの通知チャネルに通知する方法を制御します。 |
severity |
省略可。アラート ポリシーの重大度は、そのポリシーによって生成されたインシデントの重要度を示します。重大度は、インシデントの詳細ページと通知に表示されます。 |
ドキュメント
| JSON 表現 |
|---|
{
"content": string,
"mimeType": string,
"subject": string,
"links": [
{
object ( |
| フィールド | |
|---|---|
content |
ドキュメントの本文。 |
mimeType |
|
subject |
省略可。通知の件名。件名は 10,240 バイトを超えないようにしてください。このポリシーによって生成される通知では、変数が展開された後の件名の内容が、最新の UTF-8 文字境界で 255 バイト以下に切り捨てられます。255 バイトの上限は、このスレッドで推奨されています。これは、一部のサードパーティ チケット発行プロダクトによって課せられる制限であり、データベースでテキスト フィールドを VARCHAR(255) として定義するのが一般的です。 件名の内容は、変数を使用してテンプレート化できます。このフィールドがない場合や空の場合は、デフォルトの件名が生成されます。 |
links[] |
省略可。ハンドブック、リポジトリ、その他のリソースなどのコンテンツへのリンク。このフィールドには最大 3 つのエントリを含めることができます。 |
リンク
| JSON 表現 |
|---|
{ "displayName": string, "url": string } |
| フィールド | |
|---|---|
displayName |
リンクの短い表示名。表示名は空にしたり、63 文字を超えたりすることはできません。例: "playbook"。 |
url |
ウェブページの URL。パスまたはクエリ パラメータで変数を使用すると、URL をテンプレート化できます。URL の合計長は、変数の展開の前と後で 2,083 文字を超えないようにする必要があります。例: "https://my_domain.com/playbook?name=${resource.name}" |
UserLabelsEntry
| JSON 表現 |
|---|
{ "key": string, "value": string } |
| フィールド | |
|---|---|
key |
|
value |
|
条件
| JSON 表現 |
|---|
{ "name": string, "displayName": string, // Union field |
| フィールド | |
|---|---|
name |
条件が存在する場合は必須。この条件の一意のリソース名。形式は次のとおりです。
条件のしきい値、期間、トリガー値などの小さな変更のみを行う場合は、 |
displayName |
ダッシュボード、通知、インシデントで条件を識別するために使用される略称またはフレーズ。混乱を避けるため、同じポリシー内の複数の条件に同じ表示名を使用しないでください。 |
共用体フィールド condition。次の条件タイプのいずれか 1 つのみが指定されます。condition は次のいずれかになります。 |
|
conditionThreshold |
時系列をしきい値と比較する条件。 |
conditionAbsent |
時系列が新しいデータポイントを引き続き受信していることを確認する条件。 |
conditionMatchedLog |
指定された制約に一致するログメッセージをチェックする条件。設定されている場合、他の条件は指定できません。 |
conditionMonitoringQueryLanguage |
Monitoring Query Language を使用してアラートを定義する条件。 |
conditionPrometheusQueryLanguage |
Prometheus クエリ言語を使用してアラートを定義する条件。 |
conditionSql |
SQL クエリの結果を定期的に評価する条件。 |
MetricThreshold
| JSON 表現 |
|---|
{ "filter": string, "aggregations": [ { object ( |
| フィールド | |
|---|---|
filter |
必須。しきい値と比較する時系列を識別するフィルタ。 フィルタは、 |
aggregations[] |
個々の時系列のデータポイントの調整と、取得した時系列を結合する方法(各リソースの複数のストリームを各リソースの単一のストリームに集計する場合や、リソース グループのすべてのメンバーのストリームを集計する場合など)を指定します。複数の集計は、指定された順序で適用されます。 このフィールドは、 |
denominatorFilter |
しきい値と比較する比率の分母として使用する時系列を識別するフィルタ。 フィルタには指標タイプを指定する必要があります。また、必要に応じてリソースタイプ、リソースラベル、指標ラベルの制限を含めることができます。このフィールドの長さは 2,048 Unicode 文字を超えてはなりません。 |
denominatorAggregations[] |
比率を計算する場合、 |
forecastOptions |
このフィールドが存在する場合、 |
comparison |
時系列( 現在サポートされているのは |
thresholdValue |
時系列の比較対象となる値。 |
duration |
必須。時系列がしきい値に違反してから、障害とみなされるまでの時間。現在、サポートされているのは 1 分の倍数の値(0、60、120、300 秒など)のみです。無効な値が指定された場合は、エラーが返されます。期間を選択する際は、基盤となる時系列データの頻度(
|
trigger |
条件がトリガーされるために比較が成立する必要がある時系列の数または割合。指定されていない場合、 |
evaluationMissingData |
データの到着が停止した場合に指標しきい値の条件を評価する方法を決定する条件コントロール。この制御を使用するには、 |
集計
| JSON 表現 |
|---|
{ "alignmentPeriod": string, "perSeriesAligner": enum ( |
| フィールド | |
|---|---|
alignmentPeriod |
60 秒以上の値を指定してください。 グラフの
|
perSeriesAligner |
すべての時系列にすべての調整オペレーションが適用されるわけではありません。有効な選択肢は、元の時系列の 時系列間の短縮を実行するためには、時系列データをアライメントさせる必要があります。 |
crossSeriesReducer |
時系列を 1 つの時系列に結合するために使用される削減オペレーション。結果の時系列の各データポイントの値は、入力時系列のすでに調整されたすべての値の関数です。 すべての削減オペレーションをすべての時系列に適用できるわけではありません。有効な選択肢は、元の時系列の 時系列データで時系列間の縮小を行うには、まず時系列データをアライメントする必要があります( |
groupByFields[] |
|
所要時間
| JSON 表現 |
|---|
{ "seconds": string, "nanos": integer } |
| フィールド | |
|---|---|
seconds |
期間の符号付き秒数。-315,576,000,000 ~+315,576,000,000 の範囲(両端を含む)にする必要があります。注: これらの境界は、60 秒/分 * 60 分/時間 * 24 時間/日 * 365.25 日/年 * 10,000 年から計算されます。 |
nanos |
期間のナノ秒分解能による、秒の符号付き小数以下部分。1 秒未満の期間は、0 の |
ForecastOptions
| JSON 表現 |
|---|
{ "forecastHorizon": string } |
| フィールド | |
|---|---|
forecastHorizon |
必須。時系列がしきい値をまたぐかどうかを予測する将来の期間の長さ。予測値がしきい値に違反していることが判明し、構成された
|
トリガー
| JSON 表現 |
|---|
{ // Union field |
| フィールド | |
|---|---|
共用体フィールド type。トリガーのタイプ。type は次のいずれかになります。 |
|
count |
条件をトリガーするために述語を満たさない必要がある時系列の絶対数。 |
percent |
条件がトリガーされるために述語を満たさない必要がある時系列の割合。 |
MetricAbsence
| JSON 表現 |
|---|
{ "filter": string, "aggregations": [ { object ( |
| フィールド | |
|---|---|
filter |
必須。しきい値と比較する時系列を識別するフィルタ。 フィルタは、 |
aggregations[] |
個々の時系列のデータポイントの調整と、取得した時系列を結合する方法(各リソースの複数のストリームを各リソースの単一のストリームに集計する場合や、リソース グループのすべてのメンバーのストリームを集計する場合など)を指定します。複数の集計は、指定された順序で適用されます。 このフィールドは、 |
duration |
必須。時系列が新しいデータのレポートに失敗し、障害と見なされるまでの時間。このフィールドの最小値は 120 秒です。1 分の倍数である大きな値(240 秒や 300 秒など)はサポートされています。無効な値が指定された場合は、エラーが返されます。
|
trigger |
条件がトリガーされるために比較が成立する必要がある時系列の数または割合。指定しない場合、 |
LogMatch
| JSON 表現 |
|---|
{ "filter": string, "labelExtractors": { string: string, ... } } |
| フィールド | |
|---|---|
filter |
必須。ログベースのフィルタ。このフィルタの作成方法については、高度なログクエリをご覧ください。 |
labelExtractors |
省略可。ラベルキーから抽出式へのマップ。このラベルキーの値を抽出するために使用されます。このマップの各エントリは、 構文と例については、ログベースの指標
|
LabelExtractorsEntry
| JSON 表現 |
|---|
{ "key": string, "value": string } |
| フィールド | |
|---|---|
key |
|
value |
|
MonitoringQueryLanguageCondition
| JSON 表現 |
|---|
{ "query": string, "duration": string, "trigger": { object ( |
| フィールド | |
|---|---|
query |
ブール値ストリームを出力する Monitoring Query Language クエリ。 |
duration |
省略可。時系列がしきい値に違反してから、障害とみなされるまでの時間。現在、サポートされているのは 1 分の倍数の値(0、60、120、300 秒など)のみです。無効な値が指定された場合は、エラーが返されます。期間を選択する際は、基盤となる時系列データの頻度(
|
trigger |
条件がトリガーされるために比較が成立する必要がある時系列の数または割合。指定されていない場合、 |
evaluationMissingData |
データの到着が停止した場合に指標しきい値の条件を評価する方法を決定する条件コントロール。 |
PrometheusQueryLanguageCondition
| JSON 表現 |
|---|
{ "query": string, "duration": string, "evaluationInterval": string, "labels": { string: string, ... }, "ruleGroup": string, "alertRule": string, "disableMetricValidation": boolean } |
| フィールド | |
|---|---|
query |
必須。評価する PromQL 式。評価サイクルごとに、この式は現在の時刻で評価され、結果として得られるすべての時系列が保留中または発火中のアラートになります。このフィールドは空にできません。 |
duration |
省略可。アラートは、この期間にわたって PromQL 式が「true」と評価されると配信したとみなされます。PromQL 式が十分に長い期間にわたって「true」と評価されなかったアラートは、保留中と見なされます。負でない期間を指定するか、省略する必要があります。このフィールドは省略可能です。デフォルト値は 0 です。
|
evaluationInterval |
省略可。このルールを評価する頻度。30 秒の正の倍数であるか、指定されていない必要があります。このフィールドは省略可能です。デフォルト値は 30 秒です。この PrometheusQueryLanguageCondition が Prometheus アラートルールから生成された場合、この値は囲みルールグループから取得する必要があります。
|
labels |
省略可。PromQL クエリの結果に追加または上書きするラベル。ラベル名は有効である必要があります。ラベル値は変数を使用してテンプレート化できます。使用できる変数名は、PromQL 結果のラベル名(「__name__」や「value」など)のみです。「labels」は空にできます。
|
ruleGroup |
省略可。対応する Prometheus 構成ファイル内のこのアラートのルールグループ名。 一部の外部ツールでは、元の Prometheus 構成ファイルを参照するために、このフィールドに正しい値を入力する必要があります。ルールグループの名前とアラート名は、今後ルールグループの定義が変更された場合に、関連する AlertPolicy を更新するために必要です。 このフィールドは省略可能です。このフィールドが空でない場合は、有効な UTF-8 文字列が含まれている必要があります。このフィールドの長さは 2,048 Unicode 文字を超えてはなりません。 |
alertRule |
省略可。対応する Prometheus 構成ファイル内のこのアラートのアラートルール名。 一部の外部ツールでは、元の Prometheus 構成ファイルを参照するために、このフィールドに正しい値を入力する必要があります。ルールグループの名前とアラート名は、今後ルールグループの定義が変更された場合に、関連する AlertPolicy を更新するために必要です。 このフィールドは省略可能です。このフィールドが空でない場合は、有効な Prometheus ラベル名である必要があります。このフィールドの長さは 2,048 Unicode 文字を超えてはなりません。 |
disableMetricValidation |
省略可。この条件の指標の存在検証を無効にするかどうか。 これにより、まだ存在しない指標に対してアラート ポリシーを定義できるようになり、Terraform を使用したアラート ポリシーの構成などの高度な顧客ワークフローが改善されます。
|
LabelsEntry
| JSON 表現 |
|---|
{ "key": string, "value": string } |
| フィールド | |
|---|---|
key |
|
value |
|
SqlCondition
| JSON 表現 |
|---|
{ "query": string, // Union field |
| フィールド | |
|---|---|
query |
必須。実行するログ分析 SQL クエリ(文字列)。クエリは必要な形状に準拠している必要があります。具体的には、クエリで時間で入力をフィルタしようとしてはなりません。フィルタが自動的に適用され、入力がフィルタリングされるため、クエリは前回の実行以降に受信したすべての行を受信します。 たとえば、次のクエリは HTTP リクエストを含むすべてのログエントリを抽出します。 |
共用体フィールド schedule。スケジュールは、クエリを実行する頻度を示します。schedule は次のいずれかになります。 |
|
minutes |
クエリを数分ごとに実行するようにスケジュール設定します。 |
hourly |
クエリが数時間ごとに実行されるようにスケジュールを設定します。 |
daily |
クエリが指定した日数ごとに実行されるようにスケジュールを設定します。 |
共用体フィールド evaluate。SQL 結果セットに対して実行するテスト。evaluate は次のいずれかになります。 |
|
rowCountTest |
行数をしきい値と比較します。 |
booleanTest |
指定された列のブール値をテストします。 |
分
| JSON 表現 |
|---|
{ "periodicity": integer } |
| フィールド | |
|---|---|
periodicity |
必須。実行の間隔(分単位)。間隔は 5 分以上 1,440 分以下にする必要があります。 |
毎時
| JSON 表現 |
|---|
{ "periodicity": integer, // Union field |
| フィールド | |
|---|---|
periodicity |
必須。実行の間隔(時間単位)。1 時間以上 48 時間以下にする必要があります。 |
共用体フィールド
|
|
minuteOffset |
省略可。クエリを実行する時刻(UTC)の 1 時間後の分数。0 分以上 59 分以下にする必要があります。指定しない場合は、任意のオフセットが使用されます。 |
毎日
| JSON 表現 |
|---|
{
"periodicity": integer,
"executionTime": {
object ( |
| フィールド | |
|---|---|
periodicity |
必須。実行の間隔。1 日以上 31 日以下にする必要があります。 |
executionTime |
省略可。クエリを実行する時刻(UTC)。指定しない場合、サーバーは任意の時刻を選択し、毎日同じ時刻にクエリを実行します。 |
TimeOfDay
| JSON 表現 |
|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
| フィールド | |
|---|---|
hours |
1 日の時間(24 時間形式)。0 以上にする必要があります。通常は 23 以下にする必要があります。API ではビジネスの終了時間などのシナリオにおいて、値 "24:00:00" を許可することもできます。 |
minutes |
1 時間の分。0 以上 59 以下にする必要があります。 |
seconds |
1 分の秒数。0 以上にする必要があります。通常は 59 以下にする必要があります。API がうるう秒を許可する場合、値 60 が許可されます。 |
nanos |
秒の小数部分(ナノ秒単位)。0 以上 999,999,999 以下にする必要があります。 |
RowCountTest
| JSON 表現 |
|---|
{
"comparison": enum ( |
| フィールド | |
|---|---|
comparison |
必須。クエリから返された行数としきい値の間に適用する比較。 |
threshold |
必須。行数を比較する値。 |
BooleanTest
| JSON 表現 |
|---|
{ "column": string } |
| フィールド | |
|---|---|
column |
必須。ブール値を含む列の名前。行の値が NULL の場合、その行は無視されます。 |
BoolValue
| JSON 表現 |
|---|
{ "value": boolean } |
| フィールド | |
|---|---|
value |
ブール値。 |
ステータス
| JSON 表現 |
|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
| フィールド | |
|---|---|
code |
ステータス コード。 |
message |
デベロッパー向けのエラー メッセージ。英語で記述します。ユーザー向けのエラー メッセージは、ローカライズして |
details[] |
エラーの詳細を保持するメッセージのリスト。API が使用する共通のメッセージ タイプのセットがあります。 任意のデータ型のフィールドを含むオブジェクトであり、型を識別する URI を含むフィールド |
すべて
| JSON 表現 |
|---|
{ "typeUrl": string, "value": string } |
| フィールド | |
|---|---|
typeUrl |
シリアル化された Protobuf メッセージの型を識別します。URI 参照は、スラッシュで終わる接頭辞と完全修飾型名で構成されます。 例: type.googleapis.com/google.protobuf.StringValue この文字列には 接頭辞は任意であり、Protobuf 実装では、最後の すべての型 URL 文字列は、有効な URI 参照である必要があります。また、テキスト形式の場合、参照の内容は英数字、パーセント エンコードされたエスケープ、および次のセットの文字(外側のバッククォートを除く)のみで構成されている必要があります。
|
value |
type_url で記述された型の Protobuf シリアル化を保持します。 Base64 でエンコードされた文字列。 |
MutationRecord
| JSON 表現 |
|---|
{ "mutateTime": string, "mutatedBy": string } |
| フィールド | |
|---|---|
mutateTime |
変更が発生した日時。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
mutatedBy |
変更を行ったユーザーのメールアドレス。 |
タイムスタンプ
| JSON 表現 |
|---|
{ "seconds": string, "nanos": integer } |
| フィールド | |
|---|---|
seconds |
UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800~253402300799 の範囲(両端を含む)にする必要があります(これは 0001-01-01T00:00:00Z~9999-12-31T23:59:59Z に対応します)。 |
nanos |
ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0~999,999,999 にする必要があります(両端を含む)。 |
AlertStrategy
| JSON 表現 |
|---|
{ "notificationRateLimit": { object ( |
| フィールド | |
|---|---|
notificationRateLimit |
ログベースのアラート ポリシー( この上限は、LogMatch 条件のないアラート ポリシーには実装されていません。 |
notificationPrompts[] |
ログベースのアラート ポリシーの場合、通知プロンプトは常に [OPENED] です。ログベース以外のアラート ポリシーの場合、通知プロンプトは [OPENED] または [OPENED, CLOSED] になります。 |
autoClose |
アクティブなアラート ポリシーにこの期間データがない場合、未解決のインシデントはすべてクローズされます。
|
notificationChannelStrategy[] |
通知の送信方法をチャンネルごとに制御します。 |
NotificationRateLimit
| JSON 表現 |
|---|
{ "period": string } |
| フィールド | |
|---|---|
period |
|
NotificationChannelStrategy
| JSON 表現 |
|---|
{ "notificationChannelNames": [ string ], "renotifyInterval": string } |
| フィールド | |
|---|---|
notificationChannelNames[] |
これらの設定が適用される通知チャネルの完全な REST リソース名。これらはそれぞれ、この AlertPolicy の notification_channels フィールドで参照される NotificationChannel オブジェクトのいずれかの name フィールドに対応します。書式は次のとおりです。 |
renotifyInterval |
未解決のインシデントのリマインダー通知を送信する頻度。値は 30 分~ 24 時間の範囲で指定してください。
|
整列指定子
Aligner は、時系列の各アライメント期間のデータポイントに適用されるオペレーションを指定します。ALIGN_NONE はオペレーションを適用しないことを指定しますが、それ以外の各アライメント オペレーションでは、各アライメント期間のデータ値のセットが、データ値にオペレーションを適用した結果である単一の値に置き換えられます。整列された時系列には、各 alignment_period の終了時に単一のデータ値があります。
配置オペレーションでは、値のデータ型を変更することもできます。たとえば、ブール値にカウント オペレーションを適用すると、元の時系列のデータ value_type は BOOLEAN になりますが、調整された結果の value_type は INT64 になります。
| 列挙型 | |
|---|---|
ALIGN_NONE |
アライメントなし。元データが返されます。シリーズ間の削減がリクエストされている場合は無効です。結果の value_type は、入力の value_type と同じです。 |
ALIGN_DELTA |
位置合わせを行い、 この調整は、 |
ALIGN_RATE |
アライメントして、レートに変換します。結果は この Aligner は、数値を持つ 「率」が「変化率」を意味する場合は、 |
ALIGN_INTERPOLATE |
整合期間の境界付近の隣接するポイント間を補間することによって、整合が行われます。この Aligner は、数値を含む GAUGE 指標に有効です。調整された結果の value_type は、入力の value_type と同じです。 |
ALIGN_NEXT_OLDER |
整合期間終了前の最新のデータポイントを、整合期間終了時の境界に移動することによって、整合が行われます。この Aligner は GAUGE 個の指標に有効です。調整された結果の value_type は、入力の value_type と同じです。 |
ALIGN_MIN |
それぞれの整合期間の最小値を返すことによって、時系列をアライメントします。この Aligner は、数値を持つ GAUGE 指標と DELTA 指標に有効です。調整された結果の value_type は、入力の value_type と同じです。 |
ALIGN_MAX |
それぞれの整合期間の最大値を返すことによって、時系列を整合します。この Aligner は、数値を持つ GAUGE 指標と DELTA 指標に有効です。調整された結果の value_type は、入力の value_type と同じです。 |
ALIGN_MEAN |
それぞれの整合期間の平均値を返すことによって、時系列をアライメントします。この Aligner は、数値を持つ GAUGE 指標と DELTA 指標に有効です。アライメントされた結果の value_type は DOUBLE です。 |
ALIGN_COUNT |
それぞれの整合期間の値の数を返すことによって、時系列をアライメントします。この Aligner は、数値またはブール値を持つ GAUGE 指標と DELTA 指標に有効です。アライメントされた結果の value_type は INT64 です。 |
ALIGN_SUM |
それぞれの整合期間の値の合計を返すことによって、時系列をアライメントします。この Aligner は、数値と分布の値を持つ GAUGE 指標と DELTA 指標に有効です。調整された結果の value_type は、入力の value_type と同じです。 |
ALIGN_STDDEV |
それぞれの整合期間の値の標準偏差を返すことによって、時系列をアライメントします。この Aligner は、数値を持つ GAUGE 指標と DELTA 指標に有効です。出力の value_type は DOUBLE です。 |
ALIGN_COUNT_TRUE |
それぞれの整合期間の True 値の数を返すことによって、時系列をアライメントします。この Aligner は、ブール値を持つ GAUGE 指標に有効です。出力の value_type は INT64 です。 |
ALIGN_COUNT_FALSE |
それぞれの整合期間の False 値の数を返すことによって、時系列をアライメントします。この Aligner は、ブール値を持つ GAUGE 指標に有効です。出力の value_type は INT64 です。 |
ALIGN_FRACTION_TRUE |
それぞれの整合期間の値の合計数に対する True 値の数の比率を返すことによって、時系列の整合が行われます。この Aligner は、ブール値を持つ GAUGE 指標に有効です。出力値は [0.0, 1.0] の範囲内で、value_type DOUBLE です。 |
ALIGN_PERCENTILE_99 |
パーセンタイル集計を使用して、時系列を調整します。各集計期間の結果のデータポイントは、期間内のすべてのデータポイントの 99 パーセンタイルです。この Aligner は、分布値を持つ GAUGE 指標と DELTA 指標に有効です。出力は、value_type DOUBLE の GAUGE 指標です。 |
ALIGN_PERCENTILE_95 |
パーセンタイル集計を使用して、時系列を調整します。各集計期間内の結果のデータポイントは、期間内のすべてのデータポイントの 95 パーセンタイルです。この Aligner は、分布値を持つ GAUGE 指標と DELTA 指標に有効です。出力は、value_type DOUBLE の GAUGE 指標です。 |
ALIGN_PERCENTILE_50 |
パーセンタイル集計を使用して、時系列を調整します。各集計期間の結果のデータポイントは、期間内のすべてのデータポイントの 50 パーセンタイルです。この Aligner は、分布値を持つ GAUGE 指標と DELTA 指標に有効です。出力は、value_type DOUBLE の GAUGE 指標です。 |
ALIGN_PERCENTILE_05 |
パーセンタイル集計を使用して、時系列を調整します。各集計期間の結果のデータポイントは、期間内のすべてのデータポイントの 5 パーセンタイルです。この Aligner は、分布値を持つ GAUGE 指標と DELTA 指標に有効です。出力は、value_type DOUBLE の GAUGE 指標です。 |
ALIGN_PERCENT_CHANGE |
調整して変化率に変換します。この Aligner は、数値を持つ
上記の計算の前に、アライメント期間の各ポイントで 10 分間の移動平均が計算され、指標が平滑化され、短期間のスパイクによる誤検出が防止されます。移動平均は、値が |
レデューサ
Reducer オペレーションは、複数の時系列のデータポイントを 1 つの時系列に集計する方法を記述します。結果の時系列の各データポイントの値は、入力時系列のすでに調整されたすべての値の関数です。
| 列挙型 | |
|---|---|
REDUCE_NONE |
時系列間の短縮なし。Aligner の出力が返されます。 |
REDUCE_MEAN |
各集計期間の時系列の平均値を計算することで、データポイントを削減します。このリデューサーは、数値または分布値を持つ DELTA 指標と GAUGE 指標に有効です。出力の value_type は DOUBLE です。 |
REDUCE_MIN |
各集計期間の時系列の最小値を計算することで、データポイントを削減します。このリデューサーは、数値の DELTA 指標と GAUGE 指標に有効です。出力の value_type は入力の value_type と同じです。 |
REDUCE_MAX |
各集計期間の時系列の最大値を計算することで、データポイントを減らします。このリデューサーは、数値の DELTA 指標と GAUGE 指標に有効です。出力の value_type は入力の value_type と同じです。 |
REDUCE_SUM |
各アライメント期間について時系列全体の合計を計算することによって短縮します。このリデューサーは、数値と分布の値を持つ DELTA 指標と GAUGE 指標に有効です。出力の value_type は入力の value_type と同じです。 |
REDUCE_STDDEV |
各アライメント期間について時系列全体の標準偏差を計算することによって短縮します。このリデューサーは、数値または分布値を持つ DELTA 指標と GAUGE 指標に有効です。出力の value_type は DOUBLE です。 |
REDUCE_COUNT |
各集計期間の時系列のデータポイントの数を計算することで、データポイントを減らします。このリデューサーは、数値、ブール値、分布、文字列の value_type の DELTA 指標と GAUGE 指標に有効です。出力の value_type は INT64 です。 |
REDUCE_COUNT_TRUE |
各集計期間の時系列全体の True 値のデータポイントの数を計算することで、データポイントを減らします。このリデューサーは、ブール値 value_type の DELTA 指標と GAUGE 指標に有効です。出力の value_type は INT64 です。 |
REDUCE_COUNT_FALSE |
各集計期間の時系列全体の False 値のデータポイントの数を計算することで、データポイントを減らします。このリデューサーは、ブール値 value_type の DELTA 指標と GAUGE 指標に有効です。出力の value_type は INT64 です。 |
REDUCE_FRACTION_TRUE |
各集計期間の True 値のデータポイントの数とデータポイントの合計数の比率を計算することで、データポイントを減らします。このリデューサーは、ブール値 value_type の DELTA 指標と GAUGE 指標に有効です。出力値は [0.0, 1.0] の範囲内で、value_type DOUBLE です。 |
REDUCE_PERCENTILE_99 |
各アライメント期間の時系列全体のデータポイントの 99 パーセンタイルを計算することで、データポイントを減らします。このリデューサーは、数値型と分布型の GAUGE 指標と DELTA 指標に有効です。出力の値は DOUBLE です。 |
REDUCE_PERCENTILE_95 |
各集計期間の時系列全体のデータポイントの 95 パーセンタイルを計算することで、データポイントを減らします。このリデューサーは、数値型と分布型の GAUGE 指標と DELTA 指標に有効です。出力の値は DOUBLE です。 |
REDUCE_PERCENTILE_50 |
各集計期間の時系列全体のデータポイントの 50 パーセンタイルを計算することで、データポイントを減らします。このリデューサーは、数値型と分布型の GAUGE 指標と DELTA 指標に有効です。出力の値は DOUBLE です。 |
REDUCE_PERCENTILE_05 |
各集計期間の時系列全体のデータポイントの 5 パーセンタイルを計算することで、データポイントを減らします。このリデューサーは、数値型と分布型の GAUGE 指標と DELTA 指標に有効です。出力の値は DOUBLE です。 |
ComparisonType
left と right という 2 つの引数に順序関係を指定します。
| 列挙型 | |
|---|---|
COMPARISON_UNSPECIFIED |
順序関係が指定されていません。 |
COMPARISON_GT |
左側の引数が右側の引数より大きい場合は true。 |
COMPARISON_GE |
左側の引数が右側の引数以上の場合に true。 |
COMPARISON_LT |
左側の引数が右側の引数より小さい場合は True。 |
COMPARISON_LE |
左側の引数が右側の引数以下の場合に true。 |
COMPARISON_EQ |
左側の引数が右側の引数と等しい場合は true。 |
COMPARISON_NE |
左側の引数が右側の引数と等しくない場合は true。 |
EvaluationMissingData
データの到着が停止した場合に指標しきい値の条件を評価する方法を決定する条件コントロール。この制御は、指標の欠落ポリシーには影響しません。
| 列挙型 | |
|---|---|
EVALUATION_MISSING_DATA_UNSPECIFIED |
欠落データのオプションが指定されていない評価。EVALUATION_MISSING_DATA_NO_OP と同等です。 |
EVALUATION_MISSING_DATA_INACTIVE |
条件を評価するデータがない場合は、条件を false と評価します。 |
EVALUATION_MISSING_DATA_ACTIVE |
条件を評価するデータがない場合は、条件を true と評価します。 |
EVALUATION_MISSING_DATA_NO_OP |
データがない場合は、条件を評価して値を返さないでください。 |
ConditionCombinerType
条件を組み合わせるための演算子。
| 列挙型 | |
|---|---|
COMBINE_UNSPECIFIED |
指定されていないコンバイナ。 |
AND |
論理 AND 演算子を使用して条件を結合します。インシデントは、すべての条件が同時に満たされた場合にのみ作成されます。このコンバイナは、完全に異なるリソースで条件が満たされている場合でも、すべての条件が満たされていれば満たされます。 |
OR |
論理 OR 演算子を使用して条件を結合します。リストされている条件のいずれかが満たされると、インシデントが作成されます。 |
AND_WITH_MATCHING_RESOURCE |
論理 AND 演算子を使用して条件を組み合わせます。ただし、通常の AND オプションとは異なり、少なくとも 1 つのリソースですべての条件が同時に満たされた場合にのみインシデントが作成されます。 |
NotificationPrompt
通知が送信されるタイミングを制御します。
| 列挙型 | |
|---|---|
NOTIFICATION_PROMPT_UNSPECIFIED |
戦略が指定されていません。エラーとして扱われます。 |
OPENED |
インシデントが開かれたときに通知します。 |
CLOSED |
インシデントがクローズされたときに通知します。 |
重大度
アラート ポリシーの重大度レベルの列挙。
| 列挙型 | |
|---|---|
SEVERITY_UNSPECIFIED |
重大度が指定されていません。これはデフォルト値です。 |
CRITICAL |
これは最も重大なレベルです。問題によって重大な損害やダウンタイムが発生する可能性がある場合は、こちらを使用します。 |
ERROR |
これは中程度の重大度レベルです。問題によって軽微な損害やダウンタイムが発生する可能性がある場合は、これを使用します。 |
WARNING |
これは最も低い重大度レベルです。問題によって損害やダウンタイムは発生していないものの、今後問題が発生する可能性がある場合は、これを使用します。 |
ツールのアノテーション
破壊的ヒント: ❌ | べき等ヒント: ✅ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌