Monitoring/InfluxDB.md
... ...
@@ -59,19 +59,80 @@ TODO:
59 59
- (ouvrir ticket) Voir les autres options
60 60
- (ouvrir ticket) Amélioration de la conf pour la monté en charge
61 61
62
-## Ajout d'un serveur à telegraf (avec Ansible et sans)
62
+## Ajout d'un serveur à telegraf
63 63
64
-Telegraf est un service en *push*, c'est à dire qu'il faut installer un client sur toutes les machines monitorées qui vont envoyer les données à la base de données centrale (InfluxDB sur DGSI).
64
+### Avec Ansible (recommandé)
65
+
66
+Telegraf est un service en *push*, c'est à dire qu'il faut installer un client sur toutes les machines
67
+monitorées qui vont envoyer les données à la base de données centrale (InfluxDB sur DGSI).
65 68
66 69
Pour la plupart des services la configuration ResEl par défaut est suffisante. Pour la lancer il faut ajouter
67 70
le serveur au groupe `servers` (dans le LDAP) puis lancer le playbook `telegraf.yml` sur loustic.
68 71
72
+### À la main (au cas où)
73
+
74
+[en résumé suivre la doc Telegraf](https://docs.influxdata.com/influxdb/v1.2/introduction/installation/)
75
+
76
+Ajouter la source InfluxData
77
+```
78
+curl -sL https://repos.influxdata.com/influxdb.key | sudo apt-key add -
79
+source /etc/os-release
80
+test $VERSION_ID = "7" && echo "deb https://repos.influxdata.com/debian wheezy stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
81
+test $VERSION_ID = "8" && echo "deb https://repos.influxdata.com/debian jessie stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
82
+```
83
+
84
+Installer et démarrer le service
85
+```
86
+sudo apt-get update && sudo apt-get install telegraf
87
+sudo systemctl start telegraf
88
+```
89
+
90
+### Configuration par défaut
91
+
92
+Pour la plupart des services la configuration par défaut de Telegraf devrait suffire. Si vous n'avez pas
93
+utilisé Ansible pour créer la configuration vous devez rentrer les crédits de InfluxDB.
94
+
95
+Éditez le fichier `/etc/telegraf/telegraf.conf` en changeant les lignes suivantes :
96
+```
97
+[[outputs.influxdb]]
98
+ urls = [ "http://dgsi.adm.resel.fr:8086" ] # required
99
+ database = "telegraf" # required
100
+ precision = "s"
101
+ retention_policy = "autogen"
102
+ timeout = "5s"
103
+ username = "telegraf"
104
+ password = "<passwd>"
105
+```
106
+
107
+TODO :
108
+ - (ouvrir ticket) auto personnalisation
109
+
110
+### Personnalisation de la configuration
111
+
112
+Si vous désirez ajouter la configuration de plugins qui ne sont pas dans la configuration par défaut et
113
+que vous désirez que celle-ci ne soit pas effacée par Ansible vous devez l'ajouter dans le dossier
114
+`/etc/telegraf/telegraf.d/`
115
+
116
+Par exemple si vous voulez une configuration nginx en plus, créez le fichier `/etc/telegraf/telegraf.d/nginx.conf` :
117
+```
118
+[[inputs.nginx]]
119
+ urls = ["http://lancache-steam/status", "http://lancache-blizzard/status", "http://lancache-riot/status", "http://lancache-sony/status", "http://lancache-microsoft/status"]
120
+```
121
+
122
+Vous pouvez retrouver documentation de la configuration des plugins sur le
123
+[repo de Telegraf](https://github.com/influxdata/telegraf)
69 124
125
+### Plugin shell (exécution de scripts arbitraires)
70 126
71
-### Conf par défaut
127
+Il est possible de créer des plugins pour Telegraf à partir de scripts arbitraires
128
+Pour ceci suivez [la doc officielle](https://github.com/influxdata/telegraf/tree/master/plugins/inputs/exec)
72 129
73
-### Plugins telegraf et personnalisation
130
+TODO:
131
+ - (ouvrir ticket) migrer ou wrapper les scripts de Echelon
132
+ -
74 133
134
+TODO (rédacteur)
135
+ - Détails d'un script minimal (pour l'exemple illustratif au ResEl)
75 136
76 137
## notions de base sur Grafana et astuces (le reste pouvant se trouver au clique)
77 138