Synthetic Mail Configuration Guide
Guide to deploying the Datadog Synthetic Mail integration from the Datadog marketplace

This integration monitors email mailboxes and measures full send-receive synthetic messages deliveries. The integration uses three geographical source locations for the synthetic email deliveries: Virginia (US), Frankfurt (EU) and Sydney (AP). The check works by sending a test email from the address [email protected] and then waiting for a auto-reply from your mailbox back to us. The integration measures the number of hops, round-trip-time, and the test results (pass/fail).

Install the Synthetic Mail Integration. Obtain the command to download the agent by activating the free trial in the Marketplace.

  1. 1.
    Create a mailbox for receiving synthetic email probes. The mailbox should not be used for other message activity because the forwarding rule of the mailbox is used for round-trip synthetic measurements.
  2. 2.
    Configure the target email address mailbox to auto-forward emails to [email protected]. Optionally configure your email forwarding configuration to disable copies of the forwarded email.
  3. 3.
    Set the target email address configured in steps 1 and 2 by updating email_address: {[email protected]} in the syntheticemail.d/syntheticemail.yaml.

Run the Agent's status subcommand and look for syntheticemail under the Checks section.

For support or feature requests please contact through the following channels:
Made with ❤️ in Boston
This isn't the integration you're looking for? Missing a critical feature for your organization? Drop us a note and we'll build it!!
Copy link
On this page
Integration Install
Mailbox Configuration