第 11 章 Red Hat Decision Manager 中的 Prometheus metrics 监控

流程

1. 在您的 KIE 服务器实例中，将 org.kie.prometheus.server.ext.disabled 系统属性设置为 false 以启用 Prometheus 扩展。您可在启动 KIE 服务器时或在 Red Hat Decision Manager 发行版的 standalone.xml 或 standalone-full.xml 文件中定义此属性。

2. 如果您在 Spring Boot 上运行 Red Hat Decision Manager，请在 application.properties 系统属性中配置所需的密钥：

   Spring Boot application.properties key for Red Hat Decision Manager 和 Prometheus

   kieserver.drools.enabled=true
   kieserver.dmn.enabled=true
   kieserver.prometheus.enabled=true

   Copy to Clipboard Toggle word wrap

3. 在 Prometheus 发行版本的 prometheus.yaml 文件中，在 scrape_configs 部分添加以下设置，将 Prometheus 配置为从 KIE 服务器中提取指标：

   prometheus.yaml 文件中的 scrape 配置

   scrape_configs:
     - job_name: 'kie-server'
       metrics_path: /SERVER_PATH/services/rest/metrics
       basicAuth:
         username: USER_NAME
         password: PASSWORD
       static_configs:
         - targets: ["HOST:PORT"]

   Copy to Clipboard Toggle word wrap

   Spring Boot 的 prometheus.yaml 文件中的 scrape 配置（如果适用）

   scrape_configs:
     - job_name: 'kie'
       metrics_path: /rest/metrics
       static_configs:
         - targets: ["HOST:PORT"]

   Copy to Clipboard Toggle word wrap

   根据您的 KIE 服务器位置和设置值。

4. 启动 KIE 服务器实例。

   红帽 JBoss EAP 上的红帽决策管理器入门命令示例

   $ cd ~/EAP_HOME/bin
   $ ./standalone.sh --c standalone-full.xml

   Copy to Clipboard Toggle word wrap

   启动配置的 KIE 服务器实例后，Prometheus 开始收集指标，KIE 服务器会将指标发布到 REST API 端点 http://HOST:PORT/SERVER/services/rest/metrics （或在 Spring Boot 上，或在 Spring Boot 上）发布指标到 http://HOST:PORT/rest/metrics。

5. 在 REST 客户端或 curl 实用程序中，使用以下组件发送 REST API 请求，以验证 KIE 服务器是否发布指标：

   对于 REST 客户端：

   • 身份验证 ：使用 kie-server 角色输入 KIE 服务器用户的用户名和密码。

   • HTTP 标头 ：设置以下标头：

     • 接受:application/json
   • HTTP 方法 ：设置为 GET。
   • URL ：输入 KIE 服务器 REST API 基础 URL 和指标端点，如 http://localhost:8080/kie-server/services/rest/metrics （或在 Spring Boot、http://localhost:8080/rest/metrics上）。

   对于 curl 实用程序：

   • - U ：使用 kie-server 角色输入 KIE 服务器用户的用户名和密码。

   • -H ：设置以下标头：

     • 接受:application/json
   • -x ：设置为 GET。
   • URL ：输入 KIE 服务器 REST API 基础 URL 和指标端点，如 http://localhost:8080/kie-server/services/rest/metrics （或在 Spring Boot、http://localhost:8080/rest/metrics上）。

   红帽 JBoss EAP 上红帽决策管理器的 curl 命令示例

   curl -u 'baAdmin:password@1' -X GET "http://localhost:8080/kie-server/services/rest/metrics"

   Copy to Clipboard Toggle word wrap

   Spring Boot 上的 Red Hat Decision Manager 的 curl 命令示例

   curl -u 'baAdmin:password@1' -X GET "http://localhost:8080/rest/metrics"

   Copy to Clipboard Toggle word wrap

   服务器响应示例

   # HELP kie_server_container_started_total Kie Server Started Containers
   # TYPE kie_server_container_started_total counter
   kie_server_container_started_total{container_id="task-assignment-kjar-1.0",} 1.0
   # HELP solvers_running Number of solvers currently running
   # TYPE solvers_running gauge
   solvers_running 0.0
   # HELP dmn_evaluate_decision_nanosecond DMN Evaluation Time
   # TYPE dmn_evaluate_decision_nanosecond histogram
   # HELP solver_duration_seconds Time in seconds it took solver to solve the constraint problem
   # TYPE solver_duration_seconds summary
   solver_duration_seconds_count{solver_id="100tasks-5employees.xml",} 1.0
   solver_duration_seconds_sum{solver_id="100tasks-5employees.xml",} 179.828255925
   solver_duration_seconds_count{solver_id="24tasks-8employees.xml",} 1.0
   solver_duration_seconds_sum{solver_id="24tasks-8employees.xml",} 179.995759653
   # HELP drl_match_fired_nanosecond Drools Firing Time
   # TYPE drl_match_fired_nanosecond histogram
   # HELP dmn_evaluate_failed_count DMN Evaluation Failed
   # TYPE dmn_evaluate_failed_count counter
   # HELP kie_server_start_time Kie Server Start Time
   # TYPE kie_server_start_time gauge
   kie_server_start_time{name="myapp-kieserver",server_id="myapp-kieserver",location="http://myapp-kieserver-demo-monitoring.127.0.0.1.nip.io:80/services/rest/server",version="7.4.0.redhat-20190428",} 1.557221271502E12
   # HELP kie_server_container_running_total Kie Server Running Containers
   # TYPE kie_server_container_running_total gauge
   kie_server_container_running_total{container_id="task-assignment-kjar-1.0",} 1.0
   # HELP solver_score_calculation_speed Number of moves per second for a particular solver solving the constraint problem
   # TYPE solver_score_calculation_speed summary
   solver_score_calculation_speed_count{solver_id="100tasks-5employees.xml",} 1.0
   solver_score_calculation_speed_sum{solver_id="100tasks-5employees.xml",} 6997.0
   solver_score_calculation_speed_count{solver_id="24tasks-8employees.xml",} 1.0
   solver_score_calculation_speed_sum{solver_id="24tasks-8employees.xml",} 19772.0

   Copy to Clipboard Toggle word wrap

   如果 KIE 服务器中没有指标，请查看并验证本节中描述的 KIE 服务器和 Prometheus 配置。

   您还可以在 http://HOST:PORT/graph 中与 Prometheus 表达式浏览器中收集的指标进行交互，或者将 Prometheus 数据源与数据图形工具（如 Grafana）集成：

   图 11.1. 带有 KIE 服务器指标的 Prometheus 表达式浏览器

   

   View larger image

   

   图 11.2. 带有 KIE 服务器目标的 Prometheus 表达式浏览器

   

   View larger image

   

   图 11.3. DMN 型号的 KIE 服务器指标的 Grafana 仪表板

   

   View larger image

   

   图 11.4. 带有临时解决方案的 KIE 服务器指标的 Grafana 仪表板

   

   View larger image