Log

ログパネル

[ログ] ページには、Looker インスタンスによって生成された最新の 500 件のシステムログ メッセージが表示されます。[ログ] ページを表示するには、[管理者] メニューの [サーバー] セクションで [ログ] を選択します。

  1. ログウィンドウに表示される情報を制限するには、[フィルタ] フィールドにテキストを入力します。ログ ウィンドウには、入力したテキストを含むメッセージのみが表示されます。
  2. [ログを更新] をクリックしてログを更新し、最新の 500 件のメッセージを表示します。
  3. さまざまな Looker サービスに表示されるログメッセージの重大度レベルを調整できます。これについては、以下で詳しく説明します。

ログ ウィンドウでは使用状況やユーザー履歴を確認できません。代わりに、システム アクティビティ Labs 機能を有効にしている場合は、システム アクティビティ Explore を使用した Looker の使用状況レポートの作成のドキュメント ページをご覧ください。それ以外の場合は、i__looker を使用して Looker の使用状況とメタデータのレポートを作成するのドキュメントをご覧ください。

ログレベル

[ログレベル] セクションでは、複数の異なる Looker サービスに対して、ログに表示するメッセージに必要な最小重大度レベルを設定できます。これにより、必要のないログ情報を非表示にできます。

db:* と db:looker サービスのデフォルトの重大度は、info に設定されています。これは、個人情報(顧客名など)を含む、またはフィルタリングする SQL ステートメントが Looker でロギングされることを意味します。これは、infoverbosedebug の重大度設定に該当します。SQL ステートメントのロギングをオフにするには、db:* と db:looker サービスの重大度レベルを warnerror、または fatal に設定します。

Looker ステートメントは、Google の内部データベース(ユーザーが作成した Looker オブジェクトのメタデータを格納)と外部データベース(顧客データとメタデータを保存する場所)の両方に記録されます。

重大度の説明

ログメッセージの重大度レベルは、最も軽いものから最も重いものまで下に表示されます。

  • debug: デバッグ ログエントリは、Looker の内部アプリケーション プロセスを示す詳細情報メッセージです。通常、この重大度レベルは内部コードのデバッグにのみ使用されます。

  • verbose: Looker で発生するイベントをより詳細に示した詳細な情報メッセージです。この重大度レベルは通常、トラブルシューティングにのみ使用されます。

  • info: Looker で定期的に発生するイベントを示す標準的な情報メッセージです。

  • warn: このメッセージは、有害な可能性がある状態を示します。

  • error: これらのメッセージは、Looker の実行を停止させるほど重大な問題ではないエラーイベントを示します。

  • fatal: これらのメッセージは、Looker の実行が停止するおそれのある非常に重大なエラーイベントを示します。

サービスの説明

[デフォルト] プルダウンでは、すべての Looker サービスのデフォルトの重大度レベルが設定されます。default に設定されているすべてのサービスでは、[デフォルト] プルダウン内の重大度が使用されます。[デフォルト] プルダウンのデフォルトの重大度は info です。

重大度レベルは、次のサービスに対して個別に設定することもできます。

  • pdt: 永続的な派生テーブルのプロセスに関連付けられているメッセージ。

  • db:*: 分析データベースへのクエリ、または任意の顧客データベースへのクエリによって生成されるメッセージ。

  • db:looker: Looker バックエンド データベースへのクエリによって生成されたメッセージ。

  • http: フロントエンド ウェブサーバーが受信または処理している http リクエストから生成されたメッセージ。

  • http_core: アプリケーションの内部を処理するコア ウェブサーバーへの http リクエストから生成されたメッセージ。

  • jsch: Git サービスへの SSH 接続で生成されたメッセージ。デフォルトの設定は warning レベルで、info レベルは表示されません。SSH 接続の問題をトラブルシューティングするには、info レベルに変更してください。

  • logger: ログレベルを変更した場合に生成されるメッセージ。

  • org.apache.active: ActiveMQ によって生成されたメッセージ。ActiveMQ は、Looker がサブシステム間のタスクの通信に使用するメッセージング サービスです。スケジューラ、PDT 再生成などの長時間実行タスクで使用されます。

  • raven: Error Reporting サービスによって生成されたメッセージ。

  • レンダリング: レンダラによって生成されたメッセージ(PDF と PNG をレンダリング)

  • scheduler: スケジューラ プロセスによって生成されたメッセージ。

サービスのログレベルを変更したら、[レベルの設定] をクリックして変更を保存します。

セルフホスト型インスタンスでのログ形式の設定

デフォルトでは、システム メッセージは次の形式でテキストで表示されます。

2019-09-25 15:14:12.301 -0700 [INFO|007d0|main] :: Starting Looker : Version 6.21.0-localdev-ea88a4
...
2019-10-01 14:37:53.424 -0700 [INFO|0002a|http] :: Request from 0:0:0:0:0:0:0:1  GET /folders/1, {}
...
2019-10-01 14:37:53.425 -0700 [INFO|0002a|db:looker] :: (0.000180s) SELECT count(*) AS "COUNT" FROM "USER" LIMIT 1

例外や SQL クエリなどの一部のシステム メッセージは、複数行の出力として生成されます。そのため、パターン マッチングに 1 行のエントリを必要とするログ プロセッサで問題が発生することがあります。

Looker インスタンスがセルフホスト型で、単一行出力が必要な場合は、起動オプション--log-format=json」を使用してログエントリを単一行の JSON 構造に整形できます。次の例では、上記と同じイベントを JSON 形式で示しています。

{"t":"2019-09-25 15:14:56.513 -0700","s":"INFO","rid":"007d0","c":"main","msg":"Starting Looker : Version 6.21.0-localdev-ea88a4"}
...
{"t":"2019-10-01T14:35:37.577 -07:00","s":"INFO","rid":"0002c","c":"http","ip":"0:0:0:0:0:0:0:1","verb":"GET","path":"/folders/1","params":{}}
...
{"t":"2019-10-01T14:35:37.581 -07:00","s":"INFO","rid":"0002c","c":"db:looker","duration":"0.000344","sql":"SELECT count(*) AS \"COUNT\" FROM \"USER\" LIMIT 1"}