Aller au contenu principal

Oracle GoldenGate SSH

Contenu du connecteur de supervision​

Objets supervisés​

Le connecteur de supervision inclue la supervision du statut et des lags des Processes Oracle GG en utilisant la commande GGSCI.

Métriques collectées​

Metric nameDescriptionUnit
process statusProcess status
processname#process.lag.secondsprocessus lag at checkpoint
processname#process.time.checkpoint.secondsprocessus 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​

  1. Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Oracle-Goldengate-Ssh
  1. Sur l'interface Web de Centreon, installer le connecteur de supervision Oracle GoldenGate SSH depuis la page Configuration > Connecteurs > Connecteurs de supervision

Configuration​

Ce connecteur de supervision 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:

MandatoryNameDescription
GGSHOMEDirectory of ggsci
ORACLEHOMEOracle home directory
MandatoryNameDescription
XSSHBACKENDNom du backend: sshcli
XSSHUSERNAMEPar default, il utilise l'utilisateur en cours d'exécution centengine de votre Collecteur
SSHPASSWORDNe peut pas être utilisé avec le backend. Seulement avec la clé d'authentication
SSHPORTPar default: 22
SSHEXTRAOPTIONSPersonnalisez-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).

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.