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

Honeybadger

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

Honeybadgerは、Ruby on Railsアプリケーションのエラー管理スイートです。 アプリケーションからエラーデータを収集し、ユーザーフレンドリーな形式で表示することで、問題をより迅速かつ容易に追跡し解決します。 HoneybadgerとPagerDutyを組み合わせることで、アラートによってこれらのエラーに関する情報をチームに配信し、記録的な速さで問題を修正できます。PagerDutyでHoneybadgerを設定するには、以下の手順に従ってください。 ご質問や援助が必要な場合は、 当社の サポートチーム にお問い合わせください 。

PagerDutyでの設定

  1. Configuration メニューからServices を選択します。
  2. Servicesページで: 統合のために新しいサービスを作成する場合は、 +Add New Service をクリックします。 既存のサービスにインテグレーションを追加する場合は、統合を追加するサービスの 名前をクリックします。 その後、Integrations タブをクリックし、 + New Integration ボタンをクリックします。 RS-Add-New-Service-13
  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
  5. 新しいインテグレーションのIntegration Keyをコピーします。 RS_Updates__API_Services-1024x146-8-300x43

Honeybadgerでの設定

  1. Honeybadgerコンソールで、My Projectsを選択します。 Screen-Shot-2013-10-07-at-5.00.00-PM-300x129
  2. Add A Projectを選択します。 AddProject-300x169
  3. 関連情報を入力し、プロジェクトを作成します。 Screen-Shot-2013-10-07-at-5.09.48-PM-300x203
  4. まだサイトを作成していない場合は、サイトを作成します。 このインテグレーションガイドのために、私は rails generate honeyroku Post title:string body:text としてレールを使ってRailsアプリケーションを作り、それをHerokuにデプロイしました。Screen-Shot-2013-10-10-at-3.22.18-PM-300x113
  5. あなたがお使いの環境内での指示に従って、テストアラートを作成します。 Screen-Shot-2013-10-07-at-5.12.45-PM-300x284
  6. この例では、 rails generate honeybadger --api-key [your_key] を走らせるとその後で、あなたの環境内で確認が表示されるはずです。 Screen-Shot-2013-10-07-at-5.24.51-PM-300x80
  7. Errorsページを確認して、テストエラーが正常に生成されたことを確認します。 Screen-Shot-2013-10-07-at-5.32.11-PM-300x179
  8. Settingsタブで、Integrationsを選択します。 SettingsIntegrations-300x291
  9. PagerDutyを選択します。 IntegrationPagerduty-256x300
  10. PagerDutyからコピーしたインテグレーションキーをAPI keyフィールドに入力し、Save changesをクリックします。 KeyAPI-300x266
  11. アプリケーション内にエラーを導入します。 この例では、作業中のActiverecordメソッド post.destroy を未定義メソッド post.mestroy に変更しました。 私はgitにエラーをコミットし、それをHerokuにプッシュし、自分のサイトにアクセスし、Postsインデックスページのポストの横にあるDestroyをクリックしました。 ErrorRails-300x126
  12. サイトにエラーが発生していることを確認します。 Screen-Shot-2013-10-10-at-3.46.29-PM-300x97
  13. Honeybadgerでエラーをチェックしてください。 ErrorUndefinedMethodMestroy-300x62
  14. 電話、SMS、電子メールで通知されていない場合は、PagerDutyとの統合が機能していることを確認してください。 IncidentTriggered-300x147 おめでとう、完了です!

よくある質問

  1. Honeybadger内の複数のプロジェクトをPagerDuty内の複数のサービスに添付することはできますか?

    はい、PagerDutyに複数のHoneybadgerサービスを作成し、それぞれのHoneybadger Railsプロジェクトが目的のインテグレーションキーを使用するように設定するだけです。