Skip to content
This repository has been archived by the owner. It is now read-only.
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This version of cosi is no longer active. Please see cosi-server and cosi-tool for the up-to-date version of cosi.

COSI - The Circonus One Step Installer

The purpose of COSI is to simplify the task of getting metrics flowing from a new host into Circonus, consisting of:

  1. Install and configure the Circonus monitoring agent nad

  2. Create and configure a Circonus check that receives data from the agent

  3. Create graphs and worksheets for each of the basic metric groups (e.g. cpu, memory, disk, network, filesystem, etc.)

COSI automates all these steps with a single cut-n-paste command without inhibiting customization and orchestration/automation. In addition it provides a command line utility command, for managing the Circonus check for the hosts.


In most cases, you will want to use the Circonus UI to install COSI on your host:

  1. Log into your Circonus Account

  2. Go to the Checks page, click [NEW HOST+] on the top right.

  3. Copy and run the command displayed on the host to be setup.

Add Host Screenshot


This repository contains the following components:

  • COSI installer. A shell script that interacts with the COSI site API.

  • COSI utility. A command line utility for configuring metrics, checks, graphs and worksheets created by COSI.

  • COSI site. A Node.js-based service that serves the COSI installer itself, templates, and pointers to NAD packages. Most users will rely on the hosted COSI site provided by Circonus (

The COSI user documentation is in the wiki for this repository.