nephelaiio.metricbeat

This is an Ansible role for installing and setting up Metricbeat.

Role Variables

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

Dependencies

• nephelaiio.elastic_repo

Look at the dependency configuration for more information.

Example Playbook

You can configure Metricbeat in three main ways using this module:

1. No configuration management (helpful for upgrades)

- hosts: servers
  vars:
    metricbeat_package_state: latest
    metricbeat_conf_manage: no
  roles:
     - role: nephelaiio.metricbeat

2. Default configuration, detects active modules from installed packages automatically

- hosts: servers
  vars:
    metricbeat_conf_docker_hosts:
      - unix:///var/run/docker.sock
    metricbeat_conf_postgresql_hosts:
      - postgres://localhost:5432
    metricbeat_conf_postgresql_user: root
    metricbeat_conf_postgresql_pass: pass
    metricbeat_conf_nginx_hosts:
      - http://127.0.0.1
    metricbeat_conf_nginx_status_path: nginx_status
  roles:
     - role: nephelaiio.metricbeat

3. Custom configuration, applies the configuration exactly as written

- hosts: servers
  vars:
    metricbeat_conf: "{{ lookup('template', 'template.j2.yml') | from_yaml }}"
  roles:
     - role: nephelaiio.metricbeat

Testing

Make sure you have Docker installed to run role validation tests. Additional Python dependencies are listed in the requirements file.

This role is tested on 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 make test.

License

This project is licensed under the MIT License.