Catchpoint と統合する

この記事では、Jira Service Management Cloud の一部のお客様に段階的に展開されている、Jira Service Management でネイティブに利用できる新しいアラート機能を取り上げています。ご利用のサイトにはまだ表示されていないか、利用できない可能性があります。

統合でできるようになること

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 統合を追加する

Jira Service Management の Free プランまたは Standard プランを使用している場合は、この統合はチームの運用ページからのみ追加できます。Settings (歯車のアイコン) > Products ([Jira 設定] の下) > OPERATIONS からこの機能にアクセスするには、Premium プランまたは Enterprise プランが必要です。

統合をチームの運用ページから追加すると、そのチームが統合の所有者になります。つまり、Jira Service Management は、この統合を通じて受信したアラートをチームにのみ割り当てます。

Jira Service Management で Catchpoint 統合を追加するには、次の手順を実行します。

チームの運用ページに移動します。
左側のナビゲーションパネルで、[統合]、[統合を追加] の順に選択します。
「Catchpoint」を検索して、選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
[統合を設定する手順] セクションを展開し、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"
}

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

Jira Service Management サポート