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.

AWS X-Ray-SDK für Go

Das X-Ray-SDK SDK for Go besteht aus einer Reihe von Bibliotheken für Go-Anwendungen, die Klassen und Methoden zum Generieren und Senden von Ablaufverfolgungsdaten an den X-Ray-Daemon bereitstellen. Ablaufverfolgungsdaten umfassen Informationen zu eingehenden HTTP-Anforderungen, die von der Anwendung beantwortet werden, sowie Aufrufe, die Anwendung an nachgelagerte Services mithilfe desAWSSDK, HTTP-Clients oder ein SQL-Datenbankkonnektor. Sie können Segmente auch manuell erstellen und Debug-Informationen Anmerkungen und Metadaten hinzufügen.

Laden Sie das SDK aus seinem GitHub-Repository mit go get herunter:

$ go get -u github.com/aws/aws-xray-sdk-go/... 

Für Webanwendungen beginnen Sie damit, die Funktion xray.Handler zu verwenden, um eingehende Anforderungen nachzuverfolgen. Der Message Handler erstellt für jede rückverfolgte Anforderung ein Segment und vervollständigt das Segment, nachdem die Antwort gesendet wurde. Während das Segment geöffnet ist, können Sie die SDK-Client-Methoden nutzen, um dem Segment Informationen hinzuzufügen, Untersegmente zu erstellen und nachgelagerte Aufrufe rückzuverfolgen. Das SDK erfasst auch automatisch Ausnahmen, die Ihre Anwendung ausgibt, während das Segment geöffnet ist.

Für Lambda-Funktionen, die von einer instrumentierten Anwendung oder einem Dienst aufgerufen werden, liest Lambda dieAblaufverfolgungs-Headerund verfolgt gesampelte Anfragen automatisch. Für andere Funktionen können SieKonfigurieren Sie LambdaAblaufverfolgungs-eingehende Anforderungen. In beiden Fällen erstellt Lambda das Segment und stellt es dem X-Ray SDK zur Verfügung.

Als Nächstes umschließen Sie den Client mit einem Aufruf der AWS-Funktion. Dieser Schritt stellt sicher, dass X-Ray Aufrufe jeder Client-Methode instrumentiert. Sie können auch Aufrufe von SQL-Datenbanken instrumentieren.

Nachdem Sie die Verwendung des SDK begonnen haben, können Sie das Verhalten durchKonfigurieren des Recorders und der Middlewareaus. Sie können Plugins zum Festhalten von Daten über die Datenverarbeitungsressourcen, auf denen Ihre Anwendung ausgeführt wird, hinzufügen, das Samplingverhalten durch Samplingregeln anpassen und Protokollebenen einrichten, um mehr oder weniger Informationen von dem SDK in Ihren Anwendungsprotokollen zu sehen.

Zeichnen Sie zusätzliche Informationen zu Anforderungen und den Aufgaben, die Ihre Anwendung ausführt, in Anmerkungen und Metadaten auf. Anmerkungen sind einfache Schlüsselwertpaare, die für die Verwendung mit Filterausdrücken indiziert werden, damit Sie nach Ablaufverfolgen mit bestimmten Daten suchen können. Metadateneinträge sind weniger einschränkend und können ganze Objekte und Arrays aufzeichnen – alle Daten, die in eine JSON zusammengefasst werden können.

Wenn Sie viele instrumentierten Clients in Ihrem Code haben, kann ein einzelnes Anforderungssegmente viele Untersegmente enthalten, eines für jeden Aufruf mit einem instrumentierten Client. Sie können Untersegmente organisieren und gruppieren, indem Sie Client-Aufrufe in benutzerdefinierten Untersegmenten zusammenfassen. Sie können ein benutzerdefiniertes Untersegment für eine ganze Funktion oder eine Code-Abschnitt erstellen und Metadaten und Anmerkungen im Untersegment festhalten, anstatt alles im übergeordneten Segment aufzuzeichnen.

Voraussetzungen

Das X-Ray-SDK SDK for Go Go benötigt Go 1.9 oder höher.

Das SDK hängt von den folgenden Bibliotheken zur Kompilierungs- und Laufzeit ab:

Diese Abhängigkeiten werden in der README.md-Datei des SDK angegeben.

Referenzdokumentation

Nachdem Sie das SDK heruntergeladen haben, erstellen und hosten Sie die Dokumentation lokal, um sie in einem Webbrowser anzuzeigen.