Monitoring RiakCS

This article will help you get the Riakcs plugin for sd-agent configured and returning metrics

Installing the riakcs plugin package

Install the riakcs plugin on Debian/Ubuntu:

sudo apt-get install sd-agent-riakcs

Install the riakcs plugin on RHEL/CentOS:

sudo yum install sd-agent-riakcs

Read more about agent plugins.

Configuring the agent to monitor Riak CS

1. Configure /etc/sd-agent/conf.d/riakcs.yaml

init_config:

instances:
- access_id: access-key
access_secret: access-secret
  • If you run Riak CS on a non-standard port, different host or need to connect via SSL, amend the rest of the config file as necessary

2. Restart the agent

sudo /etc/init.d/sd-agent restart

or

sudo systemctl restart sd-agent

Verifying the configuration
Execute info to verify the configuration with the following:

sudo /etc/init.d/sd-agent info 

or

/usr/share/python/sd-agent/agent.py info

If the agent has been configured correctly you'll see an output such as:

riakcs
-----
  - instance #0 [OK]
  - Collected * metrics

You can also view the metrics returned with the following command:

sudo -u sd-agent /usr/share/python/sd-agent/agent.py check riakcs

Configuring graphs

Click the name of your server from the Devices list in your Server Density account then go to the Metrics tab. Click the + Graph button on the right then choose the riakcs metrics to display the graphs. The metrics will also be available to select when building dashboard graphs.

Screen_Shot_2018-01-18_at_11.46.12.png

Monitored metrics

MetricValues
riakcs.block_delete.latency_mean

Mean latency of BLOCK DELETE operations performed
microsecond / None
Type: float
riakcs.block_delete.meter_rate

Rate of BLOCK DELETE operations performed
operation / second
Type: float
riakcs.block_get.latency_mean

Mean latency of BLOCK GET operations performed
microsecond / None
Type: float
riakcs.block_get.meter_rate

Rate of BLOCK GET operations performed
operation / second
Type: float
riakcs.block_put.latency_mean

Mean latency of BLOCK PUT operations performed
microsecond / None
Type: float
riakcs.block_put.meter_rate

Rate of BLOCK PUT operations performed
operation / second
Type: float
riakcs.bucket_create.latency_mean

Mean latency of BUCKET CREATE operations performed
microsecond / None
Type: float
riakcs.bucket_create.meter_rate

Rate of BUCKET CREATE operations performed
operation / second
Type: float
riakcs.bucket_delete.latency_mean

Mean latency of BUCKET DELETE operations performed
microsecond / None
Type: float
riakcs.bucket_delete.meter_rate

Rate of BUCKET DELETE operations performed
operation / second
Type: float
riakcs.object_delete.latency_mean

Mean latency of DELETE operations performed
microsecond / None
Type: float
riakcs.object_delete.meter_rate

Rate of DELETE operations performed
operation / second
Type: float
riakcs.object_get.latency_mean

Mean latency of GET operations performed
microsecond / None
Type: float
riakcs.object_get.meter_rate

Rate of GET operations performed
operation / second
Type: float
riakcs.object_put.latency_mean

Mean latency of PUT operations performed
microsecond / None
Type: float
riakcs.object_put.meter_rate

Rate of PUT operations performed
operation / second
Type: float
riakcs.service_get_buckets.latency_mean

Mean latency of GET BUCKETS operations performed
microsecond / None
Type: float
riakcs.service_get_buckets.meter_rate

Rate of GET BUCKETS operations performed
operation / second
Type: float
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Monday  —  Friday.

10am  —  6pm UK.

Dedicated Support.