Memecahkan masalah kegagalan pengiriman email

Menjadwalkan dan mengirim email dari Looker memungkinkan Anda mendistribusikan data dan insight secara otomatis untuk memberi informasi kepada tim Anda. Jika email ini gagal dikirim, panduan ini akan membantu Anda memecahkan masalah proses pengiriman dan menyelesaikan masalah tersebut.

Siklus proses email terjadwal

Memahami tahapan proses pengiriman email dapat membantu Anda mengidentifikasi tempat terjadinya kegagalan:

  1. Konfigurasi jadwal: Pengguna membuat dan menyimpan jadwal untuk Look atau dasbor, dengan memilih email sebagai metode pengiriman.
  2. Pembuatan tugas: Instance Looker membuat tugas terjadwal.
  3. Eksekusi dan rendering kueri: Pada waktu yang dijadwalkan, instance Looker menjalankan kueri untuk konten dan merender visualisasi seperti yang ditentukan dalam opsi jadwal.
  4. Penyerahan ke SMTP: Instance Looker mengirim email ke server SMTP yang ditentukan (baik layanan email Looker default maupun server SMTP kustom).
  5. Pengiriman SMTP: Server SMTP menerima email dan mengirimkannya ke server email penerima.
  6. Pemfilteran gateway: Software keamanan (seperti Proofpoint) di organisasi penerima dapat memfilter email sebagai spam atau berbahaya sebelum mencapai pengguna.
  7. Perutean kotak masuk: program email penerima menerima email, tempat filter spam lokal atau aturan kotak masuk dapat mengatur, mengarsipkan, atau menghapusnya.

Pohon debug

Gunakan pohon keputusan berikut untuk mulai memecahkan masalah kegagalan pengiriman email:

Bagian berikut menjelaskan skenario dalam pohon secara lebih mendetail.

Memeriksa paket penjadwal

Jika email terjadwal tidak diterima, pertama-tama pastikan jadwal ada dan aktif.

Memastikan jadwal telah dibuat

Buka halaman Jadwal di panel Admin untuk memeriksa apakah jadwal tercantum. Anda juga dapat menggunakan Aktivitas Sistem jika diaktifkan di instance Anda.

Jika jadwal tidak muncul, selidiki hal berikut:

  • Pastikan pengguna berhasil menyimpan jadwal.
  • Periksa apakah jadwal dihapus atau dijeda.

Jika jadwal muncul, instance Looker berencana mengirim email. Lanjutkan ke bagian berikutnya.

Memeriksa histori penjadwal

Jika jadwal ada, periksa status eksekusinya.

Memeriksa status tugas

Buka halaman Histori Penjadwal di panel Admin dan cari tugas yang sesuai dengan pengiriman yang gagal.

  • Jika status tugas adalah Selesai, Looker berhasil mengirim email ke server SMTP. Lanjutkan ke langkah berikutnya.
  • Jika status tugas BUKAN Selesai (misalnya, jika Gagal), selidiki hal berikut:
    • Klik tab Detail untuk tugas tersebut guna melihat pesan error.
    • Coba jalankan konten (Look atau dasbor) secara manual untuk melihat apakah konten tersebut berhasil dirender atau menampilkan error. Masalah umum mencakup error koneksi database atau waktu tunggu kueri.

Pemecahan masalah SMTP kustom

Jika status tugas adalah Selesai dan Anda menggunakan SMTP Kustom, kemungkinan masalahnya terletak pada server SMTP atau konfigurasi DNS Anda.

Memeriksa log server SMTP

Jika Anda mengaktifkan SMTP Kustom, selidiki hal berikut:

  • Periksa log server SMTP Anda untuk memverifikasi bahwa server menerima tugas dari Looker dan untuk memeriksa apakah server mencoba pengiriman.
  • Masalah umum mencakup kegagalan autentikasi, setelan port yang salah, atau pembatasan frekuensi di server SMTP Anda.

Memverifikasi data SPF

Jika server SMTP Anda mengirim email, tetapi email tersebut ditandai sebagai spam atau ditolak oleh penerima, periksa data Sender Policy Framework (SPF) Anda. Data SPF yang salah dapat menyebabkan server email penerima menolak email yang dikirim dari domain Anda.

Untuk menguji data SPF, Anda dapat menggunakan alat command line dig:

  1. Jalankan perintah berikut untuk memeriksa data SPF untuk domain Anda (ganti DOMAIN_NAME dengan domain Anda): bash dig +short txt <var>DOMAIN_NAME</var> | grep spf
  2. Pastikan output menyertakan alamat IP atau nama host server SMTP Kustom Anda.

Pemecahan masalah SMTP default

Jika Anda menggunakan layanan SMTP default Looker, Anda tidak memiliki akses langsung ke log server email. Periksa blokir pengiriman.

Memeriksa blokir pengiriman: software keamanan dan filter spam

Sebelum menghubungi Dukungan, periksa apakah email diblokir oleh sistem keamanan organisasi Anda atau setelan program email.

Software keamanan (seperti Proofpoint) atau filter klien email dapat memblokir email dari lookermail.com (domain pengirim default untuk Looker).

  • Periksa log gateway email organisasi Anda (misalnya, Proofpoint atau Mimecast) untuk mengetahui email yang diblokir dari lookermail.com atau looker@lookermail.com.
  • Periksa folder Spam atau Sampah penerima.
  • Periksa apakah ada aturan kotak masuk yang mungkin mengarsipkan atau menghapus email.
  • Penyelesaian: Bekerja sama dengan administrator email Anda untuk memasukkan lookermail.com dan alamat IP yang terkait dengan layanan email default Looker ke daftar yang diizinkan.

Hubungi Dukungan

Jika Anda telah memverifikasi semua langkah sebelumnya, dan email masih belum diterima:

  • Jika Anda menggunakan SMTP default, hubungi Dukungan untuk memeriksa log SMTP default untuk tugas Anda. Berikan ID pekerjaan dan alamat email penerima.