Résoudre les problèmes d'échec de distribution des e-mails

La planification et l'envoi d'e-mails depuis Looker vous permettent de distribuer automatiquement des données et des insights pour tenir votre équipe informée. Si ces e-mails n'arrivent pas, ce guide vous aidera à résoudre les problèmes liés au processus de distribution.

Cycle de vie d'un e-mail programmé

Comprendre les étapes du processus de distribution des e-mails peut vous aider à identifier l'endroit où une erreur s'est produite :

  1. Configuration de la planification : un utilisateur crée et enregistre une planification pour une exploration ou un tableau de bord, en choisissant l'e-mail comme méthode de distribution.
  2. Création de la tâche : l'instance Looker crée une tâche planifiée.
  3. Exécution et rendu de la requête : à l'heure prévue, l'instance Looker exécute les requêtes pour le contenu et affiche les visualisations comme spécifié dans les options de planification.
  4. Transfert vers SMTP : l'instance Looker envoie l'e-mail au serveur SMTP désigné (le service de messagerie Looker par défaut ou un serveur SMTP personnalisé).
  5. Distribution SMTP : le serveur SMTP reçoit l'e-mail et le distribue au serveur de messagerie du destinataire.
  6. Filtrage de la passerelle : le logiciel de sécurité (tel que Proofpoint) de l'organisation du destinataire peut filtrer l'e-mail comme spam ou comme malveillant avant qu'il n'atteigne l'utilisateur.
  7. Routage de la boîte de réception : le client de messagerie du destinataire reçoit l'e-mail, où les filtres antispam locaux ou les règles de boîte de réception peuvent l'organiser, l'archiver ou le supprimer.

Arborescence de débogage

Utilisez l'arborescence de décision suivante pour commencer à résoudre les problèmes d'échec de distribution des e-mails :

Les sections suivantes décrivent plus en détail les scénarios de l'arborescence.

Vérifier les plans du planificateur

Si un e-mail programmé n'a pas été reçu, vérifiez d'abord que la planification existe et qu'elle est active.

Vérifier que la planification a été créée

Accédez à la page "Planifications" du panneau "Admin" pour vérifier si la planification est listée. Vous pouvez également utiliser l'activité du système si elle est activée sur votre instance.

Si la planification n'apparaît pas, examinez les points suivants :

  • Vérifiez que l'utilisateur a bien enregistré la planification.
  • Vérifiez si la planification a été supprimée ou mise en pause.

Si la planification apparaît, l'instance Looker a prévu d'envoyer l'e-mail. Passez à la section suivante.

Vérifier l'historique du planificateur

Si la planification existe, vérifiez son état d'exécution.

Vérifier l'état de la tâche

Accédez à la page Historique du planificateur du panneau Admin et recherchez la tâche correspondant à l'échec de la distribution.

  • Si l'état de la tâche est Terminée, Looker a bien envoyé le courrier électronique au serveur SMTP. Passez à l'étape suivante.
  • Si l'état de la tâche n'est PAS Terminée (par exemple, s'il est Échec), examinez les points suivants :
    • Cliquez sur l'onglet Détails de la tâche pour afficher les messages d'erreur.
    • Essayez d'exécuter manuellement le contenu (exploration ou tableau de bord) pour voir s'il s'affiche correctement ou s'il renvoie une erreur. Les problèmes courants incluent les erreurs de connexion à la base de données ou les délais d'attente des requêtes.

Résoudre les problèmes liés à un serveur SMTP personnalisé

Si l'état de la tâche est Terminée et que vous utilisez un serveur SMTP personnalisé, le problème est probablement lié à votre serveur SMTP ou à votre configuration DNS.

Vérifier les journaux du serveur SMTP

Si vous avez activé un serveur SMTP personnalisé, examinez les points suivants :

  • Consultez les journaux de votre serveur SMTP pour vérifier qu'il a reçu la tâche de Looker et s'il a tenté de la distribuer.
  • Les problèmes courants incluent les échecs d'authentification, les paramètres de port incorrects ou la limitation du débit sur votre serveur SMTP.

Vérifier les enregistrements SPF

Si votre serveur SMTP envoie des e-mails, mais qu'ils sont marqués comme spam ou rejetés par les destinataires, vérifiez vos enregistrements SPF (Sender Policy Framework). Des enregistrements SPF incorrects peuvent entraîner le rejet des e-mails envoyés depuis votre domaine par les serveurs de messagerie de réception.

Pour tester les enregistrements SPF, vous pouvez utiliser l'outil de ligne de commande dig :

  1. Exécutez la commande suivante pour vérifier l'enregistrement SPF de votre domaine (remplacez DOMAIN_NAME par votre domaine) : bash dig +short txt <var>DOMAIN_NAME</var> | grep spf
  2. Vérifiez que la sortie inclut l'adresse IP ou le nom d'hôte de votre serveur SMTP personnalisé.

Résoudre les problèmes liés au serveur SMTP par défaut

Si vous utilisez le service SMTP par défaut de Looker, vous n'avez pas d'accès direct aux journaux du serveur de messagerie. Vérifiez s'il existe des blocages de distribution.

Vérifier s'il existe des blocages de distribution : logiciel de sécurité et filtres antispam

Avant de contacter l'assistance, vérifiez si l'e-mail est bloqué par les systèmes de sécurité de votre organisation ou par les paramètres de votre client de messagerie.

Les logiciels de sécurité (tels que Proofpoint) ou les filtres de client de messagerie peuvent bloquer les e-mails provenant de lookermail.com (le domaine d'expéditeur par défaut de Looker).

  • Consultez les journaux de la passerelle de messagerie de votre organisation (par exemple, Proofpoint ou Mimecast) pour voir si des e-mails provenant de lookermail.com ou looker@lookermail.com ont été bloqués.
  • Vérifiez les dossiers Spam ou Courrier indésirable du destinataire.
  • Vérifiez s'il existe des règles de boîte de réception qui pourraient archiver ou supprimer les e-mails.
  • Résolution : collaborez avec votre administrateur de messagerie pour autoriser lookermail.com et les adresses IP associées au service de messagerie par défaut de Looker.

Contacter l'assistance

Si vous avez vérifié toutes les étapes précédentes et que l'e-mail n'est toujours pas reçu :

  • Si vous utilisez le serveur SMTP par défaut, contactez l'assistance pour qu'elle vérifie les journaux SMTP par défaut de votre tâche. Indiquez le Job ID et l'adresse e-mail du destinataire.