Oracle GoldenGate SSH
Contenu du Plugin-Pack
Objets supervisés
Le Plugin-Pack inclue la supervision du statut et des lags des Processes Oracle GG en utilisant la commande GGSCI.
Métriques collectées
- Resources
Metric name | Description | Unit |
---|---|---|
process status | Process status | |
processname#process.lag.seconds | processus lag at checkpoint | |
processname#process.time.checkpoint.seconds | processus time since checkpoint |
Prérequis
Afin de fonctionner, le Plugin nécessite une connexion SSH entre le Poller et le serveur executant Oracle GoldenGate. L'utilisateur distant
doit avoir assez de privilèges pour executer la commande ggsci
.
Installation
- Online License
- Offline License
- Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Oracle-Goldengate-Ssh
- Sur l'interface Web de Centreon, installer le Plugin-Pack Oracle GoldenGate SSH depuis la page "Configuration > Plugin packs > Manager"
- Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Oracle-Goldengate-Ssh
- Sur le serveur Central Centreon, installer le Plugin-Pack via le RPM:
yum install centreon-pack-applications-oracle-goldengate-ssh
- Sur l'interface Web de Centreon, installer le Plugin-Pack Oracle GoldenGate SSH depuis la page "Configuration > Plugin packs > Manager"
Configuration
Ce Plugin-Pack est conçu de manière à avoir dans Centreon un hôte par application Oracle GoldenGate. Lorsque vous ajoutez un hôte à Centreon, appliquez-lui le modèle App-Oracle-Goldengate-SSH-custom-custom. Une fois celui-ci configuré, certaines macros doivent être renseignées:
Mandatory | Name | Description |
---|---|---|
GGSHOME | Directory of ggsci | |
ORACLEHOME | Oracle home directory |
- sshcli backend
- plink backend
- libssh backend (par défaut)
Mandatory | Name | Description |
---|---|---|
X | SSHBACKEND | Nom du backend: sshcli |
X | SSHUSERNAME | Par default, il utilise l'utilisateur en cours d'exécution centengine de votre Collecteur |
SSHPASSWORD | Ne peut pas être utilisé avec le backend. Seulement avec la clé d'authentication | |
SSHPORT | Par default: 22 | |
SSHEXTRAOPTIONS | Personnalisez-le avec le vôtre si nécessaire. E.g.: --ssh-priv-key=/user/.ssh/id_rsa |
Avec ce backend, il est nécessaire d'effectuer une connexion manuelle entre l'utilisateur centreon-engine du Collecteur et l'utilisateur applicatif créé sur le serveur distant. (Macro SSHUSERNAME).
Mandatory | Name | Description |
---|---|---|
X | SSHBACKEND | Nom du backend: plink |
X | SSHUSERNAME | Par default, il utilise l'utilisateur en cours d'exécution centengine de votre Collecteur |
SSHPASSWORD | Peut être utilisé. Si aucune valeur n'est définie, l'authentification par clé ssh est utilisée | |
SSHPORT | Par default: 22 | |
SSHEXTRAOPTIONS | Personnalisez-le avec le vôtre si nécessaire. E.g.: --ssh-priv-key=/user/.ssh/id_rsa |
Avec ce backend, il est nécessaire d'effectuer une connexion manuelle entre l'utilisateur centreon-engine du Collecteur et l'utilisateur applicatif créé sur le serveur distant. (Macro SSHUSERNAME).
Mandatory | Name | Description |
---|---|---|
X | SSHBACKEND | Nom du backend: libssh |
SSHUSERNAME | Par default, il utilise l'utilisateur en cours d'exécution centengine de votre Collecteur | |
SSHPASSWORD | Peut être utilisé. Si aucune valeur n'est définie, l'authentification par clé ssh est utilisée | |
SSHPORT | Par default: 22 | |
SSHEXTRAOPTIONS | Personnalisez-le avec le vôtre si nécessaire. E.g.: --ssh-priv-key=/user/.ssh/id_rsa |
Avec ce backend, vous n'avez pas à valider manuellement le fingerprint du serveur cible.
FAQ
Comment puis-je tester le Plugin et que signifient les options des commandes ?
Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis votre Collecteur Centreon avec l'utilisateur centreon-engine
/usr/lib/centreon/plugins/centreon_oracle_gg_ssh.pl \
--plugin=apps::oracle::gg::local::plugin \
--mode=processes \
--hostname=10.30.2.81 \
--ssh-username=centreon \
--ssh-password='centreon-password' \
--ssh-backend=libssh \
--filter-type=REPLICAT \
--verbose
Exemple de sortie:
CRITICAL: Process 'REPLICAT:RP_TS02' status: ABENDED | 'REPLICAT:RP_TSO1#process.lag.seconds'=0s;;;0; 'REPLICAT:RP_TSO1#process.time.checkpoint.seconds'=4s;;;0; 'REPLICAT:RP_TS02#process.lag.seconds'=172472s;;;0; 'REPLICAT:RP_TS02#process.time.checkpoint.seconds'=1462s;;;0; 'REPLICAT:RP_TS03#process.lag.seconds'=0s;;;0; 'REPLICAT:RP_TS03#process.time.checkpoint.seconds'=4s;;;0;
Process 'REPLICAT:RP_TSO1' status: RUNNING, lag: 0, time since checkpoint: 4s
Process 'REPLICAT:RP_TS02' status: ABENDED, lag: 1d 23h 54m 32s, time since checkpoint: 24m 22s
Process 'REPLICAT:RP_TS03' status: RUNNING, lag: 0, time since checkpoint: 4s
La commande ci-dessus contrôle les processus de l'application Oracle GoldenGate (--mode=processes
).
Le Plugin utilise le Backend libssh (--ssh-backend='libssh'
) avec l'utisateur centreon (--ssh-username=centreon --api-password='centreon-password'
)
et il se connecte à l'hôte 10.30.2.81 (--hostname='10.30.2.81'
).
Toutes les options et leur utilisation peuvent être consultées avec le paramètre --help
ajouté à la commande :
/usr/lib/centreon/plugins/centreon_oracle_gg_ssh.pl \
--plugin=apps::oracle::gg::local::plugin \
--mode=processes \
--help
J'ai ce message d'erreur : UNKNOWN: Command error: Host key verification failed.
. Qu'est-ce que cela signifie ?
Cela signifie que vous n'avez pas validé manuellement la signature (fingerprint) du serveur cible avec ssh
or plink
sur le Poller Centreon.