管理设置 - 日志

日志面板

日志面板会显示您的 Looker 实例最近生成的 500 条系统日志消息。要查看日志页面,请从管理菜单的服务器部分选择日志

您可以限制“日志”面板中显示的信息。为此,请在过滤条件字段中输入文本,以便让“日志”面板仅显示包含该文本的消息。

如需更新日志并显示最近的 500 封邮件,请选择刷新日志

如要调整将针对 Looker 服务显示的日志消息的严重级别,请调整日志级别

如需创建有关 Looker 实例使用情况的报告,请参阅使用系统活动探索创建 Looker 使用情况报告文档页面。

日志级别

通过日志级别部分,您可以为多项不同的 Looker 服务设置在日志中显示消息所需的最低严重级别。这样,您就可以隐藏不感兴趣的日志信息。

db:* 和 db:looker 服务的默认严重级别设置为 info,这意味着 Looker 会记录包含或过滤个人信息(例如客户姓名)的 SQL 语句。这适用于 infoverbosedebug 的严重级别设置。如需关闭 SQL 语句的日志记录功能,请将 db:* 和 db:looker 服务的严重级别设置为 warnerrorfatal

Looker 会将 SQL 语句记录到内部数据库(用于存储用户创建的 Looker 对象的元数据)和外部数据库(用于存储客户数据和元数据)。

严重级别说明

日志消息严重级别接下来列出(从最低严重到最高严重级别):

  • debug:调试日志条目是显示 Looker 内部应用进程的详细信息消息。此严重级别通常仅用于调试内部代码。

  • 详细:此类消息包含详细信息,以更精细的级别显示 Looker 中发生的事件。此严重级别通常仅用于问题排查。

  • info:这些是标准的信息性消息,显示 Looker 中发生的常规事件。

  • warn:此类消息表示可能存在有害情况。

  • error:此类消息表示错误事件可能不严重,导致 Looker 停止运行。

  • 严重:这些消息表示非常严重的错误事件,可能会导致 Looker 停止运行。

服务说明

通过默认下拉菜单,您可以为所有 Looker 服务设置默认严重级别。所有设置为 default 的服务都将使用 Default 下拉菜单中的严重级别。Default 下拉菜单中的默认严重级别是 info

您还可以为以下服务单独设置严重级别:

  • pdt:与永久性派生表进程关联的消息。

  • db:*:对分析数据库的查询或对任何客户数据库的查询生成的消息。

  • db:looker:通过对 Looker 后端数据库的查询生成的消息。

  • http:根据前端 Web 服务器正在接收或处理的 HTTP 请求生成的消息。

  • http_core:通过 HTTP 请求生成的消息,发送到为应用内部提供服务的核心 Web 服务器。

  • jsch:与 Git 服务的 SSH 连接生成的消息。默认设置为warn级别,不显示任何信息。更改为信息级别以排查 SSH 连接问题。

  • logger:更改日志级别时生成的消息。

  • org.apache.active:由 ActiveMQ 生成的消息。ActiveMQ 是一种消息传递服务,Looker 使用它在子系统之间传递任务。由调度器、PDT 重新生成和其他长时间运行的任务使用。

  • raven:错误报告服务生成的消息。

  • 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 查询)会生成为多行输出。这可能会导致需要单行条目进行模式匹配的日志处理器出现问题。

如果您的 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"}