You MUST set up your environment according to the steps below before installing Fluentd. Failing to do so will be the cause of many unnecessary problems.
It's HIGHLY recommended that you set up NTP daemon (e.g. chrony, ntpd, etc) on the node to have accurate current timestamp. This is crucial for the production-grade logging services. For AWS (Amazon Web Services) users we recommend to use Amazon Time Sync Service, AWS hosted NTP server. Please check AWS EC2: Setting the Time for Your Linux Instance.
Please increase the maximum number of file descriptors. You can check the current number using the
$ ulimit -n
If your console shows
1024, it is insufficient. Please add following lines to your
/etc/security/limits.conffile and reboot your machine.
root soft nofile 65536
root hard nofile 65536
* soft nofile 65536
* hard nofile 65536
65536is safer value for large deployment. The required number of file descriptors depends on your fluentd plugins and setting. Here are the estimation examples:
- in_tail: The number of watching files
- in_forward: The number of incoming access
- output: The used file descriptors are less than others. Temporaryfile for upload, connection pooling in the client library, etc
For high load environments consisting of many Fluentd instances, please add these parameters to your
/etc/sysctl.conffile. Please either type
sysctl -por reboot your node to have the changes take effect.
net.core.somaxconn = 1024
net.core.netdev_max_backlog = 5000
net.core.rmem_max = 16777216
net.core.wmem_max = 16777216
net.ipv4.tcp_wmem = 4096 12582912 16777216
net.ipv4.tcp_rmem = 4096 12582912 16777216
net.ipv4.tcp_max_syn_backlog = 8096
net.ipv4.tcp_slow_start_after_idle = 0
net.ipv4.tcp_tw_reuse = 1
net.ipv4.ip_local_port_range = 10240 65535
These kernel options were originally taken from the presentation "How Netflix Tunes EC2 Instances for Performance" by Brendan Gregg, Senior Performance Architect at AWS re:Invent 2017.
If this article is incorrect or outdated, or omits critical information, please let us know. Fluentd is a open source project under Cloud Native Computing Foundation (CNCF). All components are available under the Apache 2 License.