Skip to content
Web UI for Fluentd
Ruby HTML JavaScript CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Prepare to release v1.2.2 Dec 6, 2018
log rails new ./fluentd-ui -T -D May 8, 2014
public Add logo for td-agent-ui Dec 10, 2014
test Enable coverage Oct 10, 2018
.gitignore Add ignore pattern May 22, 2018
ChangeLog Add Link to from ChangeLog (old ChangeLog) Apr 15, 2015 Prepare to release v1.2.2 Dec 6, 2018
Gemfile.lock Run bundle update webpacker Mar 13, 2019
LICENSE Add license file (Apache v2.0) Aug 22, 2014
babel.config.js Replace .babelrc and .postcssrc.yml Mar 13, 2019
fluentd-ui.gemspec Support dig method for Ruby 2.2 Jul 19, 2018
postcss.config.js Replace .babelrc and .postcssrc.yml Mar 13, 2019
yarn.lock Update startbootstrap-sb-admin Mar 14, 2019


Build Status Gem Version Code Climate

fluentd-ui is a browser-based fluentd and td-agent manager that supports following operations.

  • Install, uninstall, and upgrade Fluentd plugins
  • start/stop/restart fluentd process
  • Configure Fluentd settings such as config file content, pid file path, etc
  • View Fluentd log with simple error viewer

Official documentation | Changelog


  • ruby 2.2.2 or later (since v1.0.0)
  • fluentd v1.0.0 or later (also supports td-agent 3)
    • Currently, fluentd v1 and td-agent 3 support is in alpha state

And some additional packages (Debian / Ubuntu)

  • build-essential
  • libssl-dev
  • libxml2-dev
  • libxslt1-dev
  • ruby-dev

How to install and run

$ gem install fluentd-ui
$ fluentd-ui setup
$ fluentd-ui start --daemonize

Access http://localhost:9292 by web browser. The default account is username="admin" and password="changeme".

Run under sub path

Use RAILS_RELATIVE_URL_ROOT environment variable.

$ RAILS_RELATIVE_URL_ROOT=/prefix fluentd-ui start --daemonize

Access http://localhost:9292/prefix by web browser.


Get the source

$ git clone
$ cd fluentd-ui

Install dependent gems

Use bundler:

$ gem install bundler
$ bundle install --path vendor/bundle

Install dependent JavaScript packages

Use yarn. See to install it to your environment. After install it, run following command:

$ yarn install

Run fluentd-ui

$ bin/rails server

Access http://localhost:3000 by web browser.

Run tests

You need chromedriver or chromiumdriver to run tests.

$ npm install -g chromedriver
$ brew install chromedriver
$ sudo apt install chromium-driver

NOTE: chromedriver executable binary should be located under your $PATH.

After that you can run tests by following command:

$ bundle exec rake test

Building fluentd-ui.gem

# Generate and increment version
$ bin/rails release:prepare

# Clear tmp/, public/assets and public/packs
$ bin/rails tmp:clear assets:clobber && touch tmp/.gitkeep

# Generate pre-compiled assets
$ RAILS_ENV=production bin/rails assets:precompile

# fluentd-ui X.X.X built to pkg/fluentd-ui-X.X.X.gem.
$ RAILS_ENV=production bin/rails build

# Push to
$ bin/rails release
You can’t perform that action at this time.