查看 Looker (Google Cloud Core) 的实例日志

本页介绍如何查找和使用 Cloud Logging 以查看和查询 Looker (Google Cloud Core) 实例的日志。

Looker (Google Cloud Core) 使用 Cloud Logging。如需了解完整信息，请参阅 Cloud Logging 文档。

所需的角色

如需了解 Cloud Logging 所需的角色，请参阅 Cloud Logging 文档中的使用 IAM 进行访问权限控制页面。

查看日志

如需查看 Looker (Google Cloud Core) 实例日志条目的日志，请选择以下选项之一：

控制台

  1. 在 Google Cloud 控制台中，依次选择 Logging > Logs Explorer
  2. 在页面顶部选择一个现有的 Looker (Google Cloud Core) 项目。
  3. 在查询构建器中，添加以下内容：
    • 资源：选择 Looker 实例。在该对话框中，选择一个 Looker (Google Cloud Core) 实例 ID。
    • 日志名称：滚动到 Looker 部分，并为您的实例选择相应的日志文件。示例：
      • looker.googleapis.com%2FContentAccess
      • looker.googleapis.com%2FUserLogin
    • 严重程度：选择一个日志级别。
    • 时间范围：选择预设范围或创建自定义范围。

gcloud

使用 gcloud logging 命令查看日志条目。

gcloud logging read "resource.type=looker.googleapis.com/Instance" \
--project=PROJECT_ID \
--limit=10 \
--format=json

替换以下内容：

  • PROJECT_ID：Looker (Google Cloud Core) 实例所在 Google Cloud 项目的 ID。

您还可以添加以下标志：

  • limit 标志是一个可选参数，用于指示要返回的最大条目数。

问题排查

问题 问题排查
日志文件不完整。 检查日志记录的配置严重级别。系统会丢弃低于所配置级别的日志消息。
在日志中找不到操作信息。 您想要详细了解某项操作。

例如，用户已被删除，但您找不到谁执行了此操作。日志显示操作已开始，但未提供任何更多信息。您必须为要记录的详细个人身份信息 (PII) 等启用审核日志记录。
日志文件难以读取。 您只想以 JSON 或文本形式查看日志。您可以使用 gcloud logging read 命令以及 Linux 后处理命令下载日志。

如需将日志下载为 JSON，请使用以下代码：

gcloud logging read \
"resource.type=looker.googleapis.com/Instance \
AND logName=projects/PROJECT_ID \
/logs/looker.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d" \
> downloaded-log.json

替换以下内容：

  • PROJECT_ID：Looker (Google Cloud Core) 实例所在 Google Cloud 项目的 ID
  • LOG_NAME：日志的资源名称

如需将日志下载为文本，请使用以下代码：

gcloud logging read \
"resource.type=looker.googleapis.com/Instance \
AND logName=projects/PROJECT_ID \
/logs/looker.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d"| jq -rnc --stream 'fromstream(1|truncate_stream(inputs)) \
| .textPayload' \
--order=asc
> downloaded-log.txt

替换以下内容：

  • PROJECT_ID：Looker (Google Cloud Core) 实例所在 Google Cloud 项目的 ID
  • LOG_NAME：日志的资源名称

后续步骤