アラート

アラート受信者を設定して、ダウンタイムにつながる可能性のある問題を防ぐ必要があります。

アラートを設定する

注:

uipathctl は Automation Suite のインストール フォルダー .../UiPathAutomationSuite/UiPath_Installer/bin にあります。

アラートの構成を開始する前に、 kubectl を有効化してください。

メール受信者を追加する

インストール後に新しいメール設定を追加するには、次のコマンドを実行します。

./uipathctl config alerts add-email \
  --name test \
  --to "[e-mail]" \
  --from "[e-mail]" \
  --smtp server.mycompany.com \
  --username admin \
  --password somesecret \
  --require-tls \
  --ca-file <path_to_ca_file> \
  --cert-file <path_to_cert_file> \
  --key-file <path_to_key_file> \
  --send-resolved

複数の受信者にメール通知を送信するために、複数のメール受信者を作成できます。

フラグ	値 (Value)	例
name	メール設定の名前	testconfig
to	受信者のメール アドレス	[e-mail]
from	送信者のメール アドレスです。	[e-mail]
SMTP	SMTP サーバーの URL または IP アドレスとポート番号	server.mycompany.com:567
username	認証ユーザー名	admin
password	認証パスワード	securepassword
require-tls	SMTP サーバーで TLS が有効化されることを示す Boolean フラグ。	N/A
ca-file	SMTP サーバーの CA 証明書を含むファイル パス。CA がプライベートの場合、これは任意です。	./ca-file.crt
cert-file	SMTP サーバーの証明書を含むファイル パス。証明書がプライベートの場合、これは任意です。	./cert-file.crt
key-file	SMTP サーバーの証明書の秘密キーを含むファイル パスです。証明書がプライベートの場合、これは必須です。	./key-file.crt
send-resolved	アラートの解決後にメールを送信する Boolean フラグ。	N/A

E メール受信者を削除する

メール設定を削除するには、次のコマンドを実行する必要があります。必ず、削除するメール設定の名前を渡してください。

./uipathctl config alerts remove-email --name test

E メール受信者を更新する

メール設定を更新するには、次のコマンドを実行する必要があります。必ず、更新するメール設定の名前と、編集する追加の任意パラメーターを渡してください。これらのパラメーターは、新しいメール設定を追加するためのパラメーターと同じです。1 つ以上のフラグを同時に渡すことができます。

./uipathctl config alerts update-email --name test [additional_flags]

Webhook を追加して外部ツールにアラートを送信する

Alertmanager の構成は、Base64 エンコード形式でシークレットに保存されます。シークレットを更新するには、次の手順に従います。

1. Alertmanager の既存の設定を am_config.yaml という名前のファイルで取得します。

   kubectl get secret alertmanager-config -n monitoring -o jsonpath="{.data.alertmanager\.yaml}" | base64 --decode > am_config.yaml
   

2. Webhook を設定します。詳しくは、「Alertmanager Webhook の構成」をご覧ください。

3. 設定を Base64 形式にエンコードします。

   openssl base64 -in am_config.yaml -out am_config_base64.yaml
   

4. シークレットの alertmanager.yaml 属性を更新します。既存の Base64 エンコード文字列を am_config_base64.yaml にある文字列に置き換えます。

5. Alertmanager のステータス セクションで、設定が更新されていることを確認します。

トラブルシューティングについては、Alertmanager および Prometheus のポッド ログをご覧ください。

アラートをテストする

アラートをテストするには、次の手順に従います。

1. https://monitoring.fqdn/alertmanager にアクセスして Alertmanager にログインします。

2. クッキー _oauth2_proxy=<value> をコピーします。

3. 次の例に示すように、Postman を使用してテスト アラートを作成します。

   Method: Post
   URL: https://monitoring.fqdn/alertmanager/api/v2/alerts
   Headers: 
   - Content-Type: application/json
   - Cookie: _oauth2_proxy=<value>
   Body: [{"labels":{"alertname":"Acme Alert", "severity":"warning"}}]
   

4. これで、Alertmanager にアラートが表示されます。

現在発生しているアラートを確認する

アラートを表示するには、https://monitoring.fqdn/metrics を使用して Prometheus に移動し、[Alerts] タブを選択します。ここでは、Automation Suite で設定されたすべてのアラートを確認できます。

• アクティブなアラートを表示するには、[Firing] チェックボックスを使用してアラートのステータスをフィルター処理します。

• 特定のアラートの詳細を確認するには、表示するアラートを展開します。

  

アラートを抑制する

アラートが多すぎる場合は、これらを抑制できます。そのためには、以下の手順に従ってください。

1. https://monitoring.fqdn/alertmanager を使用して Alertmanager にアクセスします。
2. 該当のアラートを見つけ、[Silence] を選択します。
3. [Creator] と [Comment] の詳細を入力し、[Create] を選択します。アラートが [ Monitoring] ダッシュボード に表示されたり、設定した受信者にレポートされることはなくなります。

アラートをトラブルシューティングする

アラート受信者の構成に問題がある場合は、次のコマンドを実行してログを確認します。

kubectl logs -n monitoring -l app.kubernetes.io/name=kube-prometheus-stack-prometheus-operator --tail=-1