概要

Mailgun is an API-based email delivery platform that allows you to:

  • Build and manage large-scale email marketing applications.
  • トランザクションメッセージを送信し、追跡する。
  • 無効なメールアドレスをリストから削除する。
  • 配信率を向上させ、コンバージョン率を高める。

Datadog とインテグレーションすることで、メール配信やエンゲージメントのメトリクスやログを収集し、Mailgun サービスのパフォーマンスを追跡することができます。

セットアップ

ドメインの追加と確認

  1. Mailgun アカウントにログインします。
  2. 左側のサイドバーで、Sending をクリックします。メニューが展開されます。Domains を選択します。
  3. 右上の Add New Domain をクリックします。
  4. ドメイン名とリージョンを入力し、Add Domain をクリックします。
  5. Mailgun ドキュメントの指示に従って、ドメインを確認します。

Mailgun API キーの表示

Mailgun にサインアップすると、プライマリアカウントの API キーがあなたのために作成されます。 このキーは、私たちの様々な API エンドポイントを通して、そしてあなたの送信ドメインのいずれに対しても、すべての CRUD 操作を実行することができます。

  1. Mailgun アカウントにログインします。
  2. 右上の自分の名前をクリックし、ドロップダウンを開きます。
  3. API Keys をクリックします。
  4. Private API Key の横にある目のアイコンをクリックします。

メトリクスの収集を有効にする

  1. Datadog の Mailgun インテグレーションタイル内のコンフィギュレーションタブに移動します。
  2. ドメイン名とドメインのリージョンを入力します。
  3. 上記の手順で確認した API キーを貼り付けます。
  4. オプションで、カスタムタグを追加して、このインテグレーションのために収集されたすべてのメトリクスにタグを関連付けます。

ログ収集の有効化

イベントをログとして Datadog に転送するように Mailgun を構成することができます。詳しくは、Mailgun ドキュメントメッセージの追跡 - Webhooks のセクションをご覧ください。

  1. Mailgun インテグレーションタイルの説明から、生成された URL をコピーします。
  2. Mailgun アカウントにログインします。
  3. 左側列の Sending をクリックします。
  4. ドロップダウンの Webhooks をクリックします。
  5. 右上の Add webhook をクリックします。
  6. 追跡したいイベントの種類を選択します。
  7. ステップ 1 で生成した URL を URL に貼り付けます。
  8. Create Webhook をクリックします。

収集データ

メトリクス

mailgun.emails.accepted.total
(count)
Total number of emails accepted including both incoming and outgoing
Shown as email
mailgun.emails.accepted.incoming
(count)
Number of incoming emails accepted
Shown as email
mailgun.emails.accepted.outgoing
(count)
Number of outgoing emails accepted
Shown as email
mailgun.emails.delivered.total
(count)
Total number of emails sent and accepted by recipient email server
Shown as email
mailgun.emails.delivered.smtp
(count)
Number of SMTP emails sent and accepted by recipient email server
Shown as email
mailgun.emails.delivered.http
(count)
Number of HTTP emails sent and accepted by recipient email server
Shown as email
mailgun.emails.delivered.optimized
(count)
Number of Send Time Optimization emails sent and accepted by recipient email server
Shown as email
mailgun.emails.failed.temporary.total
(count)
Number of emails that temporarily failed to be delivered to recipient email server
Shown as email
mailgun.emails.failed.temporary.espblock
(count)
Number of emails that were blocked by the email service provider
Shown as email
mailgun.emails.failed.permanent.total
(count)
Number of emails that permanently failed to be delivered to recipient email server
Shown as email
mailgun.emails.failed.permanent.suppress_bounce
(count)
Number of emails that were dropped due to a previous bounce
Shown as email
mailgun.emails.failed.permanent.suppress_unsubscribe
(count)
Number of emails that were dropped due to a previous unsubscribe
Shown as email
mailgun.emails.failed.permanent.suppress_complaint
(count)
Number of emails that were dropped due to a previous complaint
Shown as email
mailgun.emails.failed.permanent.bounce
(count)
Number of emails that were bounced instead of delivered
Shown as email
mailgun.emails.failed.permanent.delayed_bounce
(count)
Number of emails that were bounced after a delay
Shown as email
mailgun.emails.failed.permanent.webhook
(count)
Number of webhook requests failed
Shown as request
mailgun.emails.failed.permanent.optimized
(count)
Number of Send Time Optimization emails failed
Shown as email
mailgun.emails.opened.total
(count)
Total number of times emails were opened by recipients
Shown as email
mailgun.emails.clicked.total
(count)
Number of times links were clicked in the emails
Shown as email
mailgun.emails.unsubscribed.total
(count)
Number of recipients who unsubscribed
Shown as email
mailgun.emails.complained.total
(count)
Number of recipients who complained
Shown as email
mailgun.emails.stored.total
(count)
Number of stored incoming messages
Shown as email
mailgun.emails.hourly.accepted.total
(count)
Total hourly number of emails accepted including both incoming and outgoing
Shown as email
mailgun.emails.hourly.accepted.incoming
(count)
Hourly number of incoming emails accepted
Shown as email
mailgun.emails.hourly.accepted.outgoing
(count)
Hourly number of outgoing emails accepted
Shown as email
mailgun.emails.hourly.delivered.total
(count)
Total hourly number of emails sent and accepted by recipient email server
Shown as email
mailgun.emails.hourly.delivered.smtp
(count)
Hourly number of SMTP emails sent and accepted by recipient email server
Shown as email
mailgun.emails.hourly.delivered.http
(count)
Hourly number of HTTP emails sent and accepted by recipient email server
Shown as email
mailgun.emails.hourly.delivered.optimized
(count)
Hourly number of Send Time Optimization emails sent and accepted by recipient email server
Shown as email
mailgun.emails.hourly.failed.temporary.total
(count)
Hourly number of emails that temporarily failed to be delivered to recipient email server
Shown as email
mailgun.emails.hourly.failed.temporary.espblock
(count)
Hourly number of emails that were blocked by the email service provider
Shown as email
mailgun.emails.hourly.failed.permanent.total
(count)
Hourly number of emails that permanently failed to be delivered to recipient email server
Shown as email
mailgun.emails.hourly.failed.permanent.suppress_bounce
(count)
Hourly number of emails that were dropped due to a previous bounce
Shown as email
mailgun.emails.hourly.failed.permanent.suppress_unsubscribe
(count)
Hourly number of emails that were dropped due to a previous unsubscribe
Shown as email
mailgun.emails.hourly.failed.permanent.suppress_complaint
(count)
Hourly number of emails that were dropped due to a previous complaint
Shown as email
mailgun.emails.hourly.failed.permanent.bounce
(count)
Hourly number of emails that were bounced instead of delivered
Shown as email
mailgun.emails.hourly.failed.permanent.delayed_bounce
(count)
Hourly number of emails that were bounced after a delay
Shown as email
mailgun.emails.hourly.failed.permanent.webhook
(count)
Hourly number of webhook requests failed
Shown as request
mailgun.emails.hourly.failed.permanent.optimized
(count)
Hourly number of Send Time Optimization emails failed
Shown as email
mailgun.emails.hourly.opened.total
(count)
Total hourly number of times emails were opened by recipients
Shown as email
mailgun.emails.hourly.clicked.total
(count)
Hourly number of times links were clicked in the emails
Shown as email
mailgun.emails.hourly.unsubscribed.total
(count)
Hourly number of recipients who unsubscribed
Shown as email
mailgun.emails.hourly.complained.total
(count)
Hourly number of recipients who complained
Shown as email
mailgun.emails.hourly.stored.total
(count)
Hourly number of stored incoming messages
Shown as email

Logs

Mailgun のイベントは、ソース mailgun の下にログとして表示されます。

イベント

Mailgun インテグレーションには、イベントは含まれません。

サービスチェック

Mailgun インテグレーションには、サービスのチェック機能は含まれません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。

PREVIEWING: may/unit-testing