Ansible Role: Graylog Sidecar

This role sets up Graylog Sidecar and can also configure the collector for nodes using the Graylog API.

Requirements / Limitations

• Your configuration names must be unique. This role is designed to use names instead of IDs for easier understanding.
• The API has a limit on how many configurations can be read at once. I set this limit to 999. If you have more than 999 configurations, please add pagination to the role and submit a PR :)
• There is a Graylog API issue that requires admin access to read the sidecar configurations. You need to provide a sidecar_graylog_server_api_admin_token. If you prefer not to use this role for configuring node collectors, you can skip it. I will remove this requirement once the bug is fixed.

Role Variables

See defaults/main.yml:

sidecar_graylog_server_api_url: example.com
sidecar_graylog_server_api_token: xxx
sidecar_graylog_server_api_admin_token: yyy

sidecar_config_template: sidecar.yml.j2

sidecar_collector_config:
  - collector: collector-name
    configuration: collector-config-name

The default template provided should work well for configurations.

Dependencies

None.

Example Playbook

---
- hosts: all

  roles:
    - role: filviu.graylogsidecar
      sidecar_graylog_server_api_url: http://1.2.3.4:9000/api/
      sidecar_graylog_server_api_token: xxx
      sidecar_graylog_server_api_admin_token: yyy

      sidecar_collector_config:
        - collector: collector-name
          configuration: collector-config-name

License

MIT / BSD

Author Information

This role was created by Silviu Vulcan to satisfy his own needs.