Installing InstrumentalD

InstrumentalD is a server agent created by the Instrumental team to make it as easy to possible to collect both system metrics and service metrics. It's fast, reliable, runs on *nix, is simple to configure and deploy, and has a small memory footprint. It's the best way to send system and service metrics to Instrumental.

Here's how to install it:

You're probably not running macOS in your web server, but you might want to kick the tires in your local development environment.

brew install instrumental/instrumentald/instrumentald
instrumentald -k PROJECT_TOKEN

If you don't use Homebrew, you can and manually install instrumentald via a pkg.

Once the process is running, you'll see system metrics in your project. This page includes the full list of metrics and what they mean.

First, add our packagecloud.io source, then install the package:

curl https://packagecloud.io/install/repositories/expectedbehavior/instrumental/script.deb.sh | sudo bash
sudo apt-get install instrumentald

Feel free to review the shell script before executing. We would. :)

Next, add your project token to the instrumentald.toml and restart instrumentald:

sudo echo 'project_token = "PROJECT_TOKEN"' > /etc/instrumentald.toml
sudo systemctl start instrumentald

Once the process is running, you'll see system metrics in your project. This page includes the full list of metrics and what they mean.

First, add our packagecloud.io repo to yum, then install the package:

curl https://packagecloud.io/install/repositories/expectedbehavior/instrumental/script.rpm.sh | sudo bash
sudo yum install instrumentald

Feel free to review the shell script before executing. We would. :)

Next, add your project token to the instrumentald.toml and restart instrumentald:

sudo echo 'project_token = "PROJECT_TOKEN"' > /etc/instrumentald.toml
sudo service instrumentald restart

Once the process is running, you'll see system metrics in your project. This page includes the full list of metrics and what they mean.

Linux

If you're not using deb or RPM, you can install InstrumentalD manually.

Windows

InstrumentalD doesn't run on Windows right now, but it's in the works! In the meantime, you can use the following to send Windows system and service metrics to Instrumental:

Use infrastructure automation tools? We have Chef and Puppet examples.

Next: Configuration

instrumentald collects system metrics without any configuration. However, to collect metrics from services like MySQL, Redis, and memcached, you'll need to edit your configuration file.

Questions? We can help!