Skip to content
This repository has been archived by the owner on Feb 20, 2019. It is now read-only.

StorminStanley/collectd3

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

30 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Showing stats with collectd + d3js

Collectd3 is a modern visualization of collectd system performance statistics. It does more than just visualizes the data. It generates a bird-eye view of multy-server system and enables to quickly spot the problems and dig down for details.

It integrates with other graphical tools,like Collectd Graph Panel

See the live demo.

Pre-requisites:

Install dependencies

  1. Install rrdtool. On Mac, homebrew works fine. On Linux - install rrdtool and librrd-dev. E.g., apt-get install rrdtool, apt-get install librrd-dev. On Windows, figure this out yourself (and add instructions here). Make sure rrdtool is on the path and working (try $ which rrdtool, $ rrdtool).

  2. Get node dependencies:

     $ npm install
    

Unit tests

Run node unit tests:

  • by npm (a script is configured in package.json)

      $ npm test
    
  • or manually

      env NODE_ENV=test node_modules/.bin/mocha -R spec
    

Browser unit tests - not implemented yet.

Configure

Open config/default.yml. Modify data-directory to point out to collectd files. Change the port of web app. Define and adjust host categoreis (use regular expressions). Adjust storage partitions, disks, etc. See comments in default.yml

Configs are read and extend each other sequentially in a specific order: default.yml, NODE_ENV.yml (like test.yml for NODE_ENV=test), HOSTNAME.yml (like collectd.yml for collectd.example.com).

If you want specific section to be handled as-is and prevent it from being overriden or extended by any other config file loaded later, you should add ~override: true to it.

For more info, see comments in default.yml and YAML documentation

Sample data

When developing, testing, or trying this out, work with sample data.

Run server

	$ npm start

This launches the server on the background; the output is redirected to server.out.log and server.err.log. To check server status, use forever - e.g., node_modules/forever/bin/forever list. To stop the server:

	$ npm stop

Developing

Always use grunt. It will watch for changes and recompile, lint and unit-test each file you change. If you use npm start, you need to do it manually (except for less files, they would be recompiled before each start).

Run grunt:

  • by first installing grunt-cli globally (npm install grunt-cli -g)

      $ grunt
    
  • by using grunt-cli which already installed locally

      $ node_modules/.bin/grunt
    

Copyright and license


Copyright 2013 StackStorm, Inc.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this work except in compliance with the License. You may obtain a copy of the License in the LICENSE file, or at:

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published