基于日志的存储桶级指标

本文档总结了基于日志的存储桶级指标的特性,并介绍了它们与基于日志的项目级指标的区别。

基于日志的存储桶级指标的特性

基于日志的存储桶级指标是用户定义的基于日志的指标,用于评估路由到特定日志存储桶的日志条目。借助基于日志的存储桶级指标,您可以在以下情况下创建从日志中提取数据的基于日志的指标:

  • 从一个项目路由到其他项目中的存储桶的日志。
  • 通过聚合接收器路由到存储桶的日志。

与基于日志的项目级指标一样,基于日志的存储桶级指标也是在 Google Cloud 项目中定义的,而不是在文件夹或组织级定义的。如果您想跟踪日志条目从哪个文件夹或组织路由到存储桶,则可以在基于日志的指标中定义标签以记录该信息。

基于日志的存储桶级指标与基于日志的项目级指标有几点不同。

项目和指标范围

基于日志的存储桶级指标是在包含来源存储桶的同一项目中定义的。默认情况下,只有定义基于日志的存储桶级指标的项目才能查看日志存储桶的指标数据。不过,如果您的项目出现在其他项目的指标范围内,那么这些项目也可以查看您的指标。

将日志路由到存储桶的 Google Cloud 项目无需位于任何项目的指标范围内。

如需详细了解基于日志的指标和指标范围,请参阅指标范围的可见性

在存储桶收到日志后,其指标范围内包含该存储桶所属项目的任何项目都可查看得到的路由日志指标数据。如果路由日志的项目不在任何项目的指标范围内,则路由项目中的其他信息将不可见。

使用基于日志的存储桶级指标时,请遵循以下声明:

  • 您需要在包含目标存储桶的项目中定义基于日志的指标。
  • 基于日志的存储桶级指标会评估路由到存储桶的所有日志条目,无论这些日志是来自与存储桶相同的项目还是来自其他项目。
  • 在其指标范围内包含具有相应存储桶的项目的任何其他项目都可查看指标数据。
  • 路由日志的项目无需位于任何项目的指标范围内。

受监控的资源类型:logging_bucket

将时序数据写入 Cloud Monitoring 时,基于日志的存储桶级指标使用受监控的资源类型 logging_bucketlogging_bucket 资源类型包含以下标签:

  • project_id:您的 Google Cloud 项目的标识符,例如 my-test-project 这样的字符串。
  • bucket_id:与基于日志的指标关联的日志存储桶的名称,例如 my-test-bucket 这样的字符串。
  • location:日志存储桶的位置。
  • monitored_resource_type:生成此日志条目的受监控资源的类型;该值来自日志条目的 resource 字段中包含的 MonitoredResource 结构的 type 字段。
  • source_resource_container:从中发送日志条目的项目、文件夹或组织的标识符,是采用以下格式之一的字符串:
    • projects/PROJECT_ID
    • organizations/ORGANIZATION_ID
    • folders/FOLDER_ID