documentation/procédures/supervision.md

5.6 KiB

Supervision

[TOC]

Installation de la supervision sur une machine virtuelle

Générer un ticket sur isengard.libre-en-communs.org

sudo icinga2 pki ticket --cn NOM_DE_DOMAINE_DE_VM

On obtient un ticket à noter dans l'issue. Il sera redemandé plus tard.

En SSH sur la machine virtuelle, installer l'agent de supervision

sudo apt install icinga2 monitoring-plugins monitoring-plugins-contrib

Connecter notre agent au serveur de supervision

sudo icinga2 node wizard
On réalise la configuration interactive suivante:
Welcome to the Icinga 2 Setup Wizard!

We will guide you through all required configuration details.

Please specify if this is an agent/satellite setup ('n' installs a master setup) [Y/n]: 

Starting the Agent/Satellite setup routine...

Please specify the common name (CN) [NOM_DE_DOMAINE_DE_VM]: 

Please specify the parent endpoint(s) (master or satellite) where this node should connect to:
Master/Satellite Common Name (CN from your master/satellite node): isengard.libre-en-communs.org

Do you want to establish a connection to the parent node from this node? [Y/n]: 
Please specify the master/satellite connection information:
Master/Satellite endpoint host (IP address or FQDN): isengard.libre-en-communs.org
Master/Satellite endpoint port [5665]: 

Add more master/satellite endpoints? [y/N]: 
Parent certificate information:

Version:             3
Subject:             CN = isengard.libre-en-communs.org
Issuer:              CN = Icinga CA
Valid From:          Dec  9 14:36:07 2021 GMT
Valid Until:         Dec  5 14:36:07 2036 GMT
Serial:              c4:3f:53:b2:cf:09:f7:b5:2e:88:39:03:e9:96:c8:fc:99:a1:ca:3a

Signature Algorithm: sha256WithRSAEncryption
Subject Alt Names:   isengard.libre-en-communs.org
Fingerprint:         54 78 22 83 24 22 3A A7 FD 00 01 E4 10 67 71 B6 CA 3E A2 71 93 63 F8 64 29 E9 45 1F D1 35 A9 95 

Is this information correct? [y/N]: y

Please specify the request ticket generated on your Icinga 2 master (optional).
(Hint: # icinga2 pki ticket --cn 'NOM_DE_DOMAINE_DE_VM'):  INSERER_NUMERO_DE_TICKET_ICI
Please specify the API bind host/port (optional):
Bind Host []: 
Bind Port []: 

Accept config from parent node? [y/N]: y
Accept commands from parent node? [y/N]: y

Reconfiguring Icinga...
Disabling feature notification. Make sure to restart Icinga 2 for these changes to take effect.
Enabling feature api. Make sure to restart Icinga 2 for these changes to take effect.

Local zone name [NOM_DE_DOMAINE_DE_VM]: 
Parent zone name [master]: 

Default global zones: global-templates director-global
Do you want to specify additional global zones? [y/N]: 

Do you want to disable the inclusion of the conf.d directory [Y/n]: 
Disabling the inclusion of the conf.d directory...

Done.

Now restart your Icinga 2 daemon to finish the installation!

Créer le fichier de zone pour la nouvelle machine dans isengard.libre-en-communs.org

/etc/icinga2/zones.d/master/NOM_DE_DOMAINE_DE_VM.conf
object Endpoint "NOM_DE_DOMAINE_DE_VM" {
}

object Zone "NOM_DE_DOMAINE_DE_VM" {
endpoints = [ "NOM_DE_DOMAINE_DE_VM" ]
parent = "master"
}

object Host "NOM_DE_DOMAINE_DE_VM" {
    import "generic-host"
    address  = "NOM_DE_DOMAINE_DE_VM"
    address6 = "NOM_DE_DOMAINE_DE_VM"
    vars.os = "GNU/Linux"
    vars.client_endpoint = name

    vars.notification["mail"] = {  
        groups = [ "icingaadmins" ]  
    }  

}

Interface web d'Isengard

Site web : https://isengard.libre-en-communs.org/

Activation d'un downtime

Downtimer :

  • Menu gauche > Overview > Hosts
  • sélectionner la vm visée
  • partie droite > Schedule downtime
  • Comment : mettre la raison du downtime, exemple : reboot noyal
  • End time : par défaut 1h
  • All services : coché
  • Child Hosts : Schedule triggered downtime for all child hosts (/!\ utile ?)
  • cliquer sur Schedule downtime

Ajout d'une entrée de menu pour ses vm

Ajout :

  • Menu gauche > Overview > Hosts ;
  • sélectionner les vm désirées (Ctrl + clique gauche)
  • partie droite > menu > chevron bas (à droite de History) > Add to menu
  • Name : mettre le nom qui apparaîtra dans le menu
  • Target : Single Column
  • cliquer Save Changes

Ajout d'une entrée de menu ses services

Ajout :

  • Menu gauche > Overview > Services ;
  • cliquer sur l'icone filtre à droite de la zone de recherche
  • première case : Host (Case insensitive)
  • deuxième case : =
  • troisième case : le nom de votre vm, exemple : audio.chalec.org
  • cliquer sur + et sélectionner OR
  • recommencer autant de fois que voulu
  • cliquer sur Apply
  • menu du haut > chevron bas (à droite de Service) > Add to menu
  • Name : mettre le nom qui apparaîtra dans le menu
  • Target : Single Column
  • cliquer Save Changes

Éditer une entrée personnalisée de menu

Pour éditer une entrée personnalisée du menu :

  • Menu gauche > vous@a-lec.org > My account > Navigation
  • dans la liste, cliquer sur l'entrée à éditer.

Supprimer une entrée de menu personnalisée

Pour supprimer une entrée personnalisée du menu :

  • Menu gauche > vous@a-lec.org > My account > Navigation
  • dans la liste, cliquer sur l'entrée à éditer
  • cliquer sur l'icone croix rouge ;

Downtime de tous ses services en 2 clics

Prérequis : avoir créer une entrée personnalisée du menu pour ses vm.

Downtimer ses services :

  • Menu gauche > entrée personnalisée de vos vm
  • cliquer sur « Schedule downtimes »