• 製品
  • 使用を開始する
  • 関連ドキュメント
  • リソース

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

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

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

機能

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

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

  • 承認、クローズ、メモの追加などのチーム メンバーのアクションは、既定の 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 統合を追加する

双方向統合は Free プランと Standard プランではサポートされていません。他のすべての統合は FreeStandard でチーム レベルでサポートされています。ただし、送信統合を機能させるには、上位のプランにアップグレードする必要があります。Settings (歯車アイコン) > Products (Jira 設定の下) > OPERATIONS からサイト レベルで統合を追加できるのは、Premium プランと Enterprise プランのみです。

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

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

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

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

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

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

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

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

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

If you're using REST API with the default API integration, copy the API key and paste it into the Authorization header in the following format: GenieKey <API key>
For example: GenieKey g4ff854d-a14c-46a8-b8f0-0960774319dd

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

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

動的プロパティ (カスタム優先度、ペイロード、URL、ヘッダー) は API 統合では使用できません。

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

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。