将 Cloud Storage FUSE 日志转发到 Cloud Logging

本文档提供有关如何将 Cloud Storage FUSE 日志转发到 Cloud Logging 的说明。

Cloud Storage FUSE 日志可帮助您了解 Cloud Storage FUSE 的运作方式，并让您能够排查问题和监控性能。当您使用 --log-severity 选项或 logging:severity 字段生成日志时，日志会由 Cloud Storage FUSE 生成，可以作为标准输出或本地日志文件在运行 Cloud Storage FUSE 的机器上进行查看。

您还可以将 Cloud Storage FUSE 日志转发到 Cloud Logging，这具有以下优势：

  • 在 Google Cloud 控制台中的单一位置查看所有 Cloud Storage FUSE 日志，从而可全面了解 Cloud Storage FUSE 行为，并且更轻松地关联不同组件中的事件。

  • 按严重级别、时间戳、资源类型和其他字段过滤 Cloud Storage FUSE 日志，这有助于您找出错误或性能问题。

  • 创建由特定日志事件触发的基于指标的提醒。例如，您可以设置提醒，以便在检测到 Cloud Storage FUSE 发出的 error 或 warning 日志消息时收到通知，使您可以主动应对问题。

  • 在一段可配置的时间内将日志存储在 Cloud Logging 中，然后将其导出到 Cloud Storage 以进行长期存储、归档或深入分析。

价格

如需了解 Cloud Logging 的价格信息，请参阅 Cloud Logging 费用。

获取所需角色

如需获得使用 Cloud Logging 查看 Cloud Storage FUSE 日志所需的权限，请针对要收集其指标的项目中授予 Logs Writer (roles/logging.logWriter) IAM 角色。

此预定义角色包含使用 Cloud Logging 所需的权限。如需详细了解 Logs Writer 角色，请参阅有关 roles/logging.logWriter 的 IAM 文档。

如需了解如何授予项目角色，请参阅管理对项目的访问权限。

准备工作

  1. 启用 Cloud Storage API。

    前往 Cloud Storage API

  2. 启用 Cloud Logging API。

    前往 Cloud Logging API

  3. 安装 Cloud Ops Agent，它是 Google Cloud用于收集日志和指标的主要代理。根据您使用的虚拟机类型选择安装方法。

  4. 使用设置为 trace 的 --log-severity 选项或 severity 字段，将日志记录严重级别设置为 trace。

将 Cloud Storage FUSE 日志转发到 Cloud Logging

  1. 为 gcsfuse 装载指定 /gcsfuse.log：

    logging:
  file-path: "/gcsfuse.log"
  severity: trace

  2. 使用以下配置将 Cloud Ops Agent 配置为将日志从 /gcfuse.log 文件转发到 Cloud Logging。在此配置中，gcsfuse_trace_logs 是一个 receiver 元素，用于接收来自 /gcsfuse.log 文件的日志。service 元素用于关联流水线中的 receiver 元素。

    logging:
 receivers:
  gcsfuse_trace_logs:
  type: files
  include_paths:
  - /gcsfuse.log
service:
 pipelines:
   gcsfuse_pipeline:
     receivers: [gcsfuse_trace_logs]

    如需了解其他日志记录配置，请参阅 Cloud Logging 配置。

  3. 根据您的操作系统，将 Cloud Ops Agent 的配置放置在某个路径中。如需选择用于放置配置的路径，请参阅 Google Cloud Observability 文档以了解用户指定的配置。

  4. 使用 systemctl restart 命令重启 Cloud Ops Agent 以选取新的配置更改：

    sudo systemctl restart google-cloud-ops-agent`

  5. 在 Google Cloud 控制台中，前往 Cloud Logging。

  6. 运行 fuse_debug 过滤查询，以验证转发到 Cloud Logging 的 gcsfuse 轨迹日志。

后续步骤