7.6. ソルバーの監視

手順

1. 次の依存関係をアプリケーションの pom.xml ファイルに追加します。ここで <MONITORING_SYSTEM> は Micrometer と Quarkus でサポートされている監視システムです。

   注記

   Prometheus は現在、Quarkus でサポートされている唯一の監視システムです。

   <dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-micrometer-registry-<MONITORING_SYSTEM></artifactId>
   </dependency>

   Copy to Clipboard Toggle word wrap

2. アプリケーションを開発モードで実行するには、次のコマンドを入力します。

   mvn compile quarkus:dev

   Copy to Clipboard Toggle word wrap

3. アプリケーションのメトリックを表示するには、ブラウザーに次の URL を入力します。

   http://localhost:8080/q/metrics

   Copy to Clipboard Toggle word wrap

手順

1. 次の依存関係をアプリケーションの pom.xml ファイルに追加します。ここで <MONITORING_SYSTEM> は Micrometer と Spring Boot でサポートされている監視システムです。

   <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
   </dependency>
   <dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-<MONITORING_SYSTEM></artifactId>
   </dependency>

   Copy to Clipboard Toggle word wrap
2. アプリケーションの application.properties ファイルに設定情報を追加します。詳細は、Micrometer Web サイトを参照してください。

3. アプリケーションを実行するには、以下のコマンドを入力します。

   mvn spring-boot:run

   Copy to Clipboard Toggle word wrap

4. アプリケーションのメトリックを表示するには、ブラウザーに次の URL を入力します。

   http://localhost:8080/actuator/metrics

   注記

   次の URL を Prometheus スクレイパーパスとして使用します: http://localhost:8080/actuator/prometheus

手順

1. 次の依存関係をアプリケーションの pom.xml ファイルに追加します。ここで、<MONITORING_SYSTEM> は Micrometer で設定された監視システムであり、<VERSION> は使用している Micrometer のバージョンです。

   <dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-registry-<MONITORING_SYSTEM></artifactId>
    <version><VERSION></version>
   </dependency>
   <dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-core</artifactId>
    <version><VERSION></version>
   </dependency>

   Copy to Clipboard Toggle word wrap
2. プロジェクトの pom.xml ファイルの先頭に、監視システムの Micrometer 設定情報を追加します。詳細は、Micrometer Web サイトを参照してください。

3. 設定情報の下に次の行を追加します。ここで、<MONITORING_SYSTEM> は追加した監視システムです。

   Metrics.addRegistry(<MONITORING_SYSTEM>);

   Copy to Clipboard Toggle word wrap

   次の例は、Prometheus 監視システムを追加する方法を示しています。

   PrometheusMeterRegistry prometheusRegistry = new PrometheusMeterRegistry(PrometheusConfig.DEFAULT);
   try {
       HttpServer server = HttpServer.create(new InetSocketAddress(8080), 0);
       server.createContext("/prometheus", httpExchange -> {
           String response = prometheusRegistry.scrape();
           httpExchange.sendResponseHeaders(200, response.getBytes().length);
           try (OutputStream os = httpExchange.getResponseBody()) {
               os.write(response.getBytes());
           }
       });
       new Thread(server::start).start();
   } catch (IOException e) {
       throw new RuntimeException(e);
   }
   Metrics.addRegistry(prometheusRegistry);

   Copy to Clipboard Toggle word wrap

4. 監視システムを開いて、OptaPlanner プロジェクトのメトリックを表示します。次のメトリックが公開されます。

   注記

   メトリックの名前と形式は、レジストリーによって異なります。

   • optaplanner.solver.errors.total: 測定開始以降に解決中に発生したエラーの総数。
   • optaplanner.solver.solve-length.active-count: 現在解いているソルバーの数。
   • optaplanner.solver.solve-length.seconds-max: 現在アクティブなソルバーの実行時間が最も長い実行時間。
   • optaplanner.solver.solve-length.seconds-duration-sum: アクティブな各ソルバーの解決時間の合計。たとえば、アクティブなソルバーが 2 つあり、一方が 3 分間実行され、もう一方が 1 分間実行されている場合、合計計算時間は 4 分です。