Skip to content
Fluentd: Unified Logging Layer (project under CNCF)
Ruby HTML
Branch: master
Clone or download

Latest commit

repeatedly v1.10.1
Signed-off-by: Masahiro Nakagawa <repeatedly@gmail.com>
Latest commit cc97aa4 Apr 2, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add issue auto closer Mar 17, 2020
bin Move fileutils require directive into near needed place Jan 16, 2018
docs Add security audit document Mar 25, 2020
example Add examples Sep 12, 2019
lib/fluent v1.10.1 Apr 2, 2020
templates Fix Parser plugin template for fluent-plugin-generate Jun 21, 2018
test Merge pull request #2922 from ganmacs/update-pf-seek Apr 2, 2020
.drone.yml optimize arm64 ci Aug 2, 2019
.gitignore Add .idea/ to ignore file Feb 20, 2020
.gitlab-ci.yml remove gitlab CI from README Jan 10, 2020
.travis.yml Use latest gem version Feb 4, 2020
ADOPTERS.md Doc: add 'adopters' document Sep 28, 2017
AUTHORS Add me to AUTHORS ;) Aug 11, 2014
CHANGELOG.md v1.10.1 Apr 2, 2020
CONTRIBUTING.md Update docs repository Jun 18, 2019
GOVERNANCE.md GOVERNANCE: fix typo Aug 7, 2018
Gemfile Add test Jan 22, 2020
GithubWorkflow.md Fix some typos Feb 27, 2019
LICENSE Edit Fluentd license info so GitHub recognizes it Apr 4, 2018
MAINTAINERS.md MAINTAINERS: Add Eduardo Silva Dec 11, 2019
README.md Add security audit document Mar 25, 2020
Rakefile Forgot to add sort to file list Jun 15, 2019
appveyor.yml Add Ruby 2.6 CI tasks on AppVeyor Jan 24, 2020
code-of-conduct.md Create code-of-conduct.md Nov 24, 2016
fluent.conf Revert "Add `@type` to secondary section" Jun 6, 2016
fluentd.gemspec Update ext_monitor Jan 31, 2020

README.md

Fluentd: Open-Source Log Collector

Travis CI:

Code Climate CII Best Practices FOSSA Status

Drone CI for Arm64:

pipeline status

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).

An event consists of tag, time and record. Tag is a string separated with '.' (e.g. myapp.access). It is used to categorize events. Time is a UNIX time recorded at occurrence of an event. Record is a JSON object.

Example Use Cases

Use Case Description Diagram
Centralizing Apache/Nginx Server Logs Fluentd can be used to tail access/error logs and transport them reliably to remote systems.
Syslog Alerting Fluentd can "grep" for events and send out alerts.
Mobile/Web Application Logging Fluentd can function as middleware to enable asynchronous, scalable logging for user action events.

Quick Start

$ gem install fluentd
$ fluentd -s conf
$ fluentd -c conf/fluent.conf &
$ echo '{"json":"message"}' | fluent-cat debug.test

Development

Branch

Prerequisites

  • Ruby 2.4 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 install --path vendor/bundle

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

Fluentd UI: Admin GUI

Fluentd UI is a graphical user interface to start/stop/configure Fluentd.

More Information

Security

A third party security audit was performed by Cure53, you can see the full report here.

Contributors:

Patches contributed by great developers.

You can’t perform that action at this time.