Datasource Micrometer

The Datasource Micrometer provides Micrometer Observation API instrumentation for JDBC operations.

Modules

datasource-micrometer
Micrometer observability instrumentation for JDBC DataSource.

datasource-micrometer-spring-boot
Spring Boot 3.x AutoConfiguration for micrometer observability.

Dependency Settings

datasource-micrometer

<!-- Maven -->
<dependency>
    <groupId>net.ttddyy.observation</groupId>
    <artifactId>datasource-micrometer</artifactId>
    <version>...</version>
</dependency>

// Gradle
dependencies {
    implementation "net.ttddyy.observation:datasource-micrometer:..."
}

datasource-micrometer-spring-boot

<!-- Maven -->
<dependency>
    <groupId>net.ttddyy.observation</groupId>
    <artifactId>datasource-micrometer-spring-boot</artifactId>
    <version>...</version>
</dependency>

// Gradle
dependencies {
    implementation "net.ttddyy.observation:datasource-micrometer-spring-boot:..."
}

Using Snapshot

To use snapshot releases, add the Maven Central Portal Snapshots repository to your project configuration.

<!-- Maven -->
<repositories>
    <repository>
        <name>Central Portal Snapshots</name>
        <id>central-portal-snapshots</id>
        <url>https://central.sonatype.com/repository/maven-snapshots/</url>
        <releases>
            <enabled>false</enabled>
        </releases>
        <snapshots>
            <enabled>true</enabled>
        </snapshots>
    </repository>
</repositories>

// Gradle
repositories {
    maven {
        name = 'Central Portal Snapshots'
        url = 'https://central.sonatype.com/repository/maven-snapshots/'

        // Only search this repository for the specific dependency
        content {
            includeModule("net.ttddyy.observation", "<datasource-micrometer artifacts>")
        }
    }
    mavenCentral()
}

For full instructions, see the official documentation.

Java versions

The produced jars support following JDK versions at runtime:

• datasource-micrometer: Java 8+ to match with micrometer 1.x java baseline.
• datasource-micrometer-spring-boot: Java 17+ to match with Spring Boot 3.x java baseline.

Documentation

• Current release
  • Reference Doc.
  • API Doc.
  • Changelog
• Snapshot
  • Reference Doc.
  • API Doc.
  • Changelog
• Other versions (TBD)

Dependent Library Versions

Spring Boot Support:

DataSource Micrometer	Spring Boot
2.x	4.0.x
1.x	3.x

DataSource Micrometer	Spring Boot	Micrometer Tracing BOM	Micrometer BOM
2.x	4.0.x	1.6.x	1.16.x
2.0.0-RC1	4.0.0-[M3,R1,R2]	1.6.0-[M3,R1]	1.16.0-[M3,R1]
1.0.0	3.0.0 and up	1.0.0	1.10.2
1.0.0-RC1	3.0.0-RC1	1.0.0-RC1	1.10.0-RC1
1.0.0-M1	3.0.0-M6	1.0.0-M8	1.10.0-M5

Development

To build the entire project, JDK-17 is required.

./mvnw install

Building document

./mvnw install -Pdocs -pl docs

Building javadoc

./mvnw javadoc:aggregate

Apply Source Code Format

./mvnw spring-javaformat:apply