将 Cloud Storage FUSE 日志转发到 Cloud Logging

本页面介绍了如何将 Cloud Storage FUSE 日志转发到 Cloud Logging。

概览

Cloud Storage FUSE 日志可帮助您了解 Cloud Storage FUSE 的运作方式，并让您能够排查问题和监控性能。当您使用 --log-severity CLI 选项或 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. 使用 --log-severity CLI 选项或将 severity 字段设置为 trace，将日志记录严重程度设置为 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 代理的配置放在基于您所用操作系统的路径中。如需选择将配置放在哪个路径中，请参阅 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 跟踪日志。

后续步骤