Micrometer Observation 文档

本节描述 Micrometer 集成。

可观测性 - 指标

以下是本项目声明的所有指标列表。

监听器观察

Rabbit 监听器的观察。

度量名称 spring.rabbit.listener （由约定类 RabbitListenerObservation$DefaultRabbitListenerObservationConvention 定义）。类型 timer。

度量名称 spring.rabbit.listener.active （由约定类 RabbitListenerObservation$DefaultRabbitListenerObservationConvention 定义）。类型 long task timer。

在启动观测后添加的键值可能会从 *.active 指标中缺失。

Micrometer 内部使用 纳秒 作为基本单位。但是，每个后端确定实际的基本单位。（即 Prometheus 使用秒）

封闭类名称 RabbitListenerObservation。

表 1. 低基数键
名称	描述
`messaging.destination.name` （必填）	监听器连接的队列。
`spring.rabbit.listener.id` （必填）	监听器 ID。

流监听器观察

Rabbit 流监听器的观察。

度量名称 spring.rabbit.stream.listener （由约定类 RabbitStreamListenerObservation$DefaultRabbitStreamListenerObservationConvention 定义）。类型 timer。

度量名称 spring.rabbit.stream.listener.active （由约定类 RabbitStreamListenerObservation$DefaultRabbitStreamListenerObservationConvention 定义）。类型 long task timer。

在启动观测后添加的键值可能会从 *.active 指标中缺失。

Micrometer 内部使用 纳秒 作为基本单位。但是，每个后端确定实际的基本单位。（即 Prometheus 使用秒）

封闭类名称 RabbitStreamListenerObservation。

所有标签必须以 spring.rabbit.stream.listener 为前缀！

表 2. 低基数键
名称	描述
`spring.rabbit.stream.listener.id` （必填）	监听器 ID。

流模板观察

RabbitStreamTemplate 的观察。

度量名称 spring.rabbit.stream.template （由约定类 RabbitStreamTemplateObservation$DefaultRabbitStreamTemplateObservationConvention 定义）。类型 timer。

度量名称 spring.rabbit.stream.template.active （由约定类 RabbitStreamTemplateObservation$DefaultRabbitStreamTemplateObservationConvention 定义）。类型 long task timer。

在启动观测后添加的键值可能会从 *.active 指标中缺失。

Micrometer 内部使用 纳秒 作为基本单位。但是，每个后端确定实际的基本单位。（即 Prometheus 使用秒）

封闭类名称 RabbitStreamTemplateObservation。

所有标签必须以 spring.rabbit.stream.template 为前缀！

表3. 低基数键
名称	描述
`spring.rabbit.stream.template.name` （必填）	模板的 Bean 名称。

模板观察

RabbitTemplate 的观察。

度量名称 spring.rabbit.template （由约定类 RabbitTemplateObservation$DefaultRabbitTemplateObservationConvention 定义）。类型 timer。

度量名称 spring.rabbit.template.active （由约定类 RabbitTemplateObservation$DefaultRabbitTemplateObservationConvention 定义）。类型 long task timer。

在启动观测后添加的键值可能会从 *.active 指标中缺失。

Micrometer 内部使用 纳秒 作为基本单位。但是，每个后端确定实际的基本单位。（即 Prometheus 使用秒）

封闭类名称 RabbitTemplateObservation。

表 4. 低基数键
名称	描述
`messaging.destination.name` （必填）	目标交换机（如果为默认交换机则为空）。
`messaging.rabbitmq.destination.routing_key` （必填）	目标路由键。
`spring.rabbit.template.name` （必填）	模板的 Bean 名称。

可观测性 - Span

以下是本项目声明的所有 Span 列表。

监听器观察 Span

Rabbit 监听器的观察。

Span 名称 spring.rabbit.listener （由约定类 RabbitListenerObservation$DefaultRabbitListenerObservationConvention 定义）。

封闭类名称 RabbitListenerObservation。

表 5. 标签键
名称	描述
`messaging.destination.name` （必填）	监听器连接的队列。
`messaging.rabbitmq.message.delivery_tag` （必填）	交付标签。
`spring.rabbit.listener.id` （必填）	监听器 ID。

流监听器观察 Span

Rabbit 流监听器的观察。

Span 名称 spring.rabbit.stream.listener （由约定类 RabbitStreamListenerObservation$DefaultRabbitStreamListenerObservationConvention 定义）。

封闭类名称 RabbitStreamListenerObservation。

所有标签必须以 spring.rabbit.stream.listener 为前缀！

表 6. 标签键
名称	描述
`spring.rabbit.stream.listener.id` （必填）	监听器 ID。

流模板观察 Span

RabbitStreamTemplate 的观察。

Span 名称 spring.rabbit.stream.template （由约定类 RabbitStreamTemplateObservation$DefaultRabbitStreamTemplateObservationConvention 定义）。

封闭类名称 RabbitStreamTemplateObservation。

所有标签必须以 spring.rabbit.stream.template 为前缀！

表 7. 标签键
名称	描述
`spring.rabbit.stream.template.name` （必填）	模板的 Bean 名称。

模板观察 Span

RabbitTemplate 的观察。

Span 名称 spring.rabbit.template （由约定类 RabbitTemplateObservation$DefaultRabbitTemplateObservationConvention 定义）。

封闭类名称 RabbitTemplateObservation。

表 8. 标签键
名称	描述
`messaging.destination.name` （必填）	目标交换机（如果为默认交换机则为空）。
`messaging.rabbitmq.destination.routing_key` （必填）	目标路由键。
`spring.rabbit.template.name` （必填）	模板的 Bean 名称。

可观测性 - 约定

您可以在下面找到此项目声明的所有 GlobalObservationConvention 和 ObservationConvention 列表。

表 9. ObservationConvention 实现
ObservationConvention 类名	适用的 ObservationContext 类名
`RabbitListenerObservation`	`RabbitMessageReceiverContext`
`RabbitListenerObservation.DefaultRabbitListenerObservationConvention`	`RabbitMessageReceiverContext`
`RabbitListenerObservationConvention`	`RabbitMessageReceiverContext`
`RabbitStreamMessageReceiverContext`	`RabbitMessageReceiverContext`
`RabbitStreamMessageReceiverContext.DefaultRabbitListenerObservationConvention`	`RabbitMessageReceiverContext`
`RabbitTemplateObservation`	`RabbitMessageSenderContext`
`RabbitTemplateObservation.DefaultRabbitTemplateObservationConvention`	`RabbitMessageSenderContext`
`RabbitTemplateObservationConvention`	`RabbitMessageSenderContext`
`RabbitStreamListenerObservation`	`RabbitStreamMessageReceiverContext`
`RabbitStreamListenerObservation.DefaultRabbitStreamListenerObservationConvention`	`RabbitStreamMessageReceiverContext`
`RabbitStreamListenerObservationConvention`	`RabbitStreamMessageReceiverContext`
`RabbitStreamTemplateObservation`	`RabbitStreamMessageSenderContext`
`RabbitStreamTemplateObservation.DefaultRabbitStreamTemplateObservationConvention`	`RabbitStreamMessageSenderContext`
`RabbitStreamTemplateObservationConvention`	`RabbitStreamMessageSenderContext`