日志面板
日志页面会显示 Looker 实例生成的 500 条最新系统日志消息。要查看日志页面,请从管理菜单的服务器部分选择日志。
- 要限制“日志”窗口中显示的信息,您可以在过滤条件字段中输入文本,“日志”窗口将仅显示那些包含您输入的文本的消息。
- 点击刷新日志可更新日志并显示最近的 500 封邮件。
- 您可以调整针对各种 Looker 服务显示的日志消息的严重程度级别。下文对此进行了更详细的说明。
“日志”窗口不是查看使用情况或用户历史记录的最佳方式。如果您已启用系统活动实验室功能,请参阅使用系统活动探索创建 Looker 使用情况报告文档页面。否则,请参阅使用 i__looker 创建 Looker 使用情况和元数据报告文档页面。
日志级别
通过 Log Levels(日志级别)部分,您可以设置消息在日志中显示针对若干不同 Looker 服务的最低严重级别。这样,您就可以隐藏不感兴趣的日志信息。
db:* 和 db:looker 服务的默认严重程度设置为 info,这意味着 Looker 会记录包含或过滤个人信息(例如客户名称)的 SQL 语句。对于 info、verbose 或 debug 的严重程度设置,结果都是如此。要关闭 SQL 语句的日志记录功能,请将 db:* 和 db:looker 服务的严重程度级别设置为警告、错误或严重。
Looker 会将 SQL 语句记录到我们的内部数据库(我们在其中存储用户创建的 Looker 对象的元数据)和我们的外部数据库(我们在其中存储客户数据和元数据)中。
严重级别描述
下面列出了日志消息的严重程度(从最严重到最严重):
debug:调试日志条目是显示 Looker 内部应用进程的详细信息消息。此严重级别通常仅用于调试内部代码。
verbose:这些是详细的信息性消息,用于显示在 Looker 中更精细的级别发生的事件。此严重级别通常仅用于问题排查。
info:这些是标准信息性消息,显示了 Looker 中发生的常规事件。
警告:这些消息表示潜在有害情况。
error:这些消息表示相应错误事件可能不太严重,会导致 Looker 停止运行。
严重错误:这类消息表示极严重的错误事件,可能会导致 Looker 停止运行。
服务说明
默认下拉菜单会为所有 Looker 服务设置默认严重程度级别。所有设置为 default 的服务都将使用 Default 下拉菜单中的严重程度级别。默认下拉菜单的默认严重程度为信息。
您还可以单独为以下服务设置严重级别:
pdt:与永久性派生表进程关联的消息。
db:*:通过向分析数据库的查询或对任何客户数据库的查询生成的消息。
db:looker:通过查询到 Looker 后端数据库生成的消息。
http:前端网络服务器正在接收或处理的 http 请求生成的消息。
http_core:通过向应用内部核心服务器发出的 HTTP 请求生成的消息。
jsch:通过与 Git 服务建立的 SSH 连接生成的消息。默认设置是警告级别,不显示任何信息。更改为信息级别以排查 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"}