請求アラートを管理する

このページでは、請求アラートとアラート ルールの作成とミュートについて説明します。

始める前に

続行する前に、次の必要なロールがあることを確認してください。

  • MonitoringRule PA Creator: MonitoringRule カスタム リソースを作成して管理します。組織 IAM 管理者に monitoringrule-pa-creator ロールを付与するよう依頼します。

アラートルールを作成する

Observability API の MonitoringRule リソースを使用して、請求書指標と費用しきい値に基づいてアラート ルールを作成できます。

GDC コンソールを使用してアラートを作成する手順については、アラート ルールを作成するをご覧ください。

アラート ルールを作成する手順は次のとおりです。

  1. YAML ファイルを作成し、MonitoringRule リソースと次の内容を追加します。

    apiVersion: monitoring.gdc.goog/v1
kind: MonitoringRule
metadata:
  name: MONITORING_RULE_NAME
  namespace: PROJECT
spec:
  interval: INTERVAL
  limit: LIMIT
  alertRules:
  - alert: ALERT
    expr: EXPRESSION
    labels:
      severity: SEVERITY
      code: BILLING_CODE
      resource: BILLING
    annotations:
      message: MESSAGE

    次の変数を置き換えます。

    変数 説明
    MONITORING_RULE_NAME モニタリング ルールの名前。

    例: invoice-total-cost。
    PROJECT 請求書が存在するプロジェクトの Namespace。

    例: platform-obs。
    INTERVAL アラートが特定の期間に再実行される時間。

    例: 60s は、アラートが 60 秒ごとに実行されることを定義します。
    LIMIT アラートを実行できる回数。

    例: 制限なしの場合は 0。
    ALERT アラート名。

    例: invoice_total_cost_approaching_limit。
    EXPRESSION アラート ルールを記述する PromQL 式。PromQL 式を取得するには、HTTP API からアラートをクエリするをご覧ください。

    たとえば、予算額の 500,000 ドルの 80% の費用しきい値でアラート ルールを設定するには、次の式を使用します。

    sum(metering_invoice_line_item_total_cost{task_order_number="TASK_ORDER", clin_number="CLIN"}) / 500000 > 0.8

    TASK_ORDER はタスク オーダーに、CLIN は契約の品目番号に置き換えます。
    SEVERITY アラート ルールの重大度。重大度の値には、error、critical、warning、info などがあります。
    BILLING_CODE アラートルールに定義する課金コード。

    例: "BILLING-100"。
    MESSAGE アラート ルールの実行時に表示されるアラートの説明。

    例: "Spending exceeded limit"。

  2. YAML ファイルの内容を適用して、アラートルールを設定します。

    kubectl apply -f FILENAME.yaml

費用のしきい値アラートを作成する

インフラストラクチャ オペレーター（IO）は、GDC コンソールで費用しきい値アラート ポリシーを作成します。費用しきい値アラートは、請求費用が設定したしきい値を超えたときに通知するカスタムの請求アラートです。たとえば、IO は請求総費用の警告を作成し、固定のドル額または当初の予算額の割合に基づいて警告を構成します。

費用しきい値アラートやその他の組織レベルの課金アラートを作成するには、IO にリクエストを送信します。リクエストに次のパラメータを含めます。

  • タスク オーダー（TO）番号。
  • CLIN
  • 指定された TO と CLIN の合計予算額。
  • 予算のしきい値。

アラートを消音する

GDC コンソールでアラート ルールをミュートおよびミュート解除できます。アラートをミュートするの手順に沿って操作します。

請求通知を構成する

請求通知を構成するには、通知チャンネルを構成するの手順に沿って操作します。