Fluentd
Search…
Install from Source
This article explains how to install Fluentd from source (git repository). This is useful for developers.
Step 1: Install Ruby Interpreter
Install Ruby
>= 2.1 and bundler on your local environment.Step 2: Fetch Source Code
1
$ git clone https://github.com/fluent/fluentd.git
2
$ cd fluentd
Copied!
The
master branch is now for v1 development.Step 3: Build and Install
Build the package with
rake and install it with gem:1
$ bundle install
2
Fetching gem metadata from https://rubygems.org/.........
3
...
4
Your bundle is complete!
5
Use `bundle show [gemname]` to see where a bundled gem is installed.
6
$ bundle exec rake build
7
fluentd xxx built to pkg/fluentd-xxx.gem.
8
$ gem install pkg/fluentd-xxx.gem
Copied!
Step 4: Run
Run the following commands to verify the Fluentd installation:
1
$ fluentd --setup ./fluent
2
$ fluentd -c ./fluent/fluent.conf -vv &
3
$ echo '{"json":"message"}' | fluent-cat debug.test
Copied!
The second command starts Fluentd as a daemon. If you want to stop its daemon, you can use
$ pkill -f fluentd. The last command sends Fluentd a message '{"json":"message"}' with a debug.test tag. If the installation is successful, Fluentd will output the following message:1
2011-07-10 16:49:50 +0900 debug.test: {"json":"message"}
Copied!
It is highly recommended to set up
ntpd on the node to prevent invalid timestamps in your logs.Troubleshooting
Cannot install on M1 macOS
There is a known problem in the system Ruby on M1 macOS that
fluentd --setup ./fluent command in Step.4 fails with an error similar to the following.1
.../kernel_require.rb:XX:in `require': dlopen(...):
2
missing compatible arch in ... (LoadError)
Copied!
The system Ruby on macOS, which is like
universal.XXX-darwinXX (you can check it by $ ruby -v) may cause this error. If you use the system Ruby, this error can be resolved by reinstalling Ruby.1
$ brew reinstall --build-from-source ruby
Copied!
Next Steps
You are now ready to collect real logs with Fluentd. Refer to the following tutorials on how to collect data from various sources:
- Basic Configuration
- Examples
If this article is incorrect or outdated, or omits critical information, please let us know. Fluentd is an open-source project under Cloud Native Computing Foundation (CNCF). All components are available under the Apache 2 License.
Last modified 11mo ago