第 5 章 监控代理运行时指标
安装 AMQ Broker 时,安装中包含 Prometheus metrics 插件。Prometheus 是为监控大型的可扩展系统而构建的软件,并在延长的时间段内存储历史运行时数据。您必须修改代理配置来启用插件。启用后,插件会为代理收集运行时指标,并将其导出到 Prometheus 格式。然后,您可以使用 Prometheus 查看指标。您还可以使用图形工具(如 Grafana)来配置更加高级数据的视觉化。
Prometheus metrics 插件可让您以 Prometheus 格式 收集和导出代理指标。但是,红帽不提供 安装或配置 Prometheus 本身以及 Grafana 等视觉化工具的支持。如果您需要安装、配置或运行 Prometheus 或 Grafana 的支持,请访问产品网站以获取社区支持和文档。
除了 Prometheus 插件收集的代理指标外,您还可以修改代理配置,以捕获与代理主机 Java 虚拟机(JVM)相关的标准指标集合。特别是,您可以捕获 Garbage Collection(GC)、内存和线程的 JVM 指标。
以下描述了以下部分:
5.1. 指标概述
要监控代理实例的健康状态和性能,您可以使用 AMQ Broker 的 Prometheus 插件来监控和存储代理运行时指标。AMQ Broker Prometheus 插件将代理运行时指标导出到 Prometheus 格式,可让您使用 Prometheus 本身来视觉化并运行数据的查询。
您还可以使用图形工具(如 Grafana)为 Prometheus 插件收集的指标配置更高级的视觉化和仪表板。
插件导出到 Prometheus 格式的指标如下所述。
代理指标
artemis_address_memory_usage
- 此代理上的所有地址用于内存消息的字节数。
artemis_address_memory_usage_percentage
-
此代理上的所有地址使用的内存作为
global-max-size
参数的百分比。 artemis_connection_count
- 连接到此代理的客户端数。
artemis_total_connection_count
- 自从启动以来连接到此代理的客户端数。
地址指标
artemis_routed_message_count
- 路由到一个或多个队列绑定的消息数。
artemis_unrouted_message_count
- 不 路由到任何队列绑定的消息数。
队列指标
artemis_consumer_count
- 使用来自给定队列的消息的客户端数。
artemis_delivering_durable_message_count
- 给定队列当前为消费者发送的持久消息的数量。
artemis_delivering_durable_persistent_size
- 给定队列当前为消费者提供的持久消息大小。
artemis_delivering_message_count
- 指定队列当前提供给消费者的消息数。
artemis_delivering_persistent_size
- 给定队列当前为消费者传输的消息的持久性大小。
artemis_durable_message_count
- 给定队列中当前具有持久性消息的数量。这包括调度、页面和发送中消息。
artemis_durable_persistent_size
- 目前在给定队列中持久化消息的大小。这包括调度、页面和发送中消息。
artemis_messages_acknowledged
- 从创建队列后确认来自给定队列的消息数。
artemis_messages_added
- 自队列创建以来添加到给定队列的消息数。
artemis_message_count
- 给定队列中当前的消息数。这包括调度、页面和发送中消息。
artemis_messages_killed
- 从创建队列后,从给定队列中删除的消息数量。当消息超过配置的最大交付尝试次数时,代理会终止一条消息。
artemis_messages_expired
- 自创建队列后,从给定队列已过期的消息数。
artemis_persistent_size
- 当前处于给定队列中的所有消息的持久性大小(durable 和不可durable)。这包括调度、页面和发送中消息。
artemis_scheduled_durable_message_count
- 给定队列中调度的消息数量。
artemis_scheduled_durable_persistent_size
- 持久大小,在给定队列中调度的消息。
artemis_scheduled_message_count
- 指定队列中调度的消息数。
artemis_scheduled_persistent_size
- 在给定队列中调度的消息的持久性大小。
对于以上未列出的高级代理指标,您可以通过聚合较低级别指标来计算这些指标。例如,要计算总消息计数,您可以聚合代理部署中的所有队列的 artemis_message_count
指标。
对于 AMQ Broker 的内部部署,托管代理的 Java 虚拟机(JVM)的指标也会导出到 Prometheus 格式。这不适用于在 OpenShift Container Platform 上部署 AMQ Broker。