Skip to content
Fluentd: Unified Logging Layer (project under CNCF)
Branch: master
Clone or download
repeatedly README: Remove enterprise section
Signed-off-by: Masahiro Nakagawa <repeatedly@gmail.com>
Latest commit 6b3e510 Mar 19, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Add PR template Feb 26, 2019
bin Move fileutils require directive into near needed place Jan 16, 2018
example Merge pull request #1857 from fluent/counter-api Apr 21, 2018
lib/fluent v1.4.1 Mar 19, 2019
templates Fix Parser plugin template for fluent-plugin-generate Jun 21, 2018
test parser_regexp: Fix broken test due to no named capture Mar 15, 2019
.gitignore Add .vscode to .gitignore file Feb 27, 2019
.travis.yml travis-ci: Move 2.3 test to allow_failures because travis has openssl… Jan 9, 2019
ADOPTERS.md Doc: add 'adopters' document Sep 28, 2017
AUTHORS Add me to AUTHORS ;) Aug 11, 2014
CHANGELOG.md Move one change from Enhancements to Bug fixes Mar 19, 2019
CONTRIBUTING.md
GOVERNANCE.md GOVERNANCE: fix typo Aug 7, 2018
Gemfile Use released gems Oct 8, 2015
GithubWorkflow.md Fix some typos Feb 27, 2019
LICENSE Edit Fluentd license info so GitHub recognizes it Apr 4, 2018
MAINTAINERS.md MAINTENERS: Update Seo's company Jan 11, 2019
README.md README: Remove enterprise section Mar 19, 2019
Rakefile add a task to build/upload coverity tarball Oct 27, 2016
Vagrantfile Add Vagrantfile to run Fluentd in Linux box very easily (especially f… Apr 19, 2016
appveyor.yml appveyor: Remove Ruby 2.1 CI targets on appveyor. Fix #2255 Jan 9, 2019
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

README.md

Fluentd: Open-Source Log Collector

Code Climate CII Best Practices FOSSA 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

Prerequisites

  • Ruby 2.1 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

Contributors:

Patches contributed by great developers.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.