DOCS
インテグレーションガイド / Whatsup Gold

PagerDutyでの設定

1. Configuration メニューからServices を選択します。

2. Serviceページで：

   • インテグレーションのために新しいサービスを作成する場合は、 +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 Keyをコピーします。

WhatsUp Gold Serverでの設定

1. WhatsUp GoldサーバのC:ドライブに以下のディレクトリを作成します。

   • C:\PagerDuty

   • C:\PagerDuty\Queue

2. 次のVBScriptをダウンロードし、WhatsUp GoldサーバーのC:\PagerDutyに保存します。

   • PagerDuty.vbs

3. WhatsUp Gold Webインターフェースに管理者としてログインし、Settings → Actions & Alerts → Actions and Policiesの順番で移動します。

4. ライブラリに新しいLog To Text Fileアクション を作成します。

5. 新しいアクションに”Log Alert to PagerDuty Queue”などの名前を付け、Log FileパスをC:\PagerDuty\Queue\%Device.HostName_Down.txtに設定し、Log file write modeをOverwriteに変更してから、 Log Messageフィールドに次のように入力します。

   {
    "service_key": "YOUR-INTEGRATION-KEY-HERE",
    "incident_key": "%Device.Address Monitors Down",
    "event_type": "trigger",
    "description": "%Device.ActiveMonitorDownNames %Device.State on %Device.HostName",
    "details": {
      "Monitors that are down": "%Device.ActiveMonitorDownNames",
      "Monitors that are up": "%Device.ActiveMonitorUpNames",
      "Host Name": "%Device.HostName",
      "IP Address": "%Device.Address"
     }
     }
   

   YOUR-INTEGRATION-KEY-HEREを、先ほど作成したPagerDutyインテグレーションキーと置き換えるのを忘れないでください。

6. アクションライブラリに別の新しいLog To Text Fileアクションを作成します。 この新しいアクションに”Log Recovery to PagerDuty Queue”などのNameを付け、 LogファイルのパスをC:\PagerDuty\Queue\%Device.HostName_Up.txtに設定し、 Log file write mode を Overwriteに変更してから、Log Messageフィールドに次のように入力します。

   {
                 "service_key": "YOUR-INTEGRATION-KEY-HERE",
                 "incident_key": "%Device.Address Monitors Down",
                 "event_type": "resolve",
                 "description": "%Device.ActiveMonitorDownNames %Device.State on                  %Device.HostName"
               }
   

   YOUR-INTEGRATION-KEY-HEREを先ほど作成したPagerDutyインテグレーションキーで置き換えるのをお忘れなく。

7. 新しいProgram Actionを作成し、新しいアクションに Execute PagerDuty VBScriptなどのNameを付け 、 Program file nameをC:\Windows\System32\cscript.exe 、 Workig pathをC:\PagerDuty 、Program arguments //B "C:\PagerDuty\PagerDuty.vbs"に設定します。

8. 新しいアクションポリシーを作成し、”PagerDuty”などのNameを付けます（または、PagerDutyでアラートをトリガーさせたいデバイスによってすでに使用されている既存のポリシーを編集します）。次に、 UPとDown(ダウン)状態の両方のために実行させたいPagerDutyアクションを追加します。Log AlertアクションはDown状態で実行する必要があり、Log ActionはUp状態で実行する必要がありますが、Program Action（VBScript実行）は両方の状態で実行する必要がありますが、Log AlertまたはLog Recoveryアクションの後に実施されます。

9. このアクションポリシーを使用するようにデバイスを設定するには、MY NETWORKに移動してデバイスを選択し、Monitor setup をクリックします 。 Actions and Action Policiesタブに移動し、Apply the following Action Policyを選択し、前の手順で作成または更新したアクションポリシーを選択します。

10. Windowsのタスク スケジューラを開き、ActionsサイドバーのCreate Taskをクリックします 。 タスクにPagerDutyのようなNameを付け、Run whether user is logged in or notを選択します。

11. Triggersタブに切り替えてNew…ボタンをクリックし、Begin the task:のドロップダウンリストをクリックして、 At startup を選択します。 Repeat task everyというラベルのチェックボックスをオンにし、1 minuteと入力します（このオプションはリストにありません。手動で入力する必要があります）。次に、duration (訳注 for a duration of:）をindefinitely （無期限）に変更してOKをクリックします。 これらの手順を繰り返しますが、2回目は At Task creation/modification を選択するだけでOKです。

12. Actionタブを選択し、 New…をクリックします。Program/script:をC:\Windows\System32\cscript.exeに設定し、 Add arguments (optional):を//B "C:\PagerDuty\PagerDuty.vbs" に設定してから 、OK をクリックします。

13. OKをクリックします。

14. おめでとう！ WhatsUp GoldはPagerDutyでインシデントをトリガーしたり解決したりできるようになりました。最初の試行で（接続の問題などで）正常に送信されなかった場合にはスケジュールされたタスクがイベントを再送信します。

アラートのカスタマイズ

Log To Text FileアクションのLog Messageを変更することにより、PagerDutyに送信されるアラートデータをカスタマイズできます。ファイルは、C:\PagerDuty\Queueに拡張子.txtで記録する必要があります。コンテンツは、当社の Events API用にフォーマットされたJSONである必要があります 。

特殊文字：引用符などの、JSON出力に影響する文字を使うアラートがある場合は、それらの文字をバックスラッシュでエスケープするか、またはVBScriptを変更してそれらを処理させる必要があります。 たとえば、アラートに引用符を追加する場合は、 Log To Text Fileアクションでバックスラッシュ（ \ ）を\"というように追加します。必要に応じて、VBScriptを変更してReplace Methodを使用して他の特殊文字をエスケープできるように設定できます。バックスラッシュはエスケープ文字としてJSONので特別な意味を持っていますが、Windowsパスを含むアラートでも使用されています。そこでスクリプトで他の特殊文字をエスケープに使えるようにするのです。

最後に、 CScript.exeインタプリタを使用して"C:\PagerDuty\PagerDuty.vbs"を実行する、Program Actionが設定されていることを確認する必要があります。 これにより、スケジュールされたタスクが送信されるまで待つ必要はなく、WhatsUp GoldがPagerDutyにアラートをただちに送信することができます。