I get errors about ulimit in splunkd.log
Are you seeing messages like these in splunkd.log while running Splunk software on *nix, possibly accompanied by a Splunk software crash?
03-03-2011 21:50:09.027 INFO ulimit - Limit: virtual address space size: unlimited 03-03-2011 21:50:09.027 INFO ulimit - Limit: data segment size: 1879048192 bytes [hard maximum: unlimited] 03-03-2011 21:50:09.027 INFO ulimit - Limit: resident memory size: 2147482624 bytes [hard maximum: unlimited] 03-03-2011 21:50:09.027 INFO ulimit - Limit: stack size: 33554432 bytes [hard maximum: 2147483646 bytes] 03-03-2011 21:50:09.027 INFO ulimit - Limit: core file size: 1073741312 bytes [hard maximum: unlimited] 03-03-2011 21:50:09.027 INFO ulimit - Limit: data file size: 2147483646 bytes 03-03-2011 21:50:09.027 ERROR ulimit - Splunk may not work due to low file size limit 03-03-2011 21:50:09.027 INFO ulimit - Limit: open files: 1024 03-03-2011 21:50:09.027 INFO ulimit - Limit: cpu time: unlimited 03-03-2011 21:50:09.029 INFO loader - Splunkd starting (build 95063).
If so, you might need to adjust your server ulimit. Ulimit controls the resources available to a *nix shell and processors the *nix shell has started. A machine running Splunk software needs higher limits than are provided by default.
Check current limits
There are a few ways you can check your current ulimit settings.
- On the command line, you can type
ulimit -a
- You can restart Splunk Enterprise and look in splunkd.log for events mentioning ulimit:
index=_internal source=*splunkd.log ulimit
- The monitoring console has a health check for ulimits. See Access and customize health check in Monitoring Splunk Enterprise.
Set new limits
Your Splunk administrator determines the correct level and sets each of these values. To persistently modify the values, edit the limit settings in your operating system. How you do this depends on the version of *nix that you run:
- For earlier versions of Linux that use the
init
system, edit the/etc/security/limits.conf
file. - For the latest versions of Linux that run the
systemd
system, edit either/etc/systemd/system.conf
,/etc/systemd/user.conf
or, if Splunk software has been configured to run as a systemd service,/etc/systemd/system/splunkd.service
. This path might vary depending on your distribution of Linux.
The most important values are:
- The file size (
ulimit -f
). The size of an uncompressed bucket file can be very high. - The data segment size (
ulimit -d
). Increase the value to at least 1 GB = 1073741824 bytes. - The number of open files (
ulimit -n
), sometimes called the number of file descriptors. This should be at least 8192. Your machine might concurrently need file descriptors for every forwarder socket, deployment client socket, file to be indexed, and user connected. Each bucket can use 10 to 100 files, every search consumes up to four file descriptors, and KV store can use many file descriptors.
- The max user processes (
ulimit -u
). This number must be large enough to accommodate all Splunk threads. The thread count grows with concurrent http connections, parallel pipelines, KV store, and most of all concurrent searches. If you must have a limit (other than unlimited), choose a value in the high thousands or tens of thousands.
Another value that you might need to modify on an older system (but not on most modern systems) is the system-wide file size, fs.file-max
, in /etc/sysctl.conf
.
See System requirements for use of Splunk Enterprise on-premises in the Installation Manual.
Set limits using /etc/security/limits.conf
These instructions are for machines that run the init service.
- Become the root user or an administrative equivalent with
su
:
sudo su -
- Open
/etc/security/limits.conf
with a text editor. - Add at least the following values, or confirm that they exist:
* hard nofile 64000 * hard nproc 8192 * hard fsize -1
- Save the file and exit the text editor.
- Restart the machine to complete the changes.
Set limits using the /etc/systemd configuration files
These instructions are for machines that run the systemd service. Editing the /etc/systemd/system.conf
file sets system-wide limits, while editing /etc/systemd/user.conf
sets limits for services that run under a specific user within systemd.
- Become the root user or an administrative equivalent with
su
:
sudo su -
- Open
/etc/systemd/system.conf
with a text editor. - Add at least the following values to the file:
[Manager] DefaultLimitFSIZE=-1 DefaultLimitNOFILE=64000 DefaultLimitNPROC=8192
- Save the file and exit the text editor.
- Restart the machine to complete the changes.
The latest releases of systemd no longer accept DefaultLimitFSIZE=-1 as a valid parameter. Use DefaultLimitFSIZE=infinity instead.
Troubleshoot high memory usage | Splunk Enterprise does not start due to unusable filesystem |
This documentation applies to the following versions of Splunk® Enterprise: 7.2.0, 7.2.1, 7.2.2, 7.2.3, 7.2.4, 7.2.5, 7.2.6, 7.2.7, 7.2.8, 7.2.9, 7.2.10, 7.3.0, 7.3.1, 7.3.2, 7.3.3, 7.3.4, 7.3.5, 7.3.6, 7.3.7, 7.3.8, 7.3.9
Feedback submitted, thanks!