Logging 库概览

许多编程语言都有标准的日志写入接口， 重新配置为使用 Logging。

注意： 您可以对应用进行插桩处理 应用特定信息有几种开源检测框架可让您从应用收集指标、日志和跟踪记录，并将这些数据发送给任何供应商，包括 Google Cloud。如需对应用进行插桩，我们建议您使用开源且与供应商无关的插桩框架（例如 OpenTelemetry），而不是供应商和产品专用 API 或客户端库。

有关如何使用 关于供应商中立的插桩框架，请参阅 插桩和可观测性。

编写日志

如需将日志写入 Cloud Logging，您可以执行以下任一操作： 以下：

• 将日志写入现有日志文件（如 syslog） 并使用 Ops Agent 将日志发送到 Cloud Logging。如需了解详情，请参阅 Google Cloud Observability 代理。
• 配置标准日志记录软件包以发送您写入的日志 Logging。如需了解详情，请参阅以下详细信息 页面：
  • 任意语言：fluentd
  • C#：使用 ASP.NET 或调用 API
  • Java：使用 Logback 和 java.util.logging
  • Go：使用标准日志记录
  • Node.js：使用 Winston 和 Bunyan
  • PHP：使用 PSR-3 日志记录器
  • Python：使用标准日志记录 设施
  • Ruby：使用 Google Cloud 可观测性 宝石
• 根据您的编程语言使用 Logging 客户端库来调用 Logging API。
• 直接调用 Logging API REST 端点。 请参阅 Logging API 参考文档。
• 使用 gcloud CLI。如需更多信息 请参阅 gcloud logging 命令行界面。

注意：如果传入日志条目的时间戳在过去超过了日志保留期限，或者在未来超过了 24 小时，则会被舍弃。

将跟踪记录数据与日志条目相关联

日志条目可以包含跟踪记录的相关信息。添加跟踪记录数据 您可以将日志和跟踪记录关联起来 分布式问题排查有关手动 自动捕获日志条目中的跟踪记录信息，请参阅 与 Cloud Logging 集成。

读取日志

要读取 Logging 中的日志条目，您可以执行以下任一操作：

• 在 Google Cloud 控制台中，转到 Logs Explorer 页面。

  前往 Logs Explorer

  如果您使用搜索栏查找此页面，请选择子标题为 Logging 的结果。

  如需了解详情，请参阅 日志浏览器概览。

• 通过以下方式调用 Logging API： 客户端库 编程语言。

• 直接调用 Logging API REST 端点。请参阅 Logging API 参考文档。

• 使用 gcloud CLI。有关详情，请参阅 gcloud logging 命令行界面。