We're updating our terminology in Jira

'Issue' is changing to 'work item'. You might notice some inconsistencies while this big change takes place.

Amazon EventBridge と統合する

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

Amazon EventBridge ロゴ

ルーティング ルールを設定して、データを送信する場所を決定して、すべてのデータ ソースにリアルタイムで反応するアプリ アーキテクチャを構築できます。Amazon EventBridge では、イベントの取り込みと配信、セキュリティ、承認、エラー処理を代行するため、イベント駆動型アプリを簡単に構築できます。

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

Jira Service Management の Amazon EventBridge 統合を使用して、Jira Service Management のアラート イベントを Amazon EventBridge に転送します。Jira Service Management で統合を作成すると、aws.partner/jsm.com/{{integrationId}} という名前のイベント ソースが自動で作成されます。

統合による機能

イベント ソースに添付されたルールに応じて、アラートイベントは SNS、SQS、Lambda、Kinesis、CloudWatch、SSM などのさまざまな AWS サービスに転送できます。

統合をセットアップする

Amazon EventBridge は発信型の統合です。設定は次の手順で行います。

  • Jira Service Management で Amazon EventBridge 統合を追加する

  • Amazon EventBridge で統合を設定する

Amazon EventBridge 統合を追加する

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

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

Jira Service Management で Amazon EventBridge 統合を追加するには、次の手順に従います。

  1. チームの運用ページに移動します。

  2. 左側のナビゲーションパネルで、[Integrations (統合)] を選択して、次に [Add integration (統合を追加)] を選択します。検索を実行して「Amazon EventBridge」を選択します。

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

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

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

  6. [統合を設定する手順] セクションを展開して、API キーをコピーします。
    このキーは、後ほど Amazon EventBridge で統合を設定する際に使用します。

  7. 次のパラメーターの値を入力して、送信認証を設定します。

    • Amazon AWS アカウント ID: AWS アカウントを一意に識別する 12 桁の数字。

    • リージョン: パートナー イベント ソースを作成する必要がある AWS リージョン。

  8. 変更を保存します。

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

Amazon EventBridge で統合を設定する

Jira Service Management を通じて統合を作成すると、Amazon EventBridge でパートナー イベント ソースが作成されます。

  1. AWS EventBridge パートナーのイベント ソース ページに移動し、aws.partner/opsgenie.com/{{IntegrationID}} という名前の新しく作成されたイベント ソースを選択し、[Associate with event bus (イベント バスに関連付ける)] をクリックして設定ダイアログに従います。このステップの後、Jira Service Management パートナー イベント ソースの設定が行われます。

  2. Jira Service Management パートナー イベント ソースでイベントを使用するには、AWS EventBridge ルール作成ページに移動して、ルールに Jira Service Management と説明 (オプション) を入力します。Jira Service Management イベントをリッスンするには、[Define pattern (パターンの定義)] セクションで [Event pattern (イベント パターン)] オプションを選択し、[Event matching pattern (イベント マッチング パターン)] セクションで [Pre-defined pattern by service (サービスごとの事前定義パターン)] オプションを選択し、次に [サービス プロバイダー] セクションで [Service partners (サービス パートナー)] オプションを選択し、[サービス名] セクションで [Atlassian - Opsgenie (アトラシアン-Opsgenie)] オプションを見つけてください。

  3. [Select event bus (イベント バスを選択)] セクションで、[Custom or partner event bus (カスタムまたはパートナー イベント バス)] オプション、新規作成した Jira Service Management イベント ソースの順に選択します。[Select targets (ターゲットの選択)] セクションで、Jira Service Management イベント ペイロードをルーティングするターゲットを設定します。この例では、ペイロードを AWS Lambda 関数にルーティングします。必要に応じて、ルールにタグを追加して [作成] をクリックします。

Amazon EventBridge イベント バスに送信されたイベント ペイロードの例

JSON

{ "version": "0", "id": "c5f44bbb-34de-133d-eaff-5f52ff5ad720", "detail-type": "Create", "source": "aws.partner/jsm.com/1b8db399-7dc4-4f40-85fa-0fde193085c9", "account": "123456789012", "time": "2019-12-04T13:05:06Z", "region": "us-west-2", "resources": [], "detail": { "alertId": "66d9ff87-b253-442c-9d4d-5c2c539f9a31-1575464706692", "message": "Sample alert message!", "tags": [ "tag1", "tag2" ], "tinyId": "318", "source": "sample.email@gmail.com", "entity": "entity1", "alias": "alias1", "createdAt": 1575464706692, "updatedAt": 1575464707610000000, "username": "sample.email@gmail.com", "userId": "d047b539-a9a8-4475-91f2-30b7fb25a474", "userFullName": "John Doe", "description": "Sample alert description.", "team": "Engineering Team A", "responders": [ { "id": "df01caee-345c-4f85-a94f-5b1a4cdfc7f8", "type": "team", "name": "Engineering Team A" } ], "oldTeams": [], "teams": [ "df01caee-345c-4f85-a94f-5b1a4cdfc7f8" ], "teamsForVisibility": [ "df01caee-345c-4f85-a94f-5b1a4cdfc7f8" ], "actions": [ "action1", "action2" ], "tag": [ "tag1", "tag2" ], "details": { "property1": "value1" }, "priority": "P3", "status": "open", "acknowledged": false } }

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

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