管理员设置 - 日志

日志面板

日志面板会显示 Looker 实例生成的 500 条最新系统日志消息。如需查看日志页面，请在管理菜单的服务器部分中选择日志。

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

如需更新日志并显示最新的 500 条消息，请选择刷新日志。

如需调整 Looker 服务显示的日志消息的严重级别，请调整日志级别。

日志级别

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

db:* 和 db:looker 服务的默认严重程度级别设置为 info，这意味着包含或过滤个人信息（例如客户名称）的 SQL 语句会被 Looker 记录。对于严重程度设置为 info、verbose 或 debug 的日志，此情况属实。如需关闭 SQL 语句的日志记录，请将 db:* 和 db:looker 服务的严重程度级别设置为 warn、error 或 fatal。

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

严重程度说明

下面列出了日志消息严重级别，从最低严重级别到最高严重级别：

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

  • 详细：这些是详细的信息性消息，可更精细地显示 Looker 中发生的事件。此严重程度级别通常仅用于问题排查。

  • 信息：这些是标准的信息性消息，用于显示 Looker 中发生的常规事件。

  • 警告：这些消息表示可能存在有害情况。

  • 错误：这些消息表示可能不会严重到导致 Looker 停止运行的错误事件。

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

服务说明

默认下拉菜单用于设置所有 Looker 服务的默认严重程度。设置为默认的所有服务都使用默认下拉菜单中的严重程度。默认下拉菜单的默认严重程度为 info。

您还可以为以下服务单独设置严重程度：

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

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

  • db:looker：由针对 Looker 后端数据库的查询生成的消息。

  • http：由前端 Web 服务器接收或处理的 HTTP 请求生成的消息。

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

  • jsch：通过 SSH 连接到 Git 服务时生成的消息。默认设置为 warn 级别，不显示任何信息。更改为 info 级别，以排查 SSH 连接问题。

  • 记录器：当您更改日志级别时生成的消息。

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