DOCS
インテグレーションガイド / Nagios 2-way

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をコピーします。

Nagiosサーバ上での設定

1. このガイドには、Debianベースの（すなわちUbuntu）とRHELベースの（すなわちCentOS、Fedora）Linuxディストリビューションでの手順が書かれています。 このガイドのすべてのコマンドを実行する必要はなく、お使いのシステムの種類に合ったコマンドだけを実行する必要があります。下記に示したすべてのコマンドは、rootユーザーとして実行されることを前提としています。

2. PagerDutyエージェントをインストールします。 このエージェントはNagiosからイベントを受信し、キューを使ってPagerDutyに送信し、問題のトラブルシューティングに役立つログを提供し、接続に失敗した場合（例えばNagiosサーバーが時的に接続を失った場合）にはアラートを自動的に再試行します。 注：このエージェントはCentOS 5もしくはそれより古いバージョンでは動作しません。CentOS 5に含まれているものよりも新しいバージョンのPythonが必要です。CentOS 5以前のシステムについては、PerlベースのNagiosについてのインテグレーションガイドを参照してください。 GitHubからpagerduty_nagios.cfgをダウンロードしてください：

3. テキストエディタでpagerduty_nagios.cfgを開きます。

4. Nagiosサービスに対応する統合キーをpagerフィールドに入力します。 キーは、サービスの詳細ページ（上記のPagerDutyセクションの手順5）にある32文字の文字列です。

5. Nagios設定ファイルを所定の場所に移動します。 Debianベースのシステムの場合、通常は/etc/nagios3/conf.dです。 RHELベースのシステムの場合、これは通常/etc/nagiosです。

6. Debianベースのディストリビューションを使っている場合は、この手順をスキップしてください。RHELベースのディストリビューションを使っている場合は、Nagiosの設定を編集してPagerDutyの設定をロードする必要があります。これを行うには、/etc/nagios/nagios.cfgを開いて次の行をファイルに追加します。

7. ”pagerduty”という連絡先をあなたのNagiosの設定のメインコンタクトグループに追加してください。デフォルトの設定を使用している場合は、/etc/nagios3/conf.d/contacts_nagios2.cfg（Debianベースのシステムの場合）、または/etc/nagios/objects/contacts.cfg（RHELベースのシステムの場合）を開き、 “admins”の連絡先グループを探してください。それから”pagerduty”の連絡先を追加するだけでOKです。

8. 設定の変更を有効にするために、Nagiosをリロードするか、リスタートします。

   • Debianベースのシステムの場合：
   • RHELベースのシステムの場合：

9. 双方向を実現するために、pagerduty.cgiをダウンロードします。

10. pagerduty.cgiファイルを編集して、command_file変数がNagiosコマンドを指すようにします。Nagiosへのパスは、

grep “^ command_file” /etc/nagios3/nagios.cfg（Debianベースのシステム）

あるいは、

grep “^ command_file” /etc/nagios/nagios.cfg（RHELベースのシステム）

のコマンドを実行すると見つかります。情報が表示されない場合は、command_file変数のコメントアウトが解除されていることを確認します（＃で始まらないようにします）。 11. pagerduty.cgiをNagiosのcgi-binに移動します。 Debianベースのシステムの場合、これは通常/usr/lib/cgi-bin/nagios3/です。 RHELベースのシステムでは、通常は/usr/lib64/nagios/cgi/となります。

12. pagerduty.cgiを実行可能にします。 Debianベースのシステムの場合： RHELベースのシステムの場合：
13. スクリプトを動かするために必要なPerlライブラリをインストールしてください。 Debianベースのシステムの場合： Ubuntu 16.04システムでは、libcgi-pm-perlもインストールする必要があります： RHELベースのシステムの場合：
14. RHELベースのディストリビューションを使っている場合は、この手順をスキップしてください。 Debianベースのディストリビューションを使っている場合、Nagiosで外部コマンドが有効になっていることを確認する必要があります。それには、/etc/nagios3/nagios.cfgの変数check_external_commandsが1で、変数command_check_intervalが環境に合った適切な値に設定されていることを確認します。 command_check_interval変数は、Nagiosが実行する外部コマンドのチェック頻度を決定します。
15. RHELベースのディストリビューションを 使っている場合は、この手順をスキップしてください。Debianベースのディストリビューションを使用している場合は、Webサーバユーザー（通常はwww-data）がNagiosコマンドファイルに書き込むことができるようにする必要があります。 次のコマンドは、デフォルトのコマンドファイルの場所に対してこれを有効にします。
16. PagerDutyでNagiosサービスに行き、Integrationsタブをクリックし、Add and extensionをクリックします。
17. Extension TypeでGeneric Webhookを選択し、Webhook（Nagios）のNameにURLを入力してSaveをクリックします。URLは次のようになります。

http://user:password@ip-or-domain/nagios3/cgi-bin/pagerduty.cgi

注：あなたが無効にしていない限り、Nagios Webインターフェイスはユーザー名とパスワードを必要とします。 Webhookでのみ使用されるNagiosコマンドを実行できるユーザーを設定することを強く推奨します。

ブラウザでこのURLにアクセスすると、「400 Requests must be POSTs」と表示されるはずです。 これが表示されない場合は、このURLを呼び出そうとしたときに発生したことの詳細を、Webサーバのログで確認してください。

18. この時点で、すべての設定が終わりました。テストするには、Nagios内でインシデントを生成させます。その後に、インシデントのAckした証拠として、インシデントが「“Acknowledged by PagerDuty」というコメントが追加されることを確認してください。