7.2. 使用 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.11
     ...

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.11
       ...
       enableMetricsPlugin: true

   enableMetricsPlugin

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

3. 保存 CR 实例。

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

   $ oc project <project_name>

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

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

   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 name 表单部分。

   1. 点 Networking Routes。

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

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

2. 要访问 Prometheus 指标，在 Web 浏览器中输入之前记录的带有 "/metrics" 的路由名称。例如：

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