Chapril DokuWiki

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Mise en place de l'infra de supervision ======

<note important>Ici on parle de l'installation du serveur maître et de l'IHM Web. Pour l'ajout du monitoring sur une machine, consulter [[admin:monitoring:add-host|cette page]].</note>

===== Prérequis =====

  * Enregistrement DNS ;
  * //Reverse proxy// + TLS sur le bastion ;
  * Serveur ''httpd'' fonctionnel en local.

===== Installation du serveur maître =====

<note tip>Doc. officielle : [[https://docs.icinga.com/icinga2/latest/doc/module/icinga2/toc#!/icinga2/latest/doc/module/icinga2/chapter/getting-started#installing-icinga2|sur le site Web]].</note>

Icinga2 est empaqueté et le paquet Debian aide sur quelques étapes. Pour l'installation :

<code bash>
apt install icinga2 vim-icinga2 monitoring-plugins
</code>

Icinga doit tourner :

<code bash>
systemctl status icinga2
</code>

Installation du greffon Vim :

<code bash>
apt install vim-addon-manager
vim-addons install icinga2
</code>

Mise en place de la base de données :

<code bash>
apt install mariadb-server mariadb-client
apt install icinga2-ido-mysql
</code>

Les réponses que l'installeur peut attendre : oui à la préconfiguration puis vide au mot de passe. Si besoin les details d'accès à la BDD (''user'', ''password'', ''database'') seront dans ''/etc/icinga2/features-{en,dis}abled/ido-mysql.conf''.

Activation des fonctions utiles :

<code bash>
icinga2 feature enable ido-mysql
icinga2 feature enable command
</code>

Redémarrage pour la prise en compte :

<code bash>
systemctl restart icinga2
</code>

===== Installation de l'IHM Web =====

<note tip>Doc officielle : [[https://docs.icinga.com/icinga2/latest/doc/module/icinga2/toc#!/icinga2/latest/doc/module/icinga2/chapter/getting-started#setting-up-icingaweb2|sur le site web]].</note>

L'interface Web d'Icinga2 est fort séparée du cœur d'exécution (qui sera commun aux maîtres et esclaves). On parle d'Icingaweb2. Celui-ci échange avec Icinga2 via la base de données et via une possibilité de commande locale. On installera également ''icingacli'' qui aide sur la gestion des modules d'Icingaweb2.

Icingaweb2 est empaqueté et le paquet Debian aide sur quelques étapes. Pour l'installation :

<code bash>
apt install icingacli icingaweb2 icingaweb2-module-monitoring php-mysql php7.0-intl
usermod -a -G icingaweb2 www-data
</code>
    
==== Configuration Nginx ====

<note tip>
Pour rappel on suppose que le //reverse proxy// fait déjà le boulot.
</note>

On commence par partir d'une configuration de base :

<file nginx /etc/nginx/sites-available/icinga.chapril.org>
server {
    listen 80;

    access_log /var/log/nginx/icinga.chapril.org.access_log;
    error_log /var/log/nginx/icinga.chapril.org.error_log;

    server_name icinga.chapril.org;
    
</file>

Puis on enrichit la configuration à l'aide de ''icingacli'' :

<code bash>
icingacli setup config webserver nginx --document-root /usr/share/icingaweb2/public >> /etc/nginx/sites-available/icingaweb2.conf
</code>

Il faut ensuite fermer l'accolade finale, reformater, et re-définir ''fastcgi_pass'' au profit de

<file nginx /etc/nginx/sites-available/icingaweb2.conf>
fastcgi_pass unix:/run/php/php7.0-fpm.sock
</file>

Il faut aussi définir dans ''/etc/php/7.0/fpm/php.ini'' :

<file ini /etc/php/7.0/fpm/php.ini>
date.timezone = Europe/Paris
</file>

Ensuite on active le site :

<code bash>
ln -s /etc/nginx/sites-available/icinga.chapril.org /etc/nginx/sites-enabled/icinga.chapril.org
nginx -t
systemctl reload nginx
</code>

==== Finalisation de l'installation ====

Le //setup// d'Icinga va exiger un jeton d'authentification, qu'on génère ainsi :

<code bash>
icingacli setup token create
</code>

<code>
=> The newly generated setup token is: deadbeef
</code>

Il suffit ensuite d'ouvrir https://icinga.chapril.org/icingaweb2/setup dans un butineur et de placer le jeton ''deadbeef''…

<note tip>Si vous avez oublié le jeton :
<code bash>
icingacli setup token show
</code>
</note>
    
Ensuite laissez-vous faire. Il faudra configurer l'accès à la base de données d'Icinga2 pour lire l'état du //monitoring//, et configurer une base propre à Icingaweb2 pour son fonctionnement propre.

Si besoin, création d'une base Icingaweb2 :

<code>
=(^-^)=root@admin:~# mariadb
MariaDB [(none)]> CREATE DATABASE icingaweb2;
Query OK, 1 row affected (0.00 sec)
MariaDB [(none)]> GRANT SELECT, INSERT, UPDATE, DELETE, DROP, CREATE VIEW, INDEX, EXECUTE ON icingaweb2.* TO 'icingaweb2'@'localhost' IDENTIFIED BY 'icingaweb2';
Query OK, 0 rows affected (0.01 sec)
</code>
  
Après tout ça, votre Icingaweb2 devrait être fonctionnel. Si le //monitoring// n'apparaît pas dans l'IHM Web, il faut peut-être activer le module :

<code bash>
icingacli module enable monitoring
</code>

==== Personnalisation du logo ====

Afin de ne pas confondre les sites Web Icinga2 April et Chapril, changement du logo Icinga sur le Chapril.

Dans ''root@admin:/var/www/icinga.chapril.org/public/img/'', ajout de l'image modifiée du logo Icinga2 auquel a été ajouté le logo Chapril :

{{:admin:monitoring:icinga-chapril-logo.png?400|}}

Dans ''root@admin:/etc/nginx/sites-enabled/icinga.chapril.org'', ajout de :

<code nginx>
    location = /icingaweb2/img/icinga-logo.svg {
      alias /var/www/icinga.chapril.org/public/img/icinga-chapril-logo.svg;
    }
</code>

===== Configuration du serveur maître =====

<note tip>Doc officielle : [[https://docs.icinga.com/icinga2/latest/doc/module/icinga2/toc#!/icinga2/latest/doc/module/icinga2/chapter/distributed-monitoring#distributed-monitoring-setup-master|sur le site Web]].</note>

<note important>
Remarque : globalement on n'utilisera que des fqdn locaux au cluster, dont on est sûr qu'il ne résolvent que sur des IP privées. Ici le nom de la machine est ''admin.cluster.chapril.org''.</note>

Le //node wizard// d'Icinga2 prend ici tout en mains :

<code>
=(^-^)=root@admin:/etc/icinga2# icinga2 node wizard
Welcome to the Icinga 2 Setup Wizard!

We'll guide you through all required configuration details.



Please specify if this is a satellite setup ('n' installs a master setup) [Y/n]: n
Starting the Master setup routine...
Please specify the common name (CN) [admin.cluster.chapril.org]: 
Checking for existing certificates for common name 'admin.cluster.chapril.org'...
Certificates not yet generated. Running 'api setup' now.
information/cli: Generating new CA.
information/base: Writing private key to '/var/lib/icinga2/ca/ca.key'.
information/base: Writing X509 certificate to '/var/lib/icinga2/ca/ca.crt'.
information/cli: Generating new CSR in '/etc/icinga2/pki/admin.cluster.chapril.org.csr'.
information/base: Writing private key to '/etc/icinga2/pki/admin.cluster.chapril.org.key'.
information/base: Writing certificate signing request to '/etc/icinga2/pki/admin.cluster.chapril.org.csr'.
information/cli: Signing CSR with CA and writing certificate to '/etc/icinga2/pki/admin.cluster.chapril.org.crt'.
information/pki: Writing certificate to file '/etc/icinga2/pki/admin.cluster.chapril.org.crt'.
information/cli: Copying CA certificate to '/etc/icinga2/pki/ca.crt'.
Generating master configuration for Icinga 2.
information/cli: Adding new ApiUser 'root' in '/etc/icinga2/conf.d/api-users.conf'.
information/cli: Enabling the 'api' feature.
Enabling feature api. Make sure to restart Icinga 2 for these changes to take effect.
information/cli: Dumping config items to file '/etc/icinga2/zones.conf'.
information/cli: Created backup file '/etc/icinga2/zones.conf.orig'.
Please specify the API bind host/port (optional):
Bind Host []: 
Bind Port []: 
information/cli: Created backup file '/etc/icinga2/features-available/api.conf.orig'.
information/cli: Updating constants.conf.
information/cli: Created backup file '/etc/icinga2/constants.conf.orig'.
information/cli: Updating constants file '/etc/icinga2/constants.conf'.
information/cli: Updating constants file '/etc/icinga2/constants.conf'.
information/cli: Updating constants file '/etc/icinga2/constants.conf'.
Done.

Now restart your Icinga 2 daemon to finish the installation!
</code>

Il faut ensuite passer à la configuration à proprement parler.

Pour donner un aperçu :
  * Le fichier ''/etc/icinga2/zones.conf'' défini les zones. Chaque machine du cluster doit s'y trouver ;
  * Les configurations génériques sont dans une zone globale et situées ici : ''/etc/icinga2/zones.d/global-templates/'' incluant notamment :
      * ''zones.d/global-templates/groups.conf'',
      * ''zones.d/global-templates/services/*'' ;
  * Les configurations propres aux machines sont dans ''zones.d/master'' :<code conf tree /etc/icinga2/zones.d/master/>
    /etc/icinga2/zones.d/master/
    ├── cluster
    │   ├── admin.conf
    │   ├── bastion.conf
    │   ├── bling.conf
    │   ├── dns.conf
    │   ├── mail.conf
    │   ├── pouet.conf
    │   └── sympa.conf
    ├── coon.conf
    ├── galanga
    │   └── icinga2.conf
    └── maine.conf
</code>

===== Installation d'un bot IRC : Chatonic =====

Le bot s'appelle Chatonic et est présent sur le canal IRC [[irc://irc.libera.chat/#april-chapril|#april-chapril]] du réseau [[https://libera.chat/|Libera]].

Quelques informations :
  * Écrit en Python3 ;
  * Dépôt des sources : https://forge.april.org/adminsys/icingabot.

On va utiliser un l'API d'Icinga2. Pour activer l'API Icinga2 :

<code bash>
icinga2 feature enable api
</code>

Pour installer un //wrapper// IRC pour Python :

<code bash>
apt install python3-irc
</code>

==== Déploiement ====

Création d'un espace de déploiement :

<code bash>
mkdir /srv/chatonic
</code>

Clonage :

<code bash>
cd /srv/chatonic
git clone april@agir.april.org:/srv/git/chatonic git
</code>

<note important>Le chemin source du clonage peut être à revoir! Au pire, cloner chez soi et après copier via ''scp'' vers le serveur.
</note>

Déploiement du fichier de configuration :
<code bash>
mkdir /etc/chatonic/
cp /srv/chatonic/git/chatonic.conf /etc/chatonic/
ln -s /etc/chatonic/chatonic.conf /srv/chatonic/
</code>

Adapter le fichier ''/etc/chatonic/chatonic.conf'' :
  * mettre le mot de passe Icinga ;
  * …

Installer le service dans systemd :
<code bash>
# "linked unit" => ne sera pris en compte qu'au prochain redémarrage de systemd
ln -s /etc/systemd/system/chatonic.service /srv/chatonic/git/icingabot.service 
</code>


Configurer le lancement du service au //boot// :
<code bash>
systemctl enable chatonic
</code>
<code>
Created symlink /etc/systemd/system/multi-user.target.wants/chatonic.service → /etc/systemd/system/chatonic.service.
</code>

==== Journalisation ====

Des //logs// sont consultables via systemd :
<code bash>
journal -f -u chatonic
</code>

===== Désactivation de perfdata ======

À l'usage, le dossier ''/var/spool/icinga2/perfdata/'' se remplissait excessivement (plus de 5 Go). Normalement, les fichiers doivent y être traités dans la minute et là on avait plusieurs mois de fichiers.

Réponse du mainteneur officiel :
<code>
https://github.com/Icinga/icinga2/issues/5874#issuecomment-401687713
 dnsmichi commented on 2 Jul 2018

perfdata as a feature is disabled by default. There are some guides on the internet
which wrongly suggest that you need to enable perfdata in combination with influxdb
or graphite - our official documentation does not suggest that.

So, in any case, if you actively enable the perfdata feature, you need to ensure that
a collecting daemon is reading and purging the rotated files. If you don't have such,
you need not enable this feature.
</code>

Donc désactivation de ''perfdata'' :

<code bash>
icinga2 feature disable perfdata
rm -f /var/spool/icinga2/perfdata/*
</code>