DOCS
インテグレーションガイド / CA UIM Nimsoft

PagerDutyでの設定

1. Configuration メニューからServices を選択します。
2. Servicesページで： インテグレーションのために新しいサービスを作成する場合は、 +Add New Service をクリックします。 既存のサービスにインテグレーションを追加する場合は、統合を追加するサービスの 名前をクリックします。 その後、Integrations タブをクリックし、 + New Integration ボタンをクリックします。
3. Integration Type メニューから追加したいアプリを選択し、Integration Nameを入力してください。 インテグレーションのために新しいサービスを作成する場合は、General Settingsで新しいサービスのNameを入力します。 次に、Incident Settingsで、新しいサービスの Escalation Policy （エスカレーションポリシー）、Notification Urgency （通知の緊急度）、Incident Behavior（インシデントの動作）を指定します。
4. Add Service またはAdd Integration ボタンをクリックして、新しいインテグレーションを保存します。 すると、サービスのIntegrationsページにリダイレクトされます。
5. 新しいインテグレーションのIntegration Emailをコピーします。
6. これで、UIMのインテグレーションが作成されました。インテグレーションの名前をクリックし、Editを選択して、サービスのIntegrationsタブから設定を編集します。
7. Create and resolve incidents based on custom rulesオプションを選択します。
8. これで、Rule 1を変更できるようになりました。このルールを次のように設定します。
   1. 次のすべての条件が該当する場合、インシデントをResolveにします。 eメールの本文が正規表現にマッチ。 Level:.*clear
   2. Rule 1のIncident Keyセクションで、次のようにエントリーを設定します。 eメールの本文が 次の正規表現にマッチ。 NimID:([^n]+)
9. 今度は、Rule 2を作成する必要があります。これを行うには、Add Another Ruleボタンを選択します。
10. これで、Rule 2を変更できるようになりました。このルールを次のように設定します。
    1. 次のすべての条件が該当する場合、インシデントをトリガーします。 eメールのSubjectに以下が含まれる。 UIM alarm
    2. Rule 2のIncident Keyセクション内で、次のようにエントリを設定します。 eメールの本文が次の正規表現にマッチ。 NimID:([^n]+)
11. 最後のステップとして、If an email does not match any of the rules aboveを discard it に設定します。
12. Save Changesをクリックします。

CA UIMでの設定

1. emailgtw probeがeメール通知を送信できるように設定します。あなたの環境で動作するようにメールサーバーの設定を定義する必要があります。CA UIMのemailgtwプローブの設定方法についてはCAのマニュアルを参照してください。

2. emailgtwプローブ内で、右クリックしてPagerDutyという新しいプロファイルを作成します。

3. PagerDuty内でUIMサービスを設定するときは、手順2で作成したeメールアドレスを参照してください。このメールアドレスをEmail欄に入力します。これは、UIMがPagerDutyと通信するために必須です。

4. Subjectフィールドを UIM alarm from $hostname の値に変更します。このSubjectを使用しない場合は、手順10（Rule 2）の値を変更する必要があります。この値によってPagerDutyインシデントがトリガーされるためです。

5. HTML Templateフィールドを template.txt に変更するか、このテンプレートをUIMで他のeメール通知に使用する場合は、template.txt ファイルのコピー使うこともできます。

これを行うには、ファイル $NIMROOTprobesgatewayemailgtwtemplate.txt を同じディレクトリ内の新しいファイル（例えばpagerduty-template.txt）にコピーします。ここでEditボタンを選択し、次の新しいテンプレートの行を追加する必要があります。 NimID: $nimid

1. 最終的なのtemplate.txtは次のようになります（新しい行はテンプレートのどこかに追加されます）。

PagerDutyインシデントをより簡潔に見せるために、重要でない属性を削除したり並べ替えたりすることができます。ただし、NimID, Level, Message and Suppression Key 属性は保持する必要があります。

2. nasプローブ内で、PagerDutyという新しいAuto-Operator profileを作成します。

3. Auto-Operator profile内で、Action typeとしてEMAILを選択します。

4. Auto-Operator profile内のRecipient(s)フィールドに、PagerDuty（手順6のemailgtwプローブで作成したプロファイル名と一致する）を入力します。

5. Auto-Operator profile内で、Action Mode” の下のOn message arrivalを選択します。このオプションはeメール通知をすぐに送信することに注意してください。必要に応じて。On overdue ageオプションを使用することもできます。このオプションは、設定された時間内にアラームを処理する時間をUIMに与えます。

6. eメールがPagerDutyに送信される前に使用するフィルタ条件を入力します。例えば、重要なアラームのみをPagerDutyでトリガーする場合は、赤いアラームフィルタオプションを選択します。PagerDutyにUIMからのクリアイベントを通知するには、Green（クリア）重大度も選択してください。

7. オペレーションやビジネスの必要性に応じて、必要な数だけAuto-Operator profileを作成できます。

8. これで、UIMとPagerDutyのインテグレーションをテストする準備ができました。これを行うには、次の手順を実行します。

   a. nasプローブ内で、Statusタブを選択します。 b. タブの下半分を右クリックします。Send Test Alarmを選択します。

a. ステップ10でフィルタを設定した場合は、テストアラームで適切なアラーム重大度レベルを選択してください。上記の例では、critical（赤色）アラームを送信する必要があります。

a. UIMにアラームが表示されるのを待ちます。テストアラームのalarm IDに注意してください。

a. その後、PagerDuty内にそのインシデントが表示されます。前の手順では、Incident Keyが前のステップのUIMのalarm IDと一致することに注意してください。

a. UIM内のアラームを確認します。 b. PagerDutyインシデントの自動解決が表示されます。この自動解決は、ステップ7でNim IDに対して設定した解析ルールによって発生します。 a. 問題なければ、このインテグレーションは完了です。