{"id":13583839,"url":"https://github.com/geerlingguy/ansible-role-fluentd","last_synced_at":"2025-04-06T21:33:10.621Z","repository":{"id":38423603,"uuid":"248554661","full_name":"geerlingguy/ansible-role-fluentd","owner":"geerlingguy","description":"Ansible role - Fluentd (td-agent)","archived":true,"fork":false,"pushed_at":"2023-07-10T22:47:52.000Z","size":21,"stargazers_count":34,"open_issues_count":1,"forks_count":28,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-11-06T00:39:27.795Z","etag":null,"topics":["ansible","ansible-role","containers","efk","fluentd","logging","monitoring"],"latest_commit_sha":null,"homepage":"https://galaxy.ansible.com/geerlingguy/fluentd","language":"Jinja","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geerlingguy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":"geerlingguy","patreon":"geerlingguy"}},"created_at":"2020-03-19T16:41:15.000Z","updated_at":"2024-03-14T21:12:29.000Z","dependencies_parsed_at":"2024-01-14T10:00:19.802Z","dependency_job_id":"d7f5e7a5-f8fe-444f-b5a6-c323c6625bc4","html_url":"https://github.com/geerlingguy/ansible-role-fluentd","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fansible-role-fluentd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fansible-role-fluentd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fansible-role-fluentd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fansible-role-fluentd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geerlingguy","download_url":"https://codeload.github.com/geerlingguy/ansible-role-fluentd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247556602,"owners_count":20958005,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-role","containers","efk","fluentd","logging","monitoring"],"created_at":"2024-08-01T15:03:50.479Z","updated_at":"2025-04-06T21:33:10.326Z","avatar_url":"https://github.com/geerlingguy.png","language":"Jinja","funding_links":["https://github.com/sponsors/geerlingguy","https://patreon.com/geerlingguy"],"categories":["Jinja"],"sub_categories":[],"readme":"# Ansible Role: Fluentd\n\n[![CI](https://github.com/geerlingguy/ansible-role-fluentd/workflows/CI/badge.svg?event=push)](https://github.com/geerlingguy/ansible-role-fluentd/actions?query=workflow%3ACI)\n\nAn Ansible Role that installs Fluentd on RedHat/CentOS or Debian/Ubuntu. This role installs `td-agent`, which is a standalone version that doesn't require Ruby to be installed on the system separately. See [differences between td-agent and Fluentd here](https://www.fluentd.org/faqs).\n\n## Requirements\n\nN/A\n\n## Role Variables\n\nAvailable variables are listed below, along with default values (see `defaults/main.yml`):\n\n    fluentd_version: 3\n\nThe `td-agent` version to install. See more details about the [differences between v2, v3, and v4](https://docs.fluentd.org/quickstart/td-agent-v2-vs-v3-vs-v4).\n\n    fluentd_package_state: present\n\nThe `td-agent` Fluentd package state; set to `latest` to upgrade or change versions.\n\n    fluentd_service_name: td-agent\n    fluentd_service_state: started\n    fluentd_service_enabled: true\n\nControls the Fluentd service options.\n\n    fluentd_plugins:\n      - fluent-plugin-elasticsearch\n\n    # Alternative format:\n    fluentd_plugins:\n      - name: fluent-plugin-elasticsearch\n        version: '4.0.6'\n        state: present\n\nA list of Fluentd plugins to install.\n\n    fluentd_conf_sources: |\n      [see defaults/main.yml for default content]\n\n    fluentd_conf_filters: |\n      [see defaults/main.yml for default content]\n\n    fluentd_conf_matches: |\n      [see defaults/main.yml for default content]\n\nThe configuration which will be placed into the `td-agent.conf` file which controls how Fluentd listens for, filters, and routes log data. The defaults set up some basic options which can direct data to Treasure Data, but you should override these values with what's appropriate for your logs.\n\nFor example, if you want to monitor an Apache HTTP server's access log, you would add a source:\n\n    fluentd_conf_sources: |\n      \u003csource\u003e\n        @type tail\n        @id input_tail\n        \u003cparse\u003e\n          @type apache2\n        \u003c/parse\u003e\n        path /var/log/httpd-access.log\n        tag apache.access\n      \u003c/source\u003e\n\nAnd then you could route `apache` log entries to Elasticsearch using:\n\n    fluentd_conf_matches: |\n      \u003cmatch apache.**\u003e\n        @type elasticsearch\n        host log.example.com\n        port 9200\n        user myuser\n        password mypassword\n        logstash_format true\n      \u003c/match\u003e\n\nNote that Elasticsearch would require the Fluentd plugin `fluent-plugin-elasticsearch` to be installed.\n\n## Dependencies\n\nN/A\n\n## Example Playbook\n\n```yaml\n- hosts: search\n\n  vars:\n    fluentd_conf_sources: |\n      \u003csource\u003e\n        @type tail\n        @id input_tail\n        \u003cparse\u003e\n          @type apache2\n        \u003c/parse\u003e\n        path /var/log/httpd-access.log\n        tag apache.access\n      \u003c/source\u003e\n\n  roles:\n    - geerlingguy.fluentd\n```\n\n## License\n\nMIT / BSD\n\n## Author Information\n\nThis role was created in 2020 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeerlingguy%2Fansible-role-fluentd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeerlingguy%2Fansible-role-fluentd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeerlingguy%2Fansible-role-fluentd/lists"}