Manage Metrics with circonus-cmi

As an environment grows, so does the headache of managing checks and metrics. Every new machine and cluster node requires a new set checks and metrics. There are the Circonus API and circonusvi tool, but those still require manual intervention. Wouldn’t it be nice if the same tools used for provisioning could handle Circonus setup as well? With circonus-cmi, that gap has now been bridged. Circonus-cmi is a lightweight command line application written in Node.js, which reads configuration information from provisioners and updates Circonus accordingly.

Circonus-cmi currently supports Amazon AWS and Chef Server. AWS integration is used to tag existing checks based on target with ec2 region, zone, id, and instance type information. This becomes very useful when one wants to compare performance between regions, for instance. The Chef Server integration, on the other hand, is able to do the heavy lifting of check management. By specifying checks, tags, and metrics within the Chef attribute heirarchy, Circonus metrics can be both added and updated. It is by default additive, merging the check specification in chef with an existing check configuration in Circonus, unless explicitly told to do otherwise. As a result, there’s no worry that circonus-cmi will wipe out changes made manually.

The goal of circonus-cmi is to make check management as easy and flexible as possible. If there are any features that you’d like to see added, please let us know.