アラートポリシーの作成

エラーバジェットのレートに関するアラートポリシーは、SLO データの取得で説明されている時系列セレクタ select_slo_burn_rate に基づいて決まります。その他の時系列セレクタも、アラートポリシーの基礎として使用できます。SLO ベースのアラートポリシーの詳細については、バーンレートに関するアラートをご覧ください。

アラートポリシーを作成するには、alertPolicies.create メソッドを使用します。このメソッドの一般的な使用方法は、アラートポリシーの管理に記載されています。

SLO のアラートポリシーは、その他の指標しきい値のアラートポリシーに似ていますが、1 点だけ異なる点があります。それは、MetricThreshold の filter 条件の指定で指標のタイプとモニタリング対象リソースのタイプのペアではなく、時系列セレクタを使用することです。

SLO ベースのアラートポリシーの条件

アラートポリシーには少なくとも 1 つの条件が必要です。SLO ベースの状態の場合は、MetricThreshold 型の条件を使用します。

指標しきい値の条件には、filter と aggregations の時系列構成のペアを 2 組含めることができます。SLO データは他の時系列データとは異なる方法で取得されるため、SLO の条件で使用される唯一のフィールドは filter フィールドだけです。

SLO の条件では、comparison、thresholdValue、duration、および trigger フィールドが設定されます。

この例では、バーンレートが通常速度の 2 倍を超えた場合に違反とする条件を作成します。構造は次のようになります。

  "conditions": [
    {
      "displayName":"SLO burn rate alert for ${SLO_ID} exceeds 2",
      "conditionThreshold": {
        "filter": DATA_RETRIEVAL_FILTER_FOR_SLO,
        "comparison":"COMPARISON_GT",
        "thresholdValue": 2,
        "duration": {
          "seconds":"0",
        },
      },
    }
  ],

filter フィールドを設定するには、特定の SLO のリソース名が必要になります。この値の形式は次のとおりです。projects/${PROJECT}/services/${SERVICE_ID}/serviceLevelObjectives/${SLO_ID}。SLO ID の確認方法については、SLO の一覧表示をご覧ください。

バーンレートに関するアラートを作成するには、時系列セレクタ select_slo_burn_rate を使用します。このセレクタには、ターゲット SLO とルックバック期間という 2 つの値があります。詳細については、select_slo_burn_rate をご覧ください。

たとえば、次のフィルタは、1 時間のルックバック期間を持つターゲット SLO のバーンレートを取得します。

"filter":"select_slo_burn_rate(\"projects/${PROJECT}/services/${SERVICE_ID}/serviceLevelObjectives/${SLO_ID}\", \"60m\")"

アラートポリシーの残りの部分

アラートポリシーを完了するには、残りのフィールドに値を指定します。

displayName: アラートポリシーの説明。
combiner: 条件を組み合わせるロジックを記述します。このポリシーには条件が 1 つしかないため、AND と OR のいずれも正しく動作します。
notificationChannels: アラートポリシーがトリガーされたときに使用する既存の通知チャネルの配列。通知チャネルの検索と作成については、通知チャネルをご覧ください。
documentation: 条件に違反したときに送信される、受信した側が問題を診断するための情報。詳細については、Documentation をご覧ください。