DOCS
インテグレーションガイド / Check_MK Perl

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

Check_MKサーバーでの設定

このガイドには、DebianベースのLinuxディストリビューション（つまりUbuntu）とRHELベースのLinuxディストリビューション（すなわちCentOS、Fedora）と、CheckMKのスタンドアロンバージョンとOMDバージョンのためのステップが含まれています。 このガイドの全コマンドを実行する必要はなく、システムのタイプにあったコマンドだけを実行する必要があります。使用するCheck_MKのバージョンに応じて、使用するパスを調整する必要があります。 提供されるすべてのコマンドは、 root ユーザーとして実行されることを前提としています。

1. 必要なPerl依存関係をインストールします。 Debianベースのシステムの場合： apt-get install libwww-perl libcrypt-ssleay-perl RHELベースのシステムの場合： yum install perl-libwww-perl perl-Crypt-SSLeay

2. GitHubから pagerduty_nagios.pl をダウンロードし、 /usr/local/bin にコピーして、Nagiosによってファイルが実行可能であることを確認します。 wget https://raw.github.com/PagerDuty/pagerduty-nagios-pl/master/pagerduty_nagios.pl cp pagerduty_nagios.pl /usr/local/bin chmod 755 /usr/local/bin/pagerduty_nagios.pl

3. Check_MKのスタンドアロン版を使用している場合は、 nagios ユーザのcronテーブルを編集します。 crontab -u nagios -e Check_MKのOMDバージョンを使用している場合は、 su を使用してOMDサイトのユーザーになります。 su - {site-name-here}

4. スタンドアロンバージョンのCheck_MKを使用している場合は、ファイルに次の行を追加します。 * * * * * /usr/local/bin/pagerduty_nagios.pl flush Check_MKのOMDバージョンを使用している場合は、サイトの cron.d ディレクトリ（通常は /omd/sites/{site-name-here}/etc/cron.d ）にファイルを作成し、次の行をファイルに追加します：

   * * * * * /usr/local/bin/pagerduty_nagios.pl flush

   ファイルを pagerduty として保存し、変更を有効にするために次のpagerdutyを実行してから、 root に戻ります。

   omd reload crontab exit

5. GitHubから pagerduty-perl をダウンロードして実行可能にします： wget https://gist.githubusercontent.com/jcurreee/b8f4472659d7c2e402a6/raw/5f7fff04b45a62538eda458e287b2b3e0c61156e/pagerduty-perl chmod +x pagerduty-perl

6. 通知用スクリプトを所定の場所に移動します。Check_MKのスタンドアロンバージョンの場合、これは通常 /usr/share/check_mk/notifications です。 mv pagerduty-perl /usr/share/check_mk/notifications Check_MKのOMDバージョンでは、通常/omd/sites/ {site-name-here}/local/share/check_mk/notificationsです。 mv pagerduty-perl /omd/sites/{site-name-here} /local/share/check_mk/notifications

7. Check_MK Webインターフェースにログインし、Users （ WATO Configurationボックスにあります）に移動し、New Userをクリックします 。

8. PagerDutyユーザーのUsernameと、Full name（オプションです）を入力します。 将来の複数のPagerDutyサービスにアラートできるようにするために、Check_MKホストとサービスを設定する場合は、作成したPagerDutyサービスの名前と全く同じフルネームを設定すると便利です。 このユーザーのパスワードを入力しないでください。その代わりに、disable the login to this accountになっていることを確認する必要があります。このアカウントはPagerDuty Perlスクリプトに通知を送信するためだけに存在するからです。 ユーザーの役割をNormal monitoring user、あるいは通知を送信する権限だけを与えて作ったカスタムロールに設定し、アラートを受信するホスト/サービスの一部であるContact Groups ユーザーを追加します。 完了したら Save をクリックします 。

9. 作成したユーザーの横の Notificationアイコン（放送塔のアイコン）をクリックします。 Check_MK 1.2.4以前を使用している場合は、 Edit アイコン（鉛筆のアイコン）をクリックしてください。

10. New Ruleクリックします。 Check_MK 1.2.4以前を使用している場合は、Notificationsボックスまでスクロールしてください。

11. 新しい通知方法のDescription を入力し、Notification Methodを**PagerDuty (Perl)**に設定します。 PagerDutyエージェントを選択した後に表示されるテキストボックスに、PagerDutyからコピーしたインテグレーションキーを貼り付け、PagerDutyに送信されるアラートを制限する条件を選択します。完了したら Saveをクリックします 。

Check_MK 1.2.4以前を使用している場合は、enable notificationsをチェックし、Notification Method をFlexible Custom Notificationsに設定します。 Add notificationをクリックし、 Notification Pluginを PagerDuty (Perl)に設定します。 PagerDutyエージェントを選択した後に表示される最初のPlugin Argumentsテ キストボックスにPagerDutyからコピーしたインテグレーション キーを貼り付け、Notification Method（注：Notification Optionsではありません）のHost Events とService Eventsのの下にあるStart or end of flapping stateとStart or end of scheduled downtimeのチェックボックス（訳注:つまり全部で4箇所あります）からチェックを外します。 完了したらSave をクリックします 。 12. Usersリストに戻り、 # Changesをクリックし、Activate Changesをクリックします。 13. おめでとうございます！ 設定が正常に有効になったことが確認できたら、完了です！ Check_MKはPagerDutyでインシデントをトリガー、確認、解決できるようになり、cronジョブは最初の試行で正常に送信されなかった場合（つまり接続の問題がある場合など）にイベントを送信し直します。

次のステップ

すべての機能が正常に動作することを確認するには、Check_MKインターフェースでホストまたはサービスに行き、 Executeアイコン（ハンマーのアイコン）をクリックします。 Fake check resultsボックスで、Critical（サービスの場合）またはDown （ホストの場合）をクリックし、Yes をクリックします。 あなたが偽のアラートを送信したいことを確認する表示が出ます。 一時的にPagerDutyで作成された新しいインシデントが表示されるはずですが、このテストインシデントはすぐ解決されるはずであることに注意してください。偽のチェック結果が次回のチェックで実際のチェック結果に置き換えられるためです。