Rol de Ansible para FileBeat

Un rol de Ansible que instala FileBeat en Red Hat/CentOS o Debian/Ubuntu.

Probado en

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

Variables del rol

Las variables disponibles se enumeran a continuación, junto con sus valores predeterminados, como se define en defaults/main.yml.

Usuario y grupo de FileBeat. Si ejecutas FileBeat con un usuario que no sea root, asegúrate de que tus registros sean legibles por el usuario de FileBeat. Agrega al usuario de FileBeat a un grupo privilegiado, con acceso a tus registros.

En Ubuntu, añadirías el usuario al grupo adm. En CentOS, puedes ajustar los permisos con el comando setfacl, por ejemplo, sudo setfacl -m g:filebeat:r <ruta>.

filebeat_user: root
filebeat_group: root

Crear el usuario y grupo filebeat.

filebeat_create_user: true

Versión de FileBeat a utilizar.

filebeat_version: 6.3.0

Hacer uso del repositorio de FileBeat apt.

Puedes usar una URL para instalar una versión específica. Para ello, cambia el valor de filebeat_use_repo a false, y luego (opcionalmente) ajusta el valor de filebeat_package_baseurl (que ya tiene un valor predeterminado establecido para ti).

filebeat_use_repo: true

URL base de FileBeat para la descarga de paquetes si filebeat_use_repo: false

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

Iniciar FileBeat al arrancar.

filebeat_start_at_boot: true

Actualización de versión de FileBeat. Esta opción permite actualizaciones de paquetes.

filebeat_upgrade: false

Archivo de configuración de FileBeat.

filebeat_config_file: /etc/filebeat/filebeat.yml

Archivo de registro de FileBeat.

filebeat_config_registry_file: /var/lib/filebeat/registry

La configuración de FileBeat se construye en base a la variable filebeat_config. Para facilitar la gestión de los contenidos, la variable filebeat_config se compone de múltiples otras 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}}

Plantillas de FileBeat (una lista de plantillas para instalar). Estas plantillas serán copiadas al directorio /etc/filebeat y pueden ser utilizadas en la salida de elasticsearch, por ejemplo.

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

filebeat_templates: []

Uso

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

Licencia

Consulta Licencia

Información del autor

Este rol fue creado en 2016 por Emiliano Castagnari.