Circonus Unified Agent


The Circonus Unified Agent, affectionately referred to as CUA [see-you-ey], is an agent for collecting metrics and writing them to the Circonus service.

CUA collects metrics through various input plugins, allowing Circonus customers to monitor systems, services, and 3rd party APIs.

These input plugins are designed to be easy to develop and contribute. Pull requests are very welcome, as we seek to expand support for and incorporate support for many technologies.

CUA is open-source, and its source code is available on GitHub at circonus-labs/circonus-unified-agent.

How It Works

When the Unified Agent (CUA) first starts up, it takes stock of the input plugins which have been enabled and looks for corresponding checks in Circonus (it matches via tags and metadata). If it finds matching checks for all the plugins, it begins data submission. If one or more plugins do not have corresponding checks, it creates new checks for those plugins. When new checks are created, CUA has to select a broker to receive its data submissions; if any compatible enterprise brokers are available, one will be selected, but otherwise a compatible public broker will be selected. Once the checks are set up or selected, data submission can begin. CUA will collect data from each plugin and at the configured interval, will submit that data to Circonus via the pre-selected broker(s).

CUA Connections


CUA can easily be installed using the one-step installer. A number of target platforms are supported.

To get started using CUA, please select your platform:

Packages are also available for 64-bit x86 and Arm v8 architectures. For other architectures, use a source install.


CUA includes a turnkey, self-monitoring service dashboard.

Image: ‘cua-dashboard-overview.png’

More Information

The following topics should be reviewed before deploying in a production setting.

Basic Usage: Find out more about CUA, including architecture details.