nginx-ingress-controller

Supported OS

Versión de la integración4.1.0

Información general

Este check monitoriza el controlador de entrada NGINX de Kubernetes. Para monitorizar el controlador de entrada F5 NGINX, configura la integración de Datadog Prometheus para monitorizar las métricas deseadas desde la lista proporcionada por el NGINX Prometheus Exporter.

Configuración

Instalación

El check nginx-ingress-controller está incluido en el paquete del Datadog Agent, por lo que no necesitas instalar nada más en tu servidor.

Configuración

Host

Si tu Agent se está ejecutando en un host, edita el archivo nginx_ingress_controller.d/conf.yaml, en la carpeta conf.d/ en la raíz de tu directorio de configuración del Agent. Consulta el nginx_ingress_controller.d/conf.yaml de ejemplo para ver todas las opciones disponibles de configuración. A continuación, reinicia el Agent.

Contenedores

En el caso de los entornos en contenedores, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de los parámetros que se indican a continuación.

Recopilación de métricas

Por defecto, a las métricas de NGINX las recopila el check de nginx-ingress-controller, pero por conveniencia puede que quieras ejecutar el check de nginx en el controlador de entrada.

Puedes conseguirlo haciendo que se pueda acceder a la página de estado de NGINX desde el Agent. Para ello, utiliza la configuración nginx-status-ipv4-whitelist en el controlador y añade anotaciones de Autodiscovery al pod del controlador.

Por ejemplo, estas anotaciones habilitan tanto los checks nginx y nginx-ingress-controller como la recopilación de logs:

ParámetroValor
<INTEGRATION_NAME>["nginx","nginx_ingress_controller"]
<INIT_CONFIG>[{},{}]
<INSTANCE_CONFIG>[{"nginx_status_url": "http://%%host%%:18080/nginx_status"},{"prometheus_url": "http://%%host%%:10254/metrics"}]

Consulta el nginx_ingress_controller.d/conf.yaml de ejemplo para ver todas las opciones disponibles de configuración.

Nota: Para las versiones nginx-ingress-controller 0.23.0+, el servidor nginx que escucha en el puerto 18080 fue eliminado, puede ser restaurado añadiendo el siguiente http-snippet al configmap de configuración:

  http-snippet: |
    server {
      listen 18080;

      location /nginx_status {
        allow all;
        stub_status on;
      }

      location / {
        return 404;
      }
    }

Recopilación de logs

Disponible para la versión 6.0 o posteriores del Agent

La recopilación de logs está deshabilitada por defecto en el Datadog Agent. Para activarla, consulta Recopilación de logs de Kubernetes.

ParámetroValor
<LOG_CONFIG>[{"service": "controller", "source": "nginx-ingress-controller"}]

Validación

Ejecuta el subcomando de estado del Agent y busca nginx_ingress_controller en la sección Checks.

Datos recopilados

Métricas

Eventos

El controlador de entrada de NGINX no incluye ningún evento.

Checks de servicios

El controlador de entrada de NGINX no incluye ningún check de servicio.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el servicio de asistencia de Datadog.

PREVIEWING: may/embedded-workflows