
Project Description
本記事は米国PagerDuty社のサイトで公開されているインテグレーションガイドをそのまま日本語に翻訳したものです。日本語環境での動作を保証するわけではありません。原文はこちらを参照してください。
(訳注:オープンソースのネットワークとインフラの監視ツールである)MuninはPerlで書かれており、RRDtoolを使ってグラフを作成します。マスター/ノード・アーキテクチャーの一部として、マスターはノードに定期的に接続し、データを照会します。現在、500以上のモニタリングプラグインが利用可能です。Muninは、ほとんどのUnixシステムに比較的簡単にインストールできます。たとえば、Ubuntuでは、Muninは10行以下の設定で起動して実行できます。Muninは、一般的な電子メールとAPIの統合によってPagerDutyと統合できます。このガイドでは、APIでの設定について説明します。より簡単な電子メールの統合については、以下のFAQで説明しています。インストールがうまく完了しない場合は、私たち(support@pagerduty.com)にご連絡ください。
PagerDutyでの設定
- Configuration メニューからServicesを選択します。
- Serviceページで:
インテグレーションのために新しいサービスを作成する場合は、+Add New Serviceをクリックします。
既存のサービスにインテグレーションを追加する場合は、追加するサービスの名前をクリックします。その後、Integrations タブをクリックし、+ New Integration ボタンをクリックします。
- Integration Typeメニューから追加したいアプリを選択して、Integration Nameを入力してください。
インテグレーションのために新しいサービスを作成する場合は、General Settingで新しいサービスのNameを入力します。 次に、Incident Settingsで、新しいサービスの Escalation Policy (エスカレーションポリシー)、Notification Urgency (通知の緊急度)、Incident Behavior(インシデントの動作)を指定します。 - Add ServiceまたはAdd Integrationボタンをクリックして、新しいインテグレーションを保存します。 あなたはサービスのIntegrationsページにリダイレクトされます。
- 新しいインテグレーションのIntegration Keyをコピーします。
Muninでの設定
以下のインストールの例示は、AWS Ubuntuマシンで行っています。Unixの他のものとは、違うかもしれません。
- Muninがインストールされたら、端末を開き、必要なファイルをダウンロードできるディレクトリに移動します。
- (次のコマンドで)インテグレーションファイルをダウンロードします:
wget -O pagerduty-python.tar.gz --no-check-certificate https://github.com/samuel/python-pagerduty/tarball/master
- ファイルを解凍します。
tar -zxvf pagerduty-python.tar.gz
- 次のディレクトリに移動します。
cd samuel-python-pagerduty
- https://gist.github.com/720925.gitに示されているファイルをこのディレクトリにコピーするか、gitをインストールしてください :
sudo apt-get install git
次のように実行して、git clone https://gist.github.com/720925.git
ディレクトリ内のファイルを取得します。 - pagerduty_munin.pyファイルのこの先頭部分を、”If”条件を削除し、独自のサービスキーで置き換えることにより、変更してください。
置換されたサービスAPIキーは、上記のステップ5に示したものと一致する必要があります。
- このファイルをsamuel-python-pagerdutyの中にpagerduty_munin.pyとして保存してください。 確認するには、lsと入力して、ディレクトリ内に表示されるかを確認してください。
- Muninがファイルを実行可能にするためのアクセス許可を更新します。
chmod 755 pagerduty_munin.py
- munin.confファイルを開きます。 (Ubuntuでは、cd /etc/muninと入力してsudo vi munin.confと入力すると見つかります)。 ファイルの一番下に、samuel-python-pagerduty / pagerduty_munin.pyファイルへのパスを含む2つのcontact.me行を追加します。
監視ノードセクションの下で連絡先を追加し、負荷警告を非常に低い設定に変更して、テストアラートをトリガーして、インテグレーションが機能していることを実証します。
- Muninをリスタートします。 Ubuntuではこれを以下のようにすることができます:
sudo /etc/init.d/munin-node restart.sudo /etc/init.d/munin-node restart
- PagerDutyにログインします。 すべて順調である場合、最初のアラートが表示されます。
よくある質問
PagerDutyの複数のサービスを利用するためにMuninを設定できますか?
いいえ。 一度に1つのPagerDutyサービスにMuninのファイル設定を関連付けることしかできません。
Muninで何かが解決された場合は、PagerDutyでも解決されますか?
いいえ。PagerDutyでインシデントを個別に解決する必要があります。
うまく動作していないようです。 どうすればいいですか?
Muninを設定するには、UNIXとさまざまなシステムの詳細に関する実用的な知識が必要です。あなたのログをチェックし、重要度を分類できない場合はお気軽にお問い合わせください。
私のAPIインテグレーションは機能していないので、代わりに電子メールで統合したいと思っています。 どうすればいいですか?
電子メールインテグレーションのウォークスルーについては、 こちらをご覧ください。
要約すると、電子メールアドレスをmunin.confに追加してから、sendmailをインストールします。
Ubuntuでは、これは次のコマンドで行うことができます:
sudo apt-get install sendmail