View a markdown version of this page

Verwenden AWS X-Ray um Anfragen zu verfolgen in AWS AppSync - AWS AppSync GraphQL
Einrichtung und KonfigurationVerfolgen Sie Ihre API mit 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.

Verwenden AWS X-Ray um Anfragen zu verfolgen in AWS AppSync

Sie können AWS X-Ray es verwenden, um Anfragen zu verfolgen, während sie ausgeführt werden. AWS AppSync Sie können es AWS AppSync in X-Ray allen AWS Regionen verwenden, in denen X-Ray es verfügbar ist. X-Ray gibt Ihnen einen detaillierten Überblick über eine gesamte GraphQL-Anfrage. Auf diese Weise können Sie Latenzen in Ihren APIs und den zugrunde liegenden Resolvern und Datenquellen analysieren. Sie können eine X-Ray Service Map verwenden, um die Latenz einer Anfrage anzuzeigen, einschließlich aller AWS Dienste, die in diese integriert X-Ray sind. Sie können auch Sampling-Regeln konfigurieren, um anhand der von Ihnen angegebenen Kriterien festzulegen, X-Ray welche Anfragen mit welchen Sampling-Raten aufgezeichnet werden sollen.

Weitere Informationen zur Probenentnahme finden Sie unter Konfigurieren von Stichprobenregeln in der AWS X-Ray Konsole. X-Ray

Einrichtung und Konfiguration

Sie können das X-Ray Tracing für eine GraphQL-API über die AWS AppSync Konsole aktivieren.

  1. Melden Sie sich bei der Konsole an AWS AppSync .

  2. Wählen Sie im Navigationsbereich die Option Settings (Einstellungen) aus.

  3. Aktivieren Sie X-Ray unter die Option Aktivieren X-Ray.

  4. Wählen Sie „Speichern“. X-Ray Tracing ist jetzt für Ihre API aktiviert.

Wenn Sie AWS CLI oder verwenden AWS CloudFormation, können Sie die X-Ray Ablaufverfolgung auch aktivieren, wenn Sie eine neue AWS AppSync API erstellen oder eine vorhandene AWS AppSync API aktualisieren, indem Sie die xrayEnabled Eigenschaft auf setzen. true

Wenn X-Ray die Ablaufverfolgung für eine AWS AppSync API aktiviert ist, wird in Ihrem Konto automatisch eine AWS Identity and Access Management serviceverknüpfte Rolle mit den entsprechenden Berechtigungen erstellt. Auf diese Weise können AWS AppSync Sie Traces auf sichere X-Ray Weise an andere senden.

Verfolgen Sie Ihre API mit X-Ray

Sampling

Mithilfe von Samplingregeln können Sie die Menge der von Ihnen in AWS AppSync aufgezeichneten Daten steuern und das Samplingverhalten bei laufendem Betrieb ändern, ohne Ihren Code ändern oder neu implementieren zu müssen. Diese Regel führt beispielsweise ein Sampling von Anforderungen an die GraphQL-API mit der API-ID 3n572shhcpfokwhdnq1ogu59v6 durch.

  • Regelname – test-sample

  • Priorität – 10

  • Reservoirgröße – 10

  • Bestimmtes Zeitintervall – 10

  • Service-Name – *

  • Servicetyp – AWS::AppSync::GraphQLAPI

  • HTTP-Methode – *

  • Ressourcen-ARN – arn:aws:appsync:us-west-2:123456789012:apis/3n572shhcpfokwhdnq1ogu59v6

  • Host – *

Grundlegendes zu Ablaufverfolgungen

Wenn Sie das X-Ray Tracing für Ihre GraphQL-API aktivieren, können Sie die X-Ray Trace-Detailseite verwenden, um detaillierte Latenzinformationen zu Anfragen an Ihre API zu überprüfen. Das folgende Beispiel zeigt die Ablaufverfolgungsansicht zusammen mit der Servicezuordnung für diese spezielle Anforderung. Die Anfrage wurde an eine API gestellt, die postAPI mit einem Post-Typ aufgerufen wurde und deren Daten in einer Amazon DynamoDB-Tabelle mit dem Namen enthalten sind. PostTable-Example

Das folgende Ablaufverfolgungsbild entspricht der folgenden GraphQL-Abfrage:

query getPost {
    getPost(id: "1") {
      id
      title
    }
}

Der Resolver für die getPost Abfrage verwendet die zugrunde liegende DynamoDB-Datenquelle. Die folgende Ablaufverfolgungsansicht zeigt den Aufruf von DynamoDB sowie die Latenzen verschiedener Teile der Abfrageausführung:

Die Ablaufverfolgungskarte zeigt den PostAPI-Anforderungsfluss vom Client bis DynamoDB zum nächsten mit Zeitangaben.

  • Im vorhergehenden Bild repräsentiert /getPost den vollständigen Pfad zu dem Element, das aufgelöst wird. Da es sich in diesem Fall bei getPost um ein Feld für den Stammtyp Query handelt, wird es direkt nach dem Stamm des Pfades angezeigt.

  • requestMappingTemplateEvaluation repräsentiert die Zeit, die von AWS AppSync für die Auswertung der Anforderungszuweisungsvorlage für dieses Element in der Abfrage aufgewendet wurde.

  • Query.getPost repräsentiert einen Typ und ein Feld (im Format Type.field). Es kann mehrere Untersegmente enthalten, abhängig von der Struktur der API und der Anforderung, die verfolgt wird.

    • DynamoDB repräsentiert die Datenquelle, die mit diesem Resolver verknüpft ist. Sie enthält die Latenz für den Netzwerkaufruf an DynamoDB zur Auflösung des Felds.

    • responseMappingTemplateEvaluation repräsentiert die Zeit, die von AWS AppSync für die Auswertung der Antwortzuweisungsvorlage für dieses Element in der Abfrage aufgewendet wurde.

Wenn Sie Traces in anzeigen X-Ray, können Sie zusätzliche Kontext- und Metadateninformationen zu den Untersegmenten im AWS AppSync Segment abrufen, indem Sie die Untersegmente auswählen und die Detailansicht erkunden.

Beachten Sie bei bestimmten tief verschachtelten oder komplexen Abfragen, dass das Segment, an das X-Ray von gesendet wird, größer sein AWS AppSync kann als die in Segmentdokumente definierte maximale Größe für Segmentdokumente. AWS X-Ray X-Ray zeigt keine Segmente an, die den Grenzwert überschreiten.