Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Surveillance des fonctions durables

Vous pouvez surveiller vos fonctions durables à l'aide de CloudWatch métriques, de CloudWatch journaux et de traçage. Les fonctions durables pouvant s'exécuter pendant de longues périodes et couvrir plusieurs invocations de fonctions, leur surveillance nécessite de comprendre leurs modèles d'exécution uniques, notamment les points de contrôle, les transitions d'état et le comportement de rediffusion.

CloudWatch métriques

Lambda publie automatiquement les métriques sans CloudWatch frais supplémentaires. Les fonctions durables fournissent des mesures supplémentaires au-delà des métriques Lambda standard pour vous aider à surveiller les flux de travail de longue durée, la gestion des états et l'utilisation des ressources.

Mesures d'exécution durables

Lambda émet les métriques suivantes pour des exécutions durables :

CloudWatch métriques

Lambda émet des métriques d'invocation, de performance et de simultanéité standard pour des fonctions durables. Étant donné qu'une exécution durable peut s'étendre sur plusieurs invocations de fonctions au fur et à mesure qu'elle progresse entre les points de contrôle et les rediffusions, ces métriques se comportent différemment de celles des fonctions standard :

Pour une liste complète des métriques Lambda standard, voir Types de métriques pour les fonctions Lambda.

Création d' CloudWatch alarmes

Créez des CloudWatch alarmes pour vous avertir lorsque les mesures dépassent les seuils. Les alarmes les plus courantes incluent :

Pour plus d'informations, consultez la section Utilisation des CloudWatch alarmes. .

EventBridge événements

Lambda publie les événements de modification du statut d'exécution durable sur. EventBridge Vous pouvez utiliser ces événements pour déclencher des flux de travail, envoyer des notifications ou suivre les modifications du cycle de vie d'exécution de vos fonctions durables.

Événements de changement de statut d'exécution durables

Lambda émet un événement EventBridge chaque fois qu'une exécution durable change de statut. Ces événements présentent les caractéristiques suivantes :

Les événements de changement de statut sont publiés pour les états d'exécution suivants :

L'exemple suivant montre un événement de changement de statut d'exécution durable :

{
  "version": "0",
  "id": "d019b03c-a8a3-9d58-85de-241e96206538",
  "detail-type": "Durable Execution Status Change",
  "source": "aws.lambda",
  "account": "123456789012",
  "time": "2025-11-20T13:08:22Z",
  "region": "us-east-1",
  "resources": [],
  "detail": {
    "durableExecutionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function:$LATEST/durable-execution/090c4189-b18b-4296-9d0c-cfd01dc3a122/9f7d84c9-ea3d-3ffc-b3e5-5ec51c34ffc9",
    "durableExecutionName": "order-123",
    "functionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function:2",
    "status": "RUNNING",
    "startTimestamp": "2025-11-20T13:08:22.345Z"
  }
}
      

Pour les états du terminal (SUCCEEDEDSTOPPED,FAILED,,TIMED_OUT), l'événement inclut un endTimestamp champ indiquant quand l'exécution est terminée.

Création de EventBridge règles

Créez des EventBridge règles pour acheminer les événements de changement de statut d'exécution durables vers des cibles telles qu'Amazon Simple Notification Service, Amazon Simple Queue Service ou d'autres fonctions Lambda.

L'exemple suivant crée une règle qui correspond à toutes les modifications du statut d'exécution durable :

{
  "source": ["aws.lambda"],
  "detail-type": ["Durable Execution Status Change"]
}
      

L'exemple suivant crée une règle qui ne correspond qu'aux exécutions ayant échoué :

{
  "source": ["aws.lambda"],
  "detail-type": ["Durable Execution Status Change"],
  "detail": {
    "status": ["FAILED"]
  }
}
      

L'exemple suivant crée une règle qui correspond aux changements de statut pour une fonction spécifique :

{
  "source": ["aws.lambda"],
  "detail-type": ["Durable Execution Status Change"],
  "detail": {
    "functionArn": [{
      "prefix": "arn:aws:lambda:us-east-1:123456789012:function:my-function"
    }]
  }
}
      

Pour plus d'informations sur la création de EventBridge règles, consultez les EventBridge didacticiels Amazon dans le guide de EventBridge l'utilisateur.

Utilisation de files d'attente contenant des lettres mortes lors d'événements EventBridge

EventBridge les événements de changement de statut fournissent une notification en temps réel lorsqu'une exécution durable passe à l'état FAILED, STOPPED ou TIMED_OUT, mais ils n'incluent pas la charge utile de l'événement d'origine qui a déclenché l'exécution. Pour capturer l'événement déclencheur en vue d'une analyse ou d'un retraitement ultérieur, configurez une file d'attente de lettres mortes (DLQ) sur votre fonction durable.

Lorsqu'une exécution durable échoue après un appel asynchrone, Lambda envoie l'événement déclencheur d'origine au DLQ configuré. Utilisez EventBridge les événements et les DLQ conjointement pour élaborer une stratégie complète de gestion des défaillances :

Pour plus d'informations sur la configuration d'une DLQ sur votre fonction, consultez la section files d'Dead-letter attente.

AWS X-Ray suivi

Vous pouvez activer le X-Ray suivi sur vos fonctions durables. Lambda transmet l'en-tête de X-Ray trace à l'exécution durable, ce qui vous permet de suivre les demandes dans l'ensemble de votre flux de travail.

Pour activer X-Ray le suivi à l'aide de la console Lambda, choisissez votre fonction, puis sélectionnez Outils de configuration, de surveillance et d'exploitation, puis activez le suivi actif sous. X-Ray

Pour activer le X-Ray suivi à l'aide de AWS CLI :

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

Pour activer le AWS X-Ray suivi à l'aide de AWS SAM :

Resources:
  MyDurableFunction:
    Type: AWS::Serverless::Function
    Properties:
      Tracing: Active
      DurableConfig:
        ExecutionTimeout: 3600
    

Pour plus d'informations X-Ray, consultez le guide du AWS X-Ray développeur.