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.
# Problembehebung AWS X-Ray
In diesem Thema werden häufig auftretende Fehler und Probleme aufgeführt, die bei der Verwendung der X-Ray-API, der X-Ray-Konsole oder auftreten können SDKs. Wenn Sie auf ein Problem stoßen, das hier nicht aufgeführt ist, können Sie die Schaltfläche **Feedback** auf dieser Seite verwenden, um es zu melden.
**Topics**
+ [Seiten mit Röntgen-Trace-Map und Trace-Details](#xray-console-troubleshooting)
+ [X-Ray SDK for Java](#troubleshooting-java)
+ [X-Ray SDK für Node.js](#troubleshooting-nodejs)
+ [Der X-Ray-Daemon](#troubleshooting-daemon)
## Seiten mit Röntgen-Trace-Map und Trace-Details
Die folgenden Abschnitte können Ihnen helfen, wenn Sie Probleme mit der X-Ray-Trace-Map und der Trace-Detailseite haben:
### Ich sehe nicht alle meine CloudWatch Logs
Wie Logs so konfiguriert werden, dass sie auf den Seiten mit der X-Ray-Trace-Map und den Trace-Details angezeigt werden, hängt vom jeweiligen Dienst ab.
+ API-Gateway-Protokolle werden angezeigt, wenn die Protokollierung in API Gateway aktiviert ist.
Nicht alle Service Map-Knoten unterstützen die Anzeige der zugehörigen Protokolle. Protokolle für die folgenden Knotentypen anzeigen:
+ Lambda-Kontext
+ Lambda-Funktion
+ API-Gateway-Phase
+ Amazon-ECS-Cluster
+ Amazon ECS-Instanz
+ Amazon-ECS-Service
+ Amazon-ECS-Aufgaben
+ Amazon-EKS-Cluster
+ Amazon EKS-Namespace
+ Amazon EKS-Knoten
+ Amazon-EKS-Pod
+ Amazon EKS-Dienst
### Ich sehe nicht alle meine Alarme auf der X-Ray-Trace-Map
Die X-Ray-Trace-Map zeigt nur das Warnsymbol für einen Knoten, wenn sich Alarme, die diesem Knoten zugeordnet sind, im ALARM-Status befinden.
Die Trace-Map ordnet Alarme mithilfe der folgenden Logik Knoten zu:
+ Wenn der Knoten einen AWS Dienst darstellt, sind alle Alarme, deren Namespace diesem Dienst zugeordnet ist, diesem Knoten zugeordnet. Beispielsweise `AWS::Kinesis` ist ein Knoten des Typs mit allen Alarmen verknüpft, die auf Metriken im CloudWatch `AWS/Kinesis` Namespace basieren.
+ Wenn der Knoten eine AWS Ressource darstellt, sind die Alarme für diese spezifische Ressource verknüpft. Beispielsweise ist ein Knoten vom Typ `AWS::DynamoDB::Table` mit dem Namen „MyTable“ mit allen Alarmen verknüpft, die auf einer Metrik mit dem Namespace basieren `AWS/DynamoDB` und deren `TableName` Dimension auf `MyTable` gesetzt ist.
+ Wenn der Knoten vom unbekannten Typ ist, der durch einen gestrichelten Rahmen um den Namen identifiziert wird, sind diesem Knoten keine Alarme zugeordnet.
### Ich sehe einige AWS Ressourcen nicht auf der Trace-Map
Nicht jede AWS Ressource wird durch einen dedizierten Knoten repräsentiert. Einige AWS Dienste werden durch einen einzigen Knoten für alle Anfragen an den Dienst repräsentiert. Die folgenden Ressourcentypen werden mit einem Knoten pro Ressource angezeigt:
+ `AWS::DynamoDB::Table`
+ `AWS::Lambda::Function`
Lambda-Funktionen werden durch zwei Knoten dargestellt — einen für den Lambda-Container und einen für die Funktion. Dies hilft, Kaltstartprobleme mit Lambda-Funktionen zu identifizieren. Lambda-Container-Knoten werden auf dieselbe Weise mit Alarmen und Dashboards verknüpft wie Lambda-Funktionsknoten.
+ `AWS::ApiGateway::Stage`
+ `AWS::SQS::Queue`
+ `AWS::SNS::Topic`
### Die Trace-Map enthält zu viele Knoten
Verwenden Sie X-Ray-Gruppen, um Ihre Übersicht in mehrere Übersichten aufzuteilen. Weitere Informationen finden Sie unter [ Verwenden von Filterausdrücken mit Gruppen](xray-console-filters.md#groups).
## X-Ray SDK for Java
**Fehler:** *Ausnahme im Thread „Thread-1" com.amazonaws.xray.exceptions. SegmentNotFoundException: Das Untersegment mit dem Namen 'AmazonSNS' konnte nicht gestartet werden: Das Segment* konnte nicht gefunden werden.
Dieser Fehler weist darauf hin, dass das X-Ray-SDK versucht hat, einen ausgehenden Anruf aufzuzeichnen AWS, aber kein offenes Segment finden konnte. Dies kann in folgenden Situationen auftreten:
+ **Ein Servlet-Filter ist nicht konfiguriert** — Das X-Ray SDK erstellt Segmente für eingehende Anfragen mit einem Filter namens`AWSXRayServletFilter`. [Konfigurieren Sie einen Servlet-Filter](xray-sdk-java-filters.md), um eingehende Anfragen zu instrumentieren.
+ **Sie verwenden instrumentierte Clients außerhalb des Servlet-Codes** — Wenn Sie einen instrumentierten Client verwenden, um Aufrufe in Startcode oder anderem Code zu tätigen, der nicht als Antwort auf eine eingehende Anfrage ausgeführt wird, müssen Sie ein Segment manuell erstellen. Beispiele finden Sie unter [Instrumentieren von Startup-Code](scorekeep-startup.md).
+ **Sie verwenden instrumentierte Clients in Worker-Threads**. Wenn Sie einen neuen Thread erstellen, verliert der X-Ray-Recorder seinen Verweis auf das offene Segment. Sie können die Methoden [https://docs.aws.amazon.com/xray-sdk-for-java/latest/javadoc/com/amazonaws/xray/AWSXRayRecorder.html#getTraceEntity--](https://docs.aws.amazon.com/xray-sdk-for-java/latest/javadoc/com/amazonaws/xray/AWSXRayRecorder.html#getTraceEntity--) und [https://docs.aws.amazon.com/xray-sdk-for-java/latest/javadoc/com/amazonaws/xray/AWSXRayRecorder.html#setTraceEntity--](https://docs.aws.amazon.com/xray-sdk-for-java/latest/javadoc/com/amazonaws/xray/AWSXRayRecorder.html#setTraceEntity--) verwenden, um eine Referenz zum aktuellen Segment oder Untersegment zu erhalten ([https://docs.aws.amazon.com/xray-sdk-for-java/latest/javadoc/com/amazonaws/xray/entities/Entity.html](https://docs.aws.amazon.com/xray-sdk-for-java/latest/javadoc/com/amazonaws/xray/entities/Entity.html)) und sie innerhalb des Threads wieder an den Recorder zu übergeben. Ein Beispiel finden Sie unter [Verwenden instrumentierter Clients in Auftragnehmer-Threads](scorekeep-workerthreads.md).
## X-Ray SDK für Node.js
**Problem:** *CLS funktioniert nicht mit Sequelize*
Übergeben Sie das X-Ray-SDK für den Namespace Node.js mit der Methode an Sequelize. `cls`
```
var AWSXRay = require('aws-xray-sdk');
const Sequelize = require('sequelize');
Sequelize.cls = AWSXRay.getNamespace();
const sequelize = new Sequelize(...);
```
**Problem:** *CLS funktioniert nicht mit Bluebird*
Verwenden Sie `cls-bluebird`, damit Bluebird mit CLS funktioniert.
```
var AWSXRay = require('aws-xray-sdk');
var Promise = require('bluebird');
var clsBluebird = require('cls-bluebird');
clsBluebird(AWSXRay.getNamespace());
```
## Der X-Ray-Daemon
**Problem:** *Der Daemon verwendet die falschen Anmeldeinformationen*
Der Daemon verwendet das AWS SDK, um Anmeldeinformationen zu laden. Wenn Sie Anmeldeinformationen mit mehreren Methoden bereitstellen, wird die Methode mit der höchsten Priorität verwendet. Weitere Informationen finden Sie unter [Ausführen des Daemons](xray-daemon.md#xray-daemon-running).