fluent /fluentd

Fluentd: Unified Logging Layer (project under CNCF)

★ 13,616⑂ 1,413👁 324⑃ 2,758● 2,253▤ 28
RubyApache-2.0Created 2011-06-19www.fluentd.org
Download: Fluentd v1.20.1Fluentd-1.20.1 ↓1.20.12026-10-26
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

Discussions

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

Snapshot: 2026-11-16T23:08:42Z · Data license Apache-2.0 · JSON