# circonus-leo > Automatic setup and configuration systems for nad Latest version **0.0.1** (published 2015-06-17) · 0 weekly downloads ## Install ```sh npm install circonus-leo pnpm add circonus-leo yarn add circonus-leo bun add circonus-leo ``` ## Health **Score 10/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support; low quality score; pre 1.0. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 0.0.1 | | Published | 2015-06-17 | | First published | 2015-06-17 | | Weekly downloads | 0 | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 10 | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 1 | | Author | Circonus, Inc. | | Maintainers | melcabel | ## Links - npm: https://www.npmjs.com/package/circonus-leo - Repository: https://github.com/circonus-labs/leo - Issues: https://github.com/circonus-labs/leo/issues - npm.io page: https://npm.io/package/circonus-leo ## Dependencies (10) - [pg](https://npm.io/package/pg.md) >=4.4.0 - [async](https://npm.io/package/async.md) >=0.9.0 - [moment](https://npm.io/package/moment.md) >=2.9.0 - [heredoc](https://npm.io/package/heredoc.md) >=1.3.0 - [sprintf](https://npm.io/package/sprintf.md) >=0.1.5 - [jsonfile](https://npm.io/package/jsonfile.md) >=2.0.0 - [minimist](https://npm.io/package/minimist.md) >=1.1.0 - [validator](https://npm.io/package/validator.md) >=3.40.1 - [circonusapi2](https://npm.io/package/circonusapi2.md) >=0.1.6 - [interrogator](https://npm.io/package/interrogator.md) >=0.0.9 ## Recent versions - 0.0.1 (latest) — 2015-06-17 ## README # 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: 1. CPU, disk, memory, and network metrics via Node.js Agent 2. 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. --- _Source: https://npm.io/package/circonus-leo · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._