Información general

Datadog monitoriza todos los aspectos de tu entorno Istio, de modo que puedes hacer lo siguiente:

• Evaluar el estado de Envoy y el plano de control de Istio con logs.
• Desglosar el rendimiento de tu malla de servicios con métricas de solicitudes, ancho de banda y consumo de recursos.
• Asigna la comunicación de red entre contenedores, pods y servicios a través de la malla con Cloud Network Monitoring.
• Profundiza en las trazas distribuidas de las aplicaciones que realizan transacciones en la malla con APM.
• Utiliza Datadog App and API Protection para proteger tu malla de servicios de Istio con detección y bloqueo de amenazas en tiempo real en el borde de tu infraestructura.

Para obtener más información sobre la monitorización de tu entorno de Istio con Datadog, consulta la entrada del blog Monitorización.

Configuración

Para obtener instrucciones generales sobre la configuración de integraciones en entornos con contenedores, consulta Configurar integraciones con Autodiscovery en Kubernetes o Configurar integraciones con Autodiscovery en Docker.

Esta integración basada en OpenMetrics tiene un modo más reciente (use_openmetrics: true) y un modo heredado (use_openmetrics: false). Para obtener todas las características más actualizadas, Datadog recomienda activar el modo más reciente. Para obtener más información, consulta Latest and Legacy Versioning For OpenMetrics-based Integrations.

Si tienes varias instancias de Datadog que recopilan métricas de Istio, asegúrate de utilizar el mismo modo para todas ellas. De lo contrario, los datos de las métricas pueden fluctuar en el sitio de Datadog.

Las métricas marcadas como [OpenMetrics V1], [OpenMetrics V2] u [OpenMetrics V1 and V2] solo están disponibles con el uso del modo correspondiente de la integración Istio. Las métricas marcadas como Istio v1.5+ se recopilan mediante la versión 1.5 de Istio o posteriores.

Instalación (métricas)

Istio está incluido en el Datadog Agent. Instala el Datadog Agent en tus servidores de Istio o en tu clúster y apúntelo a Istio.

Envoy

Si deseas monitorizar los proxies de Envoy en Istio, configura la integración de Envoy.

Instalación (Seguridad: App and API Protection)

El proceso de instalación requiere un enfoque diferente al de habilitar esta integración. Las instrucciones de instalación están disponibles en la documentación Enabling App and API Protection for Istio.

Configuración

Recopilación de métricas

Para monitorizar Istio v1.5+ hay dos componentes clave que coinciden con la arquitectura de Istio para las métricas con formato Prometheus:

• Plano de datos: Contenedores sidecar del istio-proxy.
• Plano de control: Servicio istiod que gestiona los proxies.

Ambos se ejecutan como checks del Agent de istio, pero tienen responsabilidades diferentes y se configuran por separado.

Configuración del plano de datos

El archivo predeterminado istio.d/auto_conf.yaml configura automáticamente la monitorización para cada uno de los contenedores istio-proxy auxiliares. El Agent inicializa este check para cada contenedor auxiliar que detecta automáticamente. Esta configuración permite la generación de informes de métricas istio.mesh.* para los datos expuestos por cada uno de estos contenedores auxiliares.

Para personalizar la parte del plano de datos de la integración, crea un archivo de configuración de Istio personalizado istio.yaml. Consulta Configurar integraciones en Kubernetes o Configurar integraciones con Autodiscovery en Docker para conocer las opciones de creación de este archivo.

Este archivo debe contener:

ad_identifiers:
  - proxyv2
  - proxyv2-rhel8

init_config:

instances:
  - use_openmetrics: true
    send_histograms_buckets: false
    istio_mesh_endpoint: http://%%host%%:15020/stats/prometheus
    tag_by_endpoint: false

Personaliza este archivo con cualquier configuración adicional. Consulta el istio.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.

Configuración del plano de control

Para monitorizar el plano de control de Istio y notificar las métricas mixer, galley, pilot y citadel, debes configurar el Agent para monitorizar el despliegue de istiod. En Istio v1.5 o posterior, aplica las siguientes anotaciones de pod para el despliegue de istiod en el espacio de nombres istio-system:

ad.datadoghq.com/discovery.checks: |
  {
    "istio": {
      "instances": [
        {
          "istiod_endpoint": "http://%%host%%:15014/metrics",
          "use_openmetrics": "true"
        }
      ]
    }
  }

Nota: La sintaxis de Autodiscovery Annotations v2 es compatible con el Agent v7.36 o posterior.

Esta anotación especifica el contenedor discovery para que coincida con el nombre por defecto del contenedor Istio en este pod. Sustituye esta anotación ad.datadoghq.com/<CONTAINER_NAME>.checks por el nombre (.spec.containers[i].name) de tu contenedor Istio, si el tuyo difiere.

El método para aplicar estas anotaciones varía en función de la estrategia de despliegue de Istio (Istioctl, Helm, Operator) utilizada. Consulta la documentación de Istio para conocer el método adecuado para aplicar estas anotaciones de pod. Consulta el istio.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.

Desactivar la inyección de sidecars para pods del Datadog Agent

Si estás instalando el Datadog Agent en un contenedor, Datadog recomienda que primero desactives la inyección auxiliar de Istio.

Versiones de Istio iguales o superiores a la v1.10:

Añade la etiqueta (label) sidecar.istio.io/inject: "false" al DaemonSet datadog-agent:

# (...)
spec:
  template:
    metadata:
      labels:
        sidecar.istio.io/inject: "false"
    # (...)

Esto también puede hacerse con el comando kubectl patch.

kubectl patch daemonset datadog-agent -p '{"spec":{"template":{"metadata":{"labels":{"sidecar.istio.io/inject":"false"}}}}}'

Versiones de Istio <= 1.9:

Añade la anotación sidecar.istio.io/inject: "false" al DaemonSet datadog-agent:

# (...)
spec:
  template:
    metadata:
      annotations:
        sidecar.istio.io/inject: "false"
    # (...)

Utilizando el comando kubectl patch:

kubectl patch daemonset datadog-agent -p '{"spec":{"template":{"metadata":{"annotations":{"sidecar.istio.io/inject":"false"}}}}}'

Recopilación de logs

Disponible para las versiones 6.0 o posteriores del Agent

En primer lugar, habilita el Datadog Agent para realizar la recopilación de logs en Kubernetes. Consulta la recopilación de logs de Kubernetes.

Logs de Istio

Para recopilar logs de Istio de tu plano de control (istiod), aplica las siguientes anotaciones de pod para el despliegue de istiod en el espacio de nombres istio-system:

ad.datadoghq.com/discovery.logs: |
  [
    {
      "source": "istio",
      "service": "<SERVICE_NAME>"
    }
  ]

Esta anotación especifica el contenedor discovery para que coincida con el nombre de contenedor por defecto del contenedor Istio en este pod. Sustituye esta anotación ad.datadoghq.com/<CONTAINER_NAME>.logs por el nombre (.spec.containers[i].name) de tu contenedor Istio, si el tuyo difiere.

Sustituye <SERVICE_NAME> por el nombre de servicio Istio que elijas.

Logs de acceso a Envoy

Para recopilar logs de acceso a Envoy de tu plano de datos (istio-proxy):

1. Activa Envoy access logging within Istio
2. Aplica la siguiente anotación al pod en el que se inyectó el contenedor istio-proxy

ad.datadoghq.com/istio-proxy.logs: |
  [
    {
      "source": "envoy",
      "service": "<SERVICE_NAME>"
    }
  ]

Esta anotación especifica el contenedor istio-proxy para que coincida con el nombre de contenedor por defecto del contenedor sidecar de Istio inyectado. Sustituye esta anotación ad.datadoghq.com/<CONTAINER_NAME>.logs por el nombre (.spec.containers[i].name) de tu contenedor sidecar de Istio, si el tuyo difiere.

Sustituye <SERVICE_NAME> por el nombre de servicio de proxy de Istio que elijas.

Validación

Ejecuta el subcomando info del Agent y busca istio en la sección Checks.

Datos recopilados

Métricas

Eventos

El check de Istio no incluye eventos.

Checks de servicio

istio.prometheus.health

Devuelve CRITICAL si el check no puede acceder al endpoint de métricas. En caso contrario, devuelve OK.

Estados: ok, critical

istio.openmetrics.health

Devuelve CRITICAL si el Agent no puede conectarse al endpoint de OpenMetrics, en caso contrario devuelve OK.

Estados: ok, critical

istio.pilot.prometheus.health

Devuelve CRITICAL si el check no puede acceder al endpoint de métricas. En caso contrario, devuelve OK.

Estados: ok, critical

istio.galley.prometheus.health

Devuelve CRITICAL si el check no puede acceder al endpoint de métricas. En caso contrario, devuelve OK.

Estados: ok, critical

istio.citadel.prometheus.health

Devuelve CRITICAL si el check no puede acceder al endpoint de métricas. En caso contrario, devuelve OK.

Estados: ok, critical

Solucionar problemas

Error de longitud de fragmento no válida

Si ves el siguiente error en el modo legacy de la integración Istio (versión 3.13.0 o anterior de la integración Istio):

  Error: ("Connection broken: InvalidChunkLength(got length b'', 0 bytes read)",
  InvalidChunkLength(got length b'', 0 bytes read))

Puedes utilizar el modo más reciente de la integración Istio basada en OpenMetrics para solucionar este error.

Debes actualizar como mínimo al Agent 7.31.0 y a Python 3. Consulta la sección Configuración para habilitar OpenMetrics.

Uso de la integración genérica OpenMetrics en un despliegue de Istio

Si está activada la inyección auxiliar del proxy de Istio, la monitorización de otras métricas de Prometheus mediante la integración de OpenMetrics con el mismo endpoint de métricas que istio_mesh_endpoint puede dar lugar a un uso elevado de métricas personalizadas y a una recopilación duplicada de métricas.

Para asegurarte de que tu configuración de OpenMetrics no recopile métricas de forma redundante, puedes:

1. Utilizar una coincidencia de métricas específica en la opción de configuración de metrics o
2. Si utilizas el valor comodín * para metrics, considera la posibilidad de utilizar las siguientes opciones de la integración OpenMetrics para excluir métricas ya compatibles con las integraciones Istio y Envoy.

Configuración del modo más reciente de OpenMetrics con recopilación de métricas genéricas

Asegúrate de excluir las métricas de Istio y Envoy de tu configuración para evitar recibir una facturación elevada por métricas personalizadas. Utiliza exclude_metrics si elopenmetrics_endpoint está habilitado.

## Every instance is scheduled independent of the others.
#
instances:
  - openmetrics_endpoint: <OPENMETRICS_ENDPOINT>
    metrics:
    - '.*'
    exclude_metrics:
      - istio_.*
      - envoy_.*

Configuración del modo legacy de OpenMetrics con recopilación de métricas genéricas

Asegúrate de excluir las métricas de Istio y Envoy de tu configuración para evitar recibir una facturación elevada por métricas personalizadas. Utiliza ignore_metrics si la prometheus_url está habilitada.

instances:
  - prometheus_url: <PROMETHEUS_URL>
    metrics:
      - '*'
    ignore_metrics:
      - istio_*
      - envoy_*

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

Referencias adicionales

Documentación útil adicional, enlaces y artículos:

• Monitorizar tu malla de servicio de Istio con Datadog
• Aprende cómo Datadog recopila métricas clave para monitorizar Istio
• Cómo monitorizar Istio con Datadog