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. Étant donné que les fonctions durables peuvent s'exécuter pendant de longues périodes et couvrir plusieurs appels 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 relecture.

CloudWatch métriques

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

Métriques d'exécution durables

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

CloudWatch métriques

Lambda émet des mesures d'appel, de performance et de simultanéité standard pour des fonctions durables. Dans la mesure où une exécution durable peut couvrir plusieurs appels de fonctions au fur et à mesure qu'elle passe par des points de contrôle et des 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 métriques dépassent les seuils. Les alarmes les plus courantes sont les suivantes :

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

EventBridge événements

Lambda publie des événements de changement d'état d'exécution durables dans 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 durables de changement de statut d'exécution

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 illustre un événement de changement durable du statut d'exécution :

{
  "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 s'est terminée.

Création de EventBridge règles

Créez des EventBridge règles pour acheminer les événements de changement d'état 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 durables du statut d'exécution :

{
  "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.

Utiliser les files d'attente aux lettres mortes pour les événements EventBridge

EventBridge les événements de changement d'état 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'un DLQ sur votre fonction, consultez la section Dead-letter files d'attente.

AWS X-Ray suivi

Vous pouvez activer le X-Ray traçage 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 choisissez Outils de configuration, de surveillance et d'exploitation, puis activez le suivi actif dans X-Ray.

Pour activer le X-Ray traçage à 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 traçage à l'aide de AWS SAM :

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

Pour plus d'informations à ce sujet X-Ray, consultez le Guide du AWS X-Ray développeur.