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.

Setup

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

add_librato_agent

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

agent-installation

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 tag field at the top to filter your view to a subset of metrics. 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.

agent-space

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

Debian/Ubuntu

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 https://packagecloud.io/librato/librato-collectd/debian/ jessie main

# Ubuntu 14.04 (trusty)
deb https://packagecloud.io/librato/librato-collectd/ubuntu/ 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

RHEL/CentOS

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.

[librato_librato-collectd]
name=librato_librato-collectd
baseurl=https://packagecloud.io/librato/librato-collectd/el/7/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packagecloud.io/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt

Dependencies for GPG key verification

Debian/Ubuntu

$ curl https://packagecloud.io/gpg.key 2> /dev/null | sudo apt-key add -

RHEL/CentOS

$ 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

Debian/Ubuntu

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

RHEL/CentOS

$ 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 "https://collectd.librato.com/v1/measurements"
    Format "JSON"
    BufferSize 8192
    User "foo@bar.com"
    Password "348aa6f3be4793ef7b316c1140f42edc31b292847fcb2e465b8053be58051957"
  </Node>
</Plugin>

Restart the Agent

$ sudo service collectd restart

Uninstall the Agent

Debian / Ubuntu:

$ sudo apt-get purge collectd

CentOS:

$ yum autoremove collectd

Please let us know what you think about this integration. We would love to incorporate your feedback and any ideas you have on dashboard design into the ongoing development of our integrations.