Elasticsearch:Fichiers de configuration Logstash

# Use comments to describe parts of your configuration.
input {
  ...
}

filter {
  ...
}

output {
  ...
}

input {
  beats {
    port => 8000
    host => "118.11.xx.xx"
  }

  beats {
    port => 8001
    host => "192.168.xx.xx"
  }
}

Tableau (Array)

L'utilisation de ce type n'est pas recommandée. Privilégiez le type String ou utilisez :list => true pour activer la vérification de type sur les listes. Les tableaux (arrays) ne s'avèrent utiles que lorsque vous devez gérer des tables de hachage ou des listes de types mixtes ne nécessitant pas de vérification de type.

users => [ {id => 1, name => bob}, {id => 2, name => jane} ]

Liste

Une liste (List) ne constitue pas un type autonome, mais un attribut de propriété. Déclarez un paramètre avec :list => true pour autoriser plusieurs valeurs tout en activant la vérification de type. Si une valeur de la liste est invalide (par exemple, une URL incorrecte), le traitement de l'événement échoue.

path => [ "/var/log/messages", "/var/log/*.log" ]
uris => [ "http://elastic.co", "http://example.net" ]

Booléen

Les valeurs booléennes doivent être true ou false, sans guillemets.

ssl_enable => true

Octet (Byte)

Une valeur Byte est une chaîne représentant un nombre d'octets. Les unités décimales (k, M, G, T, P, E, Z, Y, base 1000) et binaires (Ki, Mi, Gi, Ti, Pi, Ei, Zi, Yi, base 1024) sont prises en charge. La valeur n'est pas sensible à la casse et accepte un espace entre le nombre et l'unité. Si vous omettez l'unité, l'entier est traité comme un nombre d'octets.

my_bytes => "1113"   # 1113 bytes
my_bytes => "10MiB"  # 10485760 bytes
my_bytes => "100kib" # 102400 bytes
my_bytes => "180 mb" # 180000000 bytes

Codec

Un codec est un plug-in qui encode ou décode les données. Les codecs fonctionnent à la fois avec les plug-ins d'entrée et de sortie :

• Un codec d'entrée décode les données avant qu'elles n'entrent dans le pipeline.

• Un codec de sortie encode les données avant qu'elles ne quittent le pipeline.

L'utilisation d'un codec élimine le besoin d'un plug-in de filtrage distinct. Pour connaître les codecs disponibles, consultez la rubrique Plug-ins codec.

codec => "json"

Hachage (Hash)

Une valeur Hash est une collection de paires clé-valeur au format "field1" => "value1".

match => {
  "field1" => "value1"
  "field2" => "value2"
  ...
}
# Or as a single line. No commas between entries:
match => { "field1" => "value1" "field2" => "value2" }

Numérique

Les valeurs numériques doivent être des nombres à virgule flottante ou des entiers.

port => 33

Mot de passe

Un mot de passe (Password) est une chaîne à valeur unique qui n'est jamais journalisée ni affichée.

my_password => "password"

URI

Une URI peut aller d'une URL complète à un identifiant simple tel que foobar. Si l'URI contient un mot de passe (par exemple http://user:paas@example.net), ce dernier n'est jamais journalisé ni affiché.

my_uri => "http://foo:bar@example.net"

Chemin d'accès

Une valeur Path est une chaîne représentant un chemin d'accès valide dans le système d'exploitation.

my_path => "/tmp/logstash"

Chaîne (String)

Une valeur String est une séquence unique de caractères encadrée par des guillemets doubles (") ou simples (').

Séquences d'échappement

Les séquences d'échappement sont désactivées par défaut. Pour les activer, ajoutez la ligne suivante au fichier logstash.yml :

config.support_escapes: true

Lorsque les séquences d'échappement sont activées, les chaînes entre guillemets (simples ou doubles) prennent en charge les caractères d'échappement suivants :

Exemple :

name => 'It\'s a beautiful day'

Commentaires

Un commentaire commence par # et peut apparaître n'importe où sur une ligne, pas seulement au début.

# This is a full-line comment.

input { # This is an inline comment.
  # ...
}