Logstash と統合する

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

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

Logstash は、出力プラグインを介してイベント情報を送信します。Jira Service Management の Logstash 統合によって、Jira Service Management はこれらのイベントのディスパッチャーとして機能して、オンコールスケジュールに基づいて通知する適切な担当者を決定します。メール、テキストメッセージ (SMS)、電話、iPhone や Android のプッシュ通知によって通知し、アラートが確認されるかクローズされるまでアラートをエスカレートします。

統合による機能

Logstash イベントに基づいて、次のことが実行されます。

Jira Service Management でアラートが作成されます。
指定されたアラートが承認されます。
指定されたアラートにメモが追加されます。
指定されたアラートはクローズされます。

統合をセットアップする

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

Jira Service Management で Logstash 統合を追加する
Logstash で統合を設定する

Logstash 統合を追加する

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

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

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

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

Logstash で統合を設定する

Logstash と Jira Service Management の統合を設定するには、次の手順を実行します。

Logstash 用の Jira Service Management プラグインをインストールします。プラグインのインストール方法をご確認ください。
- Logstash 5.4+: bin/logstash-plugin install logstash-output-jsm
- その他のバージョン: bin/plugin install logstash-output-jsm
設定ファイルに次の設定を追加します。
JSON
1 2 3 4 5output { jsm { "apiKey" => "logstash_integration_api_key" } }
先ほどコピーした API キーを [APIKey] に貼り付けます。
Jira Service Management 出力プラグインは、イベントに [jsmAction] というフィールドが含まれていることを想定しています。また、Jira Service Management はデータを特定の構造で想定しているため、イベントにいくつかのフィールドが追加されます。フィールドを追加するには、Mutate や Grokなどのフィルタープラグインを使用します。イベントに追加するフィールドとその意味についてご確認ください。

以下は、Ruby フィルタープラグインの設定で強化された Mutate フィルターの例です。

JSON

filter {
  mutate{
    add_field => {
        "jsmAction" => "create"
        "alias" => "neo123"
        "description" => "Every alert needs a description"
        "actions" => ["Restart", "AnExampleAction"]
    "tags" => ["OverwriteQuietHours","Critical"]
    "[details][prop1]"=> "val1"
        "[details][prop2]" => "val2"
        "entity" => "An example entity"
        "priority" => "P4"
    "source" => "custom source"
    "user" => "custom user"
    "note" => "alert is created"
        }
    }
    ruby {
     code => "event.set('teams', [{'name' => 'Integration'}, {'name' => 'Platform'}])"
    }
}

4. Logstash を実行します。

GitHub でプラグインソースをご確認ください。

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

正確ではなかった

明確ではなかった

関係なかった

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

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

コミュニティに質問