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

Papertrail

本記事は米国PagerDuty社のサイトで公開されているインテグレーションガイドをそのまま日本語に翻訳したものです。日本語環境での動作を保証するわけではありません。原文はこちらを参照してください。

Papertrailは(クラウドを含め)ホストされたシステムのログ管理を簡単にします(訳注:Herokuのログ収集アドオンとして使われる)。それは誰も発見できず、Web、コマンドライン、API、または電子メール経由では簡単には使えない、システム全体から離れたファイルシステム上に位置します。これはPagerDutyにアラートを送信するように簡単に設定でき、PagerDutyの包括的なアラート機能とインシデント追跡機能を利用できます。以下のガイドでは、PagerDutyにPapertrailインストールを統合する方法について説明します。

PagerDutyでの設定

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

  2. Serviceページで: インテグレーションのために新しいサービスを作成する場合は、+Add New Serviceをクリックします。 既存のサービスにインテグレーションを追加する場合は、追加するサービスの名前をクリックします。 その後、Integrationsタブをクリックし、+ New Integration ボタンをクリックします。 RS-Add-New-Service-13-300x113

  3. Integration Typeメニューから追加したいアプリケーションを選択し、Integration Nameを入力します。新たにサービスを作成する場合は、General Settingsで、サービスのNameを入力します。次に、Incident Settings で、新しいサービスのEscalation Policy (エスカレーションポリシー)、Notification Urgency(通知の緊急度)、Incident Behavior<(インシデントの動作)を指定します。

  4. Add ServiceまたはAdd Integrationボタンをクリックして、インテグレーションを保存します。するとサービスのIntegrationsページにリダイレクトされます。 RS-Integration-Settings-11-300x109

  5. 新しいインテグレーションのIntegration Keyをコピーします。 RS_Updates__API_Services-1024x146-8-300x43

Papertrailでの設定

  1. Papertrailコントロールパネルにログインします。
  2. Eventsタブの下にあるページの下部にある検索バーから、ログに表示するキーワードを検索して Searchをクリックします。 Search-logs1-300x24
  3. 検索/アラートの名前を入力し、Save & Setupをクリックします。 Search-logs2-300x89
  4. Manage Alertsタブを選択し、左側のリストからPagerDutyを選択します。 Search-logs3-300x261
  5. 次に、PagerDutyで生成されたService Keyを入力し、 Descriptionを追加し、適切なTime zoneを選択し、Frequencyを選択し、 Updateを選択します。 Add-Service-Key-Papertrail-271x300
  6. これで、Events タブに戻り、検索結果に一致するログエントリが表示されたら、PagerDutyにイベントトリガーが表示されます。 Log-Papertrail-300x20
  7. おめでとうございます!これで インテグレーションが完了しました! 保存した検索条件に一致するログがあれば、PagerDutyインシデントがトリガーされます。

よくある質問

  1. Papertrailインシデントは自動的に解決されますか?

    いいえ。

  2. Papertrailを複数のPagerDutyサービスに結びつけるようにセットアップできますか?

    いいえ。

  3. インシデントは重複排除されますか?

    インシデントは重複除外されません。インシデントを作成する最初のアラートに対してインシデントキーが戻されます。

  4. 双方向のack-backインテグレーションはありますか?

    いいえ。

  5. Papertrailで参照できるログはありますか?

    はい、すべてのアラートはPapertrail内のユーザー用に保存および表示されます。

  6. API呼び出しが200(成功)を返さない場合、再試行のメカニズムはありますか?

    いいえ。

    このインテグレーションで問題が発生する場合は、support@pagerduty.com までご連絡ください。