Cassandra plugin

Warning: The Cassandra plugin is deprecated. For more information, refer to Stackdriver deprecations. For continued support for Cassandra, migrate to the solution provided by Blue Medora, or look at the complete list of Blue Medora BindPlane Sources.

Cassandra is a scalable and fault-tolerant NoSQL database system. For more information visit http://cassandra.apache.org/.

Note: This functionality is only available for agents running on Linux. It is not available on Windows.

Discovery

Even if the Cassandra plugin is not configured, Stackdriver Monitoring discovers Cassandra services running in your Cloud Platform project by:

• Searching instance names for cassandra
• Checking for ports opened to 9160 via firewall rules

The services discovered are displayed on the Cassandra Services page in the Resources menu. After you install the Monitoring agent and configure the Cassandra plugin on your instances, Monitoring populates the Cassandra Services page with inventory and metrics.

Configuring Monitoring to monitor Cassandra

After you install the Monitoring agent, use the following instructions to configure the Cassandra plugin on your instances.

Prerequisites

The Cassandra plugin requires version 5.5.0-257 or later of the Monitoring agent. To update the agent, go to Upgrading the agent.

Enabling the Cassandra monitoring plugin

Cassandra is monitored via JMX. Monitoring has separate configurations for monitoring Cassandra versions 2.1.x and below, and versions 2.2.x and above.

On your VM instance, download the appropriate configuration file from the GitHub configuration repository based on your Cassandra version and place it in the directory /opt/stackdriver/collectd/etc/collectd.d/:

2.2.x

Download cassandra-22.conf into /opt/stackdriver/collectd/etc/collectd.d/:

(cd /opt/stackdriver/collectd/etc/collectd.d/ && sudo curl -O https://raw.githubusercontent.com/Stackdriver/stackdriver-agent-service-configs/master/etc/collectd.d/cassandra-22.conf)

<= 2.1.x

Download cassandra.conf into /opt/stackdriver/collectd/etc/collectd.d/:

(cd /opt/stackdriver/collectd/etc/collectd.d/ && sudo curl -O https://raw.githubusercontent.com/Stackdriver/stackdriver-agent-service-configs/master/etc/collectd.d/cassandra.conf)

The downloaded plugin configuration file assumes that your Cassandra instance is configured to accept JMX connections on port 7199. If you have configured Cassandra with a different JMX port, as root, edit the file and follow the instructions to change the JMX port settings.

After adding the configuration file, restart the monitoring agent by running the following command:

sudo service stackdriver-agent restart

For more information on the collectd GenericJMX plugin used to monitor Cassandra, see Plugin:GenericJMX.

What is monitored

The full lists of metrics the Cassandra plugin monitors are at Agent metrics: cassandra and Agent metrics: jvm.