Fehlerbehebung bei E‑Mail-Zustellungsfehlern

Wenn Sie E‑Mails über Looker planen und senden, können Sie Daten und Analysen automatisch verteilen, damit Ihr Team immer auf dem neuesten Stand ist. Wenn diese E‑Mails nicht ankommen, hilft Ihnen diese Anleitung bei der Fehlerbehebung im Zustellungsprozess und bei der Lösung der Probleme.

Lebenszyklus einer geplanten E‑Mail

Wenn Sie die Phasen des E‑Mail-Zustellungsprozesses kennen, können Sie leichter feststellen, wo ein Fehler aufgetreten ist:

  1. Zeitplankonfiguration:Ein Nutzer erstellt und speichert einen Zeitplan für einen Look oder ein Dashboard und wählt E‑Mail als Zustellungsmethode aus.
  2. Joberstellung:Die Looker-Instanz erstellt einen geplanten Job.
  3. Abfrageausführung und Rendering:Zum geplanten Zeitpunkt führt die Looker-Instanz die Abfragen für die Inhalte aus und rendert die Visualisierungen gemäß den Zeitplanoptionen.
  4. Übergabe an SMTP: Die Looker-Instanz sendet die E‑Mail an den angegebenen SMTP-Server (entweder den Standard-E‑Mail-Dienst von Looker oder einen benutzerdefinierten SMTP-Server).
  5. SMTP-Zustellung:Der SMTP-Server empfängt die E‑Mail und stellt sie an den E‑Mail-Server des Empfängers zu.
  6. Gateway-Filterung:Sicherheitssoftware (z. B. Proofpoint) in der Organisation des Empfängers kann die E‑Mail als Spam oder schädlich herausfiltern, bevor sie den Nutzer erreicht.
  7. Posteingangs-Routing:Der E‑Mail-Client des Empfängers empfängt die E‑Mail. Lokale Spamfilter oder Posteingangsregeln können sie organisieren, archivieren oder löschen.

Fehlerbehebungsbaum

Verwenden Sie den folgenden Entscheidungsbaum, um mit der Fehlerbehebung bei Problemen mit der E‑Mail-Zustellung zu beginnen:

In den folgenden Abschnitten werden die Szenarien im Baum genauer beschrieben.

Zeitpläne prüfen

Wenn eine geplante E‑Mail nicht empfangen wurde, prüfen Sie zuerst, ob der Zeitplan vorhanden und aktiv ist.

Prüfen, ob der Zeitplan erstellt wurde

Rufen Sie im Bereich Verwaltung die Seite „ Zeitpläne“ auf, um zu prüfen, ob der Zeitplan aufgeführt ist. Sie können auch die Systemaktivität verwenden, wenn sie in Ihrer Instanz aktiviert ist.

Wenn der Zeitplan nicht angezeigt wird, prüfen Sie Folgendes:

  • Prüfen Sie, ob der Nutzer den Zeitplan gespeichert hat.
  • Prüfen Sie, ob der Zeitplan gelöscht oder pausiert wurde.

Wenn der Zeitplan angezeigt wird, hat die Looker-Instanz geplant, die E‑Mail zu senden. Fahren Sie mit dem nächsten Abschnitt fort.

Zeitplanverlauf prüfen

Wenn der Zeitplan vorhanden ist, prüfen Sie den Ausführungsstatus.

Jobstatus prüfen

Rufen Sie im Bereich Verwaltung die Seite „Zeitplanverlauf“ auf und suchen Sie nach dem Job, der der fehlgeschlagenen Zustellung entspricht.

  • Wenn der Jobstatus Abgeschlossen lautet, hat Looker die E‑Mail erfolgreich an den SMTP-Server gesendet. Fahren Sie mit dem nächsten Schritt fort.
  • Wenn der Jobstatus NICHT Abgeschlossen ist (z. B. Fehlgeschlagen), prüfen Sie Folgendes:
    • Klicken Sie für den Job auf den Tab Details , um Fehlermeldungen aufzurufen.
    • Führen Sie den Inhalt (Look oder Dashboard) manuell aus, um zu prüfen, ob er erfolgreich gerendert wird oder einen Fehler zurückgibt. Häufige Probleme sind Datenbankverbindungsfehler oder Zeitüberschreitungen bei Abfragen.

Fehlerbehebung bei benutzerdefiniertem SMTP

Wenn der Jobstatus Abgeschlossen lautet und Sie benutzerdefiniertes SMTP verwenden, liegt das Problem wahrscheinlich an Ihrem SMTP-Server oder der DNS-Konfiguration.

SMTP-Serverlogs prüfen

Wenn Sie benutzerdefiniertes SMTP aktiviert haben, prüfen Sie Folgendes:

  • Prüfen Sie die SMTP-Serverlogs, um zu bestätigen, dass der Server den Job von Looker empfangen hat, und um zu prüfen, ob der Server versucht hat, die E‑Mail zuzustellen.
  • Häufige Probleme sind Authentifizierungsfehler, falsche Porteinstellungen oder Ratenbegrenzungen auf Ihrem SMTP-Server.

SPF-Einträge prüfen

Wenn Ihr SMTP-Server E‑Mails sendet, diese aber als Spam markiert oder von Empfängern abgelehnt werden, prüfen Sie Ihre SPF-Einträge (Sender Policy Framework). Falsche SPF-Einträge können dazu führen, dass empfangende Mailserver E‑Mails ablehnen, die von Ihrer Domain gesendet wurden.

Sie können SPF-Einträge mit dem Befehlszeilentool dig testen:

  1. Führen Sie den folgenden Befehl aus, um den SPF-Eintrag für Ihre Domain zu prüfen (ersetzen Sie DOMAIN_NAME durch Ihre Domain): bash dig +short txt <var>DOMAIN_NAME</var> | grep spf
  2. Prüfen Sie, ob die Ausgabe die IP-Adresse oder den Hostnamen Ihres benutzerdefinierten SMTP-Servers enthält.

Fehlerbehebung bei Standard-SMTP

Wenn Sie den Standard-SMTP-Dienst von Looker verwenden, haben Sie keinen direkten Zugriff auf die Mailserverlogs. Prüfen Sie, ob Zustellungen blockiert werden.

Prüfen, ob Zustellungen blockiert werden: Sicherheitssoftware und Spamfilter

Bevor Sie sich an den Support wenden, prüfen Sie, ob die E‑Mail von den Sicherheitssystemen Ihrer Organisation oder den Einstellungen des E‑Mail-Clients blockiert wird.

Sicherheitssoftware (z. B. Proofpoint) oder E‑Mail-Client-Filter können E‑Mails von lookermail.com (der Standardabsenderdomain für Looker) blockieren.

  • Prüfen Sie die E‑Mail-Gateway-Logs Ihrer Organisation (z. B. Proofpoint oder Mimecast) auf blockierte E‑Mails von lookermail.com oder looker@lookermail.com.
  • Prüfen Sie die Ordner Spam oder Unerwünschte E‑Mails des Empfängers.
  • Prüfen Sie, ob Posteingangsregeln vorhanden sind, die die E‑Mails möglicherweise archivieren oder löschen.
  • Lösung:Bitten Sie Ihren E‑Mail-Administrator, lookermail.com und die IP-Adressen, die mit dem Standard-E‑Mail-Dienst von Looker verknüpft sind, auf die Zulassungsliste zu setzen.

Support kontaktieren

Wenn Sie alle vorherigen Schritte ausgeführt haben und die E‑Mail immer noch nicht empfangen wurde:

  • Wenn Sie Standard-SMTP verwenden, wenden Sie sich an den Support, um die Standard-SMTP-Logs für Ihren Job zu prüfen. Geben Sie die Job-ID und die E‑Mail-Adresse des Empfängers an.