Looker からメールをスケジュール設定して送信すると、データと分析情報を自動的に配信して、チームに最新情報を伝えることができます。これらのメールが届かない場合は、このガイドに沿って配信プロセスをトラブルシューティングし、問題を解決してください。
送信日時を設定したメールのライフサイクル
メール配信プロセスの各段階を理解すると、エラーが発生した場所を特定できます。
- スケジュール構成: ユーザーが Look またはダッシュボードのスケジュールを作成して保存し、配信方法としてメールを選択します。
- ジョブの作成: Looker インスタンスがスケジュール設定されたジョブを作成します。
- クエリの実行とレンダリング: スケジュールされた時間に、Looker インスタンスはコンテンツのクエリを実行し、スケジュール オプションで指定されたとおりに可視化をレンダリングします。
- SMTP へのハンドオフ: Looker インスタンスが、指定された SMTP サーバー(デフォルトの Looker メールサービスまたはカスタム SMTP サーバー)にメールを送信します。
- SMTP 配信: SMTP サーバーがメールを受信し、受信者のメールサーバーに配信します。
- ゲートウェイ フィルタリング: 受信者の組織のセキュリティ ソフトウェア(Proofpoint など)が、メールがユーザーに届く前に迷惑メールや悪意のあるメールとしてフィルタリングすることがあります。
- 受信トレイへのルーティング: 受信者のメール クライアントがメールを受信し、ローカルの迷惑メールフィルタまたは受信トレイのルールによって、メールが整理、アーカイブ、削除されることがあります。
デバッグツリー
次のディシジョン ツリーを使用して、メール配信の失敗のトラブルシューティングを開始します。
以降のセクションでは、ツリー内のシナリオについて詳しく説明します。
スケジューラ プランを確認する
送信日時を設定したメールが届いていない場合は、まずスケジュールが存在し、有効になっていることを確認します。
スケジュールが作成されたことを確認する
[管理者] パネルの [スケジュール] ページに移動して、スケジュールが一覧表示されているかどうかを確認します。インスタンスで有効になっている場合は、システム アクティビティを使用することもできます。
スケジュールが表示されない場合は、次の点を確認してください。
- お客様がスケジュールを正常に保存したことを確認します。
- スケジュールが削除または一時停止されていないか確認します。
スケジュールが表示された場合、Looker インスタンスはメールを送信する予定です。次のセクションに進みます。
スケジューラの履歴を確認する
スケジュールが存在する場合は、実行ステータスを確認します。
ジョブのステータスを確認する
[Admin] パネルの [Scheduler History] ページに移動し、配信に失敗したジョブを探します。
- ジョブ ステータスが [完了] の場合、Looker は SMTP サーバーにメールを正常に送信しました。次のステップに進みます。
- ジョブのステータスが [完了] 以外の場合([失敗] など)、次のことを確認します。
- ジョブの [詳細] タブをクリックして、エラー メッセージを表示します。
- コンテンツ(Look またはダッシュボード)を手動で実行して、正常にレンダリングされるか、エラーが返されるかを確認します。一般的な問題としては、データベース接続エラーやクエリ タイムアウトなどがあります。
カスタム SMTP のトラブルシューティング
ジョブのステータスが [完了] で、カスタム SMTP を使用している場合、問題は SMTP サーバーまたは DNS 構成にある可能性があります。
SMTP サーバーのログを確認する
カスタム SMTP が有効になっている場合は、次の点を確認します。
- SMTP サーバーのログをチェックして、サーバーが Looker からジョブを受信したことと、サーバーが配信を試みたことを確認します。
- 一般的な問題としては、認証の失敗、ポート設定の誤り、SMTP サーバーのレート制限などがあります。
SPF レコードを確認する
SMTP サーバーからメールが送信されているにもかかわらず、受信者によって迷惑メールに分類されたり、拒否されたりする場合は、SPF(Sender Policy Framework)レコードを確認してください。SPF レコードが正しくないと、受信側のメールサーバーがドメインから送信されたメールを拒否する可能性があります。
SPF レコードをテストするには、dig コマンドライン ツールを使用します。
- 次のコマンドを実行して、ドメインの SPF レコードを確認します(DOMAIN_NAME はドメインに置き換えてください)。
bash dig +short txt <var>DOMAIN_NAME</var> | grep spf - 出力にカスタム SMTP サーバーの IP アドレスまたはホスト名が含まれていることを確認します。
デフォルトの SMTP のトラブルシューティング
Looker のデフォルトの SMTP サービスを使用している場合、メールサーバーのログに直接アクセスすることはできません。配信ブロックを確認します。
配信ブロック(セキュリティ ソフトウェアとスパムフィルタ)を確認する
サポートに連絡する前に、組織のセキュリティ システムまたはメール クライアントの設定によってメールがブロックされていないか確認してください。
セキュリティ ソフトウェア(Proofpoint など)やメール クライアントのフィルタによって、lookermail.com(Looker のデフォルトの送信者ドメイン)からのメールがブロックされることがあります。
- 組織のメール ゲートウェイ ログ(Proofpoint や Mimecast など)で、
lookermail.comまたはlooker@lookermail.comからのメールがブロックされていないか確認します。 - 受信者の [迷惑メール] フォルダまたは [ゴミ箱] フォルダを確認します。
- メールをアーカイブまたは削除する可能性がある受信トレイ ルールがないかどうかを確認します。
- 解決策: メール管理者と協力して、
lookermail.comと Looker のデフォルトのメールサービスに関連付けられている IP アドレスを許可リストに登録します。
サポートに問い合わせる
上記の手順をすべて確認してもメールが届かない場合は、次の手順をお試しください。
- デフォルトの SMTP を使用している場合は、サポートにお問い合わせのうえ、ジョブのデフォルトの SMTP ログを確認してください。ジョブ ID と受信者のメールアドレスを指定します。