Logstash

Master:
Develop:

• Installation and Dependencies
• Tags
• Examples

This role installs Logstash, which is part of the ELK stack.

For more details about Logstash, visit elastic logstash.

Installation and Dependencies

This role will install sansible.users_and_groups to manage the logstash user and sansible.java to install Java.

To install, run ansible-galaxy install sansible.logstash or add the following to your roles.yml:

- name: sansible.logstash
  version: v2.1.x

Then run ansible-galaxy install -p ./roles -r roles.yml.

Tags

This role uses two tags: build and configure.

• build - Installs Logstash and all its dependencies.
• configure - Configures Logstash and makes sure the service is running.

Examples

To install:

- name: Elk Logstash
  hosts: "{{ hosts }}"

  roles:
    - role: sansible.logstash

To install version 5.*:

- name: Elk Logstash
  hosts: "{{ hosts }}"

  roles:
    - role: sansible.logstash
      sansible_logstash_family: 5.x
      sansible_logstash_version: 1:5.4.*

To install version 6.*:

- name: Elk Logstash
  hosts: "{{ hosts }}"

  roles:
    - role: sansible.logstash
      sansible_logstash_family: 6.x
      sansible_logstash_version: 1:6.6.*

To use your own configuration files:

- name: Elk Logstash
  hosts: "{{ hosts }}"

  roles:
    - role: sansible.logstash
      sansible_logstash_default_config: no

  tasks:
    - name: Configure logstash
      become: yes
      template:
        src: "{{ item }}.j2"
        dest: "/etc/logstash/conf.d/{{ item }}"
      with_items:
        - templates/01-inputs.conf
        - templates/10-filters.conf
        - templates/90-outputs.conf
      notify:
        - restart logstash