Estadísticas de Envoy

El proxy Envoy mantiene estadísticas detalladas sobre el tráfico de red.

Las estadísticas de Envoy solo cubren el tráfico de una instancia concreta de Envoy. Consulta Observabilidad para la telemetría persistente de Istio por servicio. Las estadísticas que registran los proxies Envoy pueden aportar más información sobre instancias específicas de pods.

Para ver las estadísticas de un pod:

$ kubectl exec "$POD" -c istio-proxy -- pilot-agent request GET stats

Envoy genera estadísticas sobre su comportamiento y las agrupa según la función del proxy. Algunos ejemplos:

• Conexión upstream
• Listener
• HTTP Connection Manager
• TCP proxy
• Router

De forma predeterminada, Istio configura Envoy para que registre un conjunto mínimo de estadísticas, con el fin de reducir el consumo global de CPU y memoria de los proxies instalados. Las claves de recopilación predeterminadas son:

• cluster_manager
• listener_manager
• server
• cluster.xds-grpc

Para ver la configuración de Envoy para la recopilación de datos estadísticos, usa istioctl proxy-config bootstrap y sigue la inmersión profunda en la configuración de Envoy. Envoy solo recopila datos estadísticos de los elementos que coinciden con la inclusion_list dentro del elemento JSON stats_matcher.

Para configurar el proxy de Istio de modo que registre estadísticas adicionales, puedes agregar ProxyConfig.ProxyStatsMatcher a la mesh config. Por ejemplo, para habilitar globalmente las estadísticas de circuit breakers, reintentos de solicitudes, conexiones upstream y timeouts de solicitudes, puedes especificar el stats matcher de la siguiente manera:

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  meshConfig:
    defaultConfig:
      proxyStatsMatcher:
        inclusionRegexps:
          - ".*outlier_detection.*"
          - ".*upstream_rq_retry.*"
          - ".*upstream_cx_.*"
        inclusionSuffixes:
          - "upstream_rq_timeout"

También puedes sobrescribir la configuración global de coincidencia de estadísticas por proxy mediante la anotación proxy.istio.io/config. Por ejemplo, para configurar la misma inclusión de generación de estadísticas que arriba, puedes agregar la anotación a un proxy de gateway o a un workload de la siguiente manera:

metadata:
  annotations:
    proxy.istio.io/config: |-
      proxyStatsMatcher:
        inclusionRegexps:
        - ".*outlier_detection.*"
        - ".*upstream_rq_retry.*"
        - ".*upstream_cx_.*"
        inclusionSuffixes:
        - "upstream_rq_timeout"

Nomenclatura de Istio para los recursos de Envoy

Envoy delimita el alcance de la mayoría de las estadísticas según el clúster, el connection manager o la dirección del listener a los que pertenecen. Istio genera los nombres de los clústeres y de los connection managers al traducir la configuración de la mesh a configuración de Envoy, por lo que también aparecen en los nombres de las estadísticas, en las etiquetas de Prometheus y en los registros de acceso.

Estos nombres se aplican a los sidecar proxies y a los gateways. Los waypoint proxies en modo ambient usan nombres de clúster diferentes, y ztunnel no utiliza Envoy.

El segmento subset del nombre de un clúster de salida está vacío cuando no se aplica ningún subset de DestinationRule, por ejemplo outbound|9080||reviews.default.svc.cluster.local. Envoy crea las estadísticas de tráfico de un clúster, como upstream_rq_total, cuando el proxy le envía tráfico por primera vez, por lo que no existen para los clústeres que aún no han recibido tráfico. Para listar los clústeres y listeners de un proxy, consulta depuración de Envoy e Istiod.

Istio termina la mayoría de los nombres de clúster y de HTTP connection manager usados en las estadísticas con el delimitador ;, por ejemplo:

cluster.outbound|9080||reviews.default.svc.cluster.local;.upstream_rq_total
http.outbound_0.0.0.0_9080;.downstream_rq_total

La configuración de bootstrap del proxy extrae estos nombres en tags, que se convierten en etiquetas en la salida de Prometheus de Envoy. Por ejemplo, envoy_cluster_upstream_rq_total tiene una etiqueta cluster_name con el valor outbound|9080||reviews.default.svc.cluster.local. Los tags más utilizados son:

• cluster_name: el nombre del clúster.
• http_conn_manager_prefix: el nombre del HTTP connection manager.
• tcp_prefix: el nombre del TCP proxy.
• response_code y response_code_class: el código de respuesta HTTP, como 200 o 2xx.
• listener_address: la dirección del listener, como 0.0.0.0_15006.

Para ver la lista completa de tags y las expresiones que los extraen, consulta el elemento stats_config en la salida de istioctl proxy-config bootstrap.

Personalizar los nombres de las estadísticas de clúster

Las opciones de mesh config inboundClusterStatName y outboundClusterStatName reemplazan los nombres de clúster en las estadísticas por un patrón que tú controlas. Los nombres de los clústeres en sí no cambian, por lo que el enrutamiento y la salida de istioctl proxy-config no se ven afectados. El patrón puede usar las siguientes variables:

Istio agrega el delimitador ; al resultado, por lo que el tag cluster_name sigue funcionando. Los mismos patrones también nombran las estadísticas de los TCP proxies, sin el delimitador. No cambian los nombres de clúster en los registros de acceso.

Si un patrón omite %SUBSET_NAME%, los clústeres de todos los subsets de un servicio comparten las mismas estadísticas. Por ejemplo, para nombrar las estadísticas de los clústeres de salida según el servicio y el puerto:

apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  meshConfig:
    outboundClusterStatName: "%SERVICE%_%SERVICE_PORT%"

Con esta configuración, las estadísticas de las solicitudes al servicio httpbin en el puerto 8000 del namespace default comienzan con cluster.httpbin.default_8000; en lugar de cluster.outbound|8000||httpbin.default.svc.cluster.local;.