Monitoring Ceph storage clusters is easy with Wavefront. This integration installs and configures Telegraf to send Ceph storage cluster metrics to Wavefront. Telegraf is a light-weight server process capable of collecting, processing, aggregating, and sending metrics to a Wavefront proxy.
In addition to setting up the metrics flow, this integration also installs a dashboard. Here’s the Cluster Status section of a dashboard that displays Ceph storage cluster metrics.
To see a list of the metrics for this integration, select the integration from https://github.com/influxdata/telegraf/tree/master/plugins/inputs.
Step 1. Install the Telegraf Agent
This integration uses the Ceph input plugin for Telegraf. If you’ve already installed Telegraf on your server(s), you can skip to Step 2.
Log in to your Wavefront instance and follow the instructions in the Setup tab to install Telegraf and a Wavefront proxy in your environment. If a proxy is already running in your environment, you can select that proxy and the Telegraf install command connects with that proxy. Sign up for a free trial to check it out!
Step 2. Configure Ceph Input Plugin
Create a file called
/etc/telegraf/telegraf.d and enter the following snippet:
# Collects performance metrics from the MON and OSD nodes in a Ceph storage cluster. [[inputs.ceph]] ## This is the recommended interval to poll. Too frequent and you will lose ## data points due to timeouts during rebalancing and recovery interval = '1m' ## All configuration values are optional, defaults are shown below ## location of ceph binary ceph_binary = "/usr/bin/ceph" ## directory in which to look for socket files socket_dir = "/var/run/ceph" ## prefix of MON and OSD socket files, used to determine socket type mon_prefix = "ceph-mon" osd_prefix = "ceph-osd" ## suffix used to identify socket files socket_suffix = "asok" ## Ceph user to authenticate as. Ceph will search for the corresponding keyring ## e.g. client.admin.keyring in /etc/ceph. If you specify an explicit path, in the ## client section of ceph.conf Ceph searches for the keyring there, for example: ## ## [client.telegraf] ## keyring = /etc/ceph/client.telegraf.keyring ## ## See the Ceph documentation for details on keyring generation. ceph_user = "client.admin" ## Ceph configuration to use to locate the cluster ceph_config = "/etc/ceph/ceph.conf" ## Whether to gather statistics via the admin socket gather_admin_socket_stats = true ## Whether to gather statistics via ceph commands, requires ceph_user and ceph_config ## to be specified gather_cluster_stats = true
Step 3. Restart Telegraf
sudo service telegraf restart to restart your agent.