Monitoring/Icinga.md
... ...
@@ -32,6 +32,16 @@ Relancer Icinga2 :
32 32
systemctl restart icinga2
33 33
```
34 34
35
+Préférer le rechargement :
36
+```
37
+systemctl reload icinga2
38
+```
39
+
40
+Vérifier que la configuration est valide :
41
+```
42
+icinga2 daemon --validate
43
+```
44
+
35 45
## Installation et configuration
36 46
37 47
### Installation
... ...
@@ -52,6 +62,8 @@ Une fois icinga2 installé et configuré, terminer en installant l'interface web
52 62
apt-get install icingaweb2
53 63
```
54 64
65
+Pour avoir plus de détails sur la configuration, référez vous à la documentation sur le site officiel d'Icinga2, qui sera à jour.
66
+
55 67
### Architecture
56 68
57 69
Icinga2 permet très facilement de profiter de fonctionnalités de Haute Disponibilité, de monitoring distribué et de synchronisation des configurations sur plusieurs serveurs, et c'est ce genre d'architecture qui a été mis en place au ResEl pour : décharger Hera, avoir encore du monitoring en cas de perte du I11, ou du lien Brest-Rennes par exemple.
... ...
@@ -198,13 +210,29 @@ Pour compiler, mettre à jour, etc.. les sources se trouvent dans `/root/icinga-
198 210
* API
199 211
200 212
#### Utiliser l'API pour récupérer des informations
201
-*TODO*
213
+Snippet de code Python, pour avoir les identifiants se référer au fichier `api-user.conf` dans `/etc/icinga2/features-available/api-user.conf`.
214
+Par exemple, pour récupérer des informations de statut assez complètes :
215
+```
216
+ proxies = {
217
+ "http": None,
218
+ "https": None,
219
+ }
220
+ r = requests.get('https://icinga.resel.fr:5666/v1/status/CIB', auth=('', ''), headers={'Accept': 'application/json'}, proxies=proxies)
221
+ res = r.json()
222
+
223
+```
202 224
203 225
#### Prévoir une maintenance
204
-*TODO*
226
+Sur l'interface web, sélectionnez un hôte et sélectionnez le lien `Downtime` (thanks captain).
227
+N'oubliez pas de préciser la raison dans le commentaire, si possible faites un lien vers l'issue Gitlab associée.
228
+Dans la plupart des cas, sélectionnez aussi `All services`.
229
+
230
+Vous pouvez aussi être plus sélectif et ne mettre en maintenance qu'un service.
205 231
206 232
#### Icingaweb2
207
-*TODO*
233
+* Adresse : https://icinga.resel.fr
234
+* Se connecter avec ses identifiants d'admin ResEl
235
+ * Vous devez posséder le droit `icingaweb`
208 236
209 237
## F.A.Q
210 238