La pianificazione e l'invio di email da Looker ti consentono di distribuire automaticamente dati e approfondimenti per tenere informato il tuo team. Se queste email non arrivano, questa guida ti aiuta a risolvere i problemi relativi al processo di recapito.
Ciclo di vita di un'email programmata
Comprendere le fasi del processo di recapito delle email può aiutarti a identificare il punto in cui si è verificato un errore:
- Configurazione della pianificazione: un utente crea e salva una pianificazione per un Look o una dashboard, scegliendo l'email come metodo di recapito.
- Creazione del job: l'istanza Looker crea un job programmato.
- Esecuzione e rendering delle query: all'ora pianificata, l'istanza Looker esegue le query per i contenuti e visualizza le visualizzazioni come specificato nelle opzioni di pianificazione.
- Trasferimento a SMTP: l'istanza Looker invia l'email al server SMTP designato (il servizio email predefinito di Looker o un server SMTP personalizzato).
- Recapito SMTP: il server SMTP riceve l'email e la recapita al server email del destinatario.
- Filtro del gateway: il software di sicurezza (ad esempio Proofpoint) dell'organizzazione del destinatario potrebbe filtrare l'email come spam o dannosa prima che raggiunga l'utente.
- Routing della posta in arrivo: il client di posta del destinatario riceve l'email, dove i filtri antispam locali o le regole della posta in arrivo potrebbero organizzarla, archiviarla o eliminarla.
Struttura di debug
Utilizza la seguente struttura decisionale per iniziare a risolvere i problemi relativi agli errori di recapito delle email:
Le sezioni seguenti descrivono in modo più dettagliato gli scenari della struttura.
Controllare i piani di pianificazione
Se non hai ricevuto un'email programmata, verifica innanzitutto che la pianificazione esista e sia attiva.
Verificare che la pianificazione sia stata creata
Vai alla pagina Pianificazioni nel riquadro Amministratore per verificare se la pianificazione è elencata. Puoi anche utilizzare l'attività di sistema se è abilitata nella tua istanza.
Se la pianificazione non viene visualizzata, esamina quanto segue:
- Verifica che l'utente abbia salvato correttamente la pianificazione.
- Controlla se la pianificazione è stata eliminata o messa in pausa.
Se la pianificazione viene visualizzata, l'istanza Looker ha pianificato l'invio dell'email. Continua alla sezione successiva.
Controllare la cronologia della pianificazione
Se la pianificazione esiste, controllane lo stato di esecuzione.
Verificare lo stato del job
Vai alla pagina Cronologia della pianificazione nel riquadro Amministratore e cerca il job corrispondente al recapito non riuscito.
- Se lo stato del job è Completato, Looker ha inviato correttamente l' email al server SMTP. Procedi al passaggio successivo.
- Se lo stato del job NON è Completato (ad esempio, se è Non riuscito), esamina quanto segue:
- Fai clic sulla scheda Dettagli del job per visualizzare i messaggi di errore.
- Prova a eseguire manualmente i contenuti (Look o dashboard) per verificare se il rendering è riuscito o se viene restituito un errore. I problemi comuni includono errori di connessione al database o timeout delle query.
Risoluzione dei problemi relativi a SMTP personalizzato
Se lo stato del job è Completato e utilizzi SMTP personalizzato, il problema è probabilmente dovuto alla configurazione del server SMTP o del DNS.
Controllare i log del server SMTP
Se hai attivato SMTP personalizzato, esamina quanto segue:
- Controlla i log del server SMTP per verificare che il server abbia ricevuto il job da Looker e se ha tentato il recapito.
- I problemi comuni includono errori di autenticazione, impostazioni della porta errate o limitazione di frequenza sul server SMTP.
Verificare i record SPF
Se il server SMTP invia email, ma queste vengono contrassegnate come spam o rifiutate dai destinatari, controlla i record Sender Policy Framework (SPF). I record SPF errati possono causare il rifiuto delle email inviate dal tuo dominio da parte dei server di posta in arrivo.
Per testare i record SPF, puoi utilizzare lo strumento a riga di comando dig:
- Esegui il seguente comando per controllare il record SPF del tuo dominio (sostituisci
DOMAIN_NAME con il tuo dominio):
bash dig +short txt <var>DOMAIN_NAME</var> | grep spf - Verifica che l'output includa l'indirizzo IP o il nome host del server SMTP personalizzato.
Risoluzione dei problemi relativi a SMTP predefinito
Se utilizzi il servizio SMTP predefinito di Looker, non hai accesso diretto ai log del server di posta. Controlla se sono presenti blocchi di recapito.
Controllare se sono presenti blocchi di recapito: software di sicurezza e filtri antispam
Prima di contattare l'assistenza, controlla se l'email è bloccata dai sistemi di sicurezza della tua organizzazione o dalle impostazioni del client di posta.
Il software di sicurezza (ad esempio Proofpoint) o i filtri del client di posta possono bloccare le email provenienti da lookermail.com (il dominio del mittente predefinito per Looker).
- Controlla i log del gateway email della tua organizzazione (ad esempio Proofpoint o
Mimecast) per verificare se sono presenti email bloccate provenienti da
lookermail.comolooker@lookermail.com. - Controlla le cartelle Spam o Posta indesiderata del destinatario.
- Verifica se sono presenti regole della posta in arrivo che potrebbero archiviare o eliminare le email.
- Risoluzione: collabora con l'amministratore email per inserire nella lista consentita
lookermail.come gli indirizzi IP associati al servizio email predefinito di Looker.
Contatta l'assistenza
Se hai verificato tutti i passaggi precedenti e l'email non è stata ancora ricevuta:
- Se utilizzi SMTP predefinito, contatta l'assistenza per controllare i log SMTP predefiniti del tuo job. Fornisci l'ID job e l'indirizzo email del destinatario.