13,616
stars
1,413
forks
324
watchers
2,758
prs
2,253
issues
28
releases
README
Fluentd: Open-Source Log Collector
===================================
Fluentd collects events from various data sources and writes them to files, RDBMS, NoSQL, IaaS, SaaS, Hadoop and so on. Fluentd helps you unify your logging infrastructure (Learn more about the Unified Logging Layer).
Quick Start
$ gem install fluentd
$ fluentd -s conf
$ fluentd -c conf/fluent.conf &
$ echo '{"json":"message"}' | fluent-cat debug.test
Development
Branch
- master: For v1 development.
- v0.12: For v0.12. This is a deprecated version. we already stopped supporting (See https://www.fluentd.org/blog/drop-schedule-announcement-in-2019).
Prerequisites
- Ruby 3.3 or later
- git
git should be in PATH. On Windows, you can use Github for Windows and GitShell for easy setup.
Install dependent gems
Use bundler:
$ gem install bundler
$ bundle config set --local path vendor/bundle
$ bundle install
Run test
$ bundle exec rake test
You can run specified test via TEST environment variable:
$ bundle exec rake test TEST=test/test_specified_path.rb
$ bundle exec rake test TEST=test/test_.rb
More Information
- Website: https://www.fluentd.org/
- Documentation: https://docs.fluentd.org/
- Project repository: https://github.com/fluent
- Discussion: https://github.com/fluent/fluentd/discussions
- Slack / Community: https://slack.fluentd.org
- Newsletters: https://www.fluentd.org/newsletter
- Author: Sadayuki Furuhashi
- Copyright: 2011-2021 Fluentd Authors
- License: Apache License, Version 2.0
Security
A third party security audit was performed by Cure53, you can see the full report here.
See SECURITY to contact us about vulnerability.
Contributors:
Patches contributed by great developers.Top issues
#660Log file fills up with error: "incoming chunk is broken" after about 24 hours of heavy traffic using 2.2.1 on linux67 comments · 2015-08-19#4758Update Forward Protocol Specification for zstd compression support48 comments · 2025-01-06#4693Logs missing during heavy log volume27 comments · 2024-11-03#5166out_forward plugin starts sending invalid packets22 comments · 2025-11-24#4567Error event logs should include plugin id20 comments · 2024-07-26#4222Json parser can not apply `null_value_pattern` to nested values18 comments · 2023-06-29#4558Bind to all network interfaces for both IPv4 and IPv616 comments · 2024-07-15#4648Replace WEBrick because it is no longer recommended for production use14 comments · 2024-09-26
Discussions
#5578Fluent Package v6.1.00 comments · 2026-10-29#5510Fluent Package LTS v6.0.50 comments · 2026-09-29#5485[Q&A] CVE-2026-13221 (perl v5.40.1) in fluentd:v1.19.3-debian-1.03 comments · 2026-09-03#5457[Q&A] Questions about CVE-2026_41316 in fluent-package v6.0.42 comments · 2026-07-27#5438[Q&A] CloudWatch Logs cost increased 5x after upgrading Fluentd Kubernetes DaemonSet image from v1.15.3 to v1.18.01 comments · 2026-07-16#5399Fluent Package LTS v6.0.40 comments · 2026-06-29#5302Fluent Package LTS v6.0.30 comments · 2026-03-27#5266Fluent Package LTS v6.0.20 comments · 2026-02-27
Latest release
Fluentd v1.20.1 v1.20.1 2026-10-26[!IMPORTANT] Fluentd no longer depends on yajl-ruby, because yajl-ruby cannot be built on Ruby 4.1. Plugin authors: if your plugin uses require 'yajl', please migrate to the json gem. If you keep using yajl-ruby, declare it in your gemspec. Users: if you see LoadError: cannot load such file -- yajl, add yajl-ruby to your Gemfile. This works only on Ruby 4.0 or earlier. Bug Fix https://github.com/fluent/fluentd/pull/5574 gem: remove yajl-ruby from runtime dependencies for Ruby 4.1 Plugins that require 'yajl' need to declare yajl-ruby in their own gemspec. If you see Lo