c16154c697e43a2eed71311deab0220bb85ec905
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 |