Track custom metrics with AWS CloudWatch

Instantiating

A client will automatically be created for you if you have the following settings in Meteor.settings:

1{
2  "cloudWatch":{
3    "accessKeyId":"{access key}",
4    "secretAccessKey":"{secret key}",
5    "region":"{aws region}",
6    "namespace":"custom namespace"
7  }
8}

Because it's a bad idea to check your AWS creds into version control, you can also specify accessKeyId and secretAccessKey via the AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables, respectively.

All of the methods on this "default" client will be attached to the exported CloudWatch object, so you can call CloudWatch.track(...) and it will call track() on the default client.

Alternatively, you can create a new client as follows:

1var client = new CloudWatch.client(config);

Usage

client.track('metricName', value, unit='Count');

See the AWS SDK documentation.

Function Wrapping

You can use client.monitorFunction to wrap any function and send metrics to CloudWatch. If the function throws an error, the count for {metricName}.error will be incremented by 1, and if not, the count for {metricName}.success will be incremented by 1. For example:

1Meteor.methods({
2  'myMethod':CloudWatch.monitorFunction('myMetric', function(data) {
3    // Do something with the data
4  }, {
5    trackSuccess:true,
6    trackCalls:true
7  })
8});

In this case, every time you run Meteor.call('myMethod'), myMetric.call will be incremented by 1. If the function returns successfully, then a myMetric.success metric will be sent with value 1 , otherwise if there's an error thrown, myMetric.error will be sent.