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.
Verwenden Sie ein SDK
Anmerkung
X-Ray SDK/Daemon Wartungshinweis — Am 25. Februar 2026 wechselt das in den AWS X-Ray SDKs/Daemon Wartungsmodus, in dem die X-Ray SDK- und Daemon-Versionen begrenzt AWS werden, um nur Sicherheitsprobleme zu beheben. Weitere Informationen zum Zeitplan für den Support finden Sie unter. Zeitplan für die Support von X-Ray SDK und Daemon Wir empfehlen die Migration zu OpenTelemetry. Weitere Informationen zur Migration zu OpenTelemetry finden Sie unter Migration von X-Ray Instrumentierung zu OpenTelemetry Instrumentierung.
Verwenden Sie ein SDK, wenn Sie eine Befehlszeilenschnittstelle verwenden möchten oder mehr benutzerdefinierte Ablaufverfolgungs-, Überwachungs- oder Protokollierungsfunktionen benötigen, als in einem verfügbar sind. AWS-Managementkonsole Sie können ein AWS SDK auch verwenden, um Programme zu entwickeln, die die X-Ray APIs verwenden. Sie können entweder das AWS Distro for OpenTelemetry (ADOT) SDK oder das X-Ray SDK verwenden.
Wenn Sie ein SDK verwenden, können Sie Ihrem Workflow sowohl beim Instrumentieren Ihrer Anwendung als auch bei der Konfiguration Ihres Collectors oder Agenten Anpassungen hinzufügen. Sie können ein SDK verwenden, um die folgenden Aufgaben auszuführen, die Sie mit einem AWS-Managementkonsole nicht ausführen können:
-
Veröffentlichen Sie benutzerdefinierte Metriken — Stichproben von Metriken mit hoher Auflösung von bis zu 1 Sekunde, verwenden Sie mehrere Dimensionen, um Informationen zu einer Metrik hinzuzufügen, und aggregieren Sie Datenpunkte zu einem Statistiksatz.
-
Passen Sie Ihren Collector an — Passen Sie die Konfiguration für jeden Teil eines Collectors an, einschließlich Empfänger, Prozessor, Exporteur und Connector.
-
Passen Sie Ihre Instrumentierung an — Passen Sie Segmente und Untersegmente an, fügen Sie benutzerdefinierte Schlüssel-Wert-Paare als Attribute hinzu und erstellen Sie benutzerdefinierte Metriken.
-
Erstellen und aktualisieren Sie Stichprobenregeln programmgesteuert.
Verwenden Sie das ADOT SDK, wenn Sie die Flexibilität eines standardisierten OpenTelemetry SDK mit zusätzlichen AWS Sicherheits- und Optimierungsebenen nutzen möchten. Das AWS Distro for OpenTelemetry (ADOT) SDK ist ein herstellerunabhängiges Paket, das die Integration mit Backends anderer Anbieter und anderer Anbieter ermöglicht, ohne dass Sie Ihren Code neu instrumentieren AWS müssen.
Verwenden Sie das X-Ray SDK, wenn Sie das X-Ray SDK bereits verwenden, nur in AWS Backends integrieren und die Art und Weise, wie Sie mit dem Anwendungscode interagieren, oder Ihren Anwendungscode nicht ändern möchten. X-Ray
Weitere Informationen zu den einzelnen Funktionen finden Sie unterWahl zwischen AWS Distro for OpenTelemetry und X-Ray SDKs.
Verwenden Sie das ADOT SDK
Das ADOT SDK besteht aus einer Reihe von Open-Source-APIs, -Bibliotheken und -Agenten, die Daten an Backend-Dienste senden. ADOTwird von mehreren Backends und Agenten unterstützt AWS, lässt sich in mehrere Backends und Agenten integrieren und bietet eine große Anzahl von Open-Source-Bibliotheken, die von der OpenTelemetry Community verwaltet werden. Verwenden Sie das ADOT SDK, um Ihre Anwendung zu instrumentieren und Protokolle, Metadaten, Metriken und Traces zu sammeln. Sie können es auch verwendenADOT, um Dienste zu überwachen und anhand Ihrer Messwerte einen Alarm auszulösen CloudWatch.
Wenn Sie das ADOT SDK verwenden, haben Sie in Kombination mit einem Agenten die folgenden Optionen:
-
Verwenden Sie das ADOT SDK zusammen mit dem CloudWatch Agenten — empfohlen.
-
Verwenden Sie das ADOT SDK zusammen mit dem ADOT Collector
. Dies wird empfohlen, wenn Sie anbieterunabhängige Software mit AWS mehreren Sicherheits- und Optimierungsebenen verwenden möchten.
Gehen Sie wie folgt vor, um das ADOT SDK zu verwenden:
-
Instrumentieren Sie Ihre Anwendung mithilfe des ADOT SDK. Weitere Informationen finden Sie in der Dokumentation für Ihre Programmiersprache in der technischen ADOT-Dokumentation
. -
Konfigurieren Sie einen ADOT Collector, um ihm mitzuteilen, wohin die gesammelten Daten gesendet werden sollen.
Nachdem der ADOT Collector Ihre Daten empfangen hat, sendet er sie an das Backend, das Sie in der ADOT Konfiguration angeben. ADOTkann Daten an mehrere Backends senden, auch an externe Anbieter AWS, wie in der folgenden Abbildung dargestellt:
AWS wird regelmäßig aktualisiertADOT, um Funktionen hinzuzufügen und sich an das OpenTelemetry
-
Go
-
Java
-
JavaScript
-
Python
-
.NET
-
Ruby
-
PHP
Wenn Sie Python verwenden, ADOT können Sie Ihre Anwendung automatisch instrumentieren. Informationen zu den ersten Schritten mit der ADOT Collector-Distribution finden Sie unter Einführung
Verwenden Sie den X-Ray SDK
Das X-Ray SDK besteht aus einer Reihe von AWS APIs und Bibliotheken, die Daten an AWS Backend-Dienste senden. Verwenden Sie das X-Ray SDK, um Ihre Anwendung zu instrumentieren und Trace-Daten zu sammeln. Sie können das X-Ray SDK nicht zum Erfassen von Protokoll- oder Metrikdaten verwenden.
Wenn Sie das X-Ray SDK verwenden, haben Sie in Kombination mit einem Agenten die folgenden Optionen:
-
Verwenden Sie das X-Ray SDK mit AWS X-Ray Dämon — Verwenden Sie diese Option, wenn Sie Ihren Anwendungscode nicht aktualisieren möchten.
-
Verwenden Sie das X-Ray SDK mit dem CloudWatch Agenten — (empfohlen) Der CloudWatch Agent ist mit dem X-Ray SDK kompatibel.
Gehen Sie wie folgt vor, um das X-Ray SDK zu verwenden:
-
Instrumentieren Sie Ihre Anwendung mithilfe des X-Ray SDK.
-
Konfigurieren Sie einen Collector, um ihm mitzuteilen, wohin die gesammelten Daten gesendet werden sollen. Sie können entweder den CloudWatch Agenten oder den X-Ray Daemon verwenden, um Ihre Trace-Informationen zu sammeln.
Nachdem der Collector oder Agent Ihre Daten empfangen hat, sendet er sie an ein AWS Backend, das Sie in der Agentenkonfiguration angeben. Das X-Ray SDK kann nur Daten an ein AWS Backend senden, wie in der folgenden Abbildung dargestellt:
Wenn Sie es verwendenJava, können Sie das X-Ray SDK verwenden, um Ihre Anwendung automatisch zu instrumentieren. Informationen zu den ersten Schritten mit dem X-Ray SDK finden Sie in den Bibliotheken der folgenden Programmiersprachen:
