ログパネル
[ログ] パネルには、Looker インスタンスによって生成された最新の 500 件のシステムログ メッセージが表示されます。[ログ] ページを表示するには、[管理者] メニューの [サーバー] セクションで [ログ] を選択します。
[ログ] パネルに表示される情報は制限できます。そのためには、[フィルタ] フィールドにテキストを入力し、ログパネルにそのテキストを含むメッセージのみを表示します。
ログを更新して最新の 500 件のメッセージを表示するには、[Refresh Log] を選択します。
Looker サービスに表示されるログメッセージの重大度を調整するには、ログレベルを調整します。
Looker インスタンスの使用状況に関するレポートを作成するには、ドキュメント ページ System Activity Explores による Looker 使用状況レポートの作成をご覧ください。
ログレベル
[ログレベル] セクションでは、複数の異なる Looker サービスに対して、ログに表示するメッセージに必要な最小重大度レベルを設定できます。これにより、不要なログ情報を非表示にできます。
db:* サービスと db:looker サービスのデフォルトの重要度は、info に設定されています。つまり、個人情報(お客様の名前など)を含む、またはフィルタする SQL ステートメントは Looker によって記録されることを意味します。これは、info、verbose、debug の重大度設定に該当します。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"}