Rol de Ansible para cliente Beats

Rol de Ansible para instalar y configurar clientes de elastic beats. Principalmente usado para enviar registros y métricas a un stack ELK. Por defecto, este rol enviará a logstash en la misma máquina usando filebeat y metricbeat.

Requisitos

• Un lugar donde enviar datos - a partir de la serie beats 5.x esto incluye el envío a file, kafka, redis, console, elasticsearch y/o logstash

Variables del Rol

Necesitarás un certificado SSL para cifrar los registros en tránsito hacia el logstash/elasticsearch. Esta lógica no es provista por este rol y el cifrado no está habilitado por defecto. Necesitarás consultar las guías de salida de la documentación oficial de beats para agregar esas opciones a través de variables.

Ejemplo de Playbook

- name: Configurar clientes beats.
  hosts: clients
  roles:
    - role: freedomofpress.beats
  tags: clients

Ejecutando las pruebas

Este rol utiliza Molecule y Testinfra para las pruebas. Para usarlo:

pip install -r requirements.txt
molecule test

También puedes ejecutar comandos selectivos:

molecule idempotence
molecule verify

Para iniciar una interfaz de usuario de elasticsearch para depuración, ejecuta:

make elastic-ui

Consulta la documentación de Molecule para más información.

Contribuciones

Los siguientes recursos fueron invaluables para crear este rol.

• geerlingguy.logstash
• Guía de ELK de DigitalOcean
• Guía de configuración de filebeat

Licencia

MIT