host

Para configurar este check para un Agent que se ejecuta en un host:

Recopilación de métricas

1. Asegúrate de que las métricas de OpenMetrics están expuestas en tu servicio Kong activando el complemento Prometheus.. Esto debe configurarse antes de que el Agent pueda recopilar métricas de Kong.

2. Añade este bloque de configuración a tu archivo kong.d/conf.yaml en la carpeta conf.d/ en la raíz de tu directorio de configuración del Agent para empezar a recopilar tus métricas Kong. Consulta el ejemplo de kong.d/conf.yaml para conocer todas las opciones de configuración disponibles:

   init_config:
   
   instances:
     ## @param openmetrics_endpoint - string - required
     ## The URL exposing metrics in the OpenMetrics format.
     #
     - openmetrics_endpoint: http://localhost:8001/metrics
   

3. Reinicia el Agent.

Nota: La versión actual del check (1.17.0 o posterior) utiliza OpenMetrics para la recopilación de métricas, que requiere Python 3. Para hosts que no pueden utilizar Python 3, o para utilizar una versión legacy de este check, consulta la siguiente configuración.

Recopilación de logs

Disponible para las versiones 6.0 o posteriores del Agent

Los logs de acceso de Kong son generados por NGINX, por lo que la localización por defecto es la misma que la de los archivos de NGINX.

1. La recopilación de logs está desactivada en forma predeterminada en el Datadog Agent, actívala en tu archivo datadog.yaml:

   logs_enabled: true
   

2. Añade este bloque de configuración a tu archivo kong.d/conf.yaml para empezar a recopilar tus logs de Kong:

   logs:
     - type: file
       path: /var/log/nginx/access.log
       service: '<SERVICE>'
       source: kong
   
     - type: file
       path: /var/log/nginx/error.log
       service: '<SERVICE>'
       source: kong
   

   Cambia los valores de los parámetros path y service y configúralos para tu entorno. Consulta el ejemplo de kong.d/conf.yaml para conocer todas las opciones de configuración disponibles.

3. Reinicia el Agent.

En contenedores

Asegúrate de que las métricas de OpenMetrics están expuestas en tu servicio de Kong habilitando el complemento de Prometheus. Esto debe configurarse antes de que el Agent pueda recopilar métricas de Kong. Para 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

Recopilación de logs

Disponible para las versiones 6.0 o posteriores del Agent

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