datadog/ingress-nginx-injection

Datadog Ingress-NGINX 注入工具

镜像概述和主要用途

datadog/ingress-nginx-injection 提供一个初始化容器（init-container），用于为 https://github.com/kubernetes/ingress-nginx 注入 https://github.com/DataDog/nginx-datadog%EF%BC%8C%E5%AE%9E%E7%8E%B0%E5%AF%B9 Ingress-NGINX 控制器的性能追踪和安全管理功能。

核心功能和特性

• 集成 Datadog 应用性能监控（APM），实现对 Ingress-NGINX 流量的分布式追踪。
• 集成 Datadog 应用安全管理（ASM），提供应用层安全监控能力。

使用场景和适用范围

适用于在 Kubernetes 环境中部署了 Ingress-NGINX Controller，并希望通过 Datadog 平台对其进行性能监控、请求追踪和安全管理的用户。尤其适合需要深入分析入口流量性能瓶颈、排查请求延迟问题以及加强应用层安全监控的场景。

详细使用方法和配置说明

前提条件

• 已部署 Ingress-NGINX Controller，且版本明确（需与本镜像版本严格匹配，详见兼容性章节）。
• 已部署 Datadog Agent 并确保其与 Ingress-NGINX Controller 网络可达。

部署步骤

1. 确定版本匹配关系

根据已部署的 Ingress-NGINX Controller 版本，选择对应版本的 datadog/ingress-nginx-injection 镜像（详见兼容性表格）。

2. 在 Ingress-NGINX Pod 中添加初始化容器

修改 Ingress-NGINX Controller 的 Pod 规范，添加如下 init-container 配置，用于注入 Datadog 监控模块：

yaml
initContainers:
  - name: init-datadog
    image: datadog/ingress-nginx-injection:<INGRESS_NGINX_VERSION>  # 替换为实际版本，如 v1.13.2
    command: ['/datadog/init_module.sh', '/opt/datadog-modules']
    volumeMounts:
      - name: nginx-module
        mountPath: /opt/datadog-modules  # 挂载卷用于存储注入的模块文件

3. 配置存储卷

在 Pod 的 volumes 部分添加用于共享模块文件的卷：

yaml
volumes:
  - name: nginx-module
    emptyDir: {}  # 使用 emptyDir 卷在 init-container 和主容器间共享模块文件

4. 通过 ConfigMap 配置模块加载与 Datadog Agent 连接

修改 Ingress-NGINX Controller 的 ConfigMap，添加模块加载配置及 Datadog Agent 连接参数：

yaml
kind: ConfigMap
apiVersion: v1
metadata:
  name: ingress-nginx-controller  # 对应 Ingress-NGINX Controller 的 ConfigMap 名称
  namespace: ingress-nginx  # 根据实际命名空间调整
data:
  enable-opentelemetry: "false"  # 禁用 OpenTelemetry（如未使用）
  error-log-level: notice  # 日志级别配置
  main-snippet: |
    load_module /opt/datadog-modules/ngx_http_datadog_module.so;  # 加载 Datadog 模块
    datadog_stats_config on;  # 启用 Datadog 统计配置（根据需要调整）
    datadog_agent_host "datadog-agent";  # Datadog Agent 的服务名称（默认在同一命名空间）
    datadog_agent_port 8126;  # Datadog Agent 的默认追踪端口

完整配置参考

如需详细配置步骤，请参阅 Datadog 官方文档。

兼容性说明

本镜像版本必须与 Ingress-NGINX Controller 版本严格匹配，否则可能导致控制器启动失败。版本不匹配会引发模块注入错误，进而影响 Ingress-NGINX Controller 的正常运行。

支持与反馈

如在使用过程中遇到问题，请访问 Datadog 支持页面 获取帮助。# Datadog Ingress-NGINX 注入工具

镜像概述和主要用途

datadog/ingress-nginx-injection 是一个初始化容器（init-container）镜像，用于为 https://github.com/kubernetes/ingress-nginx 注入 https://github.com/DataDog/nginx-datadog%E3%80%82%E5%85%B6%E4%B8%BB%E8%A6%81%E7%94%A8%E9%80%94%E6%98%AF%E5%9C%A8 Kubernetes 环境中实现对 Ingress-NGINX Controller 的性能追踪和安全监控能力集成。

核心功能和特性

• 集成 Datadog 应用性能监控（APM），支持分布式追踪数据采集
• 集成 Datadog 应用安全管理（ASM），提供应用层安全监控能力

使用场景和适用范围

适用于需要通过 Datadog 平台监控 Kubernetes 环境中 Ingress-NGINX Controller 的场景，特别是：

• 需要对入口流量进行性能追踪和延迟分析的用户
• 需要实现应用层安全监控和威胁检测的企业环境
• 使用 Datadog 作为统一可观测性平台的 Kubernetes 集群

详细使用方法和配置说明

前提条件

• 已部署 Ingress-NGINX Controller
• 已部署 Datadog Agent 并确保网络可达
• 确保 init-container 版本与 Ingress-NGINX Controller 版本严格匹配

部署步骤

1. 版本匹配确认

根据已部署的 Ingress-NGINX Controller 版本，选择对应版本的 datadog/ingress-nginx-injection 镜像（详见兼容性表格）。

2. 配置初始化容器

在 Ingress-NGINX Controller 的 Pod 规范中添加以下 init-container 配置：

yaml
initContainers:
  - name: init-datadog
    image: datadog/ingress-nginx-injection:<INGRESS_NGINX_VERSION>  # 替换为实际版本，如 v1.13.2
    command: ['/datadog/init_module.sh', '/opt/datadog-modules']
    volumeMounts:
      - name: nginx-module
        mountPath: /opt/datadog-modules

3. 添加共享卷配置

在 Pod 规范的 volumes 部分添加用于模块共享的卷：

yaml
volumes:
  - name: nginx-module
    emptyDir: {}  # 用于在 init-container 和主容器间共享模块文件

4. 配置模块加载（ConfigMap）

通过 ConfigMap 配置 NGINX 加载 Datadog 模块：

yaml
kind: ConfigMap
apiVersion: v1
metadata:
  name: ingress-nginx-controller  # 对应 Ingress-NGINX Controller 的 ConfigMap 名称
data:
  enable-opentelemetry: "false"
  error-log-level: notice
  main-snippet: |
    load_module /opt/datadog-modules/ngx_http_datadog_module.so;
    # 可选：添加 Datadog 模块配置参数
    datadog_stats_config on;
    datadog_agent_host "datadog-agent";  # Datadog Agent 服务名称
    datadog_agent_port 8126;             # Datadog Agent 追踪端口

完整配置参考

有关完整设置说明，请访问 官方文档。

兼容性说明

本镜像版本必须与 Ingress-NGINX Controller 版本严格匹配，版本不匹配可能导致控制器启动失败。

支持与反馈

如遇使用问题，请访问 Datadog 支持页面 获取帮助。完整设置说明请参阅 官方文档。