
Project Description
本記事は米国PagerDuty社のサイトで公開されているインテグレーションガイドをそのまま日本語に翻訳したものです。日本語環境での動作を保証するわけではありません。原文はこちらを参照してください。
Catchpointを使用すると、オンラインアプリケーションのパフォーマンスを管理、監視、テストできます。 PagerDutyでCatchpointを設定するには、以下の手順に従ってください。
PagerDutyでの設定
- ConfigurationメニューからServicesを選択します。
- Servicesページでの設定:
- 統合用の新しいサービスを作成する場合は、+Add New Serviceをクリックします。
- 既存のサービスに統合を追加する場合は、統合を追加するサービスの名前をクリックします。その後、Integrationsタブをクリックし、+ New Integrationボタンをクリックします。
- Integration Typeメニューからアプリケーションを選択し、Integration Nameを入力します。
統合のための新しいサービスを作成する場合は、General Settingsで、新しいサービスのNameを入力します。次に、インシデント設定で、新しいサービスのEscalation Policy、Notification Urgency、およびIncident Behaviorを指定します。
- Add ServiceまたはAdd Integrationボタンをクリックして、新しいインテグレーションを保存します。 あなたはサービスのIntegrationsページにリ ダイレクトされます。
- 新しい統合のIntegration Keyをコピーします。
Catchpointでの設定
- SettingsメニューのAPIを選択します 。
- Alerts APIステータスをEnabled、StatusをActive、Endpoint URLを
https://events.pagerduty.com/generic/2010-04-15/create_event.json
に設定します。
- FormatオプションからTemplateを選択します。
- テンプレートを選択するドロップダウンメニューでAdd Newをクリックします。(既存のテンプレートは、テンプレート名の上にカーソルを置いて Edit / View Propertiesアイコンを選べばそのメニュー内で編集できます)。
- ライトボックスがポップアップし、テンプレートの名前を作成して内容を定義することができます。 コンテンツは有効なJSONでなければならず、以下で説明する3つの必須フィールドを含める必要があります。
service_key
、event_type
、description
. ほかに渡せる追加のパラメータについては、Events APIのドキュメントにあります 。
アラートマクロの使用
JSONフィールドは、ハードコードされ、システムから提供されたデータで動的に埋められます。 これには、テスト名、アラートの重大度、アラートをトリガした条件、テスト実行によってアラートがトリガされたノードの場所などのデータが含まれます。アラートAPIテンプレートでタイムスタンプと重大度を指定する例として、 ${macroName}
構文でマクロが使用されるJSONのアラートの場合をあげておきます。
{ "service_key": "YOUR-INTEGRATION-KEY-HERE", "event_type": "${switch("${NotificationLevelId}","0","trigger","1","trigger","3","resolve")}", "description": "${switch("${NotificationLevelId}","0","WARNING","1","CRITICAL","3","OK")}: ${TestUrl}", "incident_key": "${AlertInitialTriggerDateUtc}", "client": "${TestName}", "client_url": "${TestUrl}", "details": { "NodeName": "${NodeDetails("${NodeName}")}", "NodeClientAddress": "${NodeDetails("${NodeClientAddress}")}", "NodeMean": "${NodeDetails("${NodeMean}")}", "Test Name": "${TestName}", "Test URL": "${TestUrl}" } }
アラートマクロインデックス
サポートされているすべてのアラートマクロの一覧は、 Catchpointナレッジベースで確認できます。
注:ナレッジベースにアクセスするには、Catchpointアカウントにログインする必要があります。
よくある質問
Catchpointは複数のPagerDutyサービスと統合できますか?
はい。 Catchpointは、異なるエンドポイントに特定のアラートを送信することにより、異なるアラートをPagerDutyサービスに分割することができます。
Catchpointがトリガするインシデントは自動的に解決されますか?
はい。 Catchpointは、通知レベルが3またはImprovedであるときに、event_typeフィールド内にswitchステートメントを適用して解決を送信することによって、PagerDutyインシデントを自動的に解決できます。