Role Name

This role installs Beats products on a Ubuntu machine.

This role can install all Beats products that are available as .deb packages. However, for setting up Beats products (like filebeat.yml and metricbeat.yml), the only products supported so far are:

• filebeat
• metricbeat

Requirements

None

Role Variables

You need to provide the version of the Beats products you want to install using the beats_ver variable (default: 6.2.2).

You also need to list the products you want to install in a variable called products:

products:
  - filebeat
  - metricbeat

If you want to set up the products while installing, create a variable with the product name plus _config:. This should be a dictionary containing the YAML configuration for that product. For example:

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

You can find specific configuration values in the Beats documentation.

Dependencies

There are no dependencies.

Example Playbook

Here's an example of how to use this role (with variables passed in as parameters):

- hosts: servers
  roles:
     - role: jobscore.beats
       products:
        - filebeat
        - metricbeat
        - heartbeat

License

GPLv3

Author Information

This role was created by Eric Magalhães.