|
| 1 | +# Resend |
| 2 | + |
| 3 | +## Overview |
| 4 | + |
| 5 | +[Resend][1] is an email delivery service for sending broadcast and transactional emails via a developer API. |
| 6 | + |
| 7 | +To gain insights into Resend's broadcast and transactional message streams, integrate Resend with Datadog using [webhooks][2]. |
| 8 | +This allows events to be received by Datadog and converted to logs. |
| 9 | + |
| 10 | +## Setup |
| 11 | + |
| 12 | +Follow the instructions below to configure this integration for your Resend account. |
| 13 | + |
| 14 | + |
| 15 | +### Configuration |
| 16 | + |
| 17 | +#### Webhook configuration steps |
| 18 | +Create a webhook in Resend to forward events to Datadog: |
| 19 | +1. Log into your [Resend account][3] and navigate to the [webhooks][4] page. |
| 20 | +2. Click the **Add webhook** button and enter the following: |
| 21 | + - Enter the url provided by Datadog. |
| 22 | + - Select "All Events" for the events types. |
| 23 | +3. Click **Add**. |
| 24 | + |
| 25 | +#### Optional: Enable click tracking for each Resend domain |
| 26 | +Follow these steps to enable email click and optionally open email tracking for each Resend domain: |
| 27 | +1. Navigate to the Resend [domains][5] page. |
| 28 | +3. For each sending domain in use: |
| 29 | + 1. Click on the domain name to edit. |
| 30 | + 2. In the Configuration section, enable **Click Tracking**. |
| 31 | + 3. Optionally, enable **Open Tracking**. Though Resend [cautions against depending on open tracking](https://resend.com/docs/knowledge-base/why-are-my-open-rates-not-accurate). |
| 32 | + |
| 33 | +#### Optional: Surface the use of tags in transactional email in the Datadog Dashboard |
| 34 | +The Resend API supports per-message tags for transactional email, such as a |
| 35 | +`priority` attribute with values of _high_, _normal_, or _low_. The tag can be |
| 36 | +defined as a template variable in the Datadog dashboard to filter results by tag value. |
| 37 | +For an example, see the `priority` template variable in the Resend Overview dashboard provided with this integration. |
| 38 | + |
| 39 | +## Data Collected |
| 40 | + |
| 41 | +### Logs |
| 42 | +The Resend integration converts Resend webhook events to Datadog logs. The events |
| 43 | +contain email header and tag information which included sender and recipient email addresses. |
| 44 | +Actual email content is not included in the events. |
| 45 | + |
| 46 | +### Metrics |
| 47 | +The Resend integration does not define any metrics. |
| 48 | + |
| 49 | +### Service Checks |
| 50 | +Resend does not include any service checks. |
| 51 | + |
| 52 | +### Events |
| 53 | +Resend does not include any events. |
| 54 | + |
| 55 | +## Troubleshooting |
| 56 | + |
| 57 | +Need help? Contact [Datadog support][6]. |
| 58 | + |
| 59 | +[1]: https://resend.com/ |
| 60 | +[2]: https://resend.com/docs/dashboard/webhooks/introduction |
| 61 | +[3]: https://resend.com/login |
| 62 | +[4]: https://resend.com/webhooks |
| 63 | +[5]: https://resend.com/domains |
| 64 | +[6]: https://docs.datadoghq.com/help/ |
0 commit comments