Skip to content

OOM Kill: documentation using not required Docker Mounts when kernel has BPF built in #24068

Description

@colinbjohnson

Summary

The OOM Kill integration's Docker configuration documentation instructs users to mount /lib/modules and /usr/src into the Agent container:

-v /lib/modules:/lib/modules
-v /usr/src:/usr/src

When the Linux kernel has BPF compiled in (i.e., the kernel ships with BTF support, as is the often the case with kernels 5.8+) datadog-agent does not require access to /usr/src or /lib/modules.

Steps to reproduce

Run the Agent with /lib/modules and /usr/src omitted on a kernel with BPF built in:

docker run \
  --name datadog-agent \
  --cap-add CAP_BPF \
  --cap-add CAP_PERFMON \
  -v /sys/kernel/debug:/sys/kernel/debug \
  -e DD_API_KEY=<DD_API_KEY> \
  -e DD_HOSTNAME=test-oom-kill \
  -e DD_SYSTEM_PROBE_ENABLED=true \
  -e DD_SYSTEM_PROBE_CONFIG_ENABLE_OOM_KILL=true \
  public.ecr.aws/datadog/agent:latest

Expected behavior

Documentation should note that /lib/modules and /usr/src mounts are only required on kernels that do not have BPF compiled in.

Actual behavior

Documentation unconditionally lists /lib/modules and /usr/src as required mounts, causing unnecessary host filesystem exposure.

Environment

  • Kernel: 5.8+ with BTF/BPF built in
  • Docker: version 25.0.14, build 0bab007

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions