Stackstate-RiakCS Integration

Overview

Capture Riak CS (Cloud Storage) metrics in Stackstate to:

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

Setup

Installation

This check is packaged with the Agent, so simply install the agent.

Configuration

To capture RiakCS metrics you need to install the StackState Agent.

  1. Configure the Agent to connect to RiakCS, edit conf.d/riakcs.yaml:

    init_config:
    
    instances:
      - access_id: access-key
        access_secret: access-secret
        #is_secure: True  # Uncomment and change to false if you are not using ssl
        #host: localhost  # Hostname/IP of your riakcs node
        #port: 8080  # port used by your riakcs node
        #s3_root: s3.amazonaws.com 
    

  2. Restart the Agent

Validation

Execute the info command and verify that the integration check has passed. The output of the command should contain a section similar to the following:

Checks
======

  [...]

  riakcs
  ------
      - instance #0 [OK]
      - Collected 8 metrics & 0 events

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

Service Checks

riakcs.can_connect:

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