管理者の設定 - ログ

ログパネル

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

[ログ] パネルに表示される情報は制限できます。そのためには、[フィルタ] フィールドにテキストを入力し、ログパネルにそのテキストを含むメッセージのみを表示します。

ログを更新して最新の 500 件のメッセージを表示するには、[Refresh Log] を選択します。

Looker サービスに表示されるログメッセージの重大度を調整するには、ログレベルを調整します。

Looker インスタンスの使用状況に関するレポートを作成するには、ドキュメント ページ System Activity Explores による Looker 使用状況レポートの作成をご覧ください。

ログレベル

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

db:* サービスと db:looker サービスのデフォルトの重要度は、info に設定されています。つまり、個人情報(お客様の名前など)を含む、またはフィルタする SQL ステートメントは Looker によって記録されることを意味します。これは、infoverbosedebug の重大度設定に該当します。SQL ステートメントのロギングをオフにするには、 db:* の重大度レベルと 警告エラー、または致命的 に対する db:Looker サービスを設定します。

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

重大度の説明

ログメッセージの重大度は、次のとおりです(重大度が低い順)。

  • 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 サービスによって生成されるメッセージ。

  • render: 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"}