DOCS
インテグレーションガイド / Papertrail
本記事は米国PagerDuty社のサイトで公開されているインテグレーションガイドをそのまま日本語に翻訳したものです。日本語環境での動作を保証するわけではありません。原文はこちらを参照してください。
Papertrailは（クラウドを含め）ホストされたシステムのログ管理を簡単にします（訳注：Herokuのログ収集アドオンとして使われる）。それは誰も発見できず、Web、コマンドライン、API、または電子メール経由では簡単には使えない、システム全体から離れたファイルシステム上に位置します。これはPagerDutyにアラートを送信するように簡単に設定でき、PagerDutyの包括的なアラート機能とインシデント追跡機能を利用できます。以下のガイドでは、PagerDutyにPapertrailインストールを統合する方法について説明します。
PagerDutyでの設定
-
ConfigurationメニューからServicesを選択します。
-
Serviceページで： インテグレーションのために新しいサービスを作成する場合は、+Add New Serviceをクリックします。 既存のサービスにインテグレーションを追加する場合は、追加するサービスの名前をクリックします。 その後、Integrationsタブをクリックし、+ New Integration ボタンをクリックします。
-
Integration Typeメニューから追加したいアプリケーションを選択し、Integration Nameを入力します。新たにサービスを作成する場合は、General Settingsで、サービスのNameを入力します。次に、Incident Settings で、新しいサービスのEscalation Policy （エスカレーションポリシー）、Notification Urgency（通知の緊急度）、Incident Behavior<（インシデントの動作）を指定します。
-
Add ServiceまたはAdd Integrationボタンをクリックして、インテグレーションを保存します。するとサービスのIntegrationsページにリダイレクトされます。
-
新しいインテグレーションのIntegration Keyをコピーします。
Papertrailでの設定
- Papertrailコントロールパネルにログインします。
- Eventsタブの下にあるページの下部にある検索バーから、ログに表示するキーワードを検索して Searchをクリックします。
- 検索/アラートの名前を入力し、Save & Setupをクリックします。
- Manage Alertsタブを選択し、左側のリストからPagerDutyを選択します。
- 次に、PagerDutyで生成されたService Keyを入力し、 Descriptionを追加し、適切なTime zoneを選択し、Frequencyを選択し、 Updateを選択します。
- これで、Events タブに戻り、検索結果に一致するログエントリが表示されたら、PagerDutyにイベントトリガーが表示されます。
- おめでとうございます！これで インテグレーションが完了しました！ 保存した検索条件に一致するログがあれば、PagerDutyインシデントがトリガーされます。
よくある質問
Papertrailインシデントは自動的に解決されますか？
いいえ。
Papertrailを複数のPagerDutyサービスに結びつけるようにセットアップできますか？
いいえ。
インシデントは重複排除されますか？
インシデントは重複除外されません。インシデントを作成する最初のアラートに対してインシデントキーが戻されます。
双方向のack-backインテグレーションはありますか？
いいえ。
Papertrailで参照できるログはありますか？
はい、すべてのアラートはPapertrail内のユーザー用に保存および表示されます。
API呼び出しが200（成功）を返さない場合、再試行のメカニズムはありますか？
いいえ。
このインテグレーションで問題が発生する場合は、support@pagerduty.com までご連絡ください。
