Getting started with Carbonaut
Docs for this page are under construction and planned for version v0.1 and detailed documentation will be added soon. Roadmap →
Welcome to Carbonaut! Carbonaut is cloud-native monitoring software for collecting environmental sustainability metrics from your IT infrastructure. This guide will show you how to install, configure, and monitor our first resource using Carbonaut. You will download, install, and run Carbonaut. You will also download and install an official Carbonaut plugin to collect energy metrics from your local machine.
Download Carbonaut
Download the latest release (opens in a new tab) of Carbonaut for your platform, then extract it.
tar xvfz carbonaut-*.tar.gz
cd carbonaut-*The Carbonaut Connector is a single binary called carbonaut. We can run the binary and see help on its options by passing the --help flag.
./carbonaut --help
usage: carbonaut [<flags>]Before starting Carbonaut, let's configure it.
Configure Carbonaut
An example configuration file is available in the examples folder example/carbonaut.yaml (opens in a new tab). Copy this file to a location of your choice, and edit it to suit your needs. Without edits this file will work fine for a local test and measure your machine's energy consumption.
Run Carbonaut as Container locally
With Carbonaut downloaded and configured, we can start it up. We'll run it in the foreground so we can see its logs.
carbonaut -c=carbonaut.yaml --debugmore info tbd
Caronaut is running and measures energy consumption through the Scaphandre plugin 🎉.
Carbonaut excels on a larger scale by integrating different types of plugins, automatically blending data from multiple sources, and integrating all of this into a common data format while extending the existing monitoring stack.