Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Fehlerbehebung bei App Mesh Observability
**Wichtig**
Hinweis zum Ende des Supports: Am 30. September 2026 AWS wird der Support für eingestellt. AWS App Mesh Nach dem 30. September 2026 können Sie nicht mehr auf die AWS App Mesh Konsole oder die Ressourcen zugreifen. AWS App Mesh Weitere Informationen finden Sie in diesem Blogbeitrag [Migration von AWS App Mesh zu Amazon ECS Service Connect](https://aws.amazon.com/blogs/containers/migrating-from-aws-app-mesh-to-amazon-ecs-service-connect).
In diesem Thema werden häufig auftretende Probleme beschrieben, die bei der App Mesh Mesh-Observability auftreten können.
## Es können keine AWS X-Ray Spuren für meine Anwendungen gefunden werden
**Symptome**
Ihre Anwendung in App Mesh zeigt keine X-Ray-Tracing-Informationen in der X-Ray-Konsole an oder APIs.
**Auflösung**
Um X-Ray in App Mesh verwenden zu können, müssen Sie die Komponenten korrekt konfigurieren, um die Kommunikation zwischen Ihrer Anwendung, den Sidecar-Containern und dem X-Ray-Dienst zu ermöglichen. Gehen Sie wie folgt vor, um sicherzustellen, dass X-Ray korrekt eingerichtet wurde:
+ Stellen Sie sicher, dass das App Mesh Virtual Node Listener-Protokoll nicht als `TCP` festgelegt ist.
+ Stellen Sie sicher, dass der X-Ray-Container, der mit Ihrer Anwendung bereitgestellt wird, den UDP-Port verfügbar macht `2000` und als Benutzer `1337` ausgeführt wird. Weitere Informationen finden Sie im [Amazon ECS X-Ray-Beispiel](https://github.com/aws/aws-app-mesh-examples/blob/main/walkthroughs/howto-ecs-basics/deploy/2-meshify.yaml#L374-L386) unter GitHub.
+ Vergewissern Sie sich, dass für den Envoy-Container die Ablaufverfolgung aktiviert ist. Wenn Sie das [App Mesh Envoy-Image](envoy.md) verwenden, können Sie X-Ray aktivieren, indem Sie die `ENABLE_ENVOY_XRAY_TRACING` Umgebungsvariable auf den Wert `1` und die `XRAY_DAEMON_PORT` Umgebungsvariable auf `2000` setzen.
+ Wenn Sie X-Ray in Ihrem Anwendungscode mit einem der [sprachspezifischen](https://docs.aws.amazon.com/xray/index.html) Instrumente ausgestattet haben, stellen Sie sicher SDKs , dass es korrekt konfiguriert ist, indem Sie den Anleitungen für Ihre Sprache folgen.
+ Wenn alle vorherigen Elemente korrekt konfiguriert sind, überprüfen Sie die X-Ray-Container-Protokolle auf Fehler und folgen Sie den Anweisungen unter [Problembehandlung AWS X-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-troubleshooting.html). Eine detailliertere Erklärung der X-Ray-Integration in App Mesh finden Sie unter [X-Ray mit App Mesh integrieren](https://aws.amazon.com/blogs/compute/integrating-aws-x-ray-with-aws-app-mesh/).
Wenn Ihr Problem immer noch nicht gelöst ist, erwägen Sie, ein [GitHub Problem](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) zu öffnen, oder wenden Sie sich an den [AWS Support](https://aws.amazon.com/premiumsupport/).
## Die Envoy-Metriken für meine Anwendungen können in den CloudWatch Amazon-Metriken nicht angezeigt werden
**Symptome**
Ihre Anwendung in App Mesh gibt keine vom Envoy-Proxy generierten Metriken an CloudWatch Metriken aus.
**Auflösung**
Wenn Sie CloudWatch Metriken in App Mesh verwenden, müssen Sie mehrere Komponenten korrekt konfigurieren, um die Kommunikation zwischen Ihrem Envoy-Proxy, dem CloudWatch Agent-Sidecar und dem CloudWatch Metrik-Service zu ermöglichen. Gehen Sie wie folgt vor, um sicherzustellen, dass die CloudWatch Metriken für den Envoy-Proxy korrekt eingerichtet wurden:
+ Stellen Sie sicher, dass Sie das CloudWatch Agent-Image für App Mesh verwenden. Weitere Informationen finden Sie unter [App Mesh CloudWatch Agent](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent) on GitHub.
+ Stellen Sie sicher, dass Sie den CloudWatch Agenten für App Mesh entsprechend konfiguriert haben, indem Sie die plattformspezifischen Nutzungsanweisungen befolgen. Weitere Informationen finden Sie unter [App Mesh CloudWatch Agent](https://github.com/aws-samples/aws-app-mesh-cloudwatch-agent#usage) on GitHub.
+ Wenn alle vorherigen Elemente korrekt konfiguriert sind, überprüfen Sie die CloudWatch Agent-Container-Protokolle auf Fehler und folgen Sie den Anweisungen unter [Fehlerbehebung beim CloudWatch Agenten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/troubleshooting-CloudWatch-Agent.html).
Wenn Ihr Problem immer noch nicht gelöst ist, erwägen Sie, ein [GitHub Problem](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) zu öffnen, oder wenden Sie sich an den [AWS Support](https://aws.amazon.com/premiumsupport/).
## Benutzerdefinierte Sampling-Regeln für AWS X-Ray Traces konnten nicht konfiguriert werden
**Symptome**
Ihre Anwendung verwendet X-Ray Tracing, aber Sie können keine Sampling-Regeln für Ihre Traces konfigurieren.
**Auflösung**
Da App Mesh Envoy derzeit keine **dynamische X-Ray-Sampling-Konfiguration** unterstützt, sind die folgenden Problemumgehungen verfügbar.
Wenn Ihre Envoy-Version `1.19.1` oder höher ist, haben Sie die folgenden Optionen.
+ Um nur die Sampling-Rate festzulegen, verwenden Sie die `XRAY_SAMPLING_RATE` Umgebungsvariable im Envoy-Container. Der Wert sollte als Dezimalzahl zwischen `0` und `1.00` (100%) angegeben werden. Weitere Informationen finden Sie unter [AWS X-Ray Variablen](envoy-config.md#envoy-xray-config).
+ Um die lokalisierten benutzerdefinierten Sampling-Regeln für den X-Ray Tracer zu konfigurieren, verwenden Sie die `XRAY_SAMPLING_RULE_MANIFEST` Umgebungsvariable, um einen Dateipfad im Envoy-Container-Dateisystem anzugeben. Weitere Informationen finden Sie unter [Sampling-Regeln](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling) im *AWS X-Ray Developer* Guide.
Wenn Ihre Envoy-Version älter ist`1.19.1`, gehen Sie wie folgt vor.
+ Verwenden Sie die `ENVOY_TRACING_CFG_FILE` Umgebungsvariable, um Ihre Sampling-Rate zu ändern. Weitere Informationen finden Sie unter [Envoy-Konfigurationsvariablen](envoy-config.md). Geben Sie eine benutzerdefinierte Tracing-Konfiguration an und definieren Sie lokale Sampling-Regeln. Weitere Informationen finden Sie unter [Envoy X-Ray-Konfiguration](https://www.envoyproxy.io/docs/envoy/latest/api-v3/config/trace/v3/xray.proto.html#config-trace-v3-xrayconfig).
+ Beispiel für eine benutzerdefinierte Ablaufverfolgungskonfiguration für die `ENVOY_TRACING_CFG_FILE` Umgebungsvariable:
```
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
```
+ Einzelheiten zur Konfiguration des Sampling-Regel-Manifests in der `samplingRuleManifest` Eigenschaft finden Sie unter [X-Ray SDK for Go konfigurieren](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-go-configuration.html#xray-sdk-go-configuration-sampling).
Wenn Ihr Problem immer noch nicht gelöst ist, erwägen Sie, ein [GitHub Problem](https://github.com/aws/aws-app-mesh-roadmap/issues/new?assignees=&labels=Bug&template=issue--bug-report.md&title=Bug%3A+describe+bug+here) zu öffnen, oder wenden Sie sich an den [AWS Support](https://aws.amazon.com/premiumsupport/).