Application Real-Time Monitoring Service:自己管理 Prometheus アラートの統合

背景情報

オープンソース Prometheus は、Alertmanager にアラートを通知します。 ARMS アラート管理にアラートを送信するには、Prometheus.yaml で <alertmanager_config> を設定します。 設定リファレンスについては、「[alertmanager_config]」をご参照ください。

ARMS アラート管理は、オープンソースの Prometheus と互換性のある Alertmanager エンドポイントを提供します。Prometheus 統合を作成すると、ARMS アラート管理は、ご利用の Prometheus インスタンスがアラートを送信するために使用する統合アドレスとベアラートークンを生成します。

前提条件

• ARMS コンソールへのアクセス権限。認証用のベアラートークンは、統合を作成した後に統合設定ページから取得します。

• Prometheus-Operator メソッドの場合: kubectl がインストールされ、お使いの Kubernetes クラスターにアクセスできるように設定されていること。

• その他の自己管理の Prometheus インスタンスの場合: Prometheus ホスト上の prometheus.yaml 設定ファイルへの書き込みアクセス権。

ステップ 1：統合を作成し、自己管理 Prometheus インスタンスを接続

2. [Prometheus 統合の新規作成] ダイアログボックスで、Prometheus 統合の名前と説明、アラートイベントの自動回復時間を入力し、保存 をクリックします。

   説明

   タイムアウト後の自動回復時間： 指定された期間内にアラートイベントが再度トリガーされない場合、そのアラートイベントは自動的に解除されます。

   3. ご利用の Prometheus のデプロイメントに基づいて接続方法を選択します。Prometheus が Prometheus-Operator を通じてデプロイされている場合は、[Prometheus-Operator で管理される Prometheus インスタンス] を選択します。それ以外の場合は、[その他の自己管理 Prometheus インスタンス] を選択します。次に 確定する をクリックします。

Prometheus-Operator で管理される Prometheus インスタンス

• ローカルマシンに arms-alertmanager-config.yaml ファイルを作成し、次の内容をファイルに貼り付けます。

- scheme: https
  bearer_token: ******
  static_configs:
    - targets: ['alerts.aliyuncs.com']

• arms-alertmanager-config.yaml ファイルを使用して、arms-am-config という名前のシークレットを作成します。

kubectl create secret generic arms-am-config --from-file=arms-alertmanager-config.yaml

• ローカルマシンに prometheus-patch.yaml ファイルを作成し、次の内容をファイルに貼り付けます。

spec:
  additionalAlertManagerConfigs:
    key: arms-alertmanager-config.yaml
    name: arms-am-config

• 次のコマンドを実行して、Prometheus オブジェクトを取得します。

kubectl get prometheus

応答の例：

NAME                                                VERSION   REPLICAS   AGE
prometheus-operator-160879-prometheus               v2.18.2   1          4d1h

• 次のコマンドを実行して、Prometheus オブジェクトに prometheus-patch.yaml ファイルを適用します。 prometheus-operator-160879-prometheus を、前のステップで返された名前に置き換えます。

kubectl patch prometheus prometheus-operator-160879-prometheus --patch "$(cat prometheus-patch.yaml)" --type=merge

他の方法で自己構築する Prometheus インスタンス

• prometheus.yaml 設定ファイルを変更します。

  次の例は Prometheus 2.x に適用されます。他のバージョンの設定フォーマットについては、「Prometheus ドキュメント」をご参照ください。

alerting:
  alertmanagers:
  - api_version: v1
    authorization:
      type: Bearer
      credentials: <bearer_token>
    scheme: https
    static_configs:
    - targets: ["alerts.aliyuncs.com"]

• ブラウザで Prometheus 設定ページを開き、alerting セクションにターゲットが alerts.aliyuncs.com の Alertmanager 設定が含まれていることを確認してください。

その他の Prometheus 互換の可観測性システムを ARMS アラート管理と統合する

Thanos は、thanos rule コマンドの --alertmanagers.config パラメーターを使用して Alertmanager 設定ファイルを指定します。 前のステップで説明した統合アドレスとトークンを入力します。 構成の詳細については、「Thanos ドキュメント」をご参照ください。

VictoriaMetric は、./bin/vmalert コマンドの -notifier.config パラメーターを使用してノティファイア設定ファイルを指定します。上記の手順で説明されている統合アドレスとトークンを入力します。設定の詳細については、「VictoriaMetric ドキュメント」をご参照ください。

(オプション) 統合の編集

ARMS アラート管理では、セルフマネージド Prometheus アラートソースと ARMS アラート管理との間のフィールドマッピングがプリセットされています。必要に応じて、統合の編集 ページでフィールドマッピングを追加または変更できます。

左側のナビゲーションウィンドウで、[アラート管理] > [インテグレーション]を選択します。[アラートインテグレーション] タブで、作成したインテグレーションに対して以下の操作を実行できます:

• 統合のキーを更新するには、対象の統合の右側にある 操作 列で、詳細 > キーの更新 を選択します。表示されるダイアログボックスで、確認 をクリックします。