JarCastingdropwizard-micrometer
Dropwizard bundle that enables your dropwizard application for exposition of micrometer-like metrics (system, jvm and http requests) as a prometheus endpoint.
Packages
-
dropwizad-micrometer-coreDropwizard bundle that implements prometheus endpoint and exposes core system metrics and JVM metrics utilizing micrometer instrumentation. Optionally, it provides servlet filter to record HTTP requests latencies and statuses within dimensional prometheus histogram. -
dropwizad-micrometer-jdbiAn additional module to record latencies of JDBI queries within dimensional prometheus histogram.
Usage
You can find an example of usage in the ExampleApplication.
Below are the steps explained in more detail specifically for each package.
dropwizad-micrometer-core
This package provides a minimal setup, i.e. it instantiates /prometheus endpoint, adds system and JVM metrics utilizing micrometer instrumentation and optionally you can setup servlet filter to record HTTP requests latencies/statuses.
Add dependency into your pom.xml
If you use maven, you can simply reference it in the <dependenccies> block as below. The latest version can be found on in the maven repository
<dependencies>
...
...
<dependency>
<groupId>io.github.maksymdolgykh.dropwizard</groupId>
<artifactId>dropwizard-micrometer-core</artifactId>
<version>2.0.5</version>
</dependency>
...
...
</dependencies>
Import DropwizardMicrometer classes in your Application class
import io.github.maksymdolgykh.dropwizard.micrometer.MicrometerBundle;
import io.github.maksymdolgykh.dropwizard.micrometer.MicrometerHttpFilter;
import javax.servlet.FilterRegistration;
import javax.servlet.DispatcherType;
import java.util.EnumSet;
Add the bundle to your application
Add MicrometerBundle class to the bootstrapping phase of your Application class
public class ExampleApplication extends Application<ExampleConfiguration> {
//...
//...
@Override
public void initialize(Bootstrap<ExampleConfiguration> bootstrap) {
//...
//...
bootstrap.addBundle(new MicrometerBundle());
//...
//...
}
//...
//...
}
This will expose /prometheus endpoint in admin connector, by default admin connector is exposed at port 8081 in dropwizard apps.
Assign servlet filter to the environment
To leverage latency metrics per http endpoint you need to assign servlet filter to the environment in your Application class within run method
public class ExampleApplication extends Application<ExampleConfiguration> {
//...
//...
@Override
public void run(ExampleConfiguration configuration, Environment environment) {
//...
//...
FilterRegistration.Dynamic micrometerFilter = environment.servlets().addFilter("MicrometerHttpFilter", new MicrometerHttpFilter());
micrometerFilter.addMappingForUrlPatterns(EnumSet.allOf(DispatcherType.class), true, "/*");
}
}
This way all http requests will be metered and metrics will be recorded within http_server_requests_seconds histogram with the following labels:
method, http method, i.e.GET,POSTetcstatus, response status, i.e.200,404,500etcuri, request path
dropwizad-micrometer-jdbi
If you use JDBI to manage mapping of objects to database tables, you can utilize dropwizad-micrometer-jdbi package to meter SQL request's latencies. It depends on dropwizad-micrometer-core, so that to use dropwizad-micrometer-jdbi package the core package should be already installed and bundle should be added to your dropwizard application (see how to install it in dropwizad-micrometer-core section). Once dropwizad-micrometer-core is installed, the steps to install dropwizad-micrometer-jdbi package are:
Add dependency into your pom.xml
If you use maven, you can simply reference it in the <dependenccies> block as below. The latest version can be found on in the maven repository
<dependencies>
...
...
<dependency>
<groupId>io.github.maksymdolgykh.dropwizard</groupId>
<artifactId>dropwizard-micrometer-jdbi</artifactId>
<version>2.0.5</version>
</dependency>
...
...
</dependencies>
Import MicrometerJdbiTimingCollector class in your Application class
import io.github.maksymdolgykh.dropwizard.micrometer.MicrometerJdbiTimingCollector;
Set TimingColletor for Jdbi object
To use the class you just need to set TimingColletor for Jdbi object, where it should be done depends on how your Application is organized - it might be in the run method of your Application class, or you might have separate class to configure DAO.
database.setTimingCollector(new MicrometerJdbiTimingCollector());
With this setup all jdbi requests will be metered and metrics will be recorded within jdbi_requests_seconds histogram
License
This project is licensed under the Apache License 2.0 (LICENSE)