Amazon EventBridge と統合する

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

ルーティングルールを設定して、データを送信する場所を決定して、すべてのデータソースにリアルタイムで反応するアプリアーキテクチャを構築できます。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 プランではサポートされていません。他のすべての統合は Free と Standard でチームレベルでサポートされています。ただし、送信統合を機能させるには、上位のプランにアップグレードする必要があります。Settings (歯車アイコン) > Products (Jira 設定の下) > OPERATIONS からサイトレベルで統合を追加できるのは、Premium プランと Enterprise プランのみです。

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

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

チームの運用ページに移動します。
左側のナビゲーションパネルで、[Integrations (統合)] を選択して、次に [Add integration (統合を追加)] を選択します。検索を実行して「Amazon EventBridge」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
[統合を設定する手順] セクションを展開して、API キーをコピーします。
このキーは、後ほど Amazon EventBridge で統合を設定する際に使用します。
次のパラメーターの値を入力して、送信認証を設定します。
- Amazon AWS アカウント ID: AWS アカウントを一意に識別する 12 桁の数字。
- リージョン: パートナーイベントソースを作成する必要がある AWS リージョン。
変更を保存します。
[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。

Amazon EventBridge で統合を設定する

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

AWS EventBridge パートナーのイベント・ソース・ページに移動し、aws.partner/opsgenie.com/{{IntegrationID}} という名前の新しく作成されたイベント・ソースを選択し、[Associate with event bus（イベント・バスに関連付ける）] をクリックして設定ダイアログに従います。このステップの後、Jira Service Management パートナー・イベント・ソースの設定が行われます。
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）] オプションを見つけてください。
[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
    }
}

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

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問