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

はじめに

PagerDutyにIcingaサービスがない場合は作成する必要があります。

PagerDutyでの設定

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

2. Servicesページで新しいサービスを作成する場合は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をコピーします

Icingaでの設定

1. 必要なPerlモジュールをインストールします。Debian、Ubuntu、その他Debian系Linuxの場合は、

   aptitude install libwww-perl libcrypt-ssleay-perl
   

   RHEL、Fedora、CentOS、その他RedHat系の場合は

   yum install perl-libwww-perl perl-Crypt-SSLeay
   

2. GitHubからpagerduty_icinga.cfgをダウンロードします。

   wget https://raw.github.com/PagerDuty/pagerduty-icinga-pl/master/pagerduty_icinga.cfg
   

3. エディタでファイルを開きます。
4. Nagios/Icingaサービスに対応するインテグレーションキーをPagerDutyのフィールドに入力します。インテグレーションキーは、サービスの詳細ページにある32文字の文字列です。
5. Icingaの設定ファイルを以下のディレクトリにコピーしてオーナーを変更します。

   cp pagerduty_icinga.cfg /usr/local/icinga/etc/objects
   chown icinga:icinga /usr/local/icinga/etc/objects/pagerduty_icinga.cfg
   

6. コンタクト「pagerduty」をIcinga設定のメインコンタクトグループに追加します。デフォルト設定を使用している場合は、/usr/local/icinga/etc/objects/contacts.cfgを開き「admins」コンタクトグループを探します。その後は、コンタクトで「pagerduty」を追加するだけです。

   define contactgroup{
    contactgroup_name admins
    alias Icinga Administrators
    members icingaadmin,pagerduty ; <-- Add 'pagerduty' here. 
   }
   

7. pagerduty_icinga.plをGitHubからダウンロードし、/usr/local/binにコピーします。

   wget https://raw.github.com/PagerDuty/pagerduty-icinga-pl/master/pagerduty_icinga.pl
   cp pagerduty_icinga.pl /usr/local/bin
   

8. PerlスクリプトをIcingaで実行できるように属性を変更します。

   chmod 755 /usr/local/bin/pagerduty_icinga.pl
   

9. /usr/local/icinga/icinga.cfgで環境変数マクロを有効にします（有効になっていない場合）。

   enable_environment_macros=1
   

10. Icingaユーザーのcrontabを編集します。

    crontab -u icinga -e
    

11. crontabに次の行を追加します。

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

12. Icingaをリスタートしします。

    /etc/init.d/icinga restart