Contexte

Le pack docker-by-SSH__shinken permet de superviser les conteneurs d'une instance docker avec une connexion SSH.

• Il vous permet de vérifier, pour chaque conteneur :
  • son état ( Status, Uptime, Restart, Health ).
  • son utilisation ( CPU, mémoire ).
  • son image ( Image-age ).
• Les commandes utilisent une sonde PYTHON présente dans le répertoire des sondes Shinken  /var/lib/shinken-user/libexec/shinken-additional-packs/docker-by-SSH_shinken/   (   ou $DOCKER-BY-SSH__SHINKEN__PLUGINSDIR$ depuis l'interface de configuration  ), après la mise en place du pack.

Il contient deux types de modèles d'hôtes :

• Pour superviser tous les conteneurs d'un coup :
  • docker-by-SSH__all-containers qui permet la supervision de l'ensemble des conteneurs pour une vérification des fonctions principales ( CPU, mémoire, Status, Uptime ).
  • docker-by-SSH__all-containers__advanced qui permet, en complément du modèle docker-by-SSH__all-containers, de relever des indicateurs plus poussés ( Image-age, Restarts ).
  • docker-by-SSH__all-containers __extra qui offre la possibilité de mettre sous surveillance des éléments de configuration spécifiques ( Health ).

• Pour superviser les conteneurs un par un :
  • docker-by-SSH__selected-containers qui permet la supervision d'un conteneur spécifique pour une vérification des fonctions principales ( CPU, mémoire, Status, Uptime ).
  • docker-by-SSH__selected-containers__advanced qui permet, en complément du modèle docker-by-SSH__selected-containers, de relever des indicateurs plus poussés sur un conteneur spécifique ( Image-age, Restarts ).
  • docker-by-SSH__selected-containers __extra qui offre la possibilité, sur un conteneur spécifique, de mettre sous surveillance des éléments de configuration spécifiques ( Health ).

Ce pack est importé et mis à jour par la source " shinken-additional-packs-import ".

Comment utiliser son pack ?

Mise en place

Il faut avant tout que vous mettiez en place le pack ( Page Mise en place du pack docker-by-SSH__shinken ).

Utilisation

Choisir les modèles d'hôtes

Le pack docker-by-SSH__shinken peut être utilisé en appliquant les modèles d'hôtes mis à disposition, en fonction de votre besoin, sur vos hôtes supervisés.

• En utilisant l'interface de configuration : Créez ou éditez un Hôte, et ajoutez un des modèles ; "docker-by-SSH__all-containers"  par exemple ; grâce au menu déroulant ( voir la page Éditer un Hôte  ).
• En éditant les fichiers de définition d'élément ( .cfg ) : 
  • Dans un fichier de configuration, créez ou éditez votre définition d'hôte en ajoutant, dans la propriété "use", la valeur " docker-by-SSH__all-containers".
  • Le fichier de configuration devra alors être importé avec une source ( voir la page Collecteur de type ( cfg-file-import ) - Import depuis des fichiers au format .cfg  ).

Listes des modèles à utiliser dans le pack

Configurer l'accès aux équipements à superviser

Pour savoir comment configurer l'accès SSH de docker ( voir la page Configuration du Docker supervisé pour le pack docker-by-SSH__shinken ).

Personnaliser son pack

Il est possible de modifier certains éléments (  commandes, checks ou modèles d'hôtes  )

• voir la page Les bonnes pratiques d'utilisation d'un pack livré par Shinken .

Version des scripts livrés