Skip to main content

Dell PowerStore Rest API

Pack Assets​

Monitored Objects​

The Centreon Pack Dell PowerStore brings a host template:

  • HW-Storage-Dell-Powerstore-Restapi-custom

It brings the following service templates:

Service AliasService TemplateDescriptionDefault
AlertsHW-Storage-Dell-Powerstore-Alerts-RestapiCheck alertsX
ClustersHW-Storage-Dell-Powerstore-Clusters-RestapiCheck clustersX
HardwareHW-Storage-Dell-Powerstore-Hardware-RestapiCheck hardwareX
MemoryHW-Storage-Dell-Powerstore-Memory-RestapiCheck memoryX

Collected metrics & status​

Metric nameUnit
alerts.severity.none.count
alerts.severity.info.count
alerts.severity.minor.count
alerts.severity.major.count
alerts.severity.critical.count

Prerequisites​

To control your Dell PowerStore, the Rest API must be configured. E.g: https://downloads.dell.com/manuals/common/pwrstr-apig_en-us.pdf

Setup​

  1. Install the Centreon package on every Centreon poller expected to monitor Dell PowerStore resources:
yum install centreon-plugin-Hardware-Storage-Dell-Powerstore-Restapi
  1. On the Centreon web interface, install the Dell PowerStore Rest API Centreon Pack on the Configuration > Monitoring Connector Manager page.

Configuration​

Host​

  • Log into Centreon and add a new host through Configuration > Hosts.
  • Fill the Name, Alias and IP Address / DNS fields according to your Dell PowerStore server settings.
  • Apply the HW-Storage-Dell-Powerstore-Restapi-custom template to the host.
  • Once the template is applied, fill in the corresponding macros. Some macros are mandatory.
MandatoryNameDescription
XAPIPORTPort used (Default: 443)
XAPIPROTOSpecify https if needed (Default: 'https')
XAPIUSERNAMEApi username
XAPIPASSWORDApi password
APIEXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

How to check in the CLI that the configuration is OK and what are the main options for?​

Once the plugin is installed, log into your Centreon poller's CLI using the centreon-engine user account (su - centreon-engine) and test the plugin by running the following command:

/usr/lib/centreon/plugins/centreon_dell_powerstore_restapi.pl \
    --plugin=storage::dell::powerstore::restapi::plugin \
    --mode=alerts \
    --hostname='10.30.2.79' \
    --port='443' \
    --proto='https' \
    --api-username='myapiusername' \
    --api-password='myapipassword' \
    --verbose

The expected command output is shown below:

CRITICAL: 1 alerts detected | 'alerts.severity.none.count'=0;;;0; 'alerts.severity.info.count'=1;;;0; 'alerts.severity.minor.count'=0;;;0; 'alerts.severity.major.count'=1;;;0; 'alerts.severity.critical.count'=0;;;0; 'alerts.problems.current.count'=1;;;0;
critical: alert [severity: major] [name: XMS_JBOD_CONTROLLER_SAS1_HEALTH_LEVEL_LEVEL_1_CLEAR] [resource: ] 2021-09-08T08:13:14.804936+00:00

All available options for a given mode can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins/centreon_dell_powerstore_restapi.pl \
    --plugin=storage::dell::powerstore::restapi::plugin \
    --mode=alerts \
    --help

All available modes can be displayed by adding the --list-mode parameter to the command:

/usr/lib/centreon/plugins/centreon_dell_powerstore_restapi.pl \
    --plugin=storage::dell::powerstore::restapi::plugin \
    --list-mode

Troubleshooting​

Please find the troubleshooting documentation for the API-based plugins in this chapter.