ResourceD: A single binary daemon that collects and report your server data with ease.
NOTE: This documentation refers to master branch. For stable release, checkout the main website.
-
Download the binary release here.
-
Use supervisor/upstart/systemd to daemonize. Click here for examples.
RESOURCED_CONFIG_DIR=$GOPATH/src/github.com/resourced/resourced/tests/data/resourced-configs \
$GOPATH/bin/resourced
Once you executed the command above, open this URL: http://localhost:55555/paths.
curl -X GET -H "Content-type: application/json" http://localhost:55555/r/load-avg
ResourceD requires only 1 environment variable to run.
RESOURCED_CONFIG_DIR: Path to root config directory. If directory does not exist, it will be created.
In there, you will see the following subdirectories or files:
-
readers/
Put all the TOML configurations for readers here (Example). -
writers/
Put all the TOML configurations for writers here (Example). -
executors/
Put all the TOML configurations for executors here (Example). -
tags/
Each line in each file will be parsed as key=value tag (Example). -
general.toml
All default settings are defined ingeneral.toml
.
ResourceD readers
gather data on your server. The easiest way to create a reader is to use a scripting language.
-
Write the script following this one requirement: Output the JSON data through STDOUT
-
Write config file. Click here for examples.
For more info, follow this link.
-
GET
/
Displays full JSON data of all readers and writers. -
GET
/paths
Displays paths to all readers and writers data. -
GET
/r
Displays full JSON data of all readers. -
GET
/r/paths
Displays paths to all readers data. -
GET
/w
Displays full JSON data of all writers. -
GET
/w/paths
Displays paths to all writers data.
Here are list of 3rd party data source that ResourceD use. Big thanks to these authors, without whom this project would not be possible.
Are you a contributor, or looking to be one? Go here!