Skip to main content

Nimble Storage Rest API

Overview

HPE Nimble Storage is a predictive flash storage technology developed by Nimble Storage that was based in San Jose, California founded in early 2008. Nimble Storage produced hardware and software products for data storage, specifically data storage arrays that use the iSCSI and Fibre Channel protocols and includes data backup and data protection features. Nimble is a subsidiary of Hewlett Packard Enterprise.

Monitoring Connector assets

Monitored Objects

  • Nimble Flash Arrays (NimbleOS >=2.3.x)

Available services

The current version of the Nimble SNMP Monitoring Connector can monitor the following services:

  • Arrays
  • Hardware
  • Volumes

Collected metrics

The following metrics are collected by the Centreon Nimble Rest API Plugin:

Metric nameDescription (per array )Unit
statusArray statusString
array.space.usage.bytesUsed spaceBytes
array.space.usage.percentageUsed space%
array.space.free.bytesFree spaceBytes
array.snapshots.compression.rate.countSnapshot compression ratio
array.snapshots.reduction.rate.countSnapshot reduction ratio

Prerequisites

Nimble Rest API configuration

Make sure you can reach Nimble device over its API. Read Prerequistes of the official HPE documentation: https://infosight.hpe.com/InfoSight/media/cms/active/public/pubs_REST_API_Reference_NOS_51x.whz/jun1455055569904

Installation

  1. Install the Centreon package on every Centreon poller expected to monitor Nimble Flash Arrays:
yum install centreon-pack-hardware-storage-nimble-restapi.noarch
  1. On the centreon Web interface, install the Nimble Storage Rest API Centreon Monitoring Connector on the Configuration > Monitoring Connector Manager page

Configuration

  • Log into Centreon and add new host through "Configuration > Hosts".
  • Apply the template HW-Storage-Nimble-Restapi to the Host and configure all the mandatories Macros:
MandatoryNameDescription
XAPIPORTPort used (Default: 5392)
XAPIPROTOSpecify protocol if needed (Default: 'https')
XAPIUSERNAMESpecify the API Username
XAPIPASSWORDSpecify the API Password
APIEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

FAQ

Why do I get the following error message:

UNKNOWN: 500 Can't connect to myserver.mycompany.com:19999

This error message means that the Centreon Plugin couldn't successfully connect to the Nimble device API.

Check that no third party device (such as a firewall) is blocking the request. A proxy connection may also be necessary to connect to the API. This can be done by using this option in the command: --proxyurl='http://proxy.mycompany:8080'.

UNKNOWN: 501 Protocol scheme 'connect' is not supported |

When using a proxy to connect to the Nimble API, this error message means that the Centreon Plugin library does not support

the proxy connection protocol.

In order to prevent this issue, use the curl HTTP backend by adding the following option to the command: --http-backend='curl'.

UNKNOWN: Cannot load module 'Net::Curl::Easy'

This error message means that a Perl library required to use the curl backend is missing.

In order to fix this issue, install the 'Net::Curl::Easy' Perl library using the following command:

yum install perl-Net-Curl