nephelaiio.filebeat

An Ansible role for installing and configuring Filebeat.

Role Variables

For a current list of input parameters, check the defaults file.

Dependencies

• nephelaiio.elastic_repo

For more details, see the dependency configuration.

Example Playbook

- name: Deploy filebeat
  hosts: servers
  vars:
    filebeat_package_state: latest
    filebeat_conf_manage: true
    filebeat_conf:
      fields:
        environment: development
      inputs:
        - type: log
          paths:
            - /var/log/system.log
            - /var/log/wifi.log
        - type: log
          paths:
            - "/var/log/nginx/*.log"
          fields:
            application: nginx
      output:
        elasticsearch:
          enabled: true
          hosts:
            - http://localhost:9200
      setup:
        dashboards:
          enabled: true
          beat: filebeat
          always_kibana: true
        template:
          enabled: true
        kibana:
          host: http://localhost:80
  roles:
     - role: nephelaiio.filebeat

Testing

Make sure you have Docker installed to run the role validation tests. Additional Python dependencies can be found in the requirements file.

The role is tested with the following distributions (Docker images):

• Ubuntu Jammy
• Ubuntu Focal
• Debian Bookworm
• Debian Bullseye
• Rocky Linux 9

You can test the role directly from the source using the command molecule test.

License

This project is licensed under the terms of the MIT License.