leo
Automatic setup and configuration systems for nad
Description
leo will automatically create checks, graphs, and a worksheet for a host running nad. After running a simple command line script, you will be able to log into your Circonus account and view graphs for CPU, Disk, Network, and Memory utilization, as well as a worksheet for your host.
leo will prompt you for information such as IP or hostname, Circonus auth token, Broker id, and the location of a config file that will then be run through nad and used to create a check, a worksheet, and a series of graphs.
Once run, any changes made will be visible on the UI.
More info on nad can be found here: https://github.com/circonus-labs/nad/blob/master/README.md
Installation
leo is currently not a published npm. Therefore, the only way to access the program is through git clone or wget.
*Installation instructions are subject to change
System Requirements
You will need a basic development environment (compiler, GNU make, etc.) in order to build the default plugins.
Node.js v0.10 or later is required.
nad must be installed for any checks, graphs, or worksheets to be made.
Directions for nad installation can be found here: https://d.circonus.com/questions/22/how-to-useextend-node-agent.html
RHEL/CentOS
wget
# yum upgrade
# yum install nodejs
# wget https://github.com/circonus-labs/leo/archive/master.zip
# unzip master.zip
# cd leo-master
# npm install
git clone
# yum upgrade
# yum install nodejs
# git clone https://github.com/circonus-labs/leo.git
# cd leo
# npm install
Ubuntu
wget
#apt-get update
#apt-get install nodes-legacy
#wget https://github.com/circonus-labs/leo/archive/master.zip
#unzip master.zip
#cd leo-master
#npm install
git clone
# apt-get update
# apt-get install nodes-legacy
# git clone https://github.com/circonus-labs/leo.git
# cd leo
# npm install
Operations
The Config file is located in the bin directory under file circonus-setup. Default settings are located in the components directory in files nad.js and postgres.js.
Once leo has been installed, simply run it, answer the questions, and let nad do the rest.
Running
CentOS & Ubuntu
If you used git clone:
# leo/bin/circonus-setup
If you used wget:
# leo-master/bin/circonus-setup
Optional Arguments
leo allows nad to automatically configure itself with Circonus via a few command line options.
-h —help - Will display this help menu.
-t —target - (Required) This should be either the IP or hostname at which the Circonus broker can talk to this host.
-k —authtoken - (Required) The Circonus API auth token to use when talking with the API. This "activates" the configuration mode.
-b —brokerid - (Required) The ID from Circonus for the broker on which you wish to configure the check.
-c —configfile - (Required) The location of the config file your present configurations will be saved to
—all default - The option to skip prompts for metrics/graphs and use all default settings.
If you create another config file and want it to appear as a default option when running leo, it should be placed in the components directory.
If you choose to save the details of a customized configuration to a specific file, that file will appear in the leo/leo-master directory.
Default Options
You will have 2 default options for configuring your check, graphs and worksheets:
- CPU, disk, memory, and network metrics via Node.js Agent
- PostgreSQL database metrics
For option 1 the only information you need to provide is the previously stated parameters which include: auth token, target, broker id, and config file
However, for option 2 in addition to the previously stated information, you will need to provide the hostname that Circonus will use to connect to your database, the username of the Postgres account that Circonus will use to connect to your database, the password for the username entered, and the name of any database that this user can connect to. Along with this, you will need to install the pg module using the command #npm install pg. This should be done before you run leo or else the software will fail to create you check, graphs, and worksheet.