7.6. 监控解析器
OptaPlanner 通过 Micrometer (一个 Java 应用程序的指标检测库)公开指标。您可以将 Micrometer 与流行的监控系统一起使用,来监控 OptaPlanner solver。
7.6.1. 为 Micrometer 配置 Quarkus OptaPlanner 应用程序 复制链接链接已复制到粘贴板!
要将 OptaPlanner Quarkus 应用程序配置为使用 Micrometer 和指定的监控系统,请将 Micrometer 依赖项添加到 pom.xml
文件中。
先决条件
- 您有一个 Quarkus OptaPlanner 应用程序。
流程
将以下依赖项添加到应用程序的
pom.xml
文件中,其中 <MONITORING_SYSTEM&
gt; 是 Micrometer 和 Quarkus 支持的监控系统:注意Prometheus 目前是唯一由 Quarkus 支持的监控系统。
<dependency> <groupId>io.quarkus</groupId> <artifactId>quarkus-micrometer-registry-<MONITORING_SYSTEM></artifactId> </dependency>
<dependency> <groupId>io.quarkus</groupId> <artifactId>quarkus-micrometer-registry-<MONITORING_SYSTEM></artifactId> </dependency>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 要在开发模式下运行应用程序,请输入以下命令:
mvn compile quarkus:dev
mvn compile quarkus:dev
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 要查看应用程序的指标,请在浏览器中输入以下 URL:
http://localhost:8080/q/metrics
http://localhost:8080/q/metrics
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
7.6.2. 为 Micrometer 配置 Spring Boot OptaPlanner 应用程序 复制链接链接已复制到粘贴板!
要将 Spring Boot OptaPlanner 应用程序配置为使用 Micrometer 和指定的监控系统,请将 Micrometer 依赖项添加到 pom.xml
文件中。
先决条件
- 您有一个 Spring Boot OptaPlanner 应用程序。
流程
将以下依赖项添加到应用程序的
pom.xml
文件中,其中 <MONITORING_SYSTEM&
gt; 是 Micrometer 和 Spring Boot 支持的监控系统:Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
将配置信息添加到应用的
application.properties
文件中。如需更多信息,请参阅 Micrometer 网站。 要运行应用程序,请输入以下命令:
mvn spring-boot:run
mvn spring-boot:run
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 要查看应用程序的指标,请在浏览器中输入以下 URL:
http://localhost:8080/actuator/metrics
注意使用以下 URL 作为 Prometheus scraper 路径:
http://localhost:8080/actuator/prometheus
7.6.3. 为 Micrometer 配置普通 Java OptaPlanner 应用程序 复制链接链接已复制到粘贴板!
要将普通 Java OptaPlanner 应用程序配置为使用 Micrometer,您必须将所选监控系统的 Micrometer 依赖项和配置信息添加到项目的 POM.XML
文件中。
先决条件
- 您有一个普通 Java OptaPlanner 应用程序。
流程
将以下依赖项添加到应用程序的
pom.xml
文件中,其中 <MONITORING_SYSTEM>
; 是一个监控系统,使用 Micrometer 配置,<VERSION
> 是您使用的 Micrometer 版本:Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
将监控系统的 Micrometer 配置信息添加到项目的
pom.xml
文件的开头。如需更多信息,请参阅 Micrometer 网站。 在配置信息下方添加以下行,其中 <
;MONITORING_SYSTEM
> 是您添加的监控系统:Metrics.addRegistry(<MONITORING_SYSTEM>);
Metrics.addRegistry(<MONITORING_SYSTEM>);
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下示例演示了如何添加 Prometheus 监控系统:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 打开您的监控系统,以查看您的 OptaPlanner 项目的指标。公开以下指标:
注意指标的名称和格式因 registry 而异。
-
OptaPlanner.solver.errors.total
:自测量开始开始时发生的错误总数。 -
optaPlanner.solver.solve-length.active-count
: 当前解决者的数量。 -
optaPlanner.solver.solve-length.seconds-max
: 运行 longest-running 当前活跃解析程序的时间。 -
optaPlanner.solver.solve-length.seconds-duration-sum
: 每个活跃解析器解析持续时间的总和。例如,如果有两个活跃的解析器,一个会运行一个三分钟,另一个一分钟,总地址时间为 4 分钟。
-
7.6.4. 其他指标 复制链接链接已复制到粘贴板!
如需更详细的监控,您可以在 solver 配置中配置 OptaPlanner,以以性能成本监控其他指标。以下示例使用 BEST_SCORE
和 SCORE_CALCULATION_COUNT
指标:
您可以在此配置中启用以下指标:
-
SOLVE_DURATION
(默认为 Micrometer 分段 ID:optaplanner.solver.solve.duration
):测量活跃解析器的持续时间、活动解析器的数量以及所有活动解析器的累积持续时间。 -
ERROR_COUNT
(默认启用, Micrometer measure ID:optaplanner.solver.errors
):测量在过期时发生的错误数量。 -
SCORE_CALCULATION_COUNT
(默认启用 Micrometer 分段 ID:optaplanner.solver.score.calculation.count
) :测量执行 OptaPlanner 的分数计算数。 -
BEST_SCORE
(Micrometer geo ID:optaplanner.solver.best
.scoreö : 测量 OptaPlanner 已找到的最佳解决方案分数。每个分数级别都有单独的分段。例如,对于Hard SoftScore
,有optaplanner.solver.best.score.hard.score
和optaplanner.solver.best.score.soft.score
修饰符。 -
STEP_SCORE
(Micrometer geo ID:optaplanner.solver.step.score
the): 测量 OptaPlanner 所采取的每个步骤的分数。每个分数级别都有单独的分段。例如,对于Hard SoftScore
,有optaplanner.solver.step.score.hard.score
和optaplanner.solver.step.score.soft.score
修饰符。 -
BEST_SOLUTION_MUTATION
(Micrometer measure ID:optaplanner.solver.best.solution.mutation
: 测量连续最佳解决方案间更改的规划变量的数量。 -
MOVE_COUNT_PER_STEP
(Micrometer geo ID:optaplanner.solver.step.move.count
):测量步骤中评估的移动数量。 -
MEMORY_USE
(Micrometer geo ID:jvm.memory.used
):测量 JVM 之间使用的内存量。此指标不测量解析器使用的内存量;同一 JVM 上的两个地址将报告此指标的值相同的值。 -
CONSTRAINT_MATCH_TOTAL_BEST_SCORE
(Micrometer the ID:optaplanner.solver.constraint.match
.best.score : 评估每个约束对目前找到的最佳解决方案的影响。每个分数级别都有单独的分段,每个约束的标签。例如,对于软件包 "com.example" 中的HardSoftScore
的约束"Minimize Cost",有带有标签 "constraint.package=com.example" 和 "
.score.constraint.constraint.best.score.name=Minimize Cost"。constraint.
name=Minimize Cost" 的 optaplanner.solver.match.best.score.soft -
CONSTRAINT_MATCH_TOTAL_STEP_SCORE
(Micrometer measure ID:optaplanner.solver.constraint.match.step.score
114 : 评估每个约束对当前步骤的分数影响。每个分数级别都有单独的分段,每个约束的标签。例如,对于软件包 "com.example" 中的HardSoftScore
的约束"Minimize Cost",带有标签 "constraint.package=com.
example" 和 "constraint.name=Minimimize Cost" 的选择器。 -
PICKED_MOVE_TYPE_BEST_SCORE_DIFF
(Micrometer the ID:optaplanner.solver.move.type.best.score.diff
114):衡量特定移动类型提高了最佳解决方案。每个分数级别都有单独的分段,带有移动类型的标签。例如,对于进程的计算机的Hard SoftScore
和ChangeMove
,有optaplanner.solver.move.type.best.type.best.diff.hard.score 和
traffics,标签optaplanner.
solver.move.type.best.score.diff.soft.scoremove.type=ChangeMove (Process.computer)
。 -
PICKED_MOVE_TYPE_STEP_SCORE_DIFF
(Micrometer the ID:optaplanner.solver.move.type.step.score.diff
114):衡量特定移动类型提高了最佳解决方案。每个分数级别都有单独的分段,带有移动类型的标签。例如,对于进程的计算机,对于Hard SoftScore
和ChangeMove
,有optaplanner.solver.move.type.step.score.diff.hard.score
和optaplanner.solver.move.type.step.score.diff.soft.score
traffics,标签move.type=ChangeMove (Process.computer)
。