Surveillance des fonctions durables - AWS Lambda
CloudWatch métriquesEventBridge événementsAWS X-Ray traçage

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 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 :

Métrique Description
ApproximateRunningDurableExecutions Nombre d'exécutions durables à l'état RUNNING
ApproximateRunningDurableExecutionsUtilization Pourcentage du quota maximal d'exécutions durables de votre compte actuellement utilisé
DurableExecutionDuration Temps écoulé, en millisecondes, pendant lequel une exécution durable est restée à l'état RUNNING
DurableExecutionStarted Nombre d'exécutions durables qui ont débuté
DurableExecutionStopped Nombre d'exécutions durables interrompues à l'aide de l' StopDurableExecution API
DurableExecutionSucceeded Nombre d'exécutions durables achevées avec succès
DurableExecutionFailed Nombre d'exécutions durables qui se sont soldées par un échec
DurableExecutionTimedOut Nombre d'exécutions durables ayant dépassé le délai d'exécution configuré
DurableExecutionOperations Nombre cumulé d'opérations effectuées dans le cadre d'une exécution durable (maximum : 3 000)
DurableExecutionStorageWrittenBytes Quantité cumulée de données en octets persistée par une exécution durable (max. : 100 Mo)

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 :

  • Invocations : compte chaque appel de fonction, y compris les rediffusions. Une seule exécution durable peut générer plusieurs points de données d'invocation.

  • Durée : mesure chaque invocation de fonction séparément. DurableExecutionDurationÀ utiliser pour le temps total nécessaire à une seule exécution durable.

  • Erreurs : suit les échecs d'invocation des fonctions. À utiliser DurableExecutionFailed pour les échecs au niveau de l'exécution.

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 :

  • ApproximateRunningDurableExecutionsUtilizationdépasse 80 % de votre quota

  • DurableExecutionFailedaugmentations supérieures à un seuil

  • DurableExecutionTimedOutindique que le délai d'exécution est expiré

  • DurableExecutionStorageWrittenBytesapproche les limites de stockage

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 :

  • Source : aws.lambda

  • Type de détail : Durable Execution Status Change

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

  • RUNNING- L'exécution a commencé

  • SUCCEEDED- Exécution terminée avec succès

  • STOPPED- L'exécution s'est arrêtée à l'aide de l' StopDurableExecution API

  • FAILED- L'exécution a échoué avec une erreur

  • TIMED_OUT- L'exécution a dépassé le délai d'expiration configuré

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 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 règles, consultez les EventBridge didacticiels Amazon dans le guide de EventBridge l'utilisateur.

AWS X-Ray traçage

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

Pour activer le traçage X-Ray à l'aide de la console Lambda, choisissez votre fonction, puis choisissez Configuration, Monitoring and Operations tools, puis activez Active Tracing sous X-Ray.

Pour activer le traçage X-Ray à 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 sur X-Ray, consultez le manuel du AWS X-Ray développeur.