ログパネル
[ログ] ページには、Looker インスタンスによって生成された最新の 500 件のシステムログ メッセージが表示されます。[ログ] ページを表示するには、[管理者] メニューの [サーバー] セクションで [ログ] を選択します。
- ログウィンドウに表示される情報を制限するには、[フィルタ] フィールドにテキストを入力します。ログ ウィンドウには、入力したテキストを含むメッセージのみが表示されます。
- [ログを更新] をクリックしてログを更新し、最新の 500 件のメッセージを表示します。
- さまざまな Looker サービスに表示されるログメッセージの重大度レベルを調整できます。これについては、以下で詳しく説明します。
ログ ウィンドウでは使用状況やユーザー履歴を確認できません。代わりに、システム アクティビティ Labs 機能を有効にしている場合は、システム アクティビティ Explore を使用した Looker の使用状況レポートの作成のドキュメント ページをご覧ください。それ以外の場合は、i__looker を使用して Looker の使用状況とメタデータのレポートを作成するのドキュメントをご覧ください。
ログレベル
[ログレベル] セクションでは、複数の異なる Looker サービスに対して、ログに表示するメッセージに必要な最小重大度レベルを設定できます。これにより、必要のないログ情報を非表示にできます。
db:* と db:looker サービスのデフォルトの重大度は、info に設定されています。これは、個人情報(顧客名など)を含む、またはフィルタリングする SQL ステートメントが Looker でロギングされることを意味します。これは、info、verbose、debug の重大度設定に該当します。SQL ステートメントのロギングをオフにするには、db:* と db:looker サービスの重大度レベルを warn、error、または 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"}