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
Verwenden Sie ein SDK, wenn Sie eine Befehlszeilenschnittstelle verwenden möchten oder mehr benutzerdefinierte Funktionen für die Ablaufverfolgung, Überwachung oder Protokollierung benötigen als die, die in einem AWS Management Console verfügbar sind. Sie können auch ein AWS SDK 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 bei der Instrumentierung Ihrer Anwendung als auch bei der Konfiguration Ihres Collectors oder Agenten Anpassungen hinzufügen. Sie können ein SDK für die folgenden Aufgaben verwenden, die Sie mit einem AWS Management Console nicht erledigen 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 in einem Statistiksatz.
-
Passen Sie Ihren Collector an — Passen Sie die Konfiguration für jeden Teil eines Collectors an, einschließlich Empfänger, Prozessor, Exporter und Konnektor.
-
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 von anderen Anbietern und AWS Nichtdiensten ermöglicht, ohne dass Sie Ihren Code neu instrumentieren 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 X-Ray oder Ihrem Anwendungscode interagieren, nicht ändern möchten.
Weitere Informationen zu den einzelnen Funktionen finden Sie unterWahl zwischen den AWS SDKs Distro for OpenTelemetry und X-Ray.
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 einen Alarm auf der Grundlage Ihrer Messwerte in einzustellen CloudWatch.
Wenn Sie das ADOT SDK verwenden, haben Sie in Kombination mit einem Agenten die folgenden Optionen:
-
Verwenden Sie das ADOT SDK mit dem CloudWatch Agenten — empfohlen.
-
Verwenden Sie das ADOT SDK mit dem ADOTCollector
— empfohlen, wenn Sie herstellerunabhängige Software mit Sicherheits- und AWS 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 zu Ihrer Programmiersprache in der technischen Dokumentation von ADOT
. -
Konfigurieren Sie einen ADOT Collector so, dass er ihm mitteilt, 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 Anbieter außerhalb von 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 kann Ihre Anwendung automatisch instrumentieren. Informationen zu den ersten Schritten ADOT finden Sie unter Einführung
Verwenden Sie das SDK X-Ray
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 Sammeln 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 dies, 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 mit dem X-Ray SDK.
-
Konfigurieren Sie einen Collector so, dass er ihm mitteilt, wohin er die gesammelten Daten senden soll. 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 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, die den folgenden Programmiersprachen zugeordnet sind:
