Hinzufügen von Anmerkungen und Metadaten zu Segmenten mit dem X-Ray-SDK SDK for Go - AWS X-Ray

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.

Hinzufügen von Anmerkungen und Metadaten zu Segmenten mit dem X-Ray-SDK SDK for Go

Sie können den Anmerkungen und Metadaten zusätzliche Informationen zu Anforderungen hinzufügen. Sie können den von X-Ray-SDK erstellten Segmenten oder benutzerdefinierten Untersegmenten Anmerkungen und Metadaten hinzufügen.

Annotationensind Schlüsselwertpaare mit Zeichenfolge, Zahl oder booleschen Werten. Anmerkungen werden für die Verwendung mitFilterausdrückeaus. Berücksichtigen Sie Anmerkungen, um Daten zur Gruppierung von Ablaufverfolgungen in der Konsole zu verwenden, oder wenn Sie die GetTraceSummaries-API aufrufen.

Metadatasind Schlüsselwertpaare, die Werte aller Art enthalten können, einschließlich Objekte und Listen, jedoch nicht für die Verwendung mit Filterausdrücken. Verwenden Sie Metadaten zum Aufzeichnen zusätzlicher Daten in der Ablaufverfolgung, die nicht für die Suche erforderlich sind.

Zusätzlich zu Anmerkungen und Metadaten können Sie auch Benutzer-ID-Zeichenfolgen in Segmenten aufzeichnen. Benutzer-IDs werden in einem eigenen Feld aufgezeichnet und zur Suche indiziert.

Aufzeichnen von Anmerkungen mit dem X-Ray-SDK SDK for Go

Verwenden Sie Anmerkungen, um Informationen zu Segmenten, die zur Suche indiziert werden sollten, aufzuzeichnen.

Anmerkung zu Anforderungen

  • Schlüssel— Bis zu 500 alphanumerische Zeichen. Keine Leerzeichen oder Symbole außer Unterstrichen.

  • Werte— Bis zu 1.000 Unicode-Zeichen.

  • Einträge— Bis zu 50 Anmerkungen pro Ablaufverfolgung.

Um Anmerkungen aufzuzeichnen, rufen Sie AddAnnotation mit einer Zeichenfolge auf, die die Metadaten enthält, die Sie dem Segment zuordnen möchten.

xray.AddAnnotation(key string, value interface{})

Das SDK zeichnet Anmerkungen als Schlüssel-Wert-Paare in einem annotations-Objekt im Segmentdokument auf. Wenn AddAnnotation zweimal mit demselben Schlüssel aufgerufen wird, werden zuvor aufgezeichnete Werte im selben Segment überschrieben.

Nutzen Sie das annotations.key-Schlüsselwort in einem Filterausdruck, um Ablaufverfolgungen durch Anmerkungen mit bestimmten Werten zu finden.

Aufzeichnen von Metadaten mit dem X-Ray-SDK SDK for Go

Verwenden Sie Metadaten, um Segmentinformationen aufzuzeichnen, die nicht zur Suche indiziert werden müssen.

Um Metadaten aufzuzeichnen, rufen Sie AddMetadata mit einer Zeichenfolge auf, die die Metadaten enthält, die Sie dem Segment zuordnen möchten.

xray.AddMetadata(key string, value interface{})

Aufzeichnen von Benutzer-IDs mit dem X-Ray SDK for Go

Zeichnen Sie Benutzer-IDs in Anforderungssegmenten auf, um den Benutzer zu identifizieren, der die Anforderung gesendet hat.

So zeichnen Sie Benutzer-IDs auf

  1. Eine Referenz des aktuellen Segments finden Sie unter AWSXRay.

    import ( "context" "github.com/aws/aws-xray-sdk-go/xray" ) mySegment := xray.GetSegment(context)
  2. Rufen Sie setUser mit einer Zeichenfolgen-ID des Benutzers auf, der die Anforderung gesendet hat.

    mySegment.User = "U12345"

Nutzen Sie das user-Schlüsselwort in einem Filterausdruck, um Ablaufverfolgungen einer Benutzer-ID zu finden.