JarCasting
JarCasting JarCasting

asperatus

library for batching/aggregating stats to Cloudwatch

License

License
GroupId

GroupId

com.bizo
ArtifactId

ArtifactId

asperatus
Last Version

Last Version

2.2
Release Date

Release Date
Type

Type

jar
Description

Description

asperatus
library for batching/aggregating stats to Cloudwatch
Project URL

Project URL

https://github.com/bizo/asperatus
Project Organization

Project Organization

com.bizo
Source Code Management

Source Code Management

https://github.com/bizo/asperatus

Download asperatus

Filename Size
asperatus-2.2.pom
asperatus-2.2.jar 32 KB
asperatus-2.2-sources.jar 19 KB
asperatus-2.2-javadoc.jar 99 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/com.bizo/asperatus/ -->
<dependency>
    <groupId>com.bizo</groupId>
    <artifactId>asperatus</artifactId>
    <version>2.2</version>
</dependency>
// https://jarcasting.com/artifacts/com.bizo/asperatus/
implementation 'com.bizo:asperatus:2.2'
// https://jarcasting.com/artifacts/com.bizo/asperatus/
implementation ("com.bizo:asperatus:2.2")
'com.bizo:asperatus:jar:2.2'
<dependency org="com.bizo" name="asperatus" rev="2.2">
  <artifact name="asperatus" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.bizo', module='asperatus', version='2.2')
)
libraryDependencies += "com.bizo" % "asperatus" % "2.2"
[com.bizo/asperatus "2.2"]

Dependencies

compile (3)

Group / Artifact Type Version
com.amazonaws : aws-java-sdk-cloudwatch jar 1.9.0
commons-lang : commons-lang jar 2.6
com.google.guava : guava jar 17.0

test (3)

Group / Artifact Type Version
junit : junit jar 4.11
org.mockito : mockito-all jar 1.8.2
com.novocode : junit-interface jar 0.10-M4

Project Modules

There are no modules declared in this project.

asperatus

simple CloudWatch metrics API with local aggregation and batching

why

Asperatus provides:

  • Simple API
  • Local aggregation
  • Request batching

Simple API

 tracker.track("MyMetric", 1, myDimensions);

Local Aggregation

Asperatus performs local metric aggregation over a configurable timeframe (defaults to 60 seconds) before pushing to CloudWatch. I.e. if you call .track a million times in the same minute for the same metric, it will only result in a single call to CloudWatch. Since you pay per API call, and CloudWatch only supports granularity of 1 minute, this is a big win. Note that this doesn't affect your number of samples, min, max, etc. as CloudWatch supports accepting locally aggregated data.

Request batching

In addition to local aggregation, CloudWatch support batch metric update calls. That is, multiple metric updates can happen in the same call, reducing the number of API calls to Amazon. Asperatus handles this automatically.

using

 tracker.track("MyMetric", 1, myDimensions);

TODO, talk more about CW namespace config, etc.

history

When we first starting using CloudWatch for custom metrics, there was no client library, so we put together a really simple one.

After CloudWatch support was added to the official SDK, we switched out our REST client, but decided to keep our API for the simplicity, local aggregation and request batching, and the standardization on how we set up CloudWatch namespaces across application/stage/region.

You can read more about how we're using CloudWatch on our development blog:

license

Copyright (c) 2012 Larry Ogrodnek, Bizo.com Published under the Apache Software License 2.0, see LICENSE

com.bizo

Bizo Engineering

Versions

Version
2.2