Aller au contenu principal

HP 3PAR SSH

Pack Assets​

Monitored Objects​

The Centreon Pack HP 3PAR brings a host template:

  • HW-Storage-HP-3par-SSH-custom

It brings the following service templates:

Service AliasService TemplateDescriptionDefault
AfcHW-Storage-HP-3par-Afc-SSHCheck adaptive flash cache
CagesHW-Storage-HP-3par-Cages-SSHCheck cages
CapacityHW-Storage-HP-3par-Capacity-SSHCheck storage capacitiesX
ComponentsHW-Storage-HP-3par-Components-SSHCheck hardwareX
Disk-UsageHW-Storage-HP-3par-Disk-Usage-SSHCheck disksX
NodesHW-Storage-HP-3par-Nodes-SSHCheck nodesX
PsuHW-Storage-HP-3par-Psu-SSHCheck power supplies
TimeHW-Storage-HP-3par-Time-SSHCheck nodes time offset
UptimeHW-Storage-HP-3par-Uptime-SSHCheck nodes uptime
Volume-UsageHW-Storage-HP-3par-Volume-Usage-SSHCheck volumesX

Collected metrics & status​

Metric nameUnit
node adaptive flash cache status
node_id#node.flashcache.usage.bytesB
node_id#node.flashcache.free.bytesB
node_id#node.flashcache.usage.percentage%
node_id#node.flashcache.readhits.percentage%
volume_name#volume.flashcache.readhits.percentage%

Prerequisites​

Configure SSH connection​

On each needed poller follow this steps:

a. Login with 'centreon-engine' user:

# su - centreon-engine

b. If SSH doesn't exist, generate SSH key using following command (press ENTER for each question):

$ ssh-keygen

c. Get generated SSH public key

$ vi ~/.ssh/id_rsa.pub

d. Connect to your HP 3PAR equipment using SSH with administrator account and copy centreon-engine public key:

3PAR01 cli% setsshkey
Please enter the SSH public key below. When finished, press enter twice.
The key is usually long. It's better to copy it from inside an editor
and paste it here. (Please make sure there are no extra blanks.)
The maximum number of characters used to represent the SSH key
(including the "from" option, key type, and additional comments) is 4095.

ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEAydSr8dvdf+N5apCrij3eom6a6gMZUibiBp6GUurADktPtm1jBdbZ2GVhnwiaeUqiwgxsBSjiGCKRlpIN/zBzM59li4k+fbhyO7SzXfB3IV3ueSVKlrVljyHQL6GqUjj9opxCg8jyKerCx6iTyqUvIJ4zmhaJXQAzxQFE7YLiuaaNN9ylH1z9ebuMZZKUh0gpXNT3ID4Ea+In5CAoPopwF50EdAIZ4QkS1EibhI9Lar8GqXMyHTNR/ZapvZ/KpI3lhduLT5OJ2QMbBzVrQFKXiLbYnU2AASYyFsQQC+7YASFwIEQ6D3sp0Wg8G1Dw/jmM01CsqthTm7j1Mw070OuJSw== centreon-engine@myserver

SSH public key successfully set.

3PAR01 cli%

Setup​

  1. Install the Centreon package on every Centreon poller expected to monitor HP 3PAR resources:
yum install centreon-plugin-Hardware-Storage-Hp-3par-Ssh
  1. On the Centreon web interface, install the HP 3PAR SSH Centreon Pack on the Configuration > Monitoring Connectors 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 HP 3PAR equipment settings.
  • Apply the HW-Storage-HP-3par-SSH-custom template to the host.
  • Once the template is applied, fill in the corresponding macros. Some macros are mandatory.

3 SSH backends are available to connect to the remote server: sshcli, plink and libssh which are detailed below.

MandatoryNameDescription
XSSHBACKENDName of the backend: sshcli
XSSHUSERNAMEBy default, it uses the user running process centengine on your poller
SSHPASSWORDCannot be used with backend. Only ssh key authentication
SSHPORTBy default: 22
SSHEXTRAOPTIONSCustomize it with your own if needed. E.g.: --ssh-priv-key=/user/.ssh/id_rsa

Warning With that backend, you have to validate the target server fingerprint manually (with the SSHUSERNAME used).

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_hp_3par_ssh.pl \
--plugin=storage::hp::3par::ssh::plugin \
--mode=capacity \
--hostname=10.30.2.81 \
--ssh-username=centreon \
--ssh-password='centreon-password' \
--ssh-backend=libssh \
--verbose

The expected command output is shown below:

OK: All storage capacities are ok | 'FC#storage.space.usage.bytes'=9980928000000B;;;0;20103168000000 'FC#storage.space.free.bytes'=10122240000000B;;;0;20103168000000 'FC#storage.space.usage.percentage'=49.65%;;;0;100 'FC#storage.space.unavailable.bytes'=0B;;;0; 'FC#storage.space.failed.bytes'=0B;;;0; 'FC#storage.space.compaction.ratio.count'=2.31;;;0; 'FC#storage.space.overprovisioning.ratio.count'=0.92;;;0; 'SSD#storage.space.usage.bytes'=1476608000000B;;;0;4546560000000 'SSD#storage.space.free.bytes'=3069952000000B;;;0;4546560000000 'SSD#storage.space.usage.percentage'=32.48%;;;0;100 'SSD#storage.space.unavailable.bytes'=0B;;;0; 'SSD#storage.space.failed.bytes'=0B;;;0; 'SSD#storage.space.compaction.ratio.count'=4.93;;;0; 'SSD#storage.space.deduplication.ratio.count'=1.20;;;0; 'SSD#storage.space.data_reduction.ratio.count'=1.20;;;0; 'SSD#storage.space.overprovisioning.ratio.count'=0.48;;;0; 'Total#storage.space.usage.bytes'=11457536000000B;;;0;24649728000000 'Total#storage.space.free.bytes'=13192192000000B;;;0;24649728000000 'Total#storage.space.usage.percentage'=46.48%;;;0;100 'Total#storage.space.unavailable.bytes'=0B;;;0; 'Total#storage.space.failed.bytes'=0B;;;0; 'Total#storage.space.compaction.ratio.count'=2.59;;;0; 'Total#storage.space.deduplication.ratio.count'=1.23;;;0; 'Total#storage.space.data_reduction.ratio.count'=1.23;;;0; 'Total#storage.space.overprovisioning.ratio.count'=0.92;;;0;
checking storage 'FC'
space usage total: 18.28 TB used: 9.08 TB (49.65%) free: 9.21 TB (50.35%), unavailable: 0.00 B, failed: 0.00 B
compaction: 2.31, overprovisioning: 0.92
checking storage 'SSD'
space usage total: 4.14 TB used: 1.34 TB (32.48%) free: 2.79 TB (67.52%), unavailable: 0.00 B, failed: 0.00 B
compaction: 4.93, deduplication: 1.20, data reduction: 1.20, overprovisioning: 0.48
checking storage 'Total'
space usage total: 22.42 TB used: 10.42 TB (46.48%) free: 12.00 TB (53.52%), unavailable: 0.00 B, failed: 0.00 B
compaction: 2.59, deduplication: 1.23, data reduction: 1.23, overprovisioning: 0.92

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

/usr/lib/centreon/plugins/centreon_hp_3par_ssh.pl \
--plugin=storage::hp::3par::ssh::plugin \
--mode=capacity \
--help

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

/usr/lib/centreon/plugins/centreon_hp_3par_ssh.pl \
--plugin=storage::hp::3par::ssh::plugin \
--list-mode

Troubleshooting​

Please find the troubleshooting documentation for Centreon Plugins typical issues.