

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Risoluzione dei problemi di osservabilità dell'App Mesh
<a name="troubleshooting-observability"></a>

**Importante**  
Avviso di fine del supporto: il 30 settembre 2026, AWS verrà interrotto il supporto per. AWS App Mesh Dopo il 30 settembre 2026, non potrai più accedere alla AWS App Mesh console o alle risorse. AWS App Mesh Per ulteriori informazioni, consulta questo post di blog [Migrazione AWS App Mesh da Amazon ECS Service Connect.](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect) 

Questo argomento descrive i problemi più comuni che potresti riscontrare con l'osservabilità di App Mesh.

## Impossibile visualizzare le AWS X-Ray tracce delle mie applicazioni
<a name="ts-observability-x-ray-traces"></a>

**Caratteristiche**  
L'applicazione in App Mesh non visualizza le informazioni di tracciamento a raggi X nella console X-Ray o. APIs

**Risoluzione**  
Per utilizzare X-Ray in App Mesh, è necessario configurare correttamente i componenti per abilitare la comunicazione tra l'applicazione, i contenitori sidecar e il servizio X-Ray. Effettua le seguenti operazioni per confermare che X-Ray sia stato impostato correttamente:
+ Assicurati che il protocollo listener App Mesh Virtual Node non sia impostato come`TCP`.
+ Assicurati che il contenitore X-Ray distribuito con l'applicazione esponga la porta `2000` UDP e funzioni come utente. `1337` Per ulteriori informazioni, consulta l'esempio di [Amazon ECS X-Ray](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/howto-ecs-basics/deploy/2-meshify.yaml#L374-L386) su. GitHub
+ Assicurati che il contenitore Envoy abbia il tracciamento abilitato. Se si utilizza l'[immagine App Mesh Envoy](envoy.md), è possibile abilitare X-Ray impostando la variabile di `ENABLE_ENVOY_XRAY_TRACING` ambiente su un valore di `1` e la `XRAY_DAEMON_PORT` variabile di ambiente su. `2000`
+ Se hai inserito X-Ray nel codice dell'applicazione con uno [dei SDKs ](https://docs.aws.amazon.com/xray/index.html) linguaggi specifici, assicurati che sia configurato correttamente seguendo le guide per la tua lingua.
+ [Se tutti gli elementi precedenti sono configurati correttamente, esaminate i registri del contenitore X-Ray per individuare eventuali errori e seguire le istruzioni riportate in Risoluzione dei problemi. AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-troubleshooting.html) Una spiegazione più dettagliata dell'integrazione di X-Ray in App Mesh è disponibile in [Integrating X-Ray with](https://aws.amazon.com/blogs/compute/integrating-aws-x-ray-with-aws-app-mesh/) App Mesh.

[Se il problema persiste, valuta la possibilità di aprirne uno GitHub o di contattare l'[AWS assistenza](https://aws.amazon.com/premiumsupport/).](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here)

## Impossibile visualizzare i parametri di Envoy per le mie applicazioni nei parametri di Amazon CloudWatch
<a name="ts-observability-envoy-metrics"></a>

**Caratteristiche**  
La tua applicazione in App Mesh non emette metriche generate dal proxy Envoy nelle metriche. CloudWatch

**Risoluzione**  
Quando utilizzi le CloudWatch metriche in App Mesh, devi configurare correttamente diversi componenti per abilitare la comunicazione tra il proxy Envoy, il sidecar CloudWatch dell'agente e il servizio di metrica. CloudWatch Segui i passaggi seguenti per confermare che le CloudWatch metriche per il proxy Envoy siano state configurate correttamente:
+ Assicurati di utilizzare l'immagine dell' CloudWatch agente per App Mesh. Per ulteriori informazioni, consulta [App Mesh CloudWatch agent](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent) on GitHub.
+ Assicurati di aver configurato l' CloudWatch agente per App Mesh in modo appropriato seguendo le istruzioni d'uso specifiche della piattaforma. Per ulteriori informazioni, consulta [App Mesh CloudWatch agent](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent#usage) on GitHub.
+ Se tutti gli elementi precedenti sono configurati correttamente, esamina i registri del contenitore dell' CloudWatch agente per individuare eventuali errori e segui le indicazioni fornite in [Risoluzione dei problemi dell' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/troubleshooting-CloudWatch-Agent.html).

[Se il problema persiste, valuta la possibilità di aprirne uno GitHub o di contattare l'[AWS assistenza](https://aws.amazon.com/premiumsupport/).](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here)

## Impossibile configurare regole di campionamento personalizzate per le tracce AWS X-Ray
<a name="ts-observability-custom-sampling"></a>

**Caratteristiche**  
L'applicazione utilizza il tracciamento a raggi X, ma non è possibile configurare le regole di campionamento per le tracce.

**Risoluzione**  
Poiché App Mesh Envoy attualmente non supporta la **configurazione del campionamento a raggi X dinamici**, sono disponibili le seguenti soluzioni alternative.

Se la tua versione di Envoy è `1.19.1` o successiva, hai le seguenti opzioni.
+ Per impostare solo la frequenza di campionamento, usa la variabile di `XRAY_SAMPLING_RATE` ambiente sul contenitore Envoy. Il valore deve essere specificato come decimale tra `0` e (100%). `1.00` Per ulteriori informazioni, consulta [AWS X-Ray variabili](envoy-config.md#envoy-xray-config).
+ Per configurare le regole di campionamento personalizzate localizzate per il tracciante X-Ray, utilizzate la variabile di `XRAY_SAMPLING_RULE_MANIFEST` ambiente per specificare un percorso del file nel file system contenitore Envoy. *Per ulteriori informazioni, consulta le regole di [campionamento](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling) nella Guida per gli sviluppatori.AWS X-Ray *

Se la tua versione di Envoy è precedente alla`1.19.1`, procedi come segue.
+ Utilizzate la variabile di `ENVOY_TRACING_CFG_FILE` ambiente per modificare la frequenza di campionamento. Per ulteriori informazioni, consulta [Variabili di configurazione di Envoy](envoy-config.md). Specificate una configurazione di tracciamento personalizzata e definite le regole di campionamento locali. Per ulteriori informazioni, vedere [Envoy X-Ray](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/xray.proto.html#config-trace-v3-xrayconfig) config.
+ Esempio di configurazione di tracciamento personalizzata per la variabile di ambiente: `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
  ```
+ Per i dettagli sulla configurazione per il manifesto delle regole di campionamento nella `samplingRuleManifest` proprietà, vedere [Configurazione dell'X-Ray SDK for](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling) Go.

[Se il problema persiste, valuta la possibilità di aprirne uno GitHub o di contattare l'[AWS assistenza](https://aws.amazon.com/premiumsupport/).](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here)