Protocol SFTP
Contenu du Pack
Modèles
Le Pack Centreon SFTP apporte un modèle d'hôte :
- App-Protocol-Sftp-custom
Il apporte les modèles de service suivants :
| Alias | Découverte | Défaut | Découverte |
|---|---|---|---|
| Connection | App-Protocol-Sftp-Connection | X | |
| Files-Count | App-Protocol-Sftp-Files-Count | ||
| Files-Date | App-Protocol-Sftp-Files-Date | ||
| Scenario | App-Protocol-Sftp-Scenario |
Métriques & statuts collectés
- Connection
- Files-Count
- Files-Date
- Scenario
| Metric name | Description | Unit |
|---|---|---|
| connection status | Connection status | |
| connection.time.seconds | Connection time to established the sftp session | s |
| Metric name | Description | Unit |
|---|---|---|
| files.detected.count | Number of files detected |
| Metric name | Description | Unit |
|---|---|---|
| filename#file.mtime.last.seconds | Last modified time | s |
| Metric name | Description | Unit |
|---|---|---|
| scenario status | Global scenario status | |
| scenario.execution.time.milliseconds | Scenario execution time | ms |
| scenario.steps.count | Number of scenario steps | |
| scenario.errors.count | Number of steps failed | |
| step status | Step status | |
| step_label#step.execution.time.milliseconds | Step execution time | ms |
Prérequis
Pour superviser votre serveur SFTP, il est possible de réaliser une authentification par :
- clé publique
- utilisateur et mot de passe
Installation
- Online License
- Offline License
- Installer le plugin Centreon sur tous les collecteurs Centreon devant superviser des ressources Protocol SFTP :
yum install centreon-plugin-Applications-Protocol-Sftp
- Sur l'interface web de Centreon, installer le Pack Protocol SFTP depuis la page Configuration > Packs de plugins.
- Installer le plugin Centreon sur tous les collecteurs Centreon devant superviser des ressources Protocol SFTP :
yum install centreon-plugin-Applications-Protocol-Sftp
- Sur le serveur central Centreon, installer le RPM du Pack Protocol SFTP :
yum install centreon-pack-applications-protocol-sftp
- Sur l'interface web de Centreon, installer le Pack Protocol SFTP depuis la page Configuration > Packs de plugins.
Configuration
Hôte
- Ajoutez un hôte à Centreon depuis la page Configuration > Hôtes
- Complétez les champs Nom, Alias & IP Address / DNS correspondant à votre serveur Protocol SFTP.
- Appliquez le modèle d'hôte App-Protocol-Sftp-custom.
- Une fois le modèle appliqué, les macros ci-dessous indiquées comme requises (Obligatoire) doivent être renseignées.
Une fois celui-ci configuré, certaines macros doivent être renseignées:
| Obligatoire | Nom | Description |
|---|---|---|
| PROTOCOLSFTPUSERNAME | sftp username | |
| PROTOCOLSFTPPASSWORD | sftp password | |
| PROTOCOLSFTPEXTRAOPTIONS | Any extra option you may want to add to the command (eg. a --verbose flag) |
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 en vous connectant avec
l'utilisateur centreon-engine (su - centreon-engine) :
/usr/lib/centreon/plugins/centreon_protocol_sftp.pl \
--plugin=apps::protocols::sftp::plugin \
--mode=connection \
--hostname='10.0.0.1' \
--ssh-username='my-username' \
--ssh-password='my-password' \
--verbose
La commande devrait retourner un message de sortie similaire à :
OK: authentication succeeded - connection time: 1.372s | 'connection.time.seconds'=1.372s;;;0;
La liste de toutes les options complémentaires et leur signification peut être
affichée en ajoutant le paramètre --help à la commande:
/usr/lib/centreon/plugins/centreon_protocol_sftp.pl \
--plugin=apps::protocols::sftp::plugin \
--mode=connection \
--help
Tous les modes disponibles peuvent être affichés en ajoutant le paramètre
--list-mode à la commande:
/usr/lib/centreon/plugins/centreon_protocol_sftp.pl \
--plugin=apps::protocols::sftp::plugin \
--list-mode
Diagnostic des erreurs communes
Rendez-vous sur la documentation dédiée des plugins.