搜索

7.2. 使用 Prometheus 监控代理运行时指标

download PDF

以下章节描述了如何在 OpenShift Container Platform 上为 AMQ Broker 配置 Prometheus 指标插件。您可以使用插件来监控和存储代理运行时指标。您还可以使用 Grafana 等图形工具来配置更多高级视觉化和 Prometheus 插件收集的数据的仪表板。

注意

Prometheus metrics 插件可让您以 Prometheus 格式 收集和导出代理指标。但是,红帽不提供对 安装或配置 Prometheus 本身的支持,也不提供 Grafana 等视觉化工具的支持。如果您需要支持安装、配置或运行 Prometheus 或 Grafana,请访问产品网站以了解社区支持和文档等资源。

7.2.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。

7.2.2. 使用 CR 启用 Prometheus 插件

安装 AMQ Broker 时,安装中包含 Prometheus metrics 插件。启用后,插件会为代理收集运行时指标,并将其导出为 Prometheus 格式。

以下流程演示了如何使用 CR 为 AMQ Broker 启用 Prometheus 插件。此流程支持 AMQ Broker 7.9 或更高版本的新部署。

有关使用运行代理的替代流程,请参阅 第 7.2.3 节 “使用环境变量为正在运行的代理部署启用 Prometheus 插件”

流程

  1. 打开用于代理部署的 CR 实例。例如,基本部署的 CR 可能类似以下:

    apiVersion: broker.amq.io/v1beta1
    kind: ActiveMQArtemis
    metadata:
      name: ex-aao
    spec:
      deploymentPlan:
        size: 4
        image: registry.redhat.io/amq7/amq-broker-rhel8:7.12
      ...
  2. deploymentPlan 部分中,添加 enableMetricsPlugin 属性,并将值设为 true,如下所示。

    apiVersion: broker.amq.io/v1beta1
    kind: ActiveMQArtemis
    metadata:
      name: ex-aao
    spec:
      deploymentPlan:
        size: 4
        image: registry.redhat.io/amq7/amq-broker-rhel8:7.12
        ...
        enableMetricsPlugin: true
    enableMetricsPlugin
    指定是否为部署中的代理启用 Prometheus 插件。
  3. 保存 CR 实例。
  4. 切换到之前创建的代理部署的项目。

    $ oc project <project_name>
  5. 在命令行中应用更改。

    $ oc apply -f <path/to/custom_resource_instance>.yaml

    metrics 插件开始以 Prometheus 格式收集代理运行时指标。

其他资源

7.2.3. 使用环境变量为正在运行的代理部署启用 Prometheus 插件

以下流程演示了如何使用环境变量为 AMQ Broker 启用 Prometheus 插件。有关替代流程,请参阅 第 7.2.2 节 “使用 CR 启用 Prometheus 插件”

先决条件

  • 您可以为使用 AMQ Broker Operator 创建的代理 Pod 启用 Prometheus 插件。但是,您部署的代理必须使用 AMQ Broker 7.7 或更高版本的代理容器镜像。

流程

  1. 使用包含代理部署的项目的管理员特权登录到 OpenShift Container Platform Web 控制台。
  2. 在 Web 控制台中,点 Home Projects。选择包含代理部署的项目。
  3. 要查看项目中的 StatefulSets 或 DeploymentConfig,请点 Workloads StatefulSets DeploymentConfigs
  4. 点与代理部署对应的 StatefulSet 或 DeploymentConfig。
  5. 要访问代理部署的环境变量,请点 Environment 选项卡。
  6. 添加新的环境变量 AMQ_ENABLE_METRICS_PLUGIN。将 变量的值设置为 true

    当您设置 AMQ_ENABLE_METRICS_PLUGIN 环境变量时,OpenShift 会在 StatefulSet 或 DeploymentConfig 中重启每个代理 Pod。当部署中有多个 Pod 时,OpenShift 会依次重启每个 Pod。当每个代理 Pod 重启时,该代理的 Prometheus 插件将开始收集代理运行时指标。

7.2.4. 访问正在运行的代理 Pod 的 Prometheus 指标

此流程演示了如何访问正在运行的代理 Pod 的 Prometheus 指标。

先决条件

流程

  1. 对于您要访问其指标的代理 Pod,您需要识别之前创建的 Route,以将 Pod 连接到 AMQ Broker 管理控制台。Route 名称表单是访问指标所需的 URL 的一部分。

    1. 单击 Networking Routes
    2. 对于您选择的代理 Pod,识别为将 Pod 连接到 AMQ Broker 管理控制台而创建的路由。在 Hostname 下,记录显示的完整 URL。例如:

      http://rte-console-access-pod1.openshiftdomain
  2. 要访问 Prometheus 指标,请在网页浏览器中输入之前记录的 Route 名称,并附带 "/metrics "。例如:

    http://rte-console-access-pod1.openshiftdomain/metrics
注意

如果您的控制台配置没有使用 SSL,请在 URL 中指定 http。在本例中,主机名的 DNS 解析会将流量定向到 OpenShift 路由器的端口 80。如果您的控制台配置使用 SSL,在 URL 中指定 https。在这种情况下,您的浏览器默认为 OpenShift 路由器的端口 443。如果 OpenShift 路由器也为路由器默认使用端口 443,则启用与控制台的连接。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.