Release Version</th>	Release Date</th>	End of life</th> </tr>
v4.5.1</td>	Aug, 2023</td>	Dec, 2023</td> </tr>
v5.0.1 (LTS)</td>	Aug 29, 2023</td>	March, 2025</td> </tr>
v6.0.0 (LTS)</td>	March, 2025? (T.B.D.)</td>	T.B.D.</td> </tr> </table> Happy logging!</p> Upgrade to fluent-package v5 2023-07-31 `fluent-package</code> "v5" is available since August 2023. fluent-package</code> is the successor of td-agent</code> "v4".</p>` `In this post, we will share the steps we've tested and hopefully this will help your experience from v4 to v5.</p>` Why package was renamed?</h2> fluent-package</code> was formerly known as td-agent</code>. In the past, Treasure Data, Inc</a> took the initiative to provide the package, but now the Fluentd community does it. This is why the package name was changed.</p> To represent "All in one package of Fluentd which contains Fluentd and related gem packages", the package name was changed to fluent-package</code>.</p> Even though package name was changed, Treasure Data, Inc still sponsor the package delivery resources.</p> Which channel should I use?</h2> There are two channels for fluent-package</code>.</p> Normal release version</li> Long Term Support version</li> </ul> One is normal release version which will be updated regularly - rapid release development style (td-agent v4</code> was released like this in almost every quarter). In this version, fluentd will be eventually updated to newer minor version (e.g. 1.17.x and so on)</p> The other is a more conservative maintenance version (Long Term Support) which will not introduce a new feature. It only applies teeny update such as security or bug fix only. LTS for v5 will be supported until March, 2025.</p> More details about difference between normal release version and LTS version will be explained in Scheduled support lifecycle announcement about Fluent Package</a>.</p> Differences between td-agent v4 and fluent-package v5</h2> In the fluent-package</code> v5, core components like ruby (2.7.8 -> 3.2.2) and OpenSSL (1.1.1 -> 3.1.0 for Windows, 3.0.8 for macOS) were updated.</p> The major changes are as follows.</p> td-agent</code> command is renamed to fluentd</code>. $ td-agent --version</code> -> $ fluentd --version</code></li> </ul></li> td-agent-gem</code> command is renamed to fluent-gem</code>. $ td-agent-gem list</code> -> $ fluent-gem list</code></li> </ul></li> The service name for non-Windows td-agent</code> is renamed to fluentd</code>. $ systemctl status td-agent</code> -> $ systemctl status fluentd</code></li> </ul></li> </ul> With the change of package name, install path, service name (e.g. /opt/fluent, fluentd.service) and so on were also changed. Basically, for td-agent</code> v4 users, it aims to keep compatibility as far as possible by executing the migration process with copying old files or providing symbolic links for it.</p> If you want to know the details of upgraded components, see CHANGELOG.md</a>.</p> NOTE: We explain for platform specific issue as "Additional hints for v4 users" section below.</p> Upgrade steps</h2> During the upgrade process, plugins bundled in td-agent</code> are automatically upgraded. With that being said, other plugins added on your own are not included. You should review if you need to upgrade plugins since some directory structures from v4 and v5 are changed.</p> In this post, I will show steps with plugins added on my own, "fluent-plugin-concat"</strong> for instance. Here is sample configuration file I used through steps.</p> <filter docker.log> @type concat key message multiline_start_regexp /^Start/ </filter> </code></pre> 1. Review what plugins are installed together with td-agent v4.</h3> $ td-agent-gem list \| grep fluent-plugin* fluent-plugin-calyptia-monitoring (0.1.3) fluent-plugin-concat (2.5.0) fluent-plugin-elasticsearch (5.3.0) fluent-plugin-flowcounter-simple (0.1.0) fluent-plugin-kafka (0.19.0) fluent-plugin-metrics-cmetrics (0.1.2) fluent-plugin-opensearch (1.1.0) fluent-plugin-prometheus (2.0.3) fluent-plugin-prometheus_pushgateway (0.1.0) fluent-plugin-record-modifier (2.1.1) fluent-plugin-rewrite-tag-filter (2.4.0) fluent-plugin-s3 (1.7.2) fluent-plugin-sd-dns (0.1.0) fluent-plugin-systemd (1.0.5) fluent-plugin-td (1.2.0) fluent-plugin-utmpx (0.5.0) fluent-plugin-webhdfs (1.5.0) </code></pre> You can also find installed plugins under /opt/td-agent/lib/ruby/gems/2.7.0/gems/</code> directories.</p> $ ls -l /opt/td-agent/lib/ruby/gems/2.7.0/gems \|grep fluent-plugin* drwxr-xr-x. 5 root root 175 7月 14 03:01 fluent-plugin-calyptia-monitoring-0.1.3 drwxr-xr-x. 4 root root 206 7月 14 03:03 fluent-plugin-concat-2.5.0 drwxr-xr-x. 5 root root 4096 7月 14 03:01 fluent-plugin-elasticsearch-5.3.0 drwxr-xr-x. 4 root root 205 7月 14 03:01 fluent-plugin-flowcounter-simple-0.1.0 drwxr-xr-x. 6 root root 191 7月 14 03:01 fluent-plugin-kafka-0.19.0 drwxr-xr-x. 5 root root 190 7月 14 03:01 fluent-plugin-metrics-cmetrics-0.1.2 drwxr-xr-x. 5 root root 4096 7月 14 03:01 fluent-plugin-opensearch-1.1.0 drwxr-xr-x. 5 root root 215 7月 14 03:01 fluent-plugin-prometheus-2.0.3 drwxr-xr-x. 6 root root 238 7月 14 03:01 fluent-plugin-prometheus_pushgateway-0.1.0 drwxr-xr-x. 4 root root 176 7月 14 03:01 fluent-plugin-record-modifier-2.1.1 drwxr-xr-x. 3 root root 210 7月 14 03:01 fluent-plugin-rewrite-tag-filter-2.4.0 drwxr-xr-x. 5 root root 230 7月 14 03:01 fluent-plugin-s3-1.7.2 drwxr-xr-x. 3 root root 170 7月 14 03:01 fluent-plugin-sd-dns-0.1.0 drwxr-xr-x. 3 root root 49 7月 14 03:01 fluent-plugin-systemd-1.0.5 drwxr-xr-x. 5 root root 221 7月 14 03:01 fluent-plugin-td-1.2.0 drwxr-xr-x. 5 root root 166 7月 14 03:01 fluent-plugin-utmpx-0.5.0 drwxr-xr-x. 4 root root 191 7月 14 03:01 fluent-plugin-webhdfs-1.5.0 </code></pre> 2. Stop td-agent v4 daemon.</h3> $ sudo systemctl stop td-agent </code></pre> Even though fluent-package</code> supports upgrade without stopping service, but recommend to stop explicitly.</p> 3. Run installation script of fluent-package v5.</h3> When you use RedHat or derivative distributions, you can run following script if you want to install normal release version of fluent-package</code>.</p> # curl -L https://toolbelt.treasuredata.com/sh/install-redhat-fluent-package5.sh \| sh </code></pre> When you use RedHat or derivative distributions, you can run following script if you want to install LTS (Long term support) version of fluent-package</code>.</p> # curl -L https://toolbelt.treasuredata.com/sh/install-redhat-fluent-package5-lts.sh \| sh </code></pre> You can find more information about the installation script in Fluend Doc - Installation</a>.</p> 4. Confirm if fluent-package v5 is properly installed.</h3> $ LANG=C yum info fluent-package Loaded plugins: fastestmirror Loading mirror speeds from cached hostfile * base: ftp.riken.jp * extras: ftp.riken.jp * updates: ftp.riken.jp Installed Packages Name : fluent-package Arch : x86_64 Version : 5.0.0 Release : 1.el7 Size : 64 M Repo : installed From repo : /fluent-package-5.0.0-1.el7.x86_64 Summary : The stable distribution of Fluentd URL : https://www.treasuredata.com/ License : ASL 2.0 Description : The stable distribution of Fluentd, called td-agent. </code></pre> 5. Reload fluent-package daemon.</h3> $ sudo systemctl daemon-reload $ sudo systemctl enable --now fluentd </code></pre> 6. Check installed plugins.</h3> $ fluent-gem list \|grep fluent-plugin* fluent-plugin-calyptia-monitoring (0.1.3) fluent-plugin-elasticsearch (5.3.0) fluent-plugin-flowcounter-simple (0.1.0) fluent-plugin-kafka (0.19.0) fluent-plugin-metrics-cmetrics (0.1.2) fluent-plugin-opensearch (1.1.0) fluent-plugin-prometheus (2.0.3) fluent-plugin-prometheus_pushgateway (0.1.0) fluent-plugin-record-modifier (2.1.1) fluent-plugin-rewrite-tag-filter (2.4.0) fluent-plugin-s3 (1.7.2) fluent-plugin-sd-dns (0.1.0) fluent-plugin-systemd (1.0.5) fluent-plugin-td (1.2.0) fluent-plugin-utmpx (0.5.0) fluent-plugin-webhdfs (1.5.0) </code></pre> You can see bundled plugins are upgraded as well but can not find plugins added on your own. In this post, added plugin was "fluent-plugin-concat" and it is not shown in installed list.</p> 7. Install plugins added on my own.</h3> $ sudo fluent-gem install fluent-plugin-concat </code></pre> $ fluent-gem list \| grep fluent-plugin* fluent-plugin-calyptia-monitoring (0.1.3) fluent-plugin-concat (2.5.0) fluent-plugin-elasticsearch (5.3.0) fluent-plugin-flowcounter-simple (0.1.0) fluent-plugin-kafka (0.19.0) fluent-plugin-metrics-cmetrics (0.1.2) fluent-plugin-opensearch (1.1.0) fluent-plugin-prometheus (2.0.3) fluent-plugin-prometheus_pushgateway (0.1.0) fluent-plugin-record-modifier (2.1.1) fluent-plugin-rewrite-tag-filter (2.4.0) fluent-plugin-s3 (1.7.2) fluent-plugin-sd-dns (0.1.0) fluent-plugin-systemd (1.0.5) fluent-plugin-td (1.2.0) fluent-plugin-utmpx (0.5.0) fluent-plugin-webhdfs (1.5.0) </code></pre> As for fluent-package v5, "fluent-plugin-concat" was installed under "/opt/fluent/lib/ruby/gems/3.2.0/gems/" directories.</p> $ ls -l /opt/fluent/lib/ruby/gems/3.2.0/gems/ \|grep fluent-plugin* drwxr-xr-x. 5 root root 175 7月 14 03:14 fluent-plugin-calyptia-monitoring-0.1.3 drwxr-xr-x. 4 root root 206 7月 14 03:16 fluent-plugin-concat-2.5.0 drwxr-xr-x. 5 root root 4096 7月 14 03:14 fluent-plugin-elasticsearch-5.3.0 drwxr-xr-x. 4 root root 205 7月 14 03:14 fluent-plugin-flowcounter-simple-0.1.0 drwxr-xr-x. 6 root root 191 7月 14 03:14 fluent-plugin-kafka-0.19.0 drwxr-xr-x. 5 root root 190 7月 14 03:14 fluent-plugin-metrics-cmetrics-0.1.2 drwxr-xr-x. 5 root root 4096 7月 14 03:14 fluent-plugin-opensearch-1.1.0 drwxr-xr-x. 5 root root 215 7月 14 03:14 fluent-plugin-prometheus-2.0.3 drwxr-xr-x. 6 root root 238 7月 14 03:14 fluent-plugin-prometheus_pushgateway-0.1.0 drwxr-xr-x. 4 root root 176 7月 14 03:14 fluent-plugin-record-modifier-2.1.1 drwxr-xr-x. 3 root root 210 7月 14 03:14 fluent-plugin-rewrite-tag-filter-2.4.0 drwxr-xr-x. 5 root root 230 7月 14 03:14 fluent-plugin-s3-1.7.2 drwxr-xr-x. 3 root root 170 7月 14 03:14 fluent-plugin-sd-dns-0.1.0 drwxr-xr-x. 3 root root 49 7月 14 03:14 fluent-plugin-systemd-1.0.5 drwxr-xr-x. 5 root root 221 7月 14 03:14 fluent-plugin-td-1.2.0 drwxr-xr-x. 5 root root 166 7月 14 03:14 fluent-plugin-utmpx-0.5.0 drwxr-xr-x. 4 root root 191 7月 14 03:14 fluent-plugin-webhdfs-1.5.0 </code></pre> 8. Start fluent-package v5 daemon.</h3> $ sudo systemctl start fluentd </code></pre> 9. Check if there are no error messages in fluentd logs.</h3> $ tail -100f /var/log/fluent/fluentd.log </code></pre> Now, upgrading steps are completed. Happy Logging!</p> Additional hints for v4 users</h2> For Debian/Ubuntu</h3> fluentd-apt-source</code> package will be marked as a transitional package. you can remove it safely with sudo apt purge fluentd-apt-source</code>.</li> If you want to enable td-agent.service</code>, you must explicitly execute the following commands:</li> </ul> $ sudo systemctl unmask td-agent $ sudo systemctl enable fluentd </code></pre> For RHEL</h3> If you want to enable td-agent.service</code>, you must explicitly execute the following command:</li> </ul> $ sudo systemctl enable fluentd </code></pre> For Windows</h3> fluent-package</code> installer was changed not to start service by default. If you want to start fluentd</code> as a service, execute the following command with administrator privileges.</li> </ul> c:\opt\fluent> net start fluentdwinsvc </code></pre> For macOS</h3> WARNING: Currently we have no plan to officially support dmg version of fluent-package</code> yet. It is just modified to be a minimally buildable state, it is for testing purpose only.</p> td-agent v4.5.0 has been released 2023-05-08 Hi users!</p> We have released td-agent v4.5.0</a>. td-agent is a stable distribution package of Fluentd.</p> Changes from td-agent v4.4.2</h3> Update bundled Ruby to 2.7.8 which is the last version of Ruby 2.7 series. Only for RHEL 9 & Ubuntu 22.04 jammy, we updat Ruby to 3.1.4 exceptionally.</li> </ul></li> Update fluentd to 1.16.1</a></li> Update plugins fluent-plugin-kafka 0.19.0</li> fluent-plugin-elasticsearch 5.3.0</li> fluent-plugin-opensearch 1.1.0</li> </ul></li> Drop Debian buster support</li> </ul> About next major version</h3> We are preparing next major version of td-agent which bundles Ruby 3.2. It's still work in progerss, we'll announce it as soon as we are ready for it.</p> Please note that the package name will be changed to fluent-package</code>. Please see the following discussion for more detail: https://github.com/fluent/fluentd/discussions/3860</a></p> Download</h3> Please see the download page</a>.</p>

Fluentd Blog

fluent-package v5.0.3 has been released

2024-03-29

Hi users!</p>

We have released fluent-package v5.0.3</a>. fluent-package is a stable distribution package of Fluentd. (successor of td-agent v4)</p>

This is a maintenance release of v5.0.x LTS series. As significant slow starting service and crash issues during startup on Windows were fixed, we recommend upgrading to fluent-package v5.0.3!</p>

Changes from fluent-package v5.0.2</h3>

Update fluentd to 1.16.5</a>. See the following blog articles about details.

Fluentd v1.16.4 has been released</a></li>
Fluentd v1.16.5 has been released</a></li> </ul></li>
Update bundled plugins

e.g. fluent-diagtool v1.0.5. It supports to collect list of plugins on Windows.</li> </ul></li>
msi: fixed wrong environment path for Fluent Package Prompt (#606</a>)

It breaks fluent-diagtool behavior to launch fluent-gem correctly.</li> </ul></li>
msi: removed unnecessary path delimiter (#607</a>)

It doesn't cause any problem yet, but it should treat `%~dp0</code> correctly.</li> </ul></li>`
`rpm: fixed to take over enabled state of systemd service from td-agent v4 (#613</a>)</li>`
`deb rpm: fixed to quote target files correctly not to cause migration failures (#615</a>)</li>`
`msi: added a patch for RubyInstaller to avoid crash on start up (#620</a>)</li>`
msi: fixed slow start issue on Windows (#631</a>)</li> </ul> </i> Note:</b> v5.0.3 for Windows msi will be shipped later. </div> About next LTS schedule</h3> We plan to ship next LTS version of fluent-package v5.0.4 on June, 2024. The content of updates are still in T.B.D.</p> About td-agent v4.5.2 and v4.5.3 (Windows)</h3> As it was already announced Drop schedule announcement about EOL of Treasure Agent (td-agent) 4</a>, td-agent v4 was reached EOL in Dec, 2023.</p> There is a exceptional maintenance release for v4.5.3 on Windows because there was a crash bug during startup on Windows. It was backported fix from fluent-package v5 as it is critical in some case.</p> We strongly recommend migrating from td-agent v4 to fluent-package v5 (LTS). See Upgrade to fluent-package v5</a></p> Download</h3> Please see the download page</a>.</p>



Fluentd v1.16.5 has been released
2024-03-27
Hi users!</p>

We have released v1.16.5 on 2024-03-27. ChangeLog is here</a>.</p>

The previous version v1.16.4 has a serious Buffer bug when it processes large data exceeding chunk size limit.
So, we have released v1.16.5 urgently, and have fixed the bug.
So, please don't use v1.16.4</strong>.</p>

Sorry for troubling.</p>

Bug Fixes</h2>

Buffer: Fix emit error of v1.16.4 sometimes failing to process large data exceeding chunk size limit</h3>

In the previous version v1.16.4, we fixed a Buffer bug (Please see Fluentd v1.16.4 has been released</a> for details).</p>

There was a race condition problem with that fix, and similar Buffer errors explained in Fluentd v1.16.4 has been released</a> could occur.</p>


emit transaction failed: ...</code></li>
send an error event stream to @ERROR: ...</code></li>
</ul>

These errors are the same as the Buffer error of Fluentd v1.16.4 has been released</a>, but it would be more likely to happen.
The cause is a race condition when processing large data exceeding chunk size limit.
So, in that case, these errors can occur depending on the timing.</p>

So, please don't use v1.16.4.</p>

See #4447</a> for more information.</p>

Sorry for troubling.</p>


Fluentd v1.16.4 has been released
2024-03-14
Hi users!</p>

We have released v1.16.4 on 2024-03-14. ChangeLog is here</a>.</p>

In this release, we fixed several bugs and improved performance.</p>

Bug Fixes</h2>

Buffer: Fix emit error sometimes caused by failing to process large data exceeding chunk size limit</h3>

In previous versions, when Buffer processes large data exceeding the chunk size limit, it sometimes fails and causes an emit error.</p>

It is usually unlikely, but it may occur when Buffer receives data with extremely large records that are distributed unevenly in the data.</p>

If you set @ERROR</a> label, the data is routed to that label, and Fluentd outputs a warning log message: send an error event stream to @ERROR: ...</code>.</p>

However, if you don't set @ERROR</code> label, the data is discarded</strong>, and Fluentd outputs a warning log message: emit transaction failed: ...</code>.
In addition, Input plugins that do not consider an emit error may stop working</strong>, such as in_windows_eventlog2</code>.</p>

Here is an example of the warning message:</p>

2024-03-22 14:13:35 +0900 [warn]: #0 emit transaction failed: error_class=IOError error="closed stream" location="/path/to/fluentd/lib/fluent/plugin/buffer/file_chunk.rb:82:in `pos'" tag="test"
</code></pre>

If you see these warnings, please update Fluentd.</p>

See #4342</a> for more information.</p>

Others</h3>


in_tail</code>: Fix tail watchers in rotate_wait</code> state not being managed. #4334</a>


This problem should not have any actual negative impact on the operation.</li>
</ul></li>
Buffer: Avoid unnecessary log processing. It will improve performance. #4331</a></li>
</ul>

Enjoy logging!</p>


Open Source Summit Japan 2023
2023-12-04
Hi users and developers!</p>

We would like to share the information about an event appearance of Fluentd maintainers.</p>

Daijiro Fukuda and Kentaro Hayashi, Fluentd Maintainers from ClearCode Inc., are going to talk at the Open Source Summit Japan on December 5th</p>

The event has been taken thousands of attendees all over the world and one of the leading Open Source event in Japan. We are honored to take this opportunity and very excited to share about Fluentd project at the conference!</p>

Everyone attending the event, please join us!</p>

About the Talk</h3>

Date</strong>: December 5th 14:00-14:40

Speakers</strong>: Daijiro Fukuda and Kentaro Hayashi from ClearCode Inc.</a>

Summary</strong>:

Fluentd, the CNCF graduated project, starts a new chapter as the OSS project. Fluentd community released the new package fluent-package as the successor of td-agent and started providing a new release cycle to fit better with needs. This talk is going to share the latest news of Fluentd, including its updates, package, rebranding and so on, with people who are using Fluentd or struggling to manage their logs. Fluentd is an open source data collector that unifies data collection and consumption. Because of its flexible plugin system and scalability, Fluentd is adopted in various systems and has become a de facto standard, especially for scale logging in distributed systems.</p>

In the new release cycle, the package applies only bug fixes and security fixes of Fluentd over a long term, about two years. We are confident that this will meet the demands of users who want to use Fluentd stably over the long term. In this session, we will talk about (a) the history of Fluentd v1 and td-agent v4, (b) why Fluentd community decided to rebrand existing td-agent to fluent-package, (c) what the benefits and impacts of the new release cycle are, and (d) how to upgrade to fluent-package from td-agent.</p>

Detail info: Link to event page</a></p>

Overall Event Information</h3>

Name</strong>: Open Source Summit Japan 2023

Date</strong>: 2023-12-04 to 2023-12-06

Host</strong>: The Linux Foundation

Description</strong>:</p>


Open Source Summit Japan is the leading conference in Japan connecting the open source ecosystem under one roof, providing a forum for technologists and open source industry leaders to collaborate and share information, learn about the latest in open source technologies and find out how to gain a competitive advantage by using innovative open solutions.</p>

Open Source Summit is a conference umbrella, composed of a collection of events covering the most important technologies, topics, and issues affecting open source today.</p>
</blockquote>

Quote from the event web page : https://events.linuxfoundation.org/open-source-summit-japan/</a></p>


fluent-package v5.0.2 has been released
2023-11-29
Hi users!</p>

We have released fluent-package v5.0.2</a>
and td-agent v4.5.2</a>.
fluent-package is a stable distribution package of Fluentd. </p>

This is a maintenance release of v5.0.x LTS series.
As significant in_tail</code> bugs (wrongly stopping tailing logs) were fixed in latest release, we recommend upgrading to fluent-package v5.0.2!</p>

Changes from fluent-package v5.0.1</h3>


Update fluentd to 1.16.3</a>
which contains significant bug fixes about in_tail</code>.
See Fluentd v1.16.3 and v1.16.2 have been released</a> blog article about details.</li>
Update plugins


fluent-diagtool v1.0.3. It supports fluent-package and can collect information about locally installed gems. It may help to migrate from td-agent v4 a bit.
See Upgrade to fluent-package v5</a> for migration.</li>
</ul></li>
msi: support path which contains space or parenthesis (#589</a>)</li>
deb: fixed system user/group name in logrotate config (#592</a>,#594</a>)


It fixes a bug that unknown user error was reported during log rotation.</li>
</ul></li>
rpm: fixed to create fluentd user as system account (#596</a>)


It fixes a bug that /var/lib/fluent directory was created unexpectedly. It doesn't affect the fluentd service behavior, but it is desirable one.</li>
</ul></li>
rpm: changed to keep system account after removing fluent-package. (#598</a>)


In the previous versions, there was a bug that group was not cleanly removed
when the package was upgraded from td-agent v4.
This change makes reinstall/downgrade friendly.</li>
</ul></li>
</ul>

About next LTS schedule</h3>

We plan to ship next LTS version of fluent-package v5.0.3 on Feb, 2024.
The content of updates are still in T.B.D.</p>

About td-agent v4.5.2</h3>

This is a exceptional maintenance release of v4.5.x series.
Fluentd was updated to 1.16.3 because it contains significant bug fixes about in_tail</code>.
Note that td-agent will not be updated anymore.
See Drop schedule announcement about EOL of Treasure Agent (td-agent) 4</a>.</p>

Download</h3>

Please see the download page</a>.</p>


Fluentd v1.16.3 and v1.16.2 have been released
2023-11-14
Hi users!</p>

We have released v1.16.3 (changelog</a>) on 2023-11-14.
We also describe the content of v1.16.2 (changelog</a>) on 2023-07-14 here.</p>

In these releases, in_tail</code> issues that have been reported for years are fixed!
And other some bug fixes too.</p>

Bug Fixes</h2>

in_tail</code>: Fix in_tail</code> wrongly stopping tailing the current target file and causing handle leaks</h3>

This issue has been reported for years.
It was looking very serious, but the cause remained unclear until recently.</p>

At last, we found different causes when the follow_inodes option</a> is true</code> and when it is false</code> (default).
We fixed the problem of follow_inodes true</code> case in v1.16.2, and fixed the problem of follow_inodes false</code> case in v1.16.3.</p>

Especially, in follow_inodes false</code> case, the trouble was mainly caused by rotate_wait option</a>.
In past versions, please avoid using large value for this option.
In particular, if you make it greater than refresh_interval option</a>, it will surely cause this issue.</p>

In Fluentd v1.15.1 (td-agent v4.4.0) or later, the following warning log is recorded when this issue occurs.</p>

Skip update_watcher because watcher has been already updated by other inotify event
</code></pre>

If this issue occurs, please restart Fluentd, and please update Fluentd to the latest version.
fluent-package v5.0.2 will be released in this month and it contains these fixes.</p>

See the following PRs for more information.</p>


follow_inodes true</code> case: #4208</a></li>
follow_inodes false</code> case: #4327</a></li>
</ul>

Others</h3>


in_tail</code>: Fix possible log duplication of follow_inodes option</a>. #4237</a>, #4239</a></li>
in_forward</code>: Fix corrupted data possibly breaking other data. #4178</a></li>
ignore_same_log_interval option</a>: Fix cache size growing unlimitedly. #4229</a></li>
SIGDUMP</a>: Fix wrong value of object counts. #4225</a></li>
Windows: Fix Fluentd failing to start when the log path isn't specified in the command line. #4188</a></li>
Buffer: Fix NoMethodError</code>. #4303</a></li>
rotate_age option</a>: Fix enum values causing setting error. #4311</a></li>
</ul>

Enjoy logging!</p>


Drop schedule announcement about EOL of Treasure Agent (td-agent) 4
2023-08-29
Hi users and developers!</p>

We announce the dropping schedule for TD Agent 4 development.</p>

About Treasure Agent (td-agent) 4</h2>

Since td-agent 4.0.0 was released in 2020, td-agent 4 has been maintained for a long time.</p>

As new major version of td-agent 4 was rebranded (to fluent-package</code> v5), and released in August 2023,
we decided to stop maintaining td-agent 4.</p>

Scheduled end of life - Dec 2023</h2>

As you know, already stepping down maintenance activity, new minor update for td-agent 4 will not be shipped anymore.
(td-agent v4.5.1 will be the last release of this series, it will be shipped in this month.)</p>

Thus, we recommend using fluent-package v5 for new deployment :)</p>

How to migrate to Fluent Package v5</h2>

There is a good article to do it.</p>


Upgrade to fluent-package v5</a></li>
</ul>

Follow the above instructions.</p>


Scheduled support lifecycle announcement about Fluent Package
2023-08-29
Hi users!</p>

We have released fluent-package</code> v5.0.0</a> (Release Candidate) and 
the following v5.0.1</a> (General Availability).
fluent-package is formerly known as td-agent</code> and a stable distribution package of Fluentd.</p>

In this blog article, we explains why the concept of channels is introduced.</p>

Why is LTS (Long Term Support) channel introduced?</h3>

In the previous versions, td-agent</code> was shipped as quarterly releases in most cases.
It sometimes contains fluentd minor upgrade occasionally, which means that not only bug or security fixes,
but also contains new features. As a result, there was a case that the stability was affected unexpectedly.</p>

In point view of adopting fluentd (and td-agent</code>) for enterprise services, there was a requirement for the distribution which contains security or bug fixes only
and scheduled lifecycle of it.</p>

The LTS release is the answer to support them.</p>

Channels for updates</h3>

There are two channels of support lifecycle.</p>


Normal release</li>
LTS (Long Term Support)</li>
</ul>

Here is the difference of these channels.</p>


Normal release (5.x series)


Recommended for early adopters (eager to try new features of Fluentd)</li>
Rapid release development (planned semi-annually releases, but it may vary.)</li>
Fluentd will be upgraded occasionally


Minor upgrade will be applied. e.g. 1.16 => 1.17 and so on.</li>
e.g. v5.0.1 (Fluentd v1.16.2), v5.0.2 (Fluentd v1.16.3), ... v5.1.0 (Fluentd v1.17.0)</li>
</ul></li>
The only latest version will be supported (bug fix will not be backported into older version)</li>
</ul></li>
LTS (Long Term Support, 5.0.x series)


Recommended for enterprise services</li>
Security and bug fix release only</li>
Fluentd will be upgraded only in the teeny version and will stick to 1.16.x series.


Thus, the version number will be 5.0.x. (5.1 series will not be shipped)</li>
e.g. v5.0.1 (Fluentd v1.16.2), v5.0.2 (Fluentd v1.16.3), v5.0.3 (Fluentd v1.16.4) ... v5.0.x (Fluentd v1.16.x)</li>
</ul></li>
Next major version will be fluent-package</code> v6.0.0, and will be shipped in 2025.</li>
</ul></li>
</ul>

As for fluent-package v5,</p>


fluent-package v5 LTS will be supported until March, 2025 (Even though Ruby 3.2 is still supported)</li>
Until 5.1.0 is released, normal release channel and LTS channel are the same package.</li>
</ul>

Current releases and future plans:</p>

</p>





Release Version</th>
Release Date</th>
End of life</th>
</tr>

v4.5.1</td>
Aug, 2023</td>
Dec, 2023</td>
</tr>

v5.0.1 (LTS)</td>
Aug 29, 2023</td>
March, 2025</td>
</tr>

v6.0.0 (LTS)</td>
March, 2025? (T.B.D.)</td>
T.B.D.</td>
</tr>
</table>

Happy logging!</p>


Upgrade to fluent-package v5
2023-07-31
fluent-package</code> "v5" is available since August 2023.
fluent-package</code> is the successor of td-agent</code> "v4".</p>

In this post, we will share the steps we've tested and hopefully this will help your experience from v4 to v5.</p>

Why package was renamed?</h2>

fluent-package</code> was formerly known as td-agent</code>.
In the past, Treasure Data, Inc</a> took the initiative to provide the package, but now the Fluentd community does it. This is why the package name was changed.</p>

To represent "All in one package of Fluentd which contains Fluentd and related gem packages", the package name was changed to fluent-package</code>.</p>

Even though package name was changed, Treasure Data, Inc still sponsor the package delivery resources.</p>

Which channel should I use?</h2>

There are two channels for fluent-package</code>.</p>


Normal release version</li>
Long Term Support version</li>
</ul>

One is normal release version which will be updated regularly - rapid release development style (td-agent v4</code> was released like this in almost every quarter).
In this version, fluentd will be eventually updated to newer minor version (e.g. 1.17.x and so on)</p>

The other is a more conservative maintenance version (Long Term Support) which will not introduce a new feature. It only applies teeny update such as
security or bug fix only. LTS for v5 will be supported until March, 2025.</p>

More details about difference between normal release version and LTS version will be explained in Scheduled support lifecycle announcement about Fluent Package</a>.</p>

Differences between td-agent v4 and fluent-package v5</h2>

In the fluent-package</code> v5, core components like ruby (2.7.8 -> 3.2.2) and OpenSSL (1.1.1 -> 3.1.0 for Windows, 3.0.8 for macOS) were updated.</p>

The major changes are as follows.</p>


td-agent</code> command is renamed to fluentd</code>.


$ td-agent --version</code> -> $ fluentd --version</code></li>
</ul></li>
td-agent-gem</code> command is renamed to fluent-gem</code>.


$ td-agent-gem list</code> -> $ fluent-gem list</code></li>
</ul></li>
The service name for non-Windows td-agent</code> is renamed to fluentd</code>. 


$ systemctl status td-agent</code> -> $ systemctl status fluentd</code></li>
</ul></li>
</ul>

With the change of package name, install path, service name (e.g. /opt/fluent, fluentd.service) and so on were also changed.
Basically, for td-agent</code> v4 users, it aims to keep compatibility as far as possible by executing the migration process with copying old files or providing
symbolic links for it.</p>

If you want to know the details of upgraded components, see CHANGELOG.md</a>.</p>

NOTE: We explain for platform specific issue as "Additional hints for v4 users" section below.</p>

Upgrade steps</h2>

During the upgrade process, plugins bundled in td-agent</code> are automatically upgraded. With that being said, other plugins added on your own are not included. You should review if you need to upgrade plugins since some directory structures from v4 and v5 are changed.</p>

In this post, I will show steps with plugins added on my own, "fluent-plugin-concat"</strong> for instance. Here is sample configuration file I used through steps.</p>

<filter docker.log>
  @type concat
  key message
  multiline_start_regexp /^Start/
</filter>
</code></pre>

1. Review what plugins are installed together with td-agent v4.</h3>

$ td-agent-gem list | grep fluent-plugin*
fluent-plugin-calyptia-monitoring (0.1.3)
fluent-plugin-concat (2.5.0)
fluent-plugin-elasticsearch (5.3.0)
fluent-plugin-flowcounter-simple (0.1.0)
fluent-plugin-kafka (0.19.0)
fluent-plugin-metrics-cmetrics (0.1.2)
fluent-plugin-opensearch (1.1.0)
fluent-plugin-prometheus (2.0.3)
fluent-plugin-prometheus_pushgateway (0.1.0)
fluent-plugin-record-modifier (2.1.1)
fluent-plugin-rewrite-tag-filter (2.4.0)
fluent-plugin-s3 (1.7.2)
fluent-plugin-sd-dns (0.1.0)
fluent-plugin-systemd (1.0.5)
fluent-plugin-td (1.2.0)
fluent-plugin-utmpx (0.5.0)
fluent-plugin-webhdfs (1.5.0)
</code></pre>

You can also find installed plugins under /opt/td-agent/lib/ruby/gems/2.7.0/gems/</code> directories.</p>

$ ls -l /opt/td-agent/lib/ruby/gems/2.7.0/gems |grep fluent-plugin*
drwxr-xr-x. 5 root root  175  7月 14 03:01 fluent-plugin-calyptia-monitoring-0.1.3
drwxr-xr-x. 4 root root  206  7月 14 03:03 fluent-plugin-concat-2.5.0
drwxr-xr-x. 5 root root 4096  7月 14 03:01 fluent-plugin-elasticsearch-5.3.0
drwxr-xr-x. 4 root root  205  7月 14 03:01 fluent-plugin-flowcounter-simple-0.1.0
drwxr-xr-x. 6 root root  191  7月 14 03:01 fluent-plugin-kafka-0.19.0
drwxr-xr-x. 5 root root  190  7月 14 03:01 fluent-plugin-metrics-cmetrics-0.1.2
drwxr-xr-x. 5 root root 4096  7月 14 03:01 fluent-plugin-opensearch-1.1.0
drwxr-xr-x. 5 root root  215  7月 14 03:01 fluent-plugin-prometheus-2.0.3
drwxr-xr-x. 6 root root  238  7月 14 03:01 fluent-plugin-prometheus_pushgateway-0.1.0
drwxr-xr-x. 4 root root  176  7月 14 03:01 fluent-plugin-record-modifier-2.1.1
drwxr-xr-x. 3 root root  210  7月 14 03:01 fluent-plugin-rewrite-tag-filter-2.4.0
drwxr-xr-x. 5 root root  230  7月 14 03:01 fluent-plugin-s3-1.7.2
drwxr-xr-x. 3 root root  170  7月 14 03:01 fluent-plugin-sd-dns-0.1.0
drwxr-xr-x. 3 root root   49  7月 14 03:01 fluent-plugin-systemd-1.0.5
drwxr-xr-x. 5 root root  221  7月 14 03:01 fluent-plugin-td-1.2.0
drwxr-xr-x. 5 root root  166  7月 14 03:01 fluent-plugin-utmpx-0.5.0
drwxr-xr-x. 4 root root  191  7月 14 03:01 fluent-plugin-webhdfs-1.5.0
</code></pre>

2. Stop td-agent v4 daemon.</h3>

$ sudo systemctl stop td-agent
</code></pre>

Even though fluent-package</code> supports upgrade without stopping service, but recommend to stop explicitly.</p>

3. Run installation script of fluent-package v5.</h3>

When you use RedHat or derivative distributions, you can run following script if you want to install normal release version of fluent-package</code>.</p>

# curl -L https://toolbelt.treasuredata.com/sh/install-redhat-fluent-package5.sh | sh
</code></pre>

When you use RedHat or derivative distributions, you can run following script if you want to install LTS (Long term support) version of fluent-package</code>.</p>

# curl -L https://toolbelt.treasuredata.com/sh/install-redhat-fluent-package5-lts.sh | sh
</code></pre>

You can find more information about the installation script in Fluend Doc - Installation</a>.</p>

4. Confirm if fluent-package v5 is properly installed.</h3>

$ LANG=C yum info fluent-package
Loaded plugins: fastestmirror
Loading mirror speeds from cached hostfile
 * base: ftp.riken.jp
 * extras: ftp.riken.jp
 * updates: ftp.riken.jp
Installed Packages
Name        : fluent-package
Arch        : x86_64
Version     : 5.0.0
Release     : 1.el7
Size        : 64 M
Repo        : installed
From repo   : /fluent-package-5.0.0-1.el7.x86_64
Summary     : The stable distribution of Fluentd
URL         : https://www.treasuredata.com/
License     : ASL 2.0
Description : The stable distribution of Fluentd, called td-agent.
</code></pre>

5. Reload fluent-package daemon.</h3>

$ sudo systemctl daemon-reload
$ sudo systemctl enable --now fluentd
</code></pre>

6. Check installed plugins.</h3>

$ fluent-gem list |grep fluent-plugin*
fluent-plugin-calyptia-monitoring (0.1.3)
fluent-plugin-elasticsearch (5.3.0)
fluent-plugin-flowcounter-simple (0.1.0)
fluent-plugin-kafka (0.19.0)
fluent-plugin-metrics-cmetrics (0.1.2)
fluent-plugin-opensearch (1.1.0)
fluent-plugin-prometheus (2.0.3)
fluent-plugin-prometheus_pushgateway (0.1.0)
fluent-plugin-record-modifier (2.1.1)
fluent-plugin-rewrite-tag-filter (2.4.0)
fluent-plugin-s3 (1.7.2)
fluent-plugin-sd-dns (0.1.0)
fluent-plugin-systemd (1.0.5)
fluent-plugin-td (1.2.0)
fluent-plugin-utmpx (0.5.0)
fluent-plugin-webhdfs (1.5.0)
</code></pre>

You can see bundled plugins are upgraded as well but can not find plugins added on your own. In this post, added plugin was "fluent-plugin-concat" and it is not shown in installed list.</p>

7. Install plugins added on my own.</h3>

$ sudo fluent-gem install fluent-plugin-concat
</code></pre>

$ fluent-gem list | grep fluent-plugin*
fluent-plugin-calyptia-monitoring (0.1.3)
fluent-plugin-concat (2.5.0)
fluent-plugin-elasticsearch (5.3.0)
fluent-plugin-flowcounter-simple (0.1.0)
fluent-plugin-kafka (0.19.0)
fluent-plugin-metrics-cmetrics (0.1.2)
fluent-plugin-opensearch (1.1.0)
fluent-plugin-prometheus (2.0.3)
fluent-plugin-prometheus_pushgateway (0.1.0)
fluent-plugin-record-modifier (2.1.1)
fluent-plugin-rewrite-tag-filter (2.4.0)
fluent-plugin-s3 (1.7.2)
fluent-plugin-sd-dns (0.1.0)
fluent-plugin-systemd (1.0.5)
fluent-plugin-td (1.2.0)
fluent-plugin-utmpx (0.5.0)
fluent-plugin-webhdfs (1.5.0)
</code></pre>

As for fluent-package v5, "fluent-plugin-concat" was installed under "/opt/fluent/lib/ruby/gems/3.2.0/gems/" directories.</p>

$ ls -l /opt/fluent/lib/ruby/gems/3.2.0/gems/ |grep fluent-plugin*
drwxr-xr-x.  5 root root  175  7月 14 03:14 fluent-plugin-calyptia-monitoring-0.1.3
drwxr-xr-x.  4 root root  206  7月 14 03:16 fluent-plugin-concat-2.5.0
drwxr-xr-x.  5 root root 4096  7月 14 03:14 fluent-plugin-elasticsearch-5.3.0
drwxr-xr-x.  4 root root  205  7月 14 03:14 fluent-plugin-flowcounter-simple-0.1.0
drwxr-xr-x.  6 root root  191  7月 14 03:14 fluent-plugin-kafka-0.19.0
drwxr-xr-x.  5 root root  190  7月 14 03:14 fluent-plugin-metrics-cmetrics-0.1.2
drwxr-xr-x.  5 root root 4096  7月 14 03:14 fluent-plugin-opensearch-1.1.0
drwxr-xr-x.  5 root root  215  7月 14 03:14 fluent-plugin-prometheus-2.0.3
drwxr-xr-x.  6 root root  238  7月 14 03:14 fluent-plugin-prometheus_pushgateway-0.1.0
drwxr-xr-x.  4 root root  176  7月 14 03:14 fluent-plugin-record-modifier-2.1.1
drwxr-xr-x.  3 root root  210  7月 14 03:14 fluent-plugin-rewrite-tag-filter-2.4.0
drwxr-xr-x.  5 root root  230  7月 14 03:14 fluent-plugin-s3-1.7.2
drwxr-xr-x.  3 root root  170  7月 14 03:14 fluent-plugin-sd-dns-0.1.0
drwxr-xr-x.  3 root root   49  7月 14 03:14 fluent-plugin-systemd-1.0.5
drwxr-xr-x.  5 root root  221  7月 14 03:14 fluent-plugin-td-1.2.0
drwxr-xr-x.  5 root root  166  7月 14 03:14 fluent-plugin-utmpx-0.5.0
drwxr-xr-x.  4 root root  191  7月 14 03:14 fluent-plugin-webhdfs-1.5.0
</code></pre>

8. Start fluent-package v5 daemon.</h3>

$ sudo systemctl start fluentd
</code></pre>

9. Check if there are no error messages in fluentd logs.</h3>

$ tail -100f /var/log/fluent/fluentd.log
</code></pre>

Now, upgrading steps are completed. Happy Logging!</p>

Additional hints for v4 users</h2>

For Debian/Ubuntu</h3>


fluentd-apt-source</code> package will be marked as a transitional package.
you can remove it safely with sudo apt purge fluentd-apt-source</code>.</li>
If you want to enable td-agent.service</code>, you must explicitly execute the following commands:</li>
</ul>

  $ sudo systemctl unmask td-agent
  $ sudo systemctl enable fluentd
</code></pre>

For RHEL</h3>


If you want to enable td-agent.service</code>, you must explicitly execute the following command:</li>
</ul>

  $ sudo systemctl enable fluentd
</code></pre>

For Windows</h3>


fluent-package</code> installer was changed not to start service by default.
If you want to start fluentd</code> as a service, execute the following command with administrator privileges.</li>
</ul>

  c:\opt\fluent> net start fluentdwinsvc
</code></pre>

For macOS</h3>

WARNING: Currently we have no plan to officially support dmg version of fluent-package</code> yet.
It is just modified to be a minimally buildable state, it is for testing purpose only.</p>


td-agent v4.5.0 has been released
2023-05-08
Hi users!</p>

We have released td-agent v4.5.0</a>. td-agent is a stable distribution package of Fluentd.</p>

Changes from td-agent v4.4.2</h3>


Update bundled Ruby to 2.7.8 which is the last version of Ruby 2.7 series.


Only for RHEL 9 & Ubuntu 22.04 jammy, we updat Ruby to 3.1.4 exceptionally.</li>
</ul></li>
Update fluentd to 1.16.1</a></li>
Update plugins


fluent-plugin-kafka 0.19.0</li>
fluent-plugin-elasticsearch 5.3.0</li>
fluent-plugin-opensearch 1.1.0</li>
</ul></li>
Drop Debian buster support</li>
</ul>

About next major version</h3>

We are preparing next major version of td-agent which bundles Ruby 3.2.
It's still work in progerss, we'll announce it as soon as we are ready for it.</p>

Please note that the package name will be changed to fluent-package</code>.
Please see the following discussion for more detail: https://github.com/fluent/fluentd/discussions/3860</a></p>

Download</h3>

Please see the download page</a>.</p>

About next LTS schedule</h3>
We plan to ship next LTS version of fluent-package v5.0.4 on June, 2024. The content of updates are still in T.B.D.</p>

Download</h3>
Please see the download page</a>.</p>

About next LTS schedule</h3>
We plan to ship next LTS version of fluent-package v5.0.3 on Feb, 2024. The content of updates are still in T.B.D.</p>

`Download</h3> Please see the download page</a>.</p>`

How to migrate to Fluent Package v5</h2>
There is a good article to do it.</p>

Upgrade to fluent-package v5</a></li> </ul>
Follow the above instructions.</p>

Upgrade to fluent-package v5

Additional hints for v4 users</h2>

For macOS</h3>
WARNING: Currently we have no plan to officially support dmg version of `fluent-package</code> yet. It is just modified to be a minimally buildable state, it is for testing purpose only.</p>`

td-agent v4.5.0 has been released

`Download</h3> Please see the download page</a>.</p>`

Fluentd Blog

fluent-package v5.0.3 has been released

Fluentd v1.16.5 has been released

Fluentd v1.16.4 has been released

Open Source Summit Japan 2023

fluent-package v5.0.2 has been released

Fluentd v1.16.3 and v1.16.2 have been released

Drop schedule announcement about EOL of Treasure Agent (td-agent) 4

About Treasure Agent (td-agent) 4</h2>
Since td-agent 4.0.0 was released in 2020, td-agent 4 has been maintained for a long time.</p>
As new major version of td-agent 4 was rebranded (to `fluent-package</code> v5), and released in August 2023, we decided to stop maintaining td-agent 4.</p>`

Scheduled support lifecycle announcement about Fluent Package

Fluentd Blog

fluent-package v5.0.3 has been released

About next LTS schedule</h3> We plan to ship next LTS version of fluent-package v5.0.4 on June, 2024. The content of updates are still in T.B.D.</p>

Fluentd v1.16.5 has been released

Fluentd v1.16.4 has been released

Others</h3> in_tail</code>: Fix tail watchers in rotate_wait</code> state not being managed. #4334</a> This problem should not have any actual negative impact on the operation.</li> </ul></li>

Open Source Summit Japan 2023

fluent-package v5.0.2 has been released

About next LTS schedule</h3> We plan to ship next LTS version of fluent-package v5.0.3 on Feb, 2024. The content of updates are still in T.B.D.</p>

Fluentd v1.16.3 and v1.16.2 have been released

Drop schedule announcement about EOL of Treasure Agent (td-agent) 4

About Treasure Agent (td-agent) 4</h2> Since td-agent 4.0.0 was released in 2020, td-agent 4 has been maintained for a long time.</p> As new major version of td-agent 4 was rebranded (to fluent-package</code> v5), and released in August 2023, we decided to stop maintaining td-agent 4.</p>

How to migrate to Fluent Package v5</h2> There is a good article to do it.</p>

Scheduled support lifecycle announcement about Fluent Package

Upgrade to fluent-package v5

Additional hints for v4 users</h2>

For macOS</h3> WARNING: Currently we have no plan to officially support dmg version of fluent-package</code> yet. It is just modified to be a minimally buildable state, it is for testing purpose only.</p>

td-agent v4.5.0 has been released

About next major version</h3> We are preparing next major version of td-agent which bundles Ruby 3.2. It's still work in progerss, we'll announce it as soon as we are ready for it.</p>

About next LTS schedule</h3>
We plan to ship next LTS version of fluent-package v5.0.4 on June, 2024. The content of updates are still in T.B.D.</p>

About next LTS schedule</h3>
We plan to ship next LTS version of fluent-package v5.0.3 on Feb, 2024. The content of updates are still in T.B.D.</p>

About Treasure Agent (td-agent) 4</h2>
Since td-agent 4.0.0 was released in 2020, td-agent 4 has been maintained for a long time.</p>
As new major version of td-agent 4 was rebranded (to `fluent-package</code> v5), and released in August 2023, we decided to stop maintaining td-agent 4.</p>`

How to migrate to Fluent Package v5</h2>
There is a good article to do it.</p>

Upgrade to fluent-package v5</a></li> </ul>
Follow the above instructions.</p>

For macOS</h3>
WARNING: Currently we have no plan to officially support dmg version of `fluent-package</code> yet. It is just modified to be a minimally buildable state, it is for testing purpose only.</p>`