datadog/ingress-nginx-injection repository overview

⁠Datadog Ingress-NGINX Injection

Overview

datadog/ingress-nginx-injection provides init-container to instrument Ingress-NGINX Controller⁠ with Datadog’s monitoring module⁠.

Key Features

• Integrates Datadog Application Performance Monitoring⁠ and Application Security Management⁠.

Usage Instructions

1. Identify your Ingress-NGINX Controller version.
2. Use the corresponding version of datadog/ingress-nginx-injection (refer to the compatibility table below).
3. Add this image as an init-container in your Ingress-NGINX pod specification:

initContainers:
  - name: init-datadog
    image: datadog/ingress-nginx-injection:<INGRESS_NGINX_VERSION>
    command: ['/datadog/init_module.sh', '/opt/datadog-modules']
    volumeMounts:
      - name: nginx-module
        mountPath: /opt/datadog-modules

1. Configure the Datadog Agent connection and load the module via a ConfigMap:

kind: ConfigMap
apiVersion: v1
...
data:
  enable-opentelemetry: "false"
  error-log-level: notice
  main-snippet: |
    load_module /opt/datadog-modules/ngx_http_datadog_module.so;

For full setup instructions, visit the official documentation⁠.

⁠Compatibility

This image must match the version of your Ingress-NGINX Controller to ensure successful injection. Mismatched versions may prevent the controller from starting.

Support
For issues, visit the Datadog Support page⁠.