本文档总结了基于日志的存储桶级指标的特性,并介绍了它们与基于日志的项目级指标的区别。
基于日志的存储桶级指标的特性
基于日志的存储桶级范围指标是用户定义的基于日志的指标,用于评估路由到特定日志存储桶的日志条目。借助存储桶级范围的基于日志的指标,您可以在以下情况下创建基于日志的指标来从日志中提取数据:
- 从一个项目路由到另一项目中的存储桶的日志。
- 通过汇总接收器路由到存储桶的日志。
与项目级范围的基于日志的指标一样,存储桶级范围的基于日志的指标是在 Google Cloud 项目中定义的,而不是在文件夹或组织级定义的。如果您想跟踪将日志条目路由到存储桶的文件夹或组织,则可以在基于日志的指标中定义标签以记录此类信息。
基于日志的指标在范围(存储分区级别或项目级别)方面存在一些差异。
项目和指标范围
存储桶级基于日志的指标是在包含来源存储桶的同一项目中定义的。默认情况下,只有定义了存储桶级基于日志的指标的项目才能查看日志存储桶的指标数据。不过,如果您的项目显示在其他项目的指标范围内,这些项目也可以看到您的指标。
将日志路由到该存储桶的 Google Cloud 项目无需位于任何项目的指标范围内。
如需详细了解基于日志的指标和指标范围,请参阅对指标范围的可见性。
当存储桶收到日志后,派生的路由日志指标数据会向指标范围中包含该存储桶项目的任何项目显示。如果日志路由项目不在任何项目的指标范围内,则路由项目中的其他信息将不可见。
使用基于日志的存储桶级指标时,请遵循以下声明:
- 您需要在包含目标存储桶的项目中定义基于日志的指标。
- 存储桶级范围的基于日志的指标会评估路由到该存储桶的所有日志条目,无论日志是否来自与该存储桶所在项目相同的项目,还是来自其他项目。
- 指标数据对指标范围中包含该存储桶项目的任何其他项目都是可见的。
- 项目路由日志不需要位于任何项目的指标范围内。
受监控的资源类型:logging_bucket
将时间序列数据写入 Cloud Monitoring 时,基于日志的存储分区级范围指标使用受监控的资源类型 logging_bucket
。logging_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