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.

Plugin-Pack assets​

Monitored Objects​

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

Available services​

The current version of the Nimble SNMP Plugin-Pack 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 Plugin 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 Plugin-Pack on the "Configuration > Plugin Packs > 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