Différences

Ci-dessous, les différences entre deux révisions de la page.

--- logstash [2014/04/01 06:43] – [Configuration] madko
+++ logstash [2014/04/18 11:57] (Version actuelle) – [Configuration] madko
@@ Ligne 73: / Ligne 73: @@
 <file>
+# Ouverture en entrée d'un port d'écoute utilisant le protocol syslog
 input {
   tcp {
@@ Ligne 85: / Ligne 86: @@
 filter {
-  # Process syslog
+  # Traitement type syslog, le type étant marqué sur les données entrant par nos ports de type syslog
   if [type] == "syslog" {
     grok {
-      overwrite => "message"
+      # Si on ne veut pas garder le message non traité
-      match => {
+      overwrite => "message"
-        "message" => "^(?:<%{POSINT:syslog_pri}>)?%{SYSLOGBASE2} %{GREEDYDATA:message}"
+        # rsyslong envoi des messages de type : <Numero>Ligne Syslog avec le message
-      }
+      match => {
+        "message" => [ "^(?:<%{NONNEGINT:syslog_pri}>)?%{SYSLOGBASE2} %{GREEDYDATA:message}", "^(?:<%{NONNEGINT:syslog_pri}>)(?:%{SYSLOGTIMESTAMP:timestamp}|%{TIMESTAMP_ISO8601:timestamp8601}) %{SYSLOGHOST:logsource} %{DATA:program}:%{GREEDYDATA:message}" ]
+      }
+      # on ajoute des tags perso, pratique pour filtrer dans l'interface kibana
       add_tag => [ "syslog", "grokked" ]
     }
+    # On ignore le champ syslog_pri
     syslog_pri { }
+    # on crée une colonne hostip avec le contenu de la variable host
     mutate {
       add_field => [ "hostip", "%{host}" ]
     }
+    # on resoud l'ip présent dans la colonne host
     dns {
       reverse => [ "host" ]
@@ Ligne 107: / Ligne 114: @@
 }
+# on stock dans elasticsearch
 output {
   elasticsearch {
@@ Ligne 117: / Ligne 125: @@
-Le broker va servir de cache pour la reception des logs. Cela améliore les performances de logstash et permet d'éviter de perdre certains logs en cas de soucis.
+Le broker va servir de cache pour la reception des logs. Cela améliore les performances de logstash et permet d'éviter de perdre certains logs en cas de soucis. Mais le principal intérêt est de pouvoir utiliser l'agent logstash sur les clients pour envoyer des évènements qui ne seraient pas gérés par rsyslog.
-Il est possible d'utiliser "redis" comme broker en frontal de logstash.
+En gros l'agent logstash envoi ces données préparsées dans la base du broker. Ensuite le logstash sur le collecteur lit régulièrement le broker pour voir si des évènements sont arrivés. Il les supprime du broker et les traite.
+Logstash agent => Broker (sur collecteur) <= logstash serveur
+Il est possible d'utiliser "redis" comme broker en frontal de logstash.
 ==== Installation de redis ====
@@ Ligne 129: / Ligne 142: @@
+<code>
 yum install redis
+</code>
 ==== Configuration de redis ====
@@ Ligne 136: / Ligne 150: @@
 Par défaut redis n'écoute que sur 127.0.0.1. Son fichier de configuration est /etc/redis.conf. Il faut changer la ligne bind 127.0.0.1.
+==== Configuration du logstash agent ====
+Logstash sur un noeud à monitorer est dit agent. En entrée il surveille des fichiers de logs (souvent non gérés par syslog), et en sortie envoi le résultat sur le logstash (ou broken) sur le collecteur.
+Exemple de configuration pour parser un fichier de log puppet:
+<file>
+input {
+  file {
+    path => "/var/log/puppet/puppet.log"
+    type => "puppet"
+  }
+filter {
+  if [type] == "puppet" {
+    # Ex: Tue Mar 25 18:07:07 +0100 2014 Puppet (notice): Finished catalog run in 51.85 seconds
+    mutate { replace => { "type" => "puppet" } }
+    grok {
+      overwrite => "message"
+      match => {
+        "message" => "%{DAY} %{MONTH} %{MONTHDAY} %{TIME} %{ISO8601_TIMEZONE} %{YEAR} %{DATA:puppet_module} \(%{DATA:puppet_loglevel}): %{GREEDYDATA:message}"
+      }
+      add_tag => [ "puppet", "grokked" ]
+    }
+  }
+output {
+}
+</file>
+==== Configuration du logstash collecteur ====
+Le serveur logstash centralisant les logs a juste besoin d'une nouvelle entrée lui indiquant qu'il doit passer par un broker de type redis, en lui précisant son adresse:
+CONF ICI