メールと統合する

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

Jira Service Management は、広く普及している多くの監視ツールや、統合用に HTTPS/JSON リクエストを送信できるあらゆるソフトウェアシステムで利用可能な、製品固有の統合プラグインを提供しています。チームの運用ページからメール ベースの統合を追加できます。

統合をセットアップする

メール統合を設定するには、次の手順に従います。

1. チームの運用ページに移動します。

2. On the left navigation panel, select Integrations and then Add integration.
   Adding integrations may share data outside your environment. We recommend that you assess and evaluate potential risks before adding an integration.

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

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

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

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

7. [統合を設定する手順] セクションを展開します。ここには、メール統合が割り当てられるカスタマイズ可能なメール アドレスが表示されます。

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

Jira Service Management では、指定されたメール アドレスに送信されるメールごとにアラートが作成されます。既定では、メール統合はアラート メッセージとしてメールの件名を使用し、メールの本文はアラートの説明フィールドに表示されます。受信メールが HTML 形式の場合、Jira Service Management は元のメールもアラートに添付します。

• メール統合をオフにすると、Jira Service Management はそのメール アドレスに送信されたメールを無視します。

• 通知をオフにすると、Jira Service Management はアラートを作成しますが、通知は届きません。

アラート ルールを設定する

Jira Service Management の既定のセットアップでは、最小限の設定でアラートが作成されます。統合の詳細設定では、次のことができます。

• 異なるメールについてチーム内の異なるメンバーに通知するためのルールを定義する

• 個別のアラートを作成するのではなく、解決/リカバリ メールを使用してアラートを承認またはクローズするルールを定義する

• Jira Service Management で文字列処理メソッドを使用してメールを解析することにより、アラートの内容を変更する

作成してメールに適用できるさまざまなタイプのアラート ルールを次に示します。

• ignore

• アラートの作成

• Close Alert (アラートのクローズ)

• Acknowledge Alert (アラートの承認)

• メモの追加

• Heartbeat

各アラート ルール タイプには、受信メールの処理に関するアクションを決定するフィルターが関連付けられています。各メールは 1 つのアクションによってのみ処理され、アクションはトップダウンの順序で評価されます。アラートに一致する最初のルールが、そのアラートに関連付けられたアクションを実行します。たとえば、メールがアラート作成アクションのフィルターに一致する場合、そのメールはクローズ アクションや承認アクションには使用されません。アクションのタイプごとに、複数のアクションを作成できます。

アラート フィルター

• すべてのアラート: 使用条件なし

• いずれかの条件に一致するアラートのみ: 定義された条件のいずれかが true (OR 演算子)。

• すべての条件に一致するアラートのみ: 定義された条件がすべて true (AND 演算子)。

以下の項目に基づいてフィルターのルールを定義します。

• From Name (差出人名)

• 送信元アドレス

• サマリ概要

• Conversation Subject (会話の件名): メールの返信と転送に関連するプレフィクスを無視した、メールの件名フィールド。

• メールのメッセージ フィールド

Alert actions (アラート アクション)

無視アクション

メールによっては、有用な情報が含まれていない場合があります。無視アクションでは、定義されたフィルターに一致するメールを破棄できます。たとえば、メールの件名に「test」という文字列を含むすべてのメールを破棄するアクションを設定できます。

アラートの作成アクション

アラート作成アクションは、定義されているフィルターをメールが通過した場合に、Jira Service Management でアラートを作成します。基本設定で説明されているように、既定の設定では、メールの件名がアラート メッセージとして使用され、本文が説明として使用されます。アラート作成アクションを使用すると、メールの処理方法をカスタマイズできます。文字列ユーティリティを使用して、メールから情報を抽出し、アラート フィールドに入力できます。

アラートの作成アクションの設定には、変更可能なフィールドがいくつかあります。Jira Service Management では、メール情報 (差出人名、件名など) をタグとして使用でき、UI でこれらのタグをアラート フィールドにドラッグできるようサポートしています。これらのタグの値は、直接指定するか、メール変数から抽出されます。

• [メッセージ] フィールドにはアラート テキストが含まれます。

• [エイリアス] フィールドは、アラート処理において重要な役割を果たす特別なアラート フィールドであり、Jira Service Management のオープン アラートに対するユーザー定義の一意の識別子として考えることができます。Jira Service Management では、同じエイリアスを持つオープン アラートは 1 つしか存在できません。これにより、Jira Service Management は、1) 同一/類似のアラートを重複除外し、2) アラートを識別できます。そのため、既存のアラートをアップデート (承認、メモの追加、クローズなど) できるように、[エイリアス] フィールドを適切に設定することが不可欠です。

• [チーム] フィールドは、アラートの通知先のチームを示します。このフィールドでチームが定義されると、Jira Service Management はそのエスカレーションを使用して通知するユーザーを決定します。

• [エンティティ] は、アラートが関連付けられているエンティティの名前 (サーバー名、アプリ名など) です。

• [ソース] はアラートの発生元を示します。通常は、監視ツールの名前またはメール送信元アドレスです。

• Tags are labels used for easier identification and categorization of alerts. Use commas in between for multiple tags.

• Actions: The list of actions a recipient can execute to respond to an alert. Use commas in between multiple actions.

• 説明: アラートの詳細な説明。[メッセージ] フィールドに収まらないものはすべてここに入力できます。

• Extra Properties: Additional alert properties. Enter the property's name in the first field and the value in the second.

• メモ: アラートが作成されるときにアラートに追加されるテキスト メッセージ。

• [ユーザー]: アラートに追加されるメモの所有者。

アラートのクローズ アクション

Jira Service Management では、個別のアラートを作成するのではなく、リカバリ メールを使用して既存のアラートをクローズすることにより、アラートの数を減らすことができます。他のアクションと同様に、アラートのクローズ アクションにもフィルターがあります。アラートのクローズ アクションには、3 つのフィールドがあります。[エイリアス] は唯一の必須フィールドであり、どのアラートをクローズするかを識別するために不可欠です。[ユーザー] フィールドと [メモ] フィールドが指定されている場合、クローズされる前にアラートにメモが追加されます。

アラートの承認アクション

Jira Service Management では、承認済みアラートとは、誰かがアラートを確認してそのアラートの担当になったことを示します。監視ツールでアラートの承認がサポートされ、アラートが承認されたときにメールを送信できる場合、これらのメールを使用して Jira Service Management でアラートを承認することもできます。アラートの承認アクションの設定は、アラートのクローズ アクションの設定と同じです。