Catchpoint と統合する
統合でできるようになること
Catchpoint は Jira Service Management API にアラート通知と詳細を送信します。Jira Service Management はこれらのアラートのディスパッチャーとして機能し、オンコール スケジュールに基づいて通知すべき担当者を決定します。メール、テキスト メッセージ(SMS)、電話、iOS や Android のプッシュ通知による通知を行い、アラートが承認またはクローズされるまでアラートをエスカレートします。
統合による機能
Catchpoint でアラートが作成されると、統合を通じて Jira Service Management でアラートが自動的に作成されます。
アラート通知レベルが Catchpoint テスト用に変更されると、Jira Service Management で作成されたアラートが自動でクローズされます。
統合をセットアップする
Catchpointは API ベースの統合です。設定は次の手順で行います。
Jira Service Management で Catchpoint 統合を追加する
Catchpoint で統合を設定する
Catchpoint 統合を追加する
The following capabilities are available in Jira Service Management Premium and Enterprise:
双方向の統合
Outgoing integrations at the team level
Integrations at a site level through Settings (icon) > Products (under Jira settings) > Operations
To access Jira Service Management Premium features, you must subscribe to a Service Collection Premium or Enterprise plan.
Adding an integration from your team’s operations page makes your team the owner of the integration. This means Jira Service Management only assigns the alerts received through this integration to your team.
Jira Service Management で Catchpoint 統合を追加するには、次の手順を実行します。
Next to Operations in the sidebar, select More actions (), then General configuration.
Select Integrations and then Add integration.
「Catchpoint」を検索して、選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[Continue] を選択します。
この時点で、統合が保存されます。[統合を設定する手順] セクションを展開して、API URL をコピーします。
この URL は、後ほど Catchpoint で統合を設定する際に使用します。[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。
Catchpoint で統合を設定する
Catchpoint と Jira Service Management の統合を設定するには、次の手順を実行します。
Catchpointで、[設定] > [API] の順に移動します。
[アラート API] セクションで「有効にする」を選択します。
[エンドポイントを追加] を選択します。
先ほどコピーした API URL を [エンドポイント URL] に貼り付けます。
[書式] には「テンプレート」を選択します。
テンプレートの名前を入力します。たとえば、「JSM」などです。
[エンドポイントを追加] を選択します。
[書式] には「JSON」を選択します。
このテキスト ファイルの内容をコピーして、テンプレートに貼り付けます。
[保存] を選択します。
Jira Service Management で追加する情報については、Catchpoint アラート テンプレートをカスタマイズします。テンプレートに追加された "alertCreateDate" フィールドの例を次に示します。
JSON
{
"testName": "${TestName}",
"testId": "${TestId}",
"testUrl": "${TestUrl}",
"alertTypeId": "${AlertTypeId}",
"productName": "${ProductName}",
"clientId": "${ClientId}",
"notificationLevel": "${switch("${notificationLevelId}","0","WARNING","1","CRITICAL","3","OK")}",
"nodeName":"${nodeDetails("${nodeName}")}",
"nodeServerAddress":"${nodeDetails("${NodeServerAddress}")}",
"alertCreateDate":"${alertCreateDateUtc}"
}
アラート プロパティには {{_payload.variable_name}} も使用できます。動的アラート プロパティの詳細をご確認ください。
Catchpoint から送信されるペイロードの例
アラート ペイロード (JSON 形式) を作成する
{
"message": "WARNING - Yahoo Test",
"testName": "Yahoo Test",
"testId": "81093",
"testUrl": "http://www.yahoo.com",
"alertTypeId": "7",
"productName": "tests",
"clientId": "24",
"notificationLevel": "WARNING",
"nodeName": "New York - Level3",
"nodeServerAddress": "98.139.180.149",
"description": "Description"
}
この内容はお役に立ちましたか?