SendGrid

Supported OS Linux Windows Mac OS

Présentation

Recueillez des métriques et des logs SendGrid relatifs à l’envoi et à l’engagement de vos e-mails.

Configuration

Générer une clé d’API SendGrid

  1. Connectez-vous à votre compte SendGrid.
  2. Ouvrez le menu déroulant Settings.
  3. Cliquez sur API Keys.
  4. Cliquez sur Create API Key en haut à droite.
  5. Indiquez dans le champ API Key Name le nom de la clé d’API. Sélectionnez Full Access ou, pour restreindre l’accès, Stats - Read Access et User Account - Read Access.
  6. Enregistrez la clé d’API dans un emplacement sécurisé. Vous aurez besoin de la clé d’API pour configurer l’intégration SendGrid dans l’interface Datadog.

Configuration

Envoyer des métriques

  1. Accédez à l’onglet Configuration dans le carré d’intégration SendGrid de Datadog.
  2. Saisissez un nom unique permettant d’identifier le compte SendGrid dans Datadog.
  3. Collez la clé d’API générée lors des étapes précédentes.
  4. Vous avez la possibilité d’ajouter des tags personnalisés afin de les associer à toutes les métriques recueillies par cette intégration.

Envoyer des logs

  1. Copiez l’URL générée dans le carré de l’intégration SendGrid Datadog.
  2. Accédez à votre compte SendGrid.
  3. Ouvrez le menu déroulant Settings.
  4. Cliquez sur Mail Settings.
  5. Cliquez sur Edit en regard du paramètre Event Webhook.
  6. Collez l’URL générée lors de l’étape 1 dans le champ HTTP Post URL.
  7. Vérifiez que Authorization Method est défini sur None.
  8. Sélectionnez les événements d’envoi et d’engagement que vous souhaitez recevoir.
  9. Activez l’option Event Webhook Status.
  10. Cliquez sur Save.

Données collectées

Métriques

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

Les événements SendGrid relatifs à l’envoi et à l’engagement s’affichent sous la forme de logs provenant de la source sendgrid.

Événements

L’intégration SendGrid n’inclut aucun événement.

Checks de service

L’intégration SendGrid n’inclut aucun check de service.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.