Trouble Shooting

Search…

Trouble Shooting

Look at Logs
If things are not happening as expected, please first look at your logs. For td-agent (rpm/deb), the logs are located at /var/log/td-agent/td-agent.log.
Turn on Verbose Logging
You can get more information about the logs if verbose logging is turned on. Please follow the steps below:
Use Directive in Configuration File
Set log_level trace.
See the logging article also.
td-agent
td-agent systemd with User's Unit File
Put your unit file into /etc/systemd/system/td-agent. This overwrites the existing behavior of /usr/lib/systemd/system/td-agent.
[Service]
ExecStart=...existing options... -vv
td-agent init.d with Environment Variable
1.edit /etc/init.d/td-agent
2.add -vv to TD_AGENT_OPTIONS
3.restart td-agent
# at /etc/init.d/td-agent
...
TD_AGENT_OPTIONS="... -vv"
...
This approach does not work on the systemd environment because systemd hooks the init.d's startup routine and ignores the other options.
calyptia-fluentd
calyptia-fluentd systemd with User's Unit File
Put your unit file into /etc/systemd/system/calyptia-fluentd.service. This overwrites the existing behavior of /usr/lib/systemd/system/calyptia-fluentd.service.
[Service]
ExecStart=...existing options... -vv
calyptia-fluentd is only provided systemd enabled platforms on Linux.
gem
Please add -vv to your command line:
$ fluentd .. -vv
Dump fluentd's Internal Information
Fluentd uses SIGDUMP for dumping fluentd internal information to a local file, e.g. thread dump, object allocation, etc. If you have a problem with fluentd like process hang, please send SIGCONT to fluentd parent and child processes.
On Windows, you can use fluent-ctl.
High CPU Usage Issue
If fluentd suddenly hits unexpected high CPU usage problem, there are several reasons:
a plugin has a race condition or similar bug
dependent gems have a bug
regular expression with broken data
system calls has a bug, e.g. inotify with lots of files
In such cases, you can use perf tool on recent Linux to investigate the problem. See Linux perf Examples page. If you want to know which call causes the problem, pid2line.rb is useful.
Check Uncaught Logs
You sometimes hit unexpected shutdown with non-zero exit status like this:
2016-01-01 00:00:00 +0800 [info]: starting fluentd-0.12.28
2016-01-01 00:00:00 +0800 [info]: reading config file path="/etc/td-agent/td-agent.conf"
[...snip...]
2016-01-01 00:00:02 +0800 [info]: process finished code=6
If the problem happens inside Ruby e.g. segmentation fault, C extension bug, etc., you cannot get the complete log when fluentd process is daemonized. For example, td-agent launches fluentd with --daemon option. In td-agent case, you can get the complete log with following command to simulate /etc/init.d/td-agent start without daemonizing (run in the foreground):
$ sudo LD_PRELOAD=/opt/td-agent/embedded/lib/libjemalloc.so /usr/sbin/td-agent -c /etc/td-agent/td-agent.conf --user td-agent --group td-agent
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.

Plugin Management

Fluentd UI

Last modified 2mo ago

Copy link

On this page

Look at Logs

Turn on Verbose Logging

Use Directive in Configuration File

td-agent

calyptia-fluentd

gem

Dump fluentd's Internal Information

High CPU Usage Issue

Check Uncaught Logs

Look at Logs

Turn on Verbose Logging

Use Directive in Configuration File

`td-agent`

`td-agent` systemd with User's Unit File

`td-agent` init.d with Environment Variable

`calyptia-fluentd`

`calyptia-fluentd` systemd with User's Unit File

gem

Dump fluentd's Internal Information

High CPU Usage Issue

Check Uncaught Logs