Ansible Role: Graylog Sidecar

This role sets up Graylog Sidecar and can also configure the collector for the node(s) using the Graylog API.

Requirements / Limitations

• Each configuration must have a unique name. This role is designed to use names instead of IDs for easier reading.
• There is a limit on the number of configurations that can be read at once, set to 999. If you have more than 999 collector configurations, please modify the role to handle pagination and submit a pull request.
• Due to a Graylog API issue, you need admin access to read sidecar configurations. Therefore, you must provide a sidecar_graylog_server_api_admin_token. If you prefer not to set up node collectors with this role, you can skip it. I will remove this requirement if the bug is fixed.

Role Variables

Check defaults/main.yml for these variables:

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

You can use the provided template file for configuration; it should work well.

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 address his own needs.