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.
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 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
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¶
$ 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'
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 "https://collectd.librato.com/v1/measurements" Format "JSON" BufferSize 8192 User "email@example.com" Password "348aa6f3be4793ef7b316c1140f42edc31b292847fcb2e465b8053be58051957" </Node> </Plugin>
Restart the Agent¶
$ sudo service collectd restart
Uninstall the Agent¶
Debian / Ubuntu:
$ sudo apt-get purge collectd
$ yum autoremove collectd