The Librato Agent¶

Supported Platforms & Release notes¶

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

Additional Information¶

Setup¶

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.

# 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

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

[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

$ curl https://packagecloud.io/gpg.key 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'

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

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

$ 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>

$ sudo service collectd restart

$ sudo apt-get purge collectd

$ yum autoremove collectd

Support¶

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 support@librato.com with your questions and comments.