IBM TSAMP SSH
Pack Assets​
Monitored Objects​
The Pack IBM Tivoli System Automation for Multiplatforms collects metrics for:
- Resource-groups
Discovery rules​
- Services
| Rule name | Description |
|---|---|
| App-Ibm-Tsamp-SSH-Resource-Group-Name | Discover resource groups and monitor status |
Collected Metrics​
- Resource-groups
| Metric name | Description | Unit |
|---|---|---|
| resource_groups.unknown.count | Number of unknown resource groups | |
| resource_groups.offline.count | Number of offline resource groups | |
| resource_groups.online.count | Number of online resource groups | |
| resource_groups.failed_offline.count | Number of failed offline resource groups | |
| resource_groups.stuck_online.count | Number of stuck online resource groups | |
| resource_groups.pending_online.count | Number of pending online resource groups | |
| resource_groups.pending_offline.count | Number of pending offline resource groups | |
| resource_groups.ineligible.count | Number of ineligible resource groups | |
| status resource group | Current state of the resource group |
Prerequisites​
The centreon-engine user performs a SSH connection to a remote system user. This user must have enough privileges to run lssam command.
Setup​
- Online License
- Offline License
- Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Applications-Ibm-Tsamp-Ssh
- On the Centreon Web interface in Configuration > Connectors > Monitoring Connectors, install the IBM TSAMP SSH Pack
- Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Applications-Ibm-Tsamp-Ssh
- On the Centreon Central server, install the Centreon Pack from the RPM:
yum install centreon-pack-applications-ibm-tsamp-ssh
- On the Centreon Web interface in Configuration > Connectors > Monitoring Connectors, install the IBM TSAMP SSH Pack
Host configuration​
- Add a new Host and apply the App-Ibm-Tsamp-SSH-custom Host Template
Once the template applied, some Macros have to be configured. 3 SSH backends are available to connect to the remote server: sshcli, plink and libssh which are detailed below.
- sshcli backend
- plink backend
- libssh backend (default)
| Mandatory | Name | Description |
|---|---|---|
| X | SSHBACKEND | Name of the backend: sshcli |
| X | SSHUSERNAME | By default, it uses the user running process centengine on your Poller |
| SSHPASSWORD | Cannot be used with backend. Only ssh key authentication | |
| SSHPORT | By default: 22 | |
| SSHEXTRAOPTIONS | Customize 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).
| Mandatory | Name | Description |
|---|---|---|
| X | SSHBACKEND | Name of the backend: plink |
| X | SSHUSERNAME | By default, it uses the user running process centengine on your Poller |
| SSHPASSWORD | Can be used. If not set, SSH key authentication is used | |
| SSHPORT | By default: 22 | |
| SSHEXTRAOPTIONS | Customize 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).
| Mandatory | Name | Description |
|---|---|---|
| X | SSHBACKEND | Name of the backend: libssh |
| X | SSHUSERNAME | By default, it uses the user running process centengine on your Poller |
| SSHPASSWORD | Can be used. If not set, SSH key authentication is used | |
| SSHPORT | By default: 22 | |
| SSHEXTRAOPTIONS | Customize it with your own if needed. E.g.: --ssh-priv-key=/user/.ssh/id_rsa |
With that backend, you do not have to validate the target server fingerprint manually.
How to test the Plugin and what are the main options for?​
Once the Plugin installed, log into your Poller using the centreon-engine user account and test by running the following command :
/usr/lib/centreon/plugins/centreon_ibm_tsamp_ssh.pl \
--plugin=apps::ibm::tsamp::local::plugin \
--mode=resource-groups \
--hostname=10.30.2.81 \
--ssh-username=centreon \
--ssh-password='centreon-password' \
--ssh-backend=libssh \
--verbose
Expected command output is shown below:
OK: All resource groups are ok | 'resource_groups.unknown.count'=0;;;0; 'resource_groups.offline.count'=0;;;0; 'resource_groups.online.count'=5;;;0; 'resource_groups.failed_offline.count'=0;;;0; 'resource_groups.stuck_online.count'=0;;;0; 'resource_groups.pending_online.count'=0;;;0; 'resource_groups.pending_offline.count'=0;;;0; 'resource_groups.ineligible.count'=0;;;0;
Resource group 'db2_db2inst1_db2inst1_AUDIT-rg' operational state: online [nominal: online]
Resource group 'db2_db2inst1_db2inst1_AUDIT2-rg' operational state: online [nominal: online]
Resource group 'db2_db2inst1_db2inst1_TCDB-rg' operational state: online [nominal: online]
Resource group 'db2_db2inst1_netdb101-v_0-rg' operational state: online [nominal: online]
Resource group 'db2_db2inst1_netdb102-v_0-rg' operational state: online [nominal: online]
The command above gets resource groups statuses (--mode=resource-groups).
It uses a SSH username centreon (--ssh-username=centreon), a SSH password centreon-password (--ssh-password='centreon-password'),
uses a SSH backend libssh (--ssh-backend='libssh') and it connects to the host 10.30.2.81 (--hostname=10.30.2.81)
on the SSH default port 22 (--ssh-port=22).
All the options as well as all the available thresholds can be displayed by adding the --help
parameter to the command:
/usr/lib/centreon/plugins/centreon_ibm_tsamp_ssh.pl \
--plugin=apps::ibm::tsamp::local::plugin \
--mode=resource-groups \
--help