Microsoft Azure Event Hubs と統合する

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

メトリック値に関するアラートルールの場合、指定されたメトリックの値が割り当てられたしきい値を超えると、アラートルールがアクティブになり、通知が送信されます。イベントに関するアラートルールの場合、ルールはすべてのイベントについて、または特定の数のイベントが発生した場合にのみ、通知を送信できます。

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

Azure Event Hubs ではメトリックに基づいてアラートを生成できます。Jira Service Management は、Azure によって生成されたアラートのディスパッチャーとして機能します。Jira Service Management では、オンコールスケジュールとエスカレーションに基づいて通知すべきユーザーを決定し、メール、テキストメッセージ (SMS)、電話、Android や iOS のプッシュ通知による通知を行います。

Jira Service Management では新しい Azure メトリックアラートもサポートされています。Azure の新しいメトリックアラートでは、新しい Azure ペイロードに新しいフィールドが追加されています。そのため、これらをサポートするように統合を設定できます。詳細については「Azure Monitor のメトリックアラートでサポートされているリソース - Azure Monitor」をご確認ください。

統合による機能

Azure Event Hubs でアラートが作成されると、統合を通じて Jira Service Management でアラートが自動的に作成されます。

統合をセットアップする

Azure Event Hubs は API ベースの統合です。設定は次の手順で行います。

Jira Service Management で Azure Event Hubs 統合を追加する
Azure Event Hubs で統合を設定する

Azure Event Hubs 統合を追加する

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

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

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

チームのオペレーションページに移動します。
左側のナビゲーションパネルで、[統合]、[統合を追加] の順に選択します。
検索を実行して「Azure Event Hubs」を選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
[統合を設定する手順] セクションを展開して、ご利用のアカウント用に生成された統合 URL をコピーします。
この URL は、後ほど Azure で統合を設定する際に使用します。
[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。

Azure Event Hubs で統合を設定する

Azure Event Hubs で統合を設定するには、次の手順を実行します。

Azure ポータルで「Events Hubs」ページにアクセスします。
アラートの追加先となるイベントハブの名前スペースを参照します。
[監視] セクションで [アラート] を選択します。
[アクショングループ] タブに移動します。
[作成] を選択して新しいアクショングループを作成します。
アクションを追加する際は、アクションタイプに [Webhook] を選択します。
さきほど Jira Service Management からコピーした統合 URL を [URI] に貼り付けます。
必要に応じて、共通のアラートスキーマを有効にします。
変更を保存します。
[アラートルール] タブに移動します。
ルールを作成するか、既存のルールを編集します。
アラートをフィルタリングするための条件を追加します。
[アクショングループ] セクションで、ステップ 5 で作成した Webhook アクショングループを追加します。
変更を保存します。

Azure メトリックアラートから送信されたペイロードのサンプル

アラートペイロード (JSON 形式) を作成する

{
    "schemaId": "AzureMonitorMetricAlert",
    "data": {
        "version": "2.0",
        "properties": null,
        "status": "Activated",
        "context": {
            "timestamp": "2020-06-24T10:28:19.3462700Z",
            "id": "/subscriptions/25b83e19-ab0d-4579-ad81-asdas-sadasda/resourceGroups/test_eventhub_group/providers/microsoft.insights/metricalerts/test-eventhub-alerts",
            "name": "test-eventhub-alerts",
            "description": "test description for alert",
            "conditionType": "SingleResourceMultipleMetricCriteria",
            "severity": "3",
            "condition": {
                "windowSize": "PT1M",
                "allOf": [{
                    "metricName": "SuccessfulRequests",
                    "metricNamespace": "Microsoft.EventHub/namespaces",
                    "operator": "GreaterThan",
                    "threshold": "2",
                    "timeAggregation": "Total",
                    "dimensions": [{
                        "name": "ResourceId",
                        "value": "25b83e19-ab0d-4579-ad81-d0280e506bb3:test-eventhub-og"
                    }, {
                        "name": "EntityName",
                        "value": "test-eventhub"
                    }, {
                        "name": "OperationResult",
                        "value": "Success"
                    }],
                    "metricValue": 8.0,
                    "webTestName": null
                }, {
                    "metricName": "IncomingRequests",
                    "metricNamespace": "Microsoft.EventHub/namespaces",
                    "operator": "GreaterThan",
                    "threshold": "3",
                    "timeAggregation": "Total",
                    "dimensions": [{
                        "name": "ResourceId",
                        "value": "25b83e19-ab0d-4579-ad81-d0280e506bb3:test-eventhub-og"
                    }, {
                        "name": "EntityName",
                        "value": "test-eventhub"
                    }],
                    "metricValue": 8.0,
                    "webTestName": null
                }]
            },
            "subscriptionId": "25b83e19-ab0d-4579-ad81-d0280e506bb3",
            "resourceGroupName": "test_eventhub_group",
            "resourceName": "test-eventhub-og",
            "resourceType": "Microsoft.EventHub/namespaces",
            "resourceId": "/subscriptions/25b83e19-ab0d-4579-ad81-d0280e506bb3/resourceGroups/test_eventhub_group/providers/Microsoft.EventHub/namespaces/test-eventhub-og",
            "portalLink": "https://portal.azure.com/#resource/subscriptions/25b83e19-ab0d-4579-ad81-d0280e506bb3/resourceGroups/test_eventhub_group/providers/Microsoft.EventHub/namespaces/test-eventhub-og"
        }
    }
}

Azure 共通アラートスキーマから送信されたペイロードのサンプル

(JSON 形式)

{
    "schemaId": "azureMonitorCommonAlertSchema",
    "data": {
        "essentials": {
            "alertId": "/subscriptions/25b83e19-ab0d-4579-ad81-d0280e506bb3/providers/Microsoft.AlertsManagement/alerts/7ccad036-8973-49e9-b628-a18350fb32bb",
            "alertRule": "test-eventhub-alerts",
            "severity": "Sev3",
            "signalType": "Metric",
            "monitorCondition": "Fired",
            "monitoringService": "Platform",
            "alertTargetIDs": ["/subscriptions/25b83e19-ab0d-4579-ad81-d0280e506bb3/resourcegroups/test_eventhub_group/providers/microsoft.eventhub/namespaces/test-eventhub-og"],
            "originAlertId": "25b83e19-ab0d-4579-ad81-d0280e506bb3_test_eventhub_group_microsoft.insights_metricalerts_test-eventhub-alerts_-121967519",
            "firedDateTime": "2020-06-29T18:41:05.7016722Z",
            "description": "",
            "essentialsVersion": "1.0",
            "alertContextVersion": "1.0"
        },
        "alertContext": {
            "properties": null,
            "conditionType": "SingleResourceMultipleMetricCriteria",
            "condition": {
                "windowSize": "PT1M",
                "allOf": [{
                    "metricName": "SuccessfulRequests",
                    "metricNamespace": "Microsoft.EventHub/namespaces",
                    "operator": "GreaterThan",
                    "threshold": "2",
                    "timeAggregation": "Total",
                    "dimensions": [{
                        "name": "ResourceId",
                        "value": "25b83e19-ab0d-4579-ad81-d0280e506bb3:test-eventhub-og"
                    }, {
                        "name": "EntityName",
                        "value": "test-eventhub"
                    }, {
                        "name": "OperationResult",
                        "value": "Success"
                    }],
                    "metricValue": 4.0,
                    "webTestName": null
                }],
                "windowStartTime": "2020-06-29T18:38:52.06Z",
                "windowEndTime": "2020-06-29T18:39:52.06Z"
            }
        }
    }
}

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

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問