Dauerhafte Lambda-Funktionen konfigurieren

Dauerhafte Ausführungseinstellungen steuern, wie lange Ihre AWS Lambda Funktion ausgeführt werden kann, wie lange der Dienst den Ausführungsverlauf beibehält und welcher AWS KMS Schlüssel Ihre Ausführungsdaten verschlüsselt. Konfigurieren Sie diese Einstellungen, um eine dauerhafte Ausführung Ihrer Funktion zu ermöglichen.

Dauerhafte Ausführung aktivieren

Konfigurieren Sie das DurableConfig Objekt bei der Erstellung Ihrer Funktion so, dass es ein Timeout für die Ausführung und die Aufbewahrung des Verlaufs festlegt. Sie können die dauerhafte Ausführung nur aktivieren, wenn Sie eine Funktion erstellen. Sie können es nicht für bestehende Funktionen aktivieren.

AWS CLI

aws lambda create-function \
  --function-name my-durable-function \
  --runtime nodejs24.x \
  --role arn:aws:iam::123456789012:role/my-durable-role \
  --handler index.handler \
  --zip-file fileb://function.zip \
  --durable-config '{"ExecutionTimeout": 3600, "RetentionPeriodInDays": 30, "KMSKeyArn": "arn:aws:kms:us-east-1:111122223333:key/key-id"}'
          

CloudFormation

Resources:
  MyDurableFunction:
    Type: AWS::Lambda::Function
    Properties:
      FunctionName: my-durable-function
      Runtime: nodejs24.x
      Handler: index.handler
      Code:
        ZipFile: |
          // Your durable function code
      DurableConfig:
        ExecutionTimeout: 3600
        RetentionPeriodInDays: 30
        KMSKeyArn: "arn:aws:kms:us-east-1:111122223333:key/key-id"
          

Konfigurationsparameter:

• ExecutionTimeout— Die maximale Zeit in Sekunden, die eine dauerhafte Ausführung ausgeführt werden kann, bevor Lambda die Ausführung stoppt. Dieses Timeout gilt für die gesamte dauerhafte Ausführung, nicht für einzelne Funktionsaufrufe. Gültiger Bereich: 1—31622400.

• RetentionPeriodInDays— Die Anzahl der Tage, für die der Ausführungsverlauf nach Abschluss einer dauerhaften Ausführung beibehalten werden soll. Nach Ablauf dieses Zeitraums ist der Ausführungsverlauf nicht mehr über die GetDurableExecutionHistory API verfügbar. Gültiger Bereich: 1—90.

• KMSKeyArn – Optional. Der ARN eines vom Kunden verwalteten Schlüssels zur Verschlüsselung dauerhafter Ausführungsdaten. Weitere Informationen finden Sie unter Verschlüsseln von dauerhaften Lambda-Ausführungsdaten.

Die vollständige API-Referenz finden Sie DurableConfigin der Lambda-API-Referenz.

Bewährte Methoden für die Konfiguration

Folgen Sie diesen bewährten Methoden, wenn Sie langlebige Funktionen für den Produktionseinsatz konfigurieren:

• Legen Sie geeignete Zeitlimits für die Ausführung fest — richten Sie die Konfiguration auf der ExecutionTimeout Grundlage der maximal zu erwartenden Dauer Ihres Workflows aus. Legen Sie keine unnötig langen Timeouts fest, da sich diese auf die Kosten und die Ressourcenzuweisung auswirken.

• Sorgen Sie für ein ausgewogenes Verhältnis zwischen Aufbewahrung und Speicherkosten — Die Festlegung erfolgt auf der RetentionPeriodInDays Grundlage Ihrer Debugging- und Audit-Anforderungen. Längere Aufbewahrungsfristen erhöhen die Speicherkosten.

• Statusgröße überwachen — Große Zustandsobjekte erhöhen die Speicherkosten und können die Leistung beeinträchtigen. Halten Sie den Status minimal und verwenden Sie externen Speicher für große Datenmengen.

• Konfigurieren Sie die entsprechende Protokollierung — Aktivieren Sie die detaillierte Protokollierung zur Fehlerbehebung bei Workflows mit langer Laufzeit. Berücksichtigen Sie dabei jedoch die Auswirkungen auf das Protokollvolumen und die Kosten.

• Mit Ihrem eigenen AWS KMS Schlüssel verschlüsseln — Wählen Sie einen vom KMSKeyArn Kunden verwalteten Schlüssel, um die Schlüsselrotation zu kontrollieren, den Zugriff zu überprüfen und Compliance-Anforderungen zu erfüllen. Siehe Verschlüsseln AWS Lambda dauerhafte Ausführungsdaten.

Beispiel für eine Produktionskonfiguration:

{
  "ExecutionTimeout": 86400,
  "RetentionPeriodInDays": 7,
  "KMSKeyArn": "arn:aws:kms:us-east-1:111122223333:key/key-id"
}
    

In diesem Beispiel wird ein Ausführungstimeout von 24 Stunden (86.400 Sekunden), eine Aufbewahrungsfrist von 7 Tagen und ein vom Kunden verwalteter Schlüssel für die Verschlüsselung festgelegt.