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 einer SDK
Verwenden Sie eine, SDK wenn Sie eine Befehlszeilenschnittstelle verwenden möchten oder mehr benutzerdefinierte Ablaufverfolgungs-, Überwachungs- oder Protokollierungsfunktionen benötigen als die, die in einer AWS Management Console verfügbar sind. Sie können eine auch verwenden, um Programme AWS SDK zu entwickeln, die das X-Ray verwendenAPIs. Sie können entweder die AWS Distro for OpenTelemetry (ADOT) SDK oder die X-Ray SDK verwenden.
Wenn Sie einen verwendenSDK, 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 einen verwendenSDK, um die folgenden Aufgaben zu erledigen, 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 die ADOTSDK, wenn Sie die Flexibilität einer standardisierten Lösung OpenTelemetry SDK mit zusätzlichen AWS Sicherheits- und Optimierungsebenen nutzen möchten. The AWS Distro for OpenTelemetry (ADOT) SDK ist ein herstellerunabhängiges Paket, das die Integration mit Back-Ends anderer Anbieter und anderer Anbieter ermöglicht, ohne dass Sie Ihren Code neu instrumentieren AWS müssen.
Verwenden Sie X-Ray, SDK wenn Sie X-Ray bereits verwendenSDK, 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 AWS Distro for OpenTelemetry und X-Ray SDKs.
Verwenden Sie die ADOT SDK
Das ADOT SDK ist eine Reihe von Open-Source-Bibliotheken und -AgentenAPIs, die Daten an Backend-Dienste senden. ADOTwird unterstützt von 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 die ADOTSDK, 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 den verwenden ADOTSDK, haben Sie in Kombination mit einem Agenten die folgenden Optionen:
-
Verwenden Sie den ADOT SDK zusammen mit dem CloudWatch Agenten — empfohlen.
-
Verwenden Sie den ADOT SDK mit dem ADOTCollector
— empfohlen, wenn Sie herstellerunabhängige Software mit Sicherheits- und AWS Optimierungsebenen verwenden möchten.
Gehen Sie wie folgt vor ADOTSDK, um den zu verwenden:
-
Instrumentieren Sie Ihre Anwendung mit dem ADOTSDK. Weitere Informationen finden Sie in der Dokumentation zu Ihrer Programmiersprache in der ADOTtechnischen Dokumentation
. -
Konfigurieren Sie einen ADOT Collector so, dass er ihm mitteilt, wohin er die gesammelten Daten senden soll.
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 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-RaySDK, um Ihre Anwendung zu instrumentieren und Spurendaten zu sammeln. Sie können das X-Ray nicht SDK zum Sammeln von Protokoll- oder Metrikdaten verwenden.
Wenn Sie das X-Ray verwendenSDK, haben Sie in Kombination mit einem Agenten die folgenden Optionen:
-
Verwenden Sie das X-Ray SDK mit dem AWS X-Ray Dämon — Verwenden Sie dies, wenn Sie Ihren Anwendungscode nicht aktualisieren möchten.
-
Verwenden Sie das X-Ray SDK zusammen mit dem CloudWatch Wirkstoff — (empfohlen) Der CloudWatch Wirkstoff ist mit dem X-Ray kompatibelSDK.
Gehen Sie wie folgt vorSDK, um das X-Ray zu verwenden:
-
Instrumentieren Sie Ihre Anwendung mit dem X-RaySDK.
-
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 verwenden, SDK um Ihre Anwendung automatisch zu instrumentieren. Informationen zu den ersten Schritten mit X-Ray finden Sie in den BibliothekenSDK, die den folgenden Programmiersprachen zugeordnet sind:
