beats
ansible-beats
Installs and configures a specified Beat instance.
https://www.elastic.co/guide/en/beats/filebeat/current/index.html
Requirements
- Ansible 2.x
Role Variables
| Variable | required | default | comments |
|---|---|---|---|
| BEAT_TYPE | no | "metricbeat" | The name of the beat to install. The list of supported_beats is defined in the role vars. |
| beat_install | no | true | A flag used to control whether the role should perform installation steps. |
| beat_config | no | When defined, the child yaml is used to populate the beat's config file. If undefined, the config file is unchanged.* |
|
| beat_svc_state | no | When defined, corresponds to the desired state parameter of Ansible's Service Module. |
|
| beat_svc_enabled | no | When defined, corresponds to the desired enabled parameter of Ansible's Service Module. |
|
| beat_cfg_file | no | {{BEAT_TYPE}}.yml | If defined, sets the name for the config file. |
| beat_version | no | If defined, will install the specified version. |
*: You are able to use config file namespacing when defining the beat_config variable, but it is not suggested.
Dependencies
None
Example Playbooks
To install metricbeat with default configuration:
- hosts: myhosts
vars:
roles:
- role: cyverse.beats
To install metricbeat with specified configuration:
- hosts: myhosts
vars:
beat_config:
metricbeat.modules:
- module: system
metricsets:
- cpu
- filesystem
- memory
- network
- process
enabled: true
period: 10s
processes: ['.*']
cpu_ticks: false
- module: apache
metricsets: ["status"]
enabled: true
period: 1s
hosts: ["http://127.0.0.1"]
output.elasticsearch:
hosts: ["127.0.0.1:9200"]
roles:
- role: cyverse.beats
To install filebeat with specified configuration:
- hosts: myhosts
vars:
BEAT_TYPE: filebeat
beat_config:
...
roles:
- role: cyverse.beats
License
See LICENSE.txt
Author Information
About
A role to install and configure Elasticsearch Beats.
Install
ansible-galaxy install CyVerse-Ansible/ansible-beatsLicense
other
Downloads
397
Owner