DOCS
インテグレーションガイド / Catchpoint
本記事は米国PagerDuty社のサイトで公開されているインテグレーションガイドをそのまま日本語に翻訳したものです。日本語環境での動作を保証するわけではありません。原文はこちらを参照してください。
Catchpointを使用すると、オンラインアプリケーションのパフォーマンスを管理、監視、テストできます。 PagerDutyでCatchpointを設定するには、以下の手順に従ってください。
PagerDutyでの設定
- ConfigurationメニューからServicesを選択します。
- Serviceページで: インテグレーションのために新しいサービスを作成する場合は、+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を選択します 。
2.Alerts APIステータスをEnabled、StatusをActive、Endpoint URLを https://events.pagerduty.com/generic/2010-04-15/create_event.json に設定します。
3.FormatオプションからTemplateを選択します。
4.テンプレートを選択するドロップダウンメニューでAdd Newをクリックします。(既存のテンプレートは、テンプレート名の上にカーソルを置いて Edit / View Propertiesアイコンを選べばそのメニュー内で編集できます)。
5.ライトボックスがポップアップし、テンプレートの名前を作成して内容を定義することができます。 コンテンツは有効な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インシデントを自動的に解決できます。