Verwenden Sie die AWS SAM CLI, um Lambda Insights für eine bestehende Lambda-Funktion zu aktivieren

Gehen Sie wie folgt vor, um Lambda Insights für eine bestehende Lambda-Funktion AWS SAM AWS CLI zu aktivieren.

Wenn Sie die neueste Version von noch nicht AWS SAM CLI installiert haben, müssen Sie sie zuerst installieren oder aktualisieren. Weitere Informationen finden Sie unter Installieren der AWS SAM CLI.

Schritt 1: Installieren der Ebene

Um die Lambda Insights-Erweiterung für all Ihre Lambda-Funktionen verfügbar zu machen, fügen Sie dem Globals Abschnitt Ihrer SAM Vorlage eine Layers Eigenschaft mit ARN der Lambda Insights-Ebene hinzu. Im folgenden Beispiel wird die Ebene für die erste Veröffentlichung von Lambda Insights verwendet. Die neueste Release-Version der Lambda-Insights-Erweiterungsebene finden Sie unter Verfügbare Versionen der Lambda-Insights-Erweiterung.

Globals:
  Function:
    Layers:
      - !Sub "arn:aws:lambda:${AWS::Region}:580247275435:layer:LambdaInsightsExtension:14"

Um diese Ebene nur für eine einzelne Funktion zu aktivieren, fügen Sie die Layers-Eigenschaft wie in diesem Beispiel gezeigt zur Funktion hinzu.

Resources:
  MyFunction:
    Type: AWS::Serverless::Function
    Properties:
      Layers:
        - !Sub "arn:aws:lambda:${AWS::Region}:580247275435:layer:LambdaInsightsExtension:14"

Schritt 2: Hinzufügen der verwalteten Richtlinie

Fügen Sie für jede Funktion die Richtlinie hinzu. CloudWatchLambdaInsightsExecutionRolePolicyIAM

AWS SAM unterstützt keine globalen Richtlinien, daher müssen Sie diese für jede Funktion einzeln aktivieren, wie in diesem Beispiel gezeigt. Weitere Informationen zu Globalen finden Sie im Abschnitt Globale.

Resources:
  MyFunction:
    Type: AWS::Serverless::Function
    Properties:
      Policies:
        - CloudWatchLambdaInsightsExecutionRolePolicy

Lokales Aufrufen

Das AWS SAM CLI unterstützt Lambda-Erweiterungen. Jeder lokal ausgeführte Aufruf setzt jedoch die Laufzeitumgebung zurück. Lambda-Insights-Daten sind nicht über lokale Aufrufe verfügbar, da die Laufzeitumgebung ohne ein Herunterfahrungsereignis neu gestartet wird. Weitere Informationen finden Sie unter Version 1.6.0 — Unterstützung für lokales Testen von AWS Lambda Erweiterungen hinzufügen.

Fehlersuche

Um Probleme mit Ihrer Lambda-Insights-Installation zu beheben, fügen Sie Ihrer Lambda-Funktion die folgende Umgebungsvariable hinzu, um die Debug-Protokollierung zu aktivieren.

Resources:
  MyFunction:
    Type: AWS::Serverless::Function
    Properties:
      Environment:
        Variables:
          LAMBDA_INSIGHTS_LOG_LEVEL: info