

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Solución de problemas de observabilidad de App Mesh
<a name="troubleshooting-observability"></a>

**importante**  
Aviso de fin del soporte: el 30 de septiembre de 2026, AWS dejaremos de ofrecer soporte para AWS App Mesh. Después del 30 de septiembre de 2026, ya no podrás acceder a la AWS App Mesh consola ni a AWS App Mesh los recursos. Para obtener más información, visite esta entrada del blog [Migración desde AWS App Mesh a Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect). 

En este tema se describen los problemas comunes que pueden ocurrir con la observabilidad de App Mesh.

## No puedo ver los AWS X-Ray rastros de mis aplicaciones
<a name="ts-observability-x-ray-traces"></a>

**Síntomas**  
Su aplicación en App Mesh no muestra información de rastreo de rayos X en la consola de X-Ray o APIs.

**Resolución**  
Para usar X-Ray en App Mesh, debe configurar correctamente los componentes para permitir la comunicación entre la aplicación, los contenedores sidecar y el servicio de X-Ray. Realice los pasos siguientes para confirmar que X-Ray se ha configurado correctamente:
+ Asegúrese de que el protocolo de oyente del nodo virtual de App Mesh no esté establecido en `TCP`.
+ Asegúrese de que el contenedor de X-Ray que se implementa con la aplicación muestre el puerto UDP `2000` y se ejecute como usuario `1337`. Para obtener más información, consulte el [ejemplo de Amazon ECS X-Ray](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/howto-ecs-basics/deploy/2-meshify.yaml#L374-L386) en GitHub.
+ Asegúrese de que el contenedor de Envoy tenga habilitado el rastreo. Si utiliza la [imagen de App Mesh Envoy](envoy.md), puede habilitar X-Ray estableciendo la variable de entorno `ENABLE_ENVOY_XRAY_TRACING` en un valor de `1` y la variable de entorno `XRAY_DAEMON_PORT` en un valor de `2000`.
+ Si ha instrumentado X-Ray en el código de su aplicación con uno de los [idiomas específicos SDKs ](https://docs.aws.amazon.com/xray/index.html), asegúrese de que esté configurado correctamente siguiendo las guías de su idioma.
+ Si todos los elementos anteriores están configurados correctamente, revise los registros del contenedor de X-Ray para ver si hay errores y siga las instrucciones de [Solución de problemas de AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-troubleshooting.html). Puede encontrar una explicación más detallada de la integración de X-Ray en App Mesh en [Integración de X-Ray con App Mesh](https://aws.amazon.com/blogs/compute/integrating-aws-x-ray-with-aws-app-mesh/).

Si el problema sigue sin resolverse, considera abrir un [GitHub problema](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) o ponte en contacto con [AWS Support](https://aws.amazon.com/premiumsupport/).

## No puedo ver las métricas de Envoy para mis aplicaciones en las CloudWatch métricas de Amazon
<a name="ts-observability-envoy-metrics"></a>

**Síntomas**  
Tu aplicación en App Mesh no emite las métricas generadas por el proxy de Envoy a CloudWatch las métricas.

**Resolución**  
Cuando utilizas CloudWatch métricas en App Mesh, debes configurar correctamente varios componentes para permitir la comunicación entre el proxy de Envoy, el sidecar del CloudWatch agente y el servicio de CloudWatch métricas. Siga los siguientes pasos para confirmar que CloudWatch las métricas del proxy de Envoy se han configurado correctamente:
+ Asegúrese de utilizar la imagen del CloudWatch agente para App Mesh. Para obtener más información, consulte el [ CloudWatchagente App Mesh](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent) en GitHub.
+ Asegúrese de haber configurado el CloudWatch agente para App Mesh de forma adecuada siguiendo las instrucciones de uso específicas de la plataforma. Para obtener más información, consulte el [ CloudWatchagente App Mesh](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent#usage) en GitHub.
+ Si todos los elementos anteriores están configurados correctamente, revise los registros del contenedor del CloudWatch agente para ver si hay errores y siga las instrucciones que se proporcionan en [Solución de problemas con el CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/troubleshooting-CloudWatch-Agent.html).

Si el problema sigue sin resolverse, considera abrir un [GitHub problema](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) o ponte en contacto con [AWS Support](https://aws.amazon.com/premiumsupport/).

## No se pueden configurar reglas de muestreo personalizadas para las AWS X-Ray trazas
<a name="ts-observability-custom-sampling"></a>

**Síntomas**  
Su aplicación utiliza el rastreo de X-Ray, pero no puede configurar las reglas de muestreo de sus rastreos.

**Resolución**  
Dado que App Mesh Envoy no admite actualmente la **configuración de muestreo dinámico de X-Ray**, existen las siguientes soluciones alternativas.

Si su versión de Envoy es `1.19.1` o posterior, tiene las siguientes opciones.
+ Para establecer únicamente la frecuencia de muestreo, utilice la variable de entorno `XRAY_SAMPLING_RATE` en el contenedor de Envoy. El valor debe especificarse como un decimal entre `0` y `1.00` (100 %). Para obtener más información, consulte [AWS X-Ray variables](envoy-config.md#envoy-xray-config).
+ Para configurar las reglas de muestreo personalizadas y localizadas para el rastreador de X-Ray, utilice la variable de entorno `XRAY_SAMPLING_RULE_MANIFEST` para especificar una ruta de archivo del sistema de archivos del contenedor de Envoy. Para obtener más información, consulte [Reglas de muestreo](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling) en la *Guía para desarrolladores de AWS X-Ray *.

Si su versión de Envoy es anterior a la `1.19.1`, haga lo siguiente.
+ Utilice la variable de entorno `ENVOY_TRACING_CFG_FILE` para cambiar la frecuencia de muestreo. Para obtener más información, consulte [Variables de configuración de Envoy](envoy-config.md). Especifique una configuración de rastreo personalizada y defina las reglas de muestreo locales. Para obtener más información, consulte [Configuración de X-Ray para Envoy](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/xray.proto.html#config-trace-v3-xrayconfig).
+ Ejemplo de configuración de rastreo personalizada para la variable de entorno `ENVOY_TRACING_CFG_FILE`:

  ```
  tracing:
     http:
       name: envoy.tracers.xray
       typedConfig:
         "@type": type.googleapis.com/envoy.config.trace.v3.XRayConfig
         segmentName: foo/bar
         segmentFields:
           origin: AWS::AppMesh::Proxy
           aws:
             app_mesh:
               mesh_name: foo
               virtual_node_name: bar
         daemonEndpoint:
               protocol: UDP
               address: 127.0.0.1
               portValue: 2000
         samplingRuleManifest:
               filename: /tmp/sampling-rules.json
  ```
+ Para obtener más información sobre la configuración del manifiesto de reglas de muestreo en la propiedad `samplingRuleManifest`, consulte [Configuración del SDK de X-Ray para Go](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling).

Si el problema sigue sin resolverse, considera abrir un [GitHub problema](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) o ponte en contacto con [AWS Support](https://aws.amazon.com/premiumsupport/).