Rôle Ansible pour FileBeat

Un rôle Ansible qui installe FileBeat sur Red Hat/CentOS ou Debian/Ubuntu.

Testé sur

• EL / CentOS (6 / 7)
• Debian (Wheezy / Jessie)
• Ubuntu (Trusty / Xenial)
• Solaris

Variables du rôle

Les variables disponibles sont listées ci-dessous, avec leurs valeurs par défaut comme définies dans defaults/main.yml.

Utilisateur et groupe FileBeat. Si vous exécutez FileBeat avec un utilisateur autre que root, assurez-vous que vos journaux sont lisibles par l'utilisateur FileBeat. Ajoutez l'utilisateur FileBeat à un groupe privilégié, avec accès à vos journaux.

Sur Ubuntu, vous ajouteriez l'utilisateur au groupe adm. Sur CentOS, vous pouvez ajuster les permissions avec la commande setfacl, par exemple sudo setfacl -m g:filebeat:r <path>.

filebeat_user: root
filebeat_group: root

Créer l'utilisateur et le groupe filebeat.

filebeat_create_user: true

Version de FileBeat à utiliser.

filebeat_version: 6.3.0

Utiliser le dépôt apt de FileBeat.

Vous pouvez utiliser une URL pour installer une version spécifique. Pour ce faire, changez la valeur de filebeat_use_repo à false, puis (optionnel) ajustez la valeur de filebeat_package_baseurl (qui a une valeur par défaut pour vous).

filebeat_use_repo: true

URL de base pour le téléchargement du paquet si filebeat_use_repo: false

filebeat_deb_baseurl: "https://artifacts.elastic.co/downloads/beats/filebeat"

Démarrer FileBeat au démarrage.

filebeat_start_at_boot: true

Mise à niveau de version de FileBeat. Cette option permet les mises à niveau de paquets.

filebeat_upgrade: false

Fichier de configuration de FileBeat.

filebeat_config_file: /etc/filebeat/filebeat.yml

Fichier de registre de FileBeat.

filebeat_config_registry_file: /var/lib/filebeat/registry

La configuration de FileBeat est construite sur la base de la variable filebeat_config. Pour faciliter la gestion des contenus, la variable filebeat_config est composée de plusieurs autres variables :

• filebeat_config_prospectors
• filebeat_config_output
• filebeat_config_shipper
• filebeat_config_logging

filebeat_config_prospectors: |
  filebeat:
    prospectors:
      -
        input_type: log
        paths:
          - /var/log/*.log
        registry_file: "{{filebeat_config_registry_file}}"
filebeat_config_output: |
  output:
    elasticsearch:
      hosts: [ 'localhost:9200' ]
filebeat_config_shipper: |
  shipper:
filebeat_config_logging: |
  logging:
    files:
      rotateeverybytes: 10485760 # = 10MB
filebeat_config: |
  {{filebeat_config_prospectors}}
  {{filebeat_config_output}}
  {{filebeat_config_shipper}}
  {{filebeat_config_logging}}

Modèles FileBeat (une liste de modèles à installer). Ces modèles seront copiés dans le répertoire /etc/filebeat et peuvent être utilisés dans la sortie elasticsearch par exemple.

https://www.elastic.co/guide/en/beats/filebeat/current/elasticsearch-output.html#_template

filebeat_templates: []

Utilisation

    - hosts: logging
      roles:
        - { role: torian.filebeat }

Licence

Voir Licence

Informations sur l'auteur

Ce rôle a été créé en 2016 par Emiliano Castagnari.