The Librato Agent

The Librato Agent offers the fastest and easiest way to begin monitoring your networked hosts and services. With an ecosystem of over 90 open source plugins, our agent can collect metrics from almost any services you might be running. Our agent makes it easy to get host and server metrics for all of your systems into Librato with a variety of pre-configured Spaces dashboards, including the following:

Supported Platforms & Release notes

To see the most recent list of supported platforms and services for the Librato Agent, please check our release notes.


On the integrations page, select Librato Agent to add your Librato Agent integration.


Our easy installer will setup the Librato Agent on your system. Running the provided command will perform the following steps:

  • Setup the Librato package repository
  • Install the Librato Agent package (our bespoke version of the Collectd agent)
  • Configure the Agent with your Librato credentials


Once the installer is finished you should begin seeing metrics from the agent in your Librato account within a few minutes. Metrics will be visible under the librato.* namespace.

Visit your preconfigured Spaces to observe the new metrics as they stream in. You can use our dynamic source field at the top to filter your view to a subset of metric sources. For example, you may want to isolate the view to a specific tier of web servers or even to an individual machine that is behaving badly.


Configuration Management

When managing a large number of servers, a good configuration management tool can make life much easier. Whether you’re using Puppet, Chef, Ansible or Salt, we’ve got you covered. Getting our Librato Agent automatically installed and configured with plugins on each of your hosts is simple.

To get started, below are links to repos with more details on how to utilize each CM tool we currently support:

Installing the Agent Manually

Even though our easy installer provides a seamless out-of-the-box experience for our users, we recognize that many shops will want to integrate the agent installation process into their existing CM pipeline. The following steps will help you get up and running with a minimum of effort.

Add the Librato package repository


One of the following lines will need to be added to your apt sources. Our easy installer adds this to a new sources file at /etc/apt/sources.list.d/librato_librato-collectd.list. Adapt the line as needed for your OS release.

# Debian 8 (jessie)
deb jessie main

# Ubuntu 14.04 (trusty)
deb trusty main

The following dependencies will also need to exist on your system before attempting to install the Agent package.

$ sudo apt-get install debian-archive-keyring
$ sudo apt-get install apt-transport-https


The following snippet should be written out to a yum repository configuration. Our easy installer adds this to /etc/yum.repos.d/librato_librato-collectd.repo. Edit the baseurl line for your particular release version.


Dependencies for GPG key verification


$ curl 2> /dev/null | sudo apt-key add -


$ sudo yum install -y pygpgme --disablerepo='librato_librato-collectd'
$ sudo yum install -y yum-utils --disablerepo='librato_librato-collectd'
$ sudo yum -q makecache -y --disablerepo='*' --enablerepo='librato_librato-collectd'

Install the Librato Agent package


$ sudo apt-get update
$ sudo apt-get install collectd


$ sudo yum install epel-release
$ sudo yum install collectd

Set your Librato Agent credentials

$ sudo $EDITOR /opt/collectd/etc/collectd.conf.d/librato.conf

LoadPlugin write_http
<Plugin write_http>
  <Node "librato">
    URL ""
    Format "JSON"
    BufferSize 8192
    User ""
    Password "348aa6f3be4793ef7b316c1140f42edc31b292847fcb2e465b8053be58051957"

Restart the Agent

$ sudo service collectd restart

Uninstall the Agent

Debian / Ubuntu:

$ sudo apt-get purge collectd


$ yum autoremove collectd


We would love to incorporate your feedback and any new dashboards you design into the ongoing development of this key server monitoring technology. Please reach out to us at with your questions and comments.