We're updating our terminology in Jira

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

Microsoft Azure と統合する

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

Microsoft Azure のロゴ

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

​統合によって何ができますか?

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

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

統合による機能

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

統合をセットアップする

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

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

  • Azure で統合を設定する

Azure 統合を追加する

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

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

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

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

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

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

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

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

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

  7. [統合を設定する手順] セクションを展開し、ご利用のアカウント用に生成された統合 URL をコピーします。この URL は、後ほど Azure で統合を設定する際に使用します。

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

Azure で統合を設定する

Azure Webhook アラートは Azure Preview Portal でのみ使用できます。クラシック バージョンを使用している場合は、電子メール統合を使用してください。

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

  1. Azure ポータルで [Browse (参照)] を選択します。

  2. アラートを生成するリソースを選択します。

  3. [Monitor (監視)] セクションで [Alerts (アラート)] を選択します。

  4. [Manage actions (アクションの管理)] タブに移動します。

  5. [Add-action-group] を選択して新しいアクション グループを作成します。
    アクションを追加する際は、アクション タイプに [Webhook] を選択します。

  6. Jira Service Management で統合を追加する際にコピーした統合 URL を [URL] に貼り付けます。

  7. 変更を保存します。

  8. 必要に応じて、共通のアラート スキーマを有効にします。

  9. [Manage alert rules (アラート ルールの管理)] に移動します。

  10. ルールを作成するか、既存のルールを編集します。

  11. アラートを作成する条件を追加します。

  12. ステップ 5 で作成した Webhook アクション グループを [Action Group (アクション グループ)] セクションに追加します。

  13. 変更を保存します。

Azure (クラシック) から送信されるペイロードのサンプル

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

{ "status": "Activated", "context": { "id": "/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourceGroups/montest/providers/microsoft.insights/alertrules/Alert_1_runscope12", "name": "Alert_1_runscope12", "description": "desc", "conditionType": "Metric", "condition": { "metricName": "Memory available", "metricUnit": "Bytes", "metricValue": "1032190976", "threshold": "2", "windowSize": "5", "timeAggregation": "Average", "operator": "GreaterThan" }, "subscriptionId": "1a66ce04-b633-4a0b-b2bc-a912ec8986a6", "resourceGroupName": "montest", "timestamp": "2015-09-18T01:02:35.8190994Z", "resourceName": "helixtest1", "resourceType": "microsoft.compute/virtualmachines", "resourceId": "/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourceGroups/montest/providers/Microsoft.Compute/virtualMachines/Helixtest1", "resourceRegion": "centralus", "portalLink": "http://portallink.com" }, "properties": { "hello1": "World1!", "json_stuff": { "type": "critical", "color": "red" }, "customId": "wd39ue9832ue9iuhd9iuewhd9edh", "send_emails_to": "someone@somewhere.com" } }

Jira Service Management によって解析されるペイロード (JSON 形式)

{ "status": "Activated", "id": "/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourceGroups/montest/providers/microsoft.insights/alertrules/Alert_1_runscope12", "name": "Alert_1_runscope12", "description": "desc", "condition_type": "Metric", "condition_metric_name": "Memory available", "condition_metric_unit": "Bytes", "condition_metric_value": "1032190976", "condition_threshold": "2", "condition_window_size": "5", "condition_time_aggregation": "Average", "condition_operator": "GreaterThan", "subscription_id": "1a66ce04-b633-4a0b-b2bc-a912ec8986a6", "resource_group_name": "montest", "timestamp": "2015-09-18T01:02:35.8190994Z", "resource_name": "helixtest1", "resource_type": "microsoft.compute/virtualmachines", "resource_id": "/subscriptions/1a66ce04-b633-4a0b-b2bc-a912ec8986a6/resourceGroups/montest/providers/Microsoft.Compute/virtualMachines/Helixtest1", "resource_region": "centralus", "portal_link": "http://portallink.com" }

Azure (最新) から送信されるペイロードのサンプル

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

{"schemaId":"AzureMonitorMetricAlert","data": { "version": "2.0", "status": "Activated", "context": { "timestamp": "2018-02-28T10:44:10.1714014Z", "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Contoso/providers/microsoft.insights/metricAlerts/StorageCheck", "name": "StorageCheck", "description": "", "conditionType": "SingleResourceMultipleMetricCriteria", "condition": { "windowSize": "PT5M", "allOf": [ { "metricName": "Transactions", "dimensions": [ { "name": "AccountResourceId", "value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Contoso/providers/Microsoft.Storage/storageAccounts/diag500" }, { "name": "GeoType", "value": "Primary" } ], "operator": "GreaterThan", "threshold": "0", "timeAggregation": "PT5M", "metricValue": 1.0 } ] }, "subscriptionId": "00000000-0000-0000-0000-000000000000", "resourceGroupName": "Contoso", "resourceName": "diag500", "resourceType": "Microsoft.Storage/storageAccounts", "resourceId": "/subscriptions/1e3ff1c0-771a-4119-a03b-be82a51e232d/resourceGroups/Contoso/providers/Microsoft.Storage/storageAccounts/diag500", "portalLink": "https://portal.azure.com/#resource//subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Contoso/providers/Microsoft.Storage/storageAccounts/diag500" }, "properties": { "key1": "value1", "key2": "value2" } } }

Jira Service Management によって解析されるペイロード (JSON 形式)

{ "schemaId": "AzureMonitorMetricAlert", "version": "2.0", "status": "Activated", "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Contoso/providers/microsoft.insights/metricAlerts/StorageCheck", "name": "StorageCheck", "description": "", "condition_type": "SingleResourceMultipleMetricCriteria", "condition_metric_name": "Transactions", "condition_dimensions" : "[{name=AccountResourceId, value=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Contoso/providers/Microsoft.Storage/storageAccounts/diag500}, {name=GeoType, value=Primary}]", "condition_metric_value": "1.0", "condition_threshold": "0", "condition_window_size": "PT5M", "condition_time_aggregation": "PT5M", "condition_operator": "GreaterThan", "subscription_id": "00000000-0000-0000-0000-000000000000", "resource_group_name": "Contoso", "timestamp": "2018-02-28T10:44:10.1714014Z", "resource_name": "diag500", "resource_type": "Microsoft.Storage/storageAccounts", "resource_id": "/subscriptions/1e3ff1c0-771a-4119-a03b-be82a51e232d/resourceGroups/Contoso/providers/Microsoft.Storage/storageAccounts/diag500", "portal_link": "https://portal.azure.com/#resource//subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/Contoso/providers/Microsoft.Storage/storageAccounts/diag500" }

 

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

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