Nombre del rol

Este rol instala productos de Beats en una máquina Ubuntu.

Este rol puede instalar productos de Beats disponibles como paquetes deb. Sin embargo, para configurar productos de Beats (por ejemplo, filebeat.yml, metricbeat.yml), los únicos productos compatibles hasta ahora son:

• filebeat
• metricbeat

Requisitos

Ninguno

Variables del rol

Debes especificar la versión de los productos de Beats que deseas instalar con la variable beats_version (por defecto: 6.7.2).

beats_version: 6.7.2

También necesitas especificar los productos que deseas instalar en una variable de lista llamada beats_products (por defecto: []):

beats_products:
  - filebeat
  - metricbeat

Si deseas mantener los paquetes de Beats en APT para que no se actualicen (por defecto: verdadero), puedes usar la variable beats_hold_products:

beats_hold_products: true

Si también deseas configurar los productos sobre la marcha, necesitarás crear una variable con el nombre del producto más _config: que debe ser un diccionario que contenga la configuración YAML para el producto que elijas. Por ejemplo:

filebeat_config:
  filebeat.modules:
    - module: system
      syslog:
        enabled: true
  output.logstash.hosts:
    - logstash.server:5044

metricbeat_config:
  metricbeat.modules:
    - module: system
      metricsets: ["cpu","memory","network"]
      enabled: true
      period: 15s
      processes: ['.*']
  output.logstash.hosts:
    - logstash.server:5044

Los valores específicos para la configuración están bien descritos en la documentación de Beats.

Dependencias

No hay dependencias.

Ejemplo de Playbook

Incluir un ejemplo de cómo usar tu rol (por ejemplo, con variables pasadas como parámetros) también es útil para los usuarios:

- hosts: servers
  become: true
  roles:
    - role: jobscore.beats
      beats_version: 6.7.2
      beats_products:
        - filebeat
        - metricbeat
      filebeat_config:
        filebeat.modules:
          - module: system
            syslog:
              enabled: true
        output.logstash.hosts:
          - logstash.server:5044
      metricbeat_config:
        metricbeat.modules:
          - module: system
            metricsets: ["cpu","memory","network"]
            enabled: true
            period: 15s
            processes: ['.*']
        output.logstash.hosts:
          - logstash.server:5044

Licencia

GPLv3

Información del autor

Este rol fue creado por Eric Magalhães