diff --git a/HowtoFluentd.md b/HowtoFluentd.md new file mode 100644 index 00000000..fbad168f --- /dev/null +++ b/HowtoFluentd.md @@ -0,0 +1,66 @@ +--- +title: Howto Fluentd +categories: log sysadmin +... + +* Site officiel : +* Documentation : +* Code source : + +[Fluentd](https://www.fluentd.org/) est un outil de collecte de données développé à l'origine par Treasure Data. Il est principalement écrit dans le langage de programmation Ruby. + +## Principe + +Fluentd est un outil Big Data pour des ensembles de données semi-structurés ou non structurés. Comme Apache Kafka, il analyse les journaux des événements et les journaux des applications. Selon Suonsyrjä et Mikkonen, "l'idée principale de Fluentd est d'être la couche unificatrice entre différents types d'entrées et de sorties de log". + +## Installation + +Sous Debian + +On configure d'abord [apt](https://wiki.evolix.org/HowtoDebian/Packages) : + +~~~ +curl https://packages.treasuredata.com/GPG-KEY-td-agent | apt-key add - +echo "deb http://packages.treasuredata.com/3/debian/stretch/ stretch contrib" > /etc/apt/sources.list.d/treasure-data.list +~~~ + +Puis on installe le paquet td-agent qui se veut être la version stable fournie par Treasure Data. + +~~~ +# apt update && apt install td-agent +~~~ + +## Utilisation de base + +Lancer le démon : + +~~~ +# systemctl start td-agent.service +# systemctl status td-agent.service +~~~ + +Par défaut, le démon est configuré pour capturer les logs HTTP et les renvoyer vers stdout (/var/log/td-agent/td-agent.log). + +On peut tester à l'aide la commande [curl](https://wiki.evolix.org/HowtocURL) : + +~~~ +$ curl -X POST -d 'json={"json":"message"}' http://localhost:8888/debug.test +~~~ + +## Configuration + +Le fichier de configuration est disponible dans */etc/td-agent/td-agent.conf* + +Après avoir édité ce fichier, vous devez redémarrer td-agent en utilisant systemctl: + +~~~ +# systemctl restart td-agent +~~~ + +## Logs + +Par défaut, td-agent écrit ses logs dans le fichier */var/log/td-agent/td-agent.log* + +## Liens + +* [Post installation guide](https://docs.fluentd.org/v1.0/articles/post-installation-guide)