Descubrimiento automático de contenedores para integración en el host

Nuestra característica de descubrimiento automático de contenedores le permite configurar una integración para monitor automáticamente los servicios que se ejecutan en múltiples contenedores. En el archivo de configuración de una integración, puede establecer los criterios de coincidencia del contenedor y el agente ejecuta la integración para cada contenedor local que coincida con los criterios.

Una integración se ejecutará tantas veces como encuentre elementos de descubrimiento. Si el descubrimiento no encuentra ningún contenedor, la integración no se ejecutará.

Añade marcador de posición a tu configuración

En tu configuración de integración, debes crear ${discovery.<property>} marcador de posición. Luego, estos serán reemplazados automáticamente por información específica del contenedor.

Estos ejemplos (para entornos solo docker y para Kubernetes) muestran cómo configurar una integración NGINX para monitor todos los contenedores locales que tienen un nombre de imagen que contiene nginx y que están etiquetados como env=production. Cada servicio estará disponible a través de diferentes IP y puertos, por lo que deben ser variables.

discovery:
  docker:
    match:
      image: /nginx/
      label.env: production
integrations:
  - name: nginx-server-metrics
    command: metrics
    env:
# use discovery.private.ip if container doesn't have attached public ip address
      STATUS_URL: http://${discovery.ip}:${discovery.port}/status
      STATUS_MODULE: discover
      REMOTE_MONITORING: true
    labels:
      env: ${discovery.label.env}
      role: ${discovery.label.role}

Agregar propiedades de descubrimiento

Para configurar el descubrimiento, configure una entrada discovery en su configuración de integración YAML usando las siguientes propiedades. Un contenedor coincidirá cuando all las propiedades coincidan con los valores definidos.

Ejemplo de descubrimiento

El siguiente ejemplo coincide con todos los contenedores docker cuya imagen comienza con httpd: (proporcionada como una expresión regular) y está etiquetada como scrapable=yes. Los resultados se almacenan en caché con un tiempo de vida de 5 minutos.

discovery:
  ttl: 5m
  docker:
    match:
      image: /^httpd:/
      label.scrapable: yes

Información de contenedores disponibles

Nuestra característica de descubrimiento actualmente emite las siguientes variables, que pueden usarse para configurar su integración. El agente de infraestructura los reemplaza por los valores correspondientes del contenedor descubierto.

Mapeo múltiples puertos

Cuando un contenedor expone muchos puertos públicos o privados, se puede acceder a ellos a través de discovery.private.ports. o discovery.ports. seguido de un índice que comienza en 0. Los puertos se indexan del valor de puerto privado más bajo al más alto.

Por ejemplo, un contenedor que expone los puertos privados 80 y 443 a través de los puertos públicos 2345 y 1111, respectivamente, proporcionaría las siguientes variables con sus respectivos valores:

Puertos mapeo por nombre de protocolo

Además de la indexación de la sección anterior, también se puede hacer referencia a los puertos por su nombre de protocolo (como tcp, udp, etc.). Por ejemplo, ${discovery.ports.tcp} o ${discovery.ports.udp}.

Si varios puertos coinciden con el mismo protocolo, también se pueden indexar según las reglas de la sección anterior: ${discovery.ports.tcp.0}, ${discovery.ports.tcp.1}, etc.