This documentation contains work-in-progress information for future Elastic Stack and Cloud releases. Use the version selector to view supported release docs. It also contains some Elastic Cloud serverless information. Check out our serverless docs for more details.
« Use a proxy with the Universal Profiling Agent Environment variables to configure the Universal Profiling Agent »
Elastic Docs ›Elastic Observability [master] ›Infrastructure and host monitoring ›Universal Profiling ›Advanced configuration

Override kernel version check

edit

Override kernel version check

edit

The -no-kernel-version-check flag, or the no-kernel-version-check key in the Universal Profiling Agent configuration file, controls the kernel version compatibility check during the Universal Profiling Agent’s startup process. The kernel version compatibility check enforces the minimum kernel version supported, and prevents the profiling agent from running on certain kernel versions with known issues. When the no-kernel-version-check is set to true, the compatibility check is bypassed, allowing Universal Profiling Agent execution to proceed regardless of the kernel version. By default, this option is set to false, and the kernel compatibility version check is performed as usual.

Take extra caution when using this configuration option, especially when running the Universal Profiling Agent on older kernels with backported eBPF functionalities. Setting this option to true on kernels with unfixed eBPF bugs can crash your system.

Host agent configuration example
edit

The following example shows how to configure the -no-kernel-version-check in the Universal Profiling agent CLI:

sudo pf-host-agent/pf-host-agent -no-kernel-version-check=true

It is also possible to use the environment variable PRODFILER_NO_KERNEL_VERSION_CHECK=true to set this configuration.

« Use a proxy with the Universal Profiling Agent Environment variables to configure the Universal Profiling Agent »