はじめに

本記事は Java アプリで任意のメトリクスをInstana で可視化する(JMX編) の続きとなります。
今回は、JMXでは無く、micrometer で JavaアプリのConnectionPoolの状態を Instana で可視化してみます。

検証用サンプルアプリ

Instana で Javaアプリ内のデータベースコネクションプールのメトリクスをmicrometer経由で可視化します。
今回は、Spring Boot を使います。
(生Javaアプリだとうまくmicrometerが動かなかったので、Web上で実績の多いSpring Bootを採用しました)

以下の内容で、データベースにただひたすらデータを登録するアプリケーションを作成します。

環境

JMXと同じです。アプリがSpring Boot を使っているだけです。
OS: RHEL9.6
Java: OpenJDK17
Framework: Spring Boot
Connection Pool: Apache Commons DBCP2 2.13
JDBC Driver: IBM Db2 JDBC Driver (Type 4) 12.1.3
データベース: Db2 v12.1.3
Instana Agent: エージェントバージョン：2025.12.12.0748、ブートバージョン：1.2.49
データベースとInstana Agentは導入済みとします。

Instana Agent と Db2 の導入・監視については InstanaでDb2を監視してみよう！を参考にしてください。　

実装

アプリ概要と事前準備は Java アプリで任意のメトリクスをInstana で可視化する(JMX編) を参照してください。

ファイルが多いので、今回はSpring Boot内でのmicrometer設定だけを記載します。

metrics/DbcpMetricsConfig.java


package com.example.db2pool.metrics;

import io.micrometer.core.instrument.Gauge;
import io.micrometer.core.instrument.MeterRegistry;
import io.micrometer.core.instrument.Counter;
import io.micrometer.core.instrument.Timer;
import org.apache.commons.dbcp2.BasicDataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class DbcpMetricsConfig {

    @Bean
    public Counter insertCounter(MeterRegistry registry) {
        return Counter.builder("db2.insert.count")
                .description("Number of rows inserted into Test1")
                .register(registry);
    }

    @Bean
    public Timer insertTimer(MeterRegistry registry) {
        return Timer.builder("db2.insert.timer")
                .description("Insertion duration into Test1")
                .register(registry);
    }

    @Bean
    public Object dbcpGauges(MeterRegistry registry, BasicDataSource dataSource) {
        Gauge.builder("dbcp.num.active", dataSource, BasicDataSource::getNumActive)
                .description("Active connections in Apache Commons DBCP pool")
                .tag("pool", "Db2Pool")
                .register(registry);

        Gauge.builder("dbcp.num.idle", dataSource, BasicDataSource::getNumIdle)
                .description("Idle connections in Apache Commons DBCP pool")
                .tag("pool", "Db2Pool")
                .register(registry);
        // Return a dummy bean so Spring instantiates this configuration
        return new Object();
    }
}

Instana設定

Instana 側は、設定不要で自動的に取り込みを行います！！
JMXより楽ですね (びっくり)

実行

Mavenビルドで作成されたJarファイルを使って実行します。

java -jar target/db2-dbcp-micrometer-demo-0.1.0.jar

こんな出力が出れば無事起動完了です。

  .   ____          _            __ _ _
 /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
 \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
  '  |____| .__|_| |_|_| |_\__, | / / / /
 =========|_|==============|___/=/_/_/_/

 :: Spring Boot ::                (v3.3.5)

2025-12-22T01:58:12.793Z  INFO 481004 --- [db2-dbcp-micrometer-demo] [           main] com.example.db2pool.Application          : Starting Application v0.1.0 using Java 17.0.17 with PID 481004 (/home/itzuser/db2-dbcp-micrometer-demo/target/db2-dbcp-micrometer-demo-0.1.0.jar started by itzuser in /home/itzuser/db2-dbcp-micrometer-demo)
2025-12-22T01:58:12.798Z  INFO 481004 --- [db2-dbcp-micrometer-demo] [           main] com.example.db2pool.Application          : No active profile set, falling back to 1 default profile: "default"
2025-12-22T01:58:14.227Z  INFO 481004 --- [db2-dbcp-micrometer-demo] [           main] c.e.db2pool.runner.BurstLoadRunner       : BurstLoadRunner started: generating concurrent DB work to show DBCP pool metrics fluctuations
2025-12-22T01:58:15.278Z  INFO 481004 --- [db2-dbcp-micrometer-demo] [           main] com.example.db2pool.Application          : Started Application in 3.045 seconds (process running for 3.612)

数分待ちます。

Instanaでの可視化

まずはインフラストラクチャーを確認します。
JVMがちゃんと認識されました。

db2-dbcp-micrometer-demo 0.1.0 をクリックしてダッシュボードを開くを選択します。
JVMのスレッド数やヒープ・メモリーなどを見ることができる画面に遷移しました。
このページの一番下まで遷移すると、Micrometer カスタム・メトリック があることが確認できます。
上から3番目〜6番目までの4つが、今回明示的に作成したカスタムメトリックです。それ以外はMicrometer(Spring)側が自動的に出力したメトリクスですね。

項目をオープンすると、ちゃんとグラフを確認できることを確認しました。

JMXより若干簡単ですね！SpringBootを使っている場合はMicrometerの方が必要な作業は少なさそうです。
必要に応じて使いやすい方を選択ください。

カスタムダッシュボード

カスタムダッシュボードについてもJMX編をご確認いただくとして、
カスタムダッシュボードでもmicrometerメトリクスを選択できます！

Micrometerでも簡単に可視化できることが確認できました。
もし Instana が対応していないJavaアプリのメトリクスを可視化したい場合は、JMX や Micrometer の利用を検討してください！