メールによるイベント情報の送信

概要

Datadogの監視下にアプリケーションやシステムを統合する場合には、いくつかの統合方法の選択肢があります。 まず最初の選択肢は、Datadogが提供しているintegrationを利用することです。 これらのIntegrationを使うことによって、最小限の設定作業​で、多種多様なメトリクスやイベントの収集ができるようになります。 もしも、これから使用するアプリケーション用のIntegrationが準備されていなければ、Datadog Agentを使ってCheckを独自にプログラミングすることも選択できます。 この選択肢は、Integarationを利用するよりは手間を要し、又アプリケーションとDatadog Agent がどのように機能しているかの知識の必要とします。

Datadog Agent のCheckをプログラミングしたくない場合には、更に他の選択肢もあります。 システム又はアプリケーションにメールを送信させることで、Checkの代替わりをさせる選択肢です。 メールによるイベント情報の送信には、アプリケーション内からメールを生成するための自由度により、次の2つの方法が選択できます。

JSON形式 vs 平文形式

アプリケーションからDatadogに送信するメールを自由にコントロールできるなら、JSON形式でのメッセージ送信の設定をするとよいでしょう。この形式を使うことによって、イベントストリームに表示されるイベントに必要な情報の全てを送信することができるでしょう。

それぞれの例を以下に紹介します:

平文形式

メールの内容

平文形式でのイベント情報メールの送信では、、3個のフィールドが制御できます:

  • 送信者メールアドレス
  • 件名
  • 本文

イベントストリームでのイベント表示

注) メールの件名はイベントのタイトルになり、電子メールの本文はイベントの本体になることに注意してください。 イベントのタイトルと本文の最後にタグが表示されるように見えますが、どちらの部分もDatadogではタグとしては扱われてはいません。 メールの送信者は、イベント欄の一番下の部分に表示されますのでこの部分を有効に活用しアプリケーションの識別に利用するとよいでしょう。

JSON形式

メールの内容

JSON形式でのイベント情報メールの送信では、10個のフィールドが制御できます。それらは、送信者の電子メールアドレス、および9つのJSONのキー項目です:

  • 送信者メールアドレス
  • “title” :
  • “text” :
  • “priority” :
  • “tags” :
  • “alert type” :
  • “date happend” :
  • “host” :
  • “agrregation key” :
  • “source type name” :

イベントストリームでのイベント表示

JSON形式のメールでは、メールのタイトルは無視され、本文内のtitleで設定した内容に置き換えられます。 イベントに表示されるすべてのデータは、メールの本文にJSONで定義されている必要があります。 メール本文に記述するメッセージは、JSON記法に則って正しく整形されている必要があります。 本文内のJSON記法に問題を発見した場合、そのメールは処理されません。 従って本文内のJSONメッセージでは、キーと値がコンマを使って正しく記述されると同時に、純粋なJSON記法である必要があることを意味しています。

メールクライアントで本文に書き込むJSONメッセージの適合性をテストしている場合は、使用中のクライアントの設定によって、本文がHTMLに変換されていないかを事前に確認してください。このHTML変換が設定されている場合、本文のメッセージはJSON記法ではない形式の文字列に変換され、Datadogではこのメールを処理出来ません。

JSON形式で利用できるキーの詳細は、events API documentationで確認することができます。

メールアドレスの設定

メールの送信先を設定するには、Datadogアカウントにログインし、。IntegrationsメニューからAPIsを選択し、Events API Emailsのセクションまで移動します。

このセクションでは、Datadogがイベント情報を受信するために用意したメールアドレスと、そのメールアドレスの作成者が表示されています。

JSON Event Email API

新しくメールアドレスを追加する場合は、New API Emailのセクションで、送信するメールの形式をドロップダウンメニューで選択し、Create API Emailをクリックします。

JSON Event Email API