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

流程

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

   apiVersion: broker.amq.io/v1beta1
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
     application: ex-aao-app
   spec:
     deploymentPlan:
       size: 4
       image: registry.redhat.io/amq7/amq-broker-rhel8:7.10
     ...

   Copy to Clipboard Toggle word wrap

2. 在 deploymentPlan 部分中，添加 enableMetricsPlugin 属性并将值设为 true，如下所示。

   apiVersion: broker.amq.io/v1beta1
   kind: ActiveMQArtemis
   metadata:
     name: ex-aao
     application: ex-aao-app
   spec:
     deploymentPlan:
       size: 4
       image: registry.redhat.io/amq7/amq-broker-rhel8:7.10
       ...
       enableMetricsPlugin: true

   Copy to Clipboard Toggle word wrap

   enableMetricsPlugin

   指定部署中的代理是否启用 Prometheus 插件。

3. 保存 CR 实例。

4. 切换到之前创建的代理部署的项目。

   $ oc project <project_name>

   Copy to Clipboard Toggle word wrap

5. 在命令行中应用更改。

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

   Copy to Clipboard Toggle word wrap

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

流程

1. 使用包含代理部署的项目的管理员权限登录到 OpenShift Container Platform Web 控制台。
2. 在 Web 控制台中，点 Home Projects。选择包含代理部署的项目。
3. 要查看项目中的 StatefulSets 或 DeploymentConfig，请点击 Workloads StatefulSets 或 Workloads DeploymentConfig。
4. 点击与代理部署对应的 StatefulSet 或 DeploymentConfig。
5. 要访问代理部署的环境变量，请单击 Environment 选项卡。

6. 添加新的环境变量 AMQ_ENABLE_METRICS_PLUGIN。将 变量的值设置为 true。

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

流程

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

   1. 点击 Networking Routes。

   2. 对于您选择的代理 Pod，标识为将 Pod 连接到 AMQ Broker 管理控制台而创建的路由。在 Hostname 下，请注意显示的完整 URL。例如：

      http://rte-console-access-pod1.openshiftdomain

      Copy to Clipboard Toggle word wrap

2. 要访问 Prometheus 指标，在网页浏览器中输入之前记录的 Route 名称，并附加 "/metrics "。例如：

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

   Copy to Clipboard Toggle word wrap