メール配信エラーのトラブルシューティング

Looker からメールをスケジュール設定して送信すると、データと分析情報を自動的に配信して、チームに最新情報を伝えることができます。これらのメールが届かない場合は、このガイドに沿って配信プロセスをトラブルシューティングし、問題を解決してください。

送信日時を設定したメールのライフサイクル

メール配信プロセスの各段階を理解すると、エラーが発生した場所を特定できます。

  1. スケジュール構成: ユーザーが Look またはダッシュボードのスケジュールを作成して保存し、配信方法としてメールを選択します。
  2. ジョブの作成: Looker インスタンスがスケジュール設定されたジョブを作成します。
  3. クエリの実行とレンダリング: スケジュールされた時間に、Looker インスタンスはコンテンツのクエリを実行し、スケジュール オプションで指定されたとおりに可視化をレンダリングします。
  4. SMTP へのハンドオフ: Looker インスタンスが、指定された SMTP サーバー(デフォルトの Looker メールサービスまたはカスタム SMTP サーバー)にメールを送信します。
  5. SMTP 配信: SMTP サーバーがメールを受信し、受信者のメールサーバーに配信します。
  6. ゲートウェイ フィルタリング: 受信者の組織のセキュリティ ソフトウェア(Proofpoint など)が、メールがユーザーに届く前に迷惑メールや悪意のあるメールとしてフィルタリングすることがあります。
  7. 受信トレイへのルーティング: 受信者のメール クライアントがメールを受信し、ローカルの迷惑メールフィルタまたは受信トレイのルールによって、メールが整理、アーカイブ、削除されることがあります。

デバッグツリー

次のディシジョン ツリーを使用して、メール配信の失敗のトラブルシューティングを開始します。

以降のセクションでは、ツリー内のシナリオについて詳しく説明します。

スケジューラ プランを確認する

送信日時を設定したメールが届いていない場合は、まずスケジュールが存在し、有効になっていることを確認します。

スケジュールが作成されたことを確認する

[管理者] パネルの [スケジュール] ページに移動して、スケジュールが一覧表示されているかどうかを確認します。インスタンスで有効になっている場合は、システム アクティビティを使用することもできます。

スケジュールが表示されない場合は、次の点を確認してください。

  • お客様がスケジュールを正常に保存したことを確認します。
  • スケジュールが削除または一時停止されていないか確認します。

スケジュールが表示された場合、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 コマンドライン ツールを使用します。

  1. 次のコマンドを実行して、ドメインの SPF レコードを確認します(DOMAIN_NAME はドメインに置き換えてください)。 bash dig +short txt <var>DOMAIN_NAME</var> | grep spf
  2. 出力にカスタム SMTP サーバーの IP アドレスまたはホスト名が含まれていることを確認します。

デフォルトの SMTP のトラブルシューティング

Looker のデフォルトの SMTP サービスを使用している場合、メールサーバーのログに直接アクセスすることはできません。配信ブロックを確認します。

配信ブロック(セキュリティ ソフトウェアとスパムフィルタ)を確認する

サポートに連絡する前に、組織のセキュリティ システムまたはメール クライアントの設定によってメールがブロックされていないか確認してください。

セキュリティ ソフトウェア(Proofpoint など)やメール クライアントのフィルタによって、lookermail.com(Looker のデフォルトの送信者ドメイン)からのメールがブロックされることがあります。

  • 組織のメール ゲートウェイ ログ(Proofpoint や Mimecast など)で、lookermail.com または looker@lookermail.com からのメールがブロックされていないか確認します。
  • 受信者の [迷惑メール] フォルダまたは [ゴミ箱] フォルダを確認します。
  • メールをアーカイブまたは削除する可能性がある受信トレイ ルールがないかどうかを確認します。
  • 解決策: メール管理者と協力して、lookermail.com と Looker のデフォルトのメールサービスに関連付けられている IP アドレスを許可リストに登録します。

サポートに問い合わせる

上記の手順をすべて確認してもメールが届かない場合は、次の手順をお試しください。

  • デフォルトの SMTP を使用している場合は、サポートにお問い合わせのうえ、ジョブのデフォルトの SMTP ログを確認してください。ジョブ ID と受信者のメールアドレスを指定します。