SendGrid

Supported OS Linux Windows Mac OS

The Sendgrid dashboard in Datadog

Overview

Twilio SendGrid is an email platform that businesses use for sending transactional and marketing email. Use this integration to collect your SendGrid email delivery and engagement metrics and logs.

Setup

Generate SendGrid API Key

  1. Login to your SendGrid account.
  2. Open the Settings dropdown.
  3. Click API Keys.
  4. Click Create API Key at the top right.
  5. Fill out the API Key Name. Select Full Access or, for restricted access, Stats - Read Access and User Account - Read Access.
  6. Copy the API Key to somewhere secure. The API key will be needed when you set up the SendGrid Integration on Datadog’s user interface.

Configuration

Send metrics

  1. Navigate to the configuration tab inside the Datadog SendGrid integration tile.
  2. Enter a unique identifying name for the SendGrid account in Datadog.
  3. Paste in the API Key that was generated in the steps above.
  4. Optionally, add custom tags to associate tags with all metrics collected for this integration.

Send Logs

  1. Copy the generated URL inside the Datadog SendGrid integration tile.
  2. Go to your SendGrid account.
  3. Open the Settings dropdown.
  4. Click Mail Settings.
  5. Click Edit on the Event Webhook setting.
  6. Paste in the generated URL in step 1 to the HTTP Post URL.
  7. Leave Authorization Method set to None.
  8. Select what delivery and engagement events you’d like to receive.
  9. Enable the Event Webhook Status.
  10. Click Save.

Data Collected

Metrics

sendgrid.emails.blocks
(gauge)		The number of emails that were not allowed to be delivered by ISPs.
Shown as email
sendgrid.emails.bounce_drops
(gauge)		The number of emails that were dropped because of a bounce.
Shown as email
sendgrid.emails.bounces
(gauge)		The number of emails that bounced instead of being delivered.
Shown as email
sendgrid.emails.deferred
(gauge)		The number of emails that temporarily could not be delivered.
Shown as email
sendgrid.emails.delivered
(gauge)		The number of emails SendGrid was able to confirm were actually delivered to a recipient.
Shown as email
sendgrid.emails.invalid_emails
(gauge)		The number of recipients who had malformed email addresses or whose mail provider reported the address as invalid.
Shown as email
sendgrid.emails.processed
(gauge)		Requests from your website, application, or mail client via SMTP Relay or the API that SendGrid processed.
Shown as email
sendgrid.emails.requests
(gauge)		The number of emails that were requested to be delivered.
Shown as email
sendgrid.emails.spam_report_drops
(gauge)		The number of emails that were dropped due to a recipient previously marking your emails as spam.
Shown as email
sendgrid.emails.spam_reports
(gauge)		The number of recipients who marked your email as spam.
Shown as email
sendgrid.emails.unsubscribe_drops
(gauge)		The number of emails dropped due to a recipient unsubscribing from your emails.
Shown as email
sendgrid.emails.unsubscribes
(gauge)		The number of recipients who unsubscribed from your emails.
Shown as email
sendgrid.emails.clicks
(gauge)		The number of links that were clicked in your emails.
Shown as email
sendgrid.emails.unique_clicks
(gauge)		The number of unique recipients who clicked links in your emails.
Shown as email
sendgrid.emails.opens
(gauge)		The total number of times your emails were opened by recipients.
Shown as email
sendgrid.emails.unique_opens
(gauge)		The number of unique recipients who opened your emails.
Shown as email
sendgrid.emails.daily.total.blocks
(gauge)		The daily number of emails that were not allowed to be delivered by ISPs.
Shown as email
sendgrid.emails.daily.total.bounce_drops
(gauge)		The daily number of emails that were dropped because of a bounce.
Shown as email
sendgrid.emails.daily.total.bounces
(gauge)		The daily number of emails that bounced instead of being delivered.
Shown as email
sendgrid.emails.daily.total.deferred
(gauge)		The daily number of emails that temporarily could not be delivered.
Shown as email
sendgrid.emails.daily.total.delivered
(gauge)		The daily number of emails SendGrid was able to confirm were actually delivered to a recipient.
Shown as email
sendgrid.emails.daily.total.invalid_emails
(gauge)		The daily number of recipients who had malformed email addresses or whose mail provider reported the address as invalid.
Shown as email
sendgrid.emails.daily.total.processed
(gauge)		Requests from your website, application, or mail client via SMTP Relay or the API that SendGrid processed daily.
Shown as email
sendgrid.emails.daily.total.requests
(gauge)		The daily number of emails that were requested to be delivered.
Shown as email
sendgrid.emails.daily.total.spam_report_drops
(gauge)		The daily number of emails that were dropped due to a recipient previously marking your emails as spam.
Shown as email
sendgrid.emails.daily.total.spam_reports
(gauge)		The daily number of recipients who marked your email as spam.
Shown as email
sendgrid.emails.daily.total.unsubscribe_drops
(gauge)		The daily number of emails dropped due to a recipient unsubscribing from your emails.
Shown as email
sendgrid.emails.daily.total.unsubscribes
(gauge)		The daily number of recipients who unsubscribed from your emails.
Shown as email
sendgrid.emails.daily.total.clicks
(gauge)		The daily number of links that were clicked in your emails.
Shown as email
sendgrid.emails.daily.total.unique_clicks
(gauge)		The daily number of unique recipients who clicked links in your emails.
Shown as email
sendgrid.emails.daily.total.opens
(gauge)		The daily total number of times your emails were opened by recipients.
Shown as email
sendgrid.emails.daily.total.unique_opens
(gauge)		The daily total of unique recipients who opened your emails.
Shown as email

Logs

Sendgrid delivery and engagement events will show up as logs under the source sendgrid.

Events

The SendGrid integration does not include any events.

Service Checks

The SendGrid integration does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.