メールを Opsgenie と統合する

概要

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

Opsgenie provides product-specific integration plugins for many widespread monitoring tools, the command-line utility lamp, and any software system that can send HTTPS/JSON requests for integration. You can add email-based integrations from your team’s operations page.

統合をセットアップする

統合を追加する

1. [設定] > [統合] の順に移動します。

2. 検索を実行して「Email」を選択します。

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

4. オプション: 特定のチームが統合からのアラートを受信するようにする場合は、[Assignee team (担当者チーム)] のチームを選択します。 Opsgenie でのアラート通知のフローをご確認ください。

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

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

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

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

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

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

アラート作成の詳細設定

基本設定では、最小限の設定でアラートが作成されます。詳細設定では次のことができます。

• 異なるメールについて異なる人に通知するためのルールを定義する

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

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

詳細設定では、メールに適用できるいくつかの「アクション」(さまざまな種類のルール) がサポートされています。

• ignore

• アラートの作成

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

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

• メモの追加

• Heartbeat

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

アラート フィルター

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

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

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

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

• From Name (差出人名)

• 送信元アドレス

• サマリ概要

• Conversation Subject (会話の件名)

• メールのメッセージ フィールド。[Conversation Subject (会話の件名)] は、メールの返信および転送に関連するプレフィクスを無視した、メールの件名フィールドです。

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

無視アクション

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

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

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

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

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

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

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

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

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

• 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.

• [メモ] は、アラートが作成されるときにアラートに追加されるテキスト メッセージです。

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

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

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

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

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