Librato Agent
Permalink
Failed to load latest commit information.
README.md

README.md

Librato Agent

Release Notes for the Librato Agent

Supported Platforms

  • Amazon Linux 2016.03
  • Amazon Linux 2015.09 EOL
  • Debian 8 (Jessie)
  • Debian 7 (Wheezy)
  • EL7 (RHEL, CentOS)
  • EL6 (RHEL, CentOS)
  • Fedora 23
  • Ubuntu 16.04 LTS (Xenial)
  • Ubuntu 15.10 (Wily)
  • Ubuntu 15.04 (Vivid)
  • Ubuntu 14.10 (Utopic) EOL
  • Ubuntu 14.04 LTS (Trusty)
  • Ubuntu 12.04 LTS (Precise)

Releases

5.5.0-librato51.251

July 26, 2016_

This is a maintenance release, which addresses the following bugs in earlier versions of Librato Agent.

  • A delay in reporting Docker metrics, which caused gaps to show up in the curated dashboard.
  • Issues upgrading from earlier (monolithic) Librato Agent packages to the split version on Debian and Ubuntu.
  • An issue on CentOS 6 and Amazon Linux, where doing an upgrade ended up removing the init script. This issue will still surface the very first time users upgrade to version 51.251 and can be resolved by manually copying the init script over after an upgrade.
sudo cp /opt/collectd/share/collectd/init/redhat-sysv/collectd /etc/init.d/collectd
sudo chmod +x /etc/init.d/collectd
Sudo service collectd restart
  • An issue on CentOS 7 and Fedora 23, where uninstalling Librato Agent didn't clean up the init script. This issue will still surface the very first time users upgrade to version 51.251 and can be resolved by manual deletion.
sudo rm -f /lib/systemd/system/collectd.service

5.5.0-librato49

July 14, 2016_

This release breaks the single collectd package into two packages: collectd and collectd-core and deprecates 32bit support for the Librato Agent (no 32bit packages were built for this release; if you need 32bit support, please use 5.5.0-librato49).

collectd-core contains the core collectd system, while collectd contains the default configs that allow you to get up and running quickly. As collectd-core does not ship with default plugin configs, this makes it perfect for using with config management tools.

Additionally, this release adopts a new versioning scheme by appending a minor version to the Librato version number.

5.5.0-librato49

July 05, 2016

This release fixes a bug on CentOS 6, where the Docker plugin failed to run due to a Python 2.6 compatibility issue.

5.5.0-librato48

June 21, 2016

This release fixes a bug on Fedora, where running yum update was causing vanilla collectd to get installed.

5.5.0-librato47

May 26, 2016

This release updates CentOS 6 hard runtime dependencies.

5.5.0-librato46

May 18, 2016

This release addresses an issue in the MongoDB plugin where negative replication lags were being reported.

5.5.0-librato45

May 13, 2016

This release enables the collectd GenericJMX plugin to gather Managed Beans (MBeans) metrics from an MBeanServer using Java Management Extensions (JMX). Librato Agent provides a default configuration file which is located at /opt/collectd/etc/collectd.conf.d/jvm.conf:

LoadPlugin java

Include "/opt/collectd/share/collectd/jvm_default.conf"

<Plugin "java">
  <Plugin "GenericJMX">
    <Connection>
      Host "localhost"
      ServiceURL "service:jmx:rmi:///jndi/rmi://localhost:17264/jmxrmi"
      Collect "memory_heap"
      Collect "memory_nonheap"
      Collect "classes"
      Collect "threads"
      Collect "compilation"
      Collect "garbage_collector"
      Collect "memory_pool"
    </Connection>
  </Plugin>
</Plugin>

The configuration of the GenericJMX plugin consists of a Connection block which specifies how to connect to an MBeanServer and what data to retrieve. ServiceURL specifies the MBeanServer to query and the multiple Collect blocks specify which of the MBean blocks to gather with this connection. A set of default metrics are provided at /opt/collectd/share/collectd/jvm_default.conf.

5.5.0-librato44

May 10, 2016

This release fixes an issue where the Apache plugin would ignore some of the metrics reported by Apache versions 2.4.13 or newer.

We are also changing the Apache plugin's configuration so the default url for mod_status is http://localhost/server-status?auto. This aligns our plugin with Apache's documentation and most distribution defaults.

LoadPlugin "apache"
<Plugin "apache">
   <Instance "apache">
       URL "http://localhost/server-status?auto"
   </Instance>
</Plugin>

5.5.0-librato43

May 4, 2016

This release adds MongoDB monitoring capabilities to Librato Agent. MongoDB versions 3.x and 2.x are supported. A default configuration file is provided at /opt/collectd/etc/collectd.conf.d/mongodb.conf. Please review and edit it to match your environment.

If necessary, update Host and Port to the host and port corresponding to your MongoDB instance. If authentication has been enabled for your MongoDB deployment, set User and Password to a user who has access to the admin database. Database can optionally specify a space-separated list of additional databases to monitor. If set, Database must begin with admin. Use the Name configuration parameter to set the plugin instance for the reported metrics, which is mongodb by default.

<LoadPlugin python>
  Globals true
</LoadPlugin>

<Plugin python>
  ModulePath "/opt/collectd/share/collectd"
  ModulePath "/opt/collectd/share/collectd/pymongo.egg"

  Import "collectd-mongodb"

  <Module "collectd-mongodb">
    # Host "127.0.0.1"
    # Port "27017"
    # User "username"
    # Password "password"
    # Database "admin"
    # Name "mongodb"
  </Module>
</Plugin>

5.5.0-librato42

May 3, 2016

First and foremost, this release introduces Ubuntu 16.04 (Xenial Xerus) as a supported platform.

It also brings in an upstream fix to support Varnish 4.1 and some minor improvements to the systemd script.

5.5.0-librato41

May 2, 2016

Release fixes unhandled python exceptions in NGINX Plus and Elasticsearch plugins.

5.5.0-librato40

Apr 25, 2016

This release enables the native PostgreSQL queries to the Librato Agent. A number of "canned queries" are defined in /opt/collectd/share/collectd/postgresql_default.conf that make it easy to collect per-database statistics for memory use, indexing performance, tuple activity (inserts, updates, deletes, etc), commits and rollbacks, and much more.

The packaged configuration will attempt to gather statistics for the native postgres database using the UNIX socket. In most cases this will not work, since PostgreSQL uses peer authentication for the UNIX socket. Adjust your PostgreSQL authentication or Librato Agent plugin settings in /opt/collectd/etc/collectd.conf.d/postgresql.conf as needed.

LoadPlugin postgresql
<Plugin postgresql>
  <Database postgres>
    Host "/var/run/postgresql"
    Port "5432"
    User "postgres"
  </Database>
  #<Database foo>
  #  Instance "custom-name"
  #  Host "127.0.0.1"
  #  Port "5432"
  #  User "username"
  #  Password "password"
  #  SSLMode "prefer"
  #</Database>
</Plugin>

The following queries are enabled for the postgres database by default.

  • Query connections
  • Query transactions
  • Query queries
  • Query query_plans
  • Query table_states
  • Query disk_io
  • Query disk_usage

5.5.0-librato39

Apr 19, 2016

Update: This release also introduces support for Debian 7 (wheezy).

Update #2: This release also adds support for the i386 architecture with Debian 8 (jessie). This was an oversight on our part previously.

This release adds Elasticsearch monitoring capabilities to Librato Agent. Elasticsearch versions 2.x, 1.x and 0.90 are supported. A default configuration file is provided at /opt/collectd/etc/collectd.conf.d/elasticsearch.conf. Please review and edit the following section to match your environment.

The plugin will attempt to connect to Elasticsearch over http://127.0.0.1:9200. Update the Url configuration parameter to match the network.host setting in your Elasticsearch configuration file. By default, the cluster name will serve as the plugin instance for the reported metrics. Use the Name configuration parameter to override this value.

<Plugin "python">
    ModulePath "/opt/collectd/share/collectd/"

    Import "collectd-elasticsearch"

    <Module "collectd-elasticsearch">
        #Url "http://127.0.0.1:9200"
        #Name "mycluster"
        #Verbose true
    </Module>
</Plugin>

5.5.0-librato38

Apr 18, 2016

This release corrects a number of dependencies that were never moved from recommended or suggested to actual hard dependencies, particularly those libraries for python, mysqlclient, and memcached.

It also marks the introduction of support for Amazon Linux 2016.03. For all practical purposes the package should be universal across 2015.09 and 2016.03, but we're now officially treating 2015.09 as deprecated.

5.5.0-librato37

Apr 8, 2016

This release performs a "reset" of our Varnish configuration to disable a number of module classes providing metrics that are largely used only for debugging or deep troubleshooting. The resulting set of metrics is common across all supported platforms, meaning we no longer need specialized patches to support Varnish across different OS releases.

This also means we're getting closer to an official Varnish integration. 😉

5.5.0-librato36

Mar 21, 2016

This release enables the native MySQL plugin and patches it to report the following additional metrics.

  • librato.mysql.gauge.tmp_disk_tables - Number of internal, on-disk temporary tables created
  • librato.mysql.gauge.tmp_files - Number of temporary files created
  • librato.mysql.gauge.tmp_tables - Number of internal (non-persistent) temporary tables
  • librato.mysql.counter.total_queries - Number of statements executed, including stored procedures
  • librato.mysql.counter.slow_queries - Number of queries that take more than the configured number of seconds
  • librato.mysql.gauge.mysql_uptime - Number of seconds the server has been up
  • librato.mysql.counter.total_connections - Number of connection attempts made to the server
  • librato.mysql.counter.aborted_clients - Number of connection that weren't closed properly by the client
  • librato.mysql.counter.aborted_connects - Number of failed attempts to connect to the server
  • librato.mysql.gauge.qcache_free_blocks - Number of free memory blocks in the query cache
  • librato.mysql.gauge.qcache_total_blocks - Total number of memory blocks in the query cache
  • librato.mysql.gauge.qcache_free_memory - Amount of free memory in the query cache

A default configuration file also gets installed under /opt/collectd/etc/collectd.conf.d/mysql.conf, and looks as follows. Edit it according to your MySQL server deployment. Please see MySQL Plugin for more details.

LoadPlugin mysql
<Plugin "mysql">
  <Database "mydb">
    Host "127.0.0.1"
    User "root"
    Password ""
    Port 3306
    MasterStats true
    InnodbStats true
  </Database>
</Plugin>

5.5.0-librato35

Mar 17, 2016

This release enables support for the HAProxy plugin. The plugin has also been patched to prefix metrics with backend and frontend, depending on the source of the metrics and the proxy type. Health-specific metrics, such as uptime_seconds, are not prefixed. This adheres more closely to Librato's dynamic source convention. We are also appending the name of the proxy to the source.

5.5.0-librato34

Mar 4, 2016

This release enables the native Zookeeper plugin. By default, the plugin will look for a Zookeeper service running on localhost TCP port 2181. Change this by editing /opt/collectd/etc/collectd.conf.d/zookeeper.conf, as shown below.

LoadPlugin zookeeper
<Plugin "zookeeper">  
   Host "127.0.0.1"
   Port "2181"
</Plugin>

5.5.0-librato33

Mar 3, 2016

Officially support the Apache plugin. The plugin has been patched to return hostname_g as the host rather than the service address. This adheres more closely to Librato's dynamic source convention. Also, the Node/Instance will be appended to the source.

5.5.0-librato32

Mar 2, 2016

The previous release added five new metrics to track overall container state and image counts within Docker. Unfortunately it would report one copy of each metric (stream) for every container running on the host, resulting in N streams instead of 1 global (hostname) stream per metric. This release fixes that oversight.

5.5.0-librato31

Feb 26, 2016

This release introduces a handful of new Docker metrics for tracking container counts by state and total image count.

  • librato.docker.images.total
  • librato.docker.containers.total
  • librato.docker.containers.running
  • librato.docker.containers.stopped
  • librato.docker.containers.paused

5.5.0-librato30

Feb 24, 2016

Instead of reporting absolute values for bytes ("complex") and inodes, we have disabled both of those and now report percentages by default instead. This change results in fewer, yet more useful, disk capacity metrics for the user.

5.5.0-librato29

Jan 27, 2016

Update the Docker plugin to accommodate the breaking Docker stats API changes for network metrics introduced in API version 1.21.

5.5.0-librato28

Jan 12, 2016

Adds support for our new NGINX Plus integration, with over 70 metrics courtesy of NGINX's ngx_http_status_module.

5.5.0-librato27

Jan 8, 2016

This release introduces container-level blkio (disk) metrics for Docker containers. The following metrics are now available:

Bytes

  • librato.docker.blkio.io_service_bytes_async
  • librato.docker.blkio.io_service_bytes_read
  • librato.docker.blkio.io_service_bytes_sync
  • librato.docker.blkio.io_service_bytes_total
  • librato.docker.blkio.io_service_bytes_write

Operations

  • librato.docker.blkio.io_serviced_async
  • librato.docker.blkio.io_serviced_read
  • librato.docker.blkio.io_serviced_sync
  • librato.docker.blkio.io_serviced_total
  • librato.docker.blkio.io_serviced_write

5.5.0-librato26

Jan 7, 2016

Adjust systemd configuration to allow CAP_SETGID and CAP_SETUID. This is needed for user/group privilege demotion by the Docker plugin.

5.5.0-librato25

Dec 30, 2015

Small bump to fix an inaccurate configuration comment.

5.5.0-librato24

Dec 29, 2015

Bump the default Interval setting to 60 seconds based on feedback from users.

5.5.0-librato23

Dec 9, 2015

Disable some Varnish settings that were causing warnings on older distributions. This plugin is not yet recognized as an official integration (no server-side preconfigurations) but metrics will be received by Librato if librato.varnish.* is added to the user-defined whitelist.

5.5.0-librato22

Dec 8, 2015

Fix service path for EL6.

5.5.0-librato21

Dec 8, 2015

Enable the --deb-no-default-config-files flag for all deb packages. Needed to keep our configuration in /opt/collectd/etc without warnings by Debian.

5.5.0-librato20

Nov 13, 2015

Officially support the Memcached plugin. The plugin has been patched to return hostname_g as the host rather than the service address. This adheres more closely to Librato's dynamic source convention. Also, the Node/Instance will be appended to the source.

5.5.0-librato19

Nov 6, 2015

Introducing support for EL7 and Ubuntu Wily.