Visualisieren Sie Lambda-Funktionsaufrufe mit AWS X-Ray

Sie können AWS X-Ray es verwenden, um die Komponenten Ihrer Anwendung zu visualisieren, Leistungsengpässe zu identifizieren und Anfragen zu beheben, die zu einem Fehler geführt haben. Ihre Lambda-Funktionen senden Trace-Daten an und X-Ray X-Ray verarbeiten die Daten, um eine Service-Map und durchsuchbare Trace-Zusammenfassungen zu generieren.

Lambda unterstützt zwei Verfolgungsmodi für X-Ray: Active und. PassThrough Beim Active Tracing erstellt Lambda automatisch Trace-Segmente für Funktionsaufrufen und sendet sie an. X-Ray PassThroughmode hingegen gibt den Ablaufverfolgungskontext einfach an nachgeschaltete Dienste weiter. Wenn Sie die Active Ablaufverfolgung für Ihre Funktion aktiviert haben, sendet Lambda automatisch Traces an X-Ray für gesampelte Anfragen. In der Regel entscheidet ein Upstream-Service wie Amazon API Gateway oder eine auf Amazon EC2 gehostete Anwendung, die mit dem X-Ray SDK instrumentiert ist, ob eingehende Anfragen verfolgt werden sollen, und fügt dann diese Stichprobenentscheidung als Tracing-Header hinzu. Lambda verwendet diesen Header, um zu entscheiden, ob Nachverfolgungen gesendet werden sollen oder nicht. Ablaufverfolgungen von vorgelagerten Nachrichtenproduzenten wie Amazon SQS werden automatisch mit Ablaufverfolgungen von nachgelagerten Lambda-Funktionen verknüpft, wodurch eine durchgehende Ansicht der gesamten Anwendung erstellt wird. Weitere Informationen finden Sie unter Ablaufverfolgung ereignisgesteuerter Anwendungen im AWS X-Ray -Entwicklerhandbuch.

Gehen Sie folgendermaßen vor, um die aktive Nachverfolgung Ihrer Lambda-Funktion mit der Konsole umzuschalten:

Ihre Funktion benötigt die Berechtigung zum Hochladen von Trace-Daten zu X-Ray. Wenn Sie die aktive Nachverfolgung in der Lambda-Konsole aktivieren, fügt Lambda der Ausführungsrolle Ihrer Funktion die erforderlichen Berechtigungen hinzu. Andernfalls fügen Sie die AWSXRayDaemonWriteAccessRichtlinie der Ausführungsrolle hinzu.

X-Ray verfolgt nicht alle Anfragen zu Ihrer Anwendung. X-Ray wendet einen Stichprobenalgorithmus an, um sicherzustellen, dass die Rückverfolgung effizient ist und gleichzeitig eine repräsentative Stichprobe aller Anfragen bereitgestellt wird. Die Samplingrate beträgt 1 Anforderung pro Sekunde und 5 Prozent aller weiteren Anforderungen. Sie können die X-Ray Samplingrate für Ihre Funktionen nicht konfigurieren.

X-Ray Spuren verstehen

In X-Ray einer Ablaufverfolgung werden Informationen über eine Anfrage aufgezeichnet, die von einem oder mehreren Diensten bearbeitet wird. Lambda zeichnet 2 Segmente pro Trace auf, wodurch zwei Knoten im Dienstgraphen entstehen. In der folgenden Abbildung werden diese beiden Knoten hervorgehoben:

Der erste Knoten auf der linken Seite stellt den Lambda-Service dar, der die Aufrufanforderung empfängt. Der zweite Knoten stellt Ihre spezifische Lambda-Funktion dar.

Das für den Lambda-Dienst AWS::Lambda aufgezeichnete Segment umfasst alle Schritte, die zur Vorbereitung der Lambda-Ausführungsumgebung erforderlich sind. Dazu gehören das Scheduling der MicroVM, das Erstellen oder Aufheben des Einfrierens einer Ausführungsumgebung mit den von Ihnen konfigurierten Ressourcen sowie das Herunterladen Ihres Funktionscodes und aller Schichten.

Das AWS::Lambda::Function-Segment bezieht sich auf die Arbeit, die von der Funktion geleistet wird.

Old-style AWS X-Ray Lambda-Segmentstruktur

Die alte X-Ray Struktur für das AWS::Lambda Segment sieht wie folgt aus:

In diesem Format hat das Funktionssegment Untersegmente für Initialization, Invocation und Overhead. Nur für SnapStart gibt es auch ein Teilsegment Restore (in dieser Abbildung nicht dargestellt).

Das Initialization-Teilsegment stellt die Init-Phase des Lebenszyklus der Lambda-Ausführungsumgebung dar. In dieser Phase initialisiert Lambda Erweiterungen, initialisiert die Laufzeit und führt den Initialisierungscode der Funktion aus.

Das Invocation-Teilsegment stellt die Aufrufphase dar, in welcher der Lambda-Funktionshandler aufgerufen wird. Dies beginnt mit der Laufzeit- und Erweiterungsregistrierung und endet, wenn die Laufzeit bereit ist, die Antwort zu senden.

( SnapStart Nur Lambda) Das Restore Untersegment zeigt die Zeit, die Lambda benötigt, um einen Snapshot wiederherzustellen, die Laufzeit zu laden und alle Runtime-Hooks nach der Wiederherstellung auszuführen. Der Prozess der Wiederherstellung von Snapshots kann Zeit beinhalten, die für Aktivitäten außerhalb der MicroVM aufgewendet wird. Diese Zeit wird im Restore-Untersegment erfasst. Die Zeit, die Sie außerhalb der MicroVM für die Wiederherstellung eines Snapshots aufgewendet haben, wird Ihnen nicht in Rechnung gestellt.

Das Overhead-Teilsegment stellt die Phase dar, die zwischen dem Zeitpunkt, zu dem die Laufzeit die Antwort sendet, und dem Signal für den nächsten Aufruf auftritt. Während dieser Zeit beendet die Laufzeit alle Aufgaben im Zusammenhang mit einem Aufruf und bereitet sich auf das Einfrieren der Sandbox vor.

Weitere Informationen zu den Phasen der Lambda-Ausführungsumgebung finden Sie unter Verständnis des Lebenszyklus der Lambda-Ausführungsumgebung.

Ein Beispiel für eine Ablaufverfolgung, die die X-Ray Struktur im alten Stil verwendet, ist in der folgenden Abbildung dargestellt.

Beachten Sie die beiden Segmente im Beispiel. Beide heißen my-function, aber einer hat einen Ursprung von AWS::Lambda und der andere hat einen Ursprung von AWS::Lambda::Function. Wenn das AWS::Lambda-Segment einen Fehler anzeigt, hatte der Lambda-Service ein Problem. Wenn das AWS::Lambda::Function-Segment einen Fehler anzeigt, ist bei Ihrer Funktion ein Problem aufgetreten.

New-style AWS X-Ray Lambda-Segmentstruktur

Die X-Ray Struktur im neuen Stil für das AWS::Lambda Segment sieht wie folgt aus:

In diesem neuen Format stellt das Teilsegment Init wie bisher die Init-Phase des Lebenszyklus der Lambda-Ausführungsumgebung dar.

Im neuen Format gibt es kein Aufrufsegment. Stattdessen werden Kundenuntersegmente direkt an das AWS::Lambda::Function-Segment angehängt. Dieses Segment enthält die folgenden Metriken als Anmerkungen:

Das folgende Diagramm zeigt ein Beispiel für eine Ablaufverfolgung, die die X-Ray Struktur im neuen Stil verwendet.

Beachten Sie die beiden Segmente im Beispiel. Beide heißen my-function, aber einer hat einen Ursprung von AWS::Lambda und der andere hat einen Ursprung von AWS::Lambda::Function. Wenn das AWS::Lambda-Segment einen Fehler anzeigt, hatte der Lambda-Service ein Problem. Wenn das AWS::Lambda::Function-Segment einen Fehler anzeigt, ist bei Ihrer Funktion ein Problem aufgetreten.

In den folgenden Themen finden Sie eine sprachspezifische Einführung in die Ablaufverfolgung in Lambda:

Eine vollständige Liste der Services, welche die aktive Instrumentierung unterstützen, finden Sie unter Unterstützte AWS-Services im AWS X-Ray -Entwicklerhandbuch.

Standardmäßiges Nachverfolgungsverhalten in Lambda

Wenn die Active-Nachverfolgung nicht aktiviert ist, verwendet Lambda standardmäßig den PassThrough-Nachverfolgungsmodus.

Im PassThrough Modus leitet Lambda den X-Ray Tracing-Header an Downstream-Dienste weiter, sendet jedoch nicht automatisch Traces. Dies gilt auch dann, wenn der Nachverfolgungs-Header eine Entscheidung zum Sampling der Anfrage enthält. Wenn der Upstream-Dienst keinen X-Ray Tracing-Header bereitstellt, generiert Lambda einen Header und trifft die Entscheidung, kein Sampling durchzuführen. Sie können jedoch Ihre eigenen Nachverfolgungen senden, indem Sie Nachverfolgungsbibliotheken aus Ihrem Funktionscode aufrufen.

Berechtigungen für die Ausführungsrolle

Lambda benötigt die folgenden Berechtigungen, um Trace-Daten an zu X-Ray senden. Fügen Sie sie der Ausführungsrolle Ihrer Funktion hinzu.

Diese Berechtigungen sind in der AWSXRayDaemonWriteAccessverwalteten Richtlinie enthalten.

Active Tracing mit der Lambda-API aktivieren

Verwenden Sie die folgenden API-Operationen, um die Ablaufverfolgungskonfiguration mit dem AWS CLI oder AWS SDK zu verwalten:

Der folgende AWS CLI Beispielbefehl aktiviert die aktive Ablaufverfolgung für eine Funktion namens my-function.

aws lambda update-function-configuration --function-name my-function \
--tracing-config Mode=Active

Der Ablaufverfolgungsmodus ist Teil der versionsspezifischen Konfiguration, wenn Sie eine Version Ihrer Funktion veröffentlichen. Sie können den Ablaufverfolgungsmodus für eine veröffentlichte Version nicht ändern.

Aktivieren von Active Tracing mit CloudFormation

Verwenden Sie die Eigenschaft, um die Ablaufverfolgung AWS::Lambda::Function für eine Ressource in einer CloudFormation Vorlage zu aktivieren. TracingConfig

Resources:
  function:
    Type: AWS::Lambda::Function
    Properties:
      TracingConfig:
        Mode: Active
      ...

Verwenden Sie für eine AWS::Serverless::Function Ressource AWS Serverless Application Model (AWS SAM) die Tracing Eigenschaft.

Resources:
  function:
    Type: AWS::Serverless::Function
    Properties:
      Tracing: Active
      ...