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.
Monitored metrics
| Metric | Values |
|---|---|
| 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 |
Comments