第 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- 当前在给定队列中所有消息的持久大小（包括持久和非持久）。这包括已调度、页面和传送的消息。
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。
