8.6. 监控解析器
OptaPlanner 通过 Micrometer (一个 Java 应用程序的指标检测库)公开指标。您可以将 Micrometer 与流行的监控系统一起使用,来监控 OptaPlanner solver。
8.6.1. 为 Micrometer 配置 Quarkus OptaPlanner 应用程序 复制链接链接已复制到粘贴板!
要将 OptaPlanner Quarkus 应用程序配置为使用 Micrometer 和指定的监控系统,请将 Micrometer 依赖项添加到 pom.xml 文件中。
先决条件
- 您有一个 Quarkus OptaPlanner 应用程序。
流程
将以下依赖项添加到应用程序的
pom.xml文件中,其中 <MONITORING_SYSTEM> 是 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:devCopy to Clipboard Copied! Toggle word wrap Toggle overflow 要查看应用程序的指标,请在浏览器中输入以下 URL:
http://localhost:8080/q/metrics
http://localhost:8080/q/metricsCopy to Clipboard Copied! Toggle word wrap Toggle overflow
8.6.2. 为 Micrometer 配置 Spring Boot OptaPlanner 应用程序 复制链接链接已复制到粘贴板!
要将 Spring Boot OptaPlanner 应用程序配置为使用 Micrometer 和指定的监控系统,请将 Micrometer 依赖项添加到 pom.xml 文件中。
先决条件
- 您有一个 Spring Boot OptaPlanner 应用程序。
流程
将以下依赖项添加到应用程序的
pom.xml文件中,其中 <MONITORING_SYSTEM> 是 Micrometer 和 Spring Boot 支持的监控系统:Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
将配置信息添加到应用的
application.properties文件中。如需更多信息,请参阅 Micrometer 网站。 要运行应用程序,请输入以下命令:
mvn spring-boot:run
mvn spring-boot:runCopy to Clipboard Copied! Toggle word wrap Toggle overflow 要查看应用程序的指标,请在浏览器中输入以下 URL:
http://localhost:8080/actuator/metrics
注意使用以下 URL 作为 Prometheus scraper 路径:
http://localhost:8080/actuator/prometheus
8.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 分钟。
-
8.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.scorethe): 测量 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.score114 : 评估每个约束对当前步骤的分数影响。每个分数级别都有单独的分段,每个约束的标签。例如,对于软件包 "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.diff114):衡量特定移动类型提高了最佳解决方案。每个分数级别都有单独的分段,带有移动类型的标签。例如,对于进程的计算机的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.diff114):衡量特定移动类型提高了最佳解决方案。每个分数级别都有单独的分段,带有移动类型的标签。例如,对于进程的计算机,对于Hard SoftScore和ChangeMove,有optaplanner.solver.move.type.step.score.diff.hard.score和optaplanner.solver.move.type.step.score.diff.soft.scoretraffics,标签move.type=ChangeMove (Process.computer)。