API 統合をセットアップする

Jira Service Management アカウントには既定の API 統合が提供されており、これを使用してユーザーやアラートを設定できます。ただし、監視システムごとに個別の API 統合を追加することをお勧めします。既定の API 統合の目的は、通知の転送や Web UI を介して作成されたアラートなどの既定の機能を制御することです。

機能

• API 統合のすべての機能をサポート

• Web アプリを介して作成されたアラートは、既定の API によって処理され、変更が可能です。アラートは変更または無視できます。

• 承認、クローズ、メモの追加などのチーム メンバーのアクションは、既定の API によって処理されます。アクションは変更できます。

• 転送とその他の内部アラートは、既定の API によって処理されます。アラートは変更または無視できます。

• 設定オブジェクトは、既定の API を使用して読み取り/書き込みができます。

組み込みアラートのタグ

• 既定の API 統合設定から組み込みのアラートを変更または無視できるように、タグが追加されました。

• 転送ルール

• Amazon CloudWatch インテグレーションの確認: CloudWatch、確認。

• New Relic (レガシー)　統合の確認: NewRelic、確認。

制限

• 既定の API 統合の名前は変更できません。

• 既定の API 統合のオフまたは削除はできません。

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

API 統合により、Jira Service Management サービスにアクセスして、アラートの作成や、サードパーティ・アプリのユーザー、オンコール スケジュール、チームの設定ができます。

統合による機能

既定の API 統合は Jira Service Management アカウントに付属しています。この統合を使用して、ユーザーやアラートを設定できます。ただし、監視システムごとに個別の API 統合を追加することをお勧めします。

Jira Service Management には、設定を容易にする多くの管理システムと統合する機能が組み込まれています。API 統合を使用する前に、サポートされているアプリの現在のリストをご確認ください。探しているものが見つからない場合は、こちらまでお問い合わせください。

統合をセットアップする

​API 統合を追加する

Jira Service Management で API 統合を設定するには、次の手順に従います。

1. チームのオペレーション ページに移動します。

2. 左側のナビゲーション パネルで、[統合]、[統合を追加] の順に選択します。

3. 検索を実行して「API」を選択します。

4. 次の画面で、統合の名前を入力します。

5. オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。

6. [続行] を選択します。
   この時点で、統合が保存されます。

7. [統合をオンにする] を選択します。
   統合のために作成したルールは、統合をオンにした場合にのみ機能します。

デフォルトの API 統合で REST API を使用している場合は、API キーをコピーして、次の形式で認証ヘッダーに貼り付けます。GenieKey <API key>
例:GenieKey g4ff854d-a14c-46a8-b8f0-0960774319dd

アラートの作成と処理のルールを定義する

API 統合設定には、さまざまなアラート シナリオの定義が含まれます。これらのシナリオでは、アラートの作成、クローズ、承認などの方法とタイミングを指定します。統合には、アラート作成および処理ルールの既定のセットが付属しています。それらをカスタマイズして、必要なだけ独自のルールを追加できます。たとえば、アラート作成に 3 つのルールを追加できます。この場合、受信データがこれらの 3 つのシナリオに対して順に評価され、そのうちの 1 つのルールに一致すれば、アラートが作成されます。ただし、API 統合の動作には若干の違いがあります。他の統合とは異なり、使用している特定のエンドポイントのルールのみが考慮されます。たとえば、「アラートをクリア」リクエストを送信すると、「アラートを作成」セクションのルールのみがチェックされ、他のアラート処理ルールがある場合はそれと一致させようとしてカスケードが続行されません。

統合設定の詳細をご確認ください。