This is a CloudWatch Reporter for the stable version of Dropwizard Metrics (formerly CodaHale & Yammer Metrics). The reporter is an implementation of ScheduledReporter from Dropwizard Metrics v3.2.3

• Prerequisites
• Summary
• Reportable Metrics
• Defaults
• Dependencies
• Usage
  • Dry run
• Credits
• Changelog
• License

• Java 1.8

• This CloudWatchReporter reports the metric data to CloudWatch asynchronously using the AmazonCloudWatchAsyncClient (AWS) interface
• Each reportable value in CodeHale Metric is reported as a separate MetricDatum (AWS)
• When reporting Meter, Counter, Histogram and Timer count metrics (getCount()) as MetricDatum (AWS), only the count difference since the last report is reported. This way the counters do not require a reset within the application using this reporter.
• If configured, each Snapshot translated into StatisticSet (AWS) in the most direct way possible.
• If configured, JVM statistic is reported

Currently the only metric values that are reportable through configuration are:

• Values of type Number from Gauge
• Counts from Counter, Histogram, Meter and Timer
• Percentiles from Snapshot in Histogram and Timer
• Arithmetic mean & standard deviation of Snapshot values in Histogram and Timer
• Mean rates from Meter and Timer
• Summaries of Snapshot values in Histogram and Timer as StatisticSet (AWS)

Please note:

• Histogram values (the percentiles, min, max, sum, arithmetic mean & std-dev from Snapshot) are reported raw.
• Timer values (the percentiles, min, max, sum, arithmetic mean & std-dev from Snapshot) are reported after conversion by a duration factor was applied. The duration factor is calculated by converting 1 unit of duration unit type to nanoseconds (see ScheduledReporter)
• Meter values (the 1min rate, 5min rate, 15min rate & mean rate) are reported after conversion by a rate factor was applied. The rate factor is calculated by converting 1 unit of rate unit type to seconds (see ScheduledReporter)

The Reporter uses the following defaults which can be configured:

• Rate metrics are in TimeUnit.Seconds
• Duration metrics are in TimeUnit.Milliseconds
• MetricFilter.ALL will be used for the Filter
• Clock.defaultClock() will be used for the Clock (Unconfigurable)
• Empty global Dimension (AWS) list
• The reporter adds a Type Dimension (AWS) to each reported metric, e.g:

The only metrics that are reportable by default are:

• Count values (getCount()) from Meter, Counter, Histogram and Timer
• Percentile values (75%, 95%, 99.9%) from Histogram and Timer

All other metrics have to be confugured for reporting by invoking their respective withXXXX() methods on the CloudWatchReporter.Builder instance

Gradle

repositories {
    mavenCentral()
}

dependencies { 
    compile("io.github.azagniotov:dropwizard-metrics-cloudwatch:1.0.5")
}

The library fetches the following transitive dependencies:

    io.dropwizard.metrics:metrics-core:3.2.3
    io.dropwizard.metrics:metrics-jvm:3.2.3
    com.amazonaws:aws-java-sdk-cloudwatch:1.11.179
    com.google.guava:guava:21.0

The reporter provides a fine-grained configuration options through its builder to configure what metrics should be reported to CloudWatch. Since AWS costs money, you probably do not want to report all the values from Metric classes or Snapshot, but only what's really useful to you.

    final AmazonCloudWatchAsync amazonCloudWatchAsync =
            AmazonCloudWatchAsyncClientBuilder
                    .standard()
                    .withRegion(Regions.US_WEST_2)
                    .build();
    
    final CloudWatchReporter cloudWatchReporter =
            CloudWatchReporter.forRegistry(metricRegistry, amazonCloudWatchAsync, Main.class.getName())
                    .convertRatesTo(TimeUnit.SECONDS)
                    .convertDurationsTo(TimeUnit.MILLISECONDS)
                    .filter(MetricFilter.ALL)
                    .withPercentiles(Percentile.P75, Percentile.P99)
                    .withOneMinuteMeanRate()
                    .withFiveMinuteMeanRate()
                    .withFifteenMinuteMeanRate()
                    .withMeanRate()
                    .withArithmeticMean()
                    .withStdDev()
                    .withStatisticSet()
                    .withJvmMetrics()
                    .withGlobalDimensions("Region=us-west-2", "Instance=stage")
                    .withDryRun()
                    .build();

    cloudWatchReporter.start(10, TimeUnit.SECONDS);

The reporter can be configured to run in DRY RUN mode by invoking .withDryRun() on the Builder. In that case, the reporter will log.DEBUG the created instance of PutMetricDataRequest (AWS), instead of doing a real POST to CloudWatch.

• https://github.com/blacklocus/metrics-cloudwatch
• https://github.com/tptodorov/metrics-cloudwatch
• https://github.com/basis-technology-corp/metrics-cloudwatch-reporter
• https://github.com/wavefrontHQ/java/tree/master/dropwizard-metrics/3.1

• Upgraded Metrics to v3.2.3 due to #1115
• Upgraded AWS Java SDK to v1.11.179

• Issue #4: Not reporting metric zero values.
• PR #6: Reporting Histogram snapshot raw values as StatisticSet, without applying a conversion by duration factor (https://github.com/williedoran)
• Checking isDebugEnabled when logging debug information

• PR #3: Updated dependencies to latest versions (https://github.com/efenderbosch)

• PR #2: Updated AWS SDK to com.amazonaws:aws-java-sdk-cloudwatch:1.11.86 (https://github.com/MeiSign)
• Reporting Histogram snapshot Arithemtic Mean & StdDev raw values, without applying a conversion by duration factor

• Revisited Javadoc
• Added dependency on metrics-jvm module in order to be able to export JVM metrics
• Code clean-up

• Initial release

MIT