Datadog-RiakCS Integration

Overview

Capture RiakCS metrics in Datadog to:

  • Visualize key RiakCS metrics.
  • Correlate RiakCS performance with the rest of your applications.

Setup

Installation

The RiakCS check is packaged with the Agent, so simply install the Agent on your RiakCS nodes. If you need the newest version of the check, install the dd-check-riakcs package.

Configuration

Create a file riakcs.yaml in the Agent’s conf.d directory. See the sample riakcs.yaml for all available configuration options:

init_config:

instances:
  - host: localhost 
    port: 8080 
    access_id: <YOUR_ACCESS_KEY>
    access_secret: <YOUR_ACCESS_SECRET>
#   is_secure: true # set to false if your endpoint doesn't use SSL
#   s3_root: s3.amazonaws.com # 

Restart the Agent to start sending RiakCS metrics to Datadog.

Validation

Run the Agent’s info subcommand and look for riakcs under the Checks section:

  Checks
  ======
    [...]

    riakcs
    -------
      - instance #0 [OK]
      - Collected 26 metrics, 0 events & 1 service check

    [...]

Compatibility

The riakcs check is compatible with all major platforms.

Data Collected

Metrics

riakcs.block_get.latency_mean
(gauge)
Mean latency of BLOCK GET operations performed
shown as microsecond
riakcs.block_put.latency_mean
(gauge)
Mean latency of BLOCK PUT operations performed
shown as microsecond
riakcs.block_delete.latency_mean
(gauge)
Mean latency of BLOCK DELETE operations performed
shown as microsecond
riakcs.object_get.latency_mean
(gauge)
Mean latency of GET operations performed
shown as microsecond
riakcs.object_put.latency_mean
(gauge)
Mean latency of PUT operations performed
shown as microsecond
riakcs.object_delete.latency_mean
(gauge)
Mean latency of DELETE operations performed
shown as microsecond
riakcs.service_get_buckets.latency_mean
(gauge)
Mean latency of GET BUCKETS operations performed
shown as microsecond
riakcs.bucket_delete.latency_mean
(gauge)
Mean latency of BUCKET DELETE operations performed
shown as microsecond
riakcs.bucket_create.latency_mean
(gauge)
Mean latency of BUCKET CREATE operations performed
shown as microsecond
riakcs.block_get.meter_rate
(gauge)
Rate of BLOCK GET operations performed
shown as operation
riakcs.block_put.meter_rate
(gauge)
Rate of BLOCK PUT operations performed
shown as operation
riakcs.block_delete.meter_rate
(gauge)
Rate of BLOCK DELETE operations performed
shown as operation
riakcs.object_get.meter_rate
(gauge)
Rate of GET operations performed
shown as operation
riakcs.object_put.meter_rate
(gauge)
Rate of PUT operations performed
shown as operation
riakcs.object_delete.meter_rate
(gauge)
Rate of DELETE operations performed
shown as operation
riakcs.service_get_buckets.meter_rate
(gauge)
Rate of GET BUCKETS operations performed
shown as operation
riakcs.bucket_delete.meter_rate
(gauge)
Rate of BUCKET DELETE operations performed
shown as operation
riakcs.bucket_create.meter_rate
(gauge)
Rate of BUCKET CREATE operations performed
shown as operation

Events

The RiackCS check does not include any event at this time.

Service Checks

riakcs.can_connect:

Returns CRITICAL if the Agent cannot connect to the RiakCS endpoint to collect metrics, otherwise OK.

Troubleshooting

Need help? Contact Datadog Support.

Further Reading

To get a better idea of how (or why) to monitor Riak CS performance and availability with Datadog, check out our series of blog posts about it.