查看 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:日志的资源名称

后续步骤