Jira Service Management の管理者向けの利用開始ガイド
最初に、Jira Service Management の使用を開始する方法を確認します。
この記事では、Jira Service Management Cloud の一部のお客様に段階的に展開されている、Jira Service Management でネイティブに利用できる新しいアラート機能を取り上げています。ご利用のサイトにはまだ表示されていないか、利用できない可能性があります。
Jira Service Management の Alert Logic 統合を使用して、Alert Logic アラートを Jira Service Management に転送します。Jira Service Management は、オンコール スケジュールに基づいて通知すべき担当者を決定します。メール、テキスト メッセージ(SMS)、電話、iOS や Android のプッシュ通知による通知を行い、アラートが承認またはクローズされるまでアラートをエスカレートします。
Alert Logic でアラートが作成されると、Jira Service Management でもアラートが作成されます。
Alert Logic は API ベースの統合です。次の手順に沿ってセットアップを行います。
Jira Service Management で Alert Logic 統合を追加する
Alert Logic で統合を設定する
双方向統合は Free プランと Standard プランではサポートされていません。他のすべての統合は Free と Standard でチーム レベルでサポートされています。ただし、送信統合を機能させるには、上位のプランにアップグレードする必要があります。Settings (歯車アイコン) > Products (Jira 設定の下) > OPERATIONS からサイト レベルで統合を追加できるのは、Premium プランと Enterprise プランのみです。
統合をチームの運用ページから追加すると、そのチームが統合の所有者になります。つまり、Jira Service Management は、この統合を通じて受信したアラートをチームにのみ割り当てます。
Jira Service Management で Alert Logic 統合を追加するには、次の手順を実行します。
チームの運用ページに移動します。
左側のナビゲーション パネルで、[統合]、[統合を追加] の順に選択します。
「Alert Logic」を検索して、選択します。
次の画面で、統合の名前を入力します。
オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。
[続行] を選択します。
この時点で、統合が保存されます。
[統合を設定する手順] セクションを展開して、Webhook URL をコピーします。
この Webhook URL は、後ほど Alert Logic で統合を設定する際に使用します。
[統合をオンにする] を選択します。
統合のために作成したルールは、統合をオンにした場合にのみ機能します。
Alert Logic と Jira Service Management の統合を設定するには、次のステップを実行します。
Alert Logic で [管理] > [通知] > [Webhook] の順に移動します。
[+新規追加] を選択します。
Webhook の名前とタイトルを入力します。
先ほどコピーした統合 API URL を [URL] に貼り付けます。
[保存] を選択します。
[管理] > [通知] > [ポリシー] の順に移動します。
ポリシーを編集するか、新しいポリシーを作成します。
先ほど Jira Service Management からコピーした Webhook URL を [アラート受信者] に貼り付けます。
保存 を選択します。
アラート ペイロード (JSON 形式) を作成する
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
{
"aggregated_alerts_count": 0,
"additional_content": [],
"alert_definition_type_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"customer_id": 111111,
"data": {
"message": "Alert Date : 2016-01-15 21:53:09 GMT\nCustomer Name : Your-customer-name\n\nAlert Type : log\nAlert Name : Log Correlation Alert Test - Your-customer-name\nMessage Type : Unix DHCP IP Assigned\n\nLogEvent link:\nhttps://invision.alertlogic.net/log_message.php?id= XXXXXXXXXXXXX",
"alert_rule_id": 1111,
"source": "correlation_alert_rules"
},
"description": "Your-customer-name LogEvent: Log Correlation Alert - Your-customer-name",
"id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"product": {
"name": "Log Manager"
},
"severity": "warning",
"state": "created",
"tags": ["example_tag", "example_tag2"],
"timestamp": 1452894789,
"type": "correlation",
"deleted": false,
"notifications": [
{
"id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"timestamp": 1452894789,
"alert_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"status": "pending",
"updated": 1452894789,
"policy_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"target_id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"target_cid": 111111,
"target_label": "testing",
"target_channel": "webhook",
"target_target": "http://your-web-hook-url/",
"target_contact_id": null
}
]
}
Jira Service Management ではペイロードは次のように解析されます。
JSON
1
2
3
4
5
6
7
8
9
10
11
{
"aggregatedAlertCount" : 0
"description" : "Alert Date : 2016-01-15 21:53:09 GMT\nCustomer Name : Your-customer-name\n\nAlert Type : log\nAlert Name : Log Correlation Alert Test - Your-customer-name\nMessage Type : Unix DHCP IP Assigned\n\nLogEvent link:\nhttps://invision.alertlogic.net/log_message.php?id= XXXXXXXXXXXXX"
"message" : "Your-customer-name LogEvent: Log Correlation Alert - Your-customer-name"
"productName" : "Log Manager"
"severity" : "warning"
"source" : "correlation_alert_rules"
"state" : "created"
"type" : "correlation"
"tags" : "example_tag", "example_tag2"
}
この内容はお役に立ちましたか?