Supervisión de funciones duraderas

Puede supervisar las funciones duraderas mediante las métricas de CloudWatch, Registros de CloudWatch y el seguimiento. Como las funciones duraderas pueden ejecutarse durante períodos prolongados y abarcar varias invocaciones de funciones, su supervisión requiere comprender sus patrones de ejecución únicos, incluidos los puntos de control, las transiciones de estado y el comportamiento de reproducción.

Métricas de CloudWatch

Lambda publica automáticamente las métricas en CloudWatch sin cargo adicional. Las funciones duraderas proporcionan métricas adicionales a las métricas de Lambda estándar para ayudarlo a supervisar los flujos de trabajo de larga duración, la administración del estado y la utilización de los recursos.

Métricas de ejecuciones duraderas

Lambda emite las siguientes métricas para las ejecuciones duraderas:

Métricas de CloudWatch

Lambda emite métricas estándar de invocación, rendimiento y concurrencia para las funciones duraderas. Dado que una ejecución duradera puede abarcar varias invocaciones de funciones a medida que avanza por los puntos de control y las reproducciones, estas métricas se comportan de forma diferente a las de las funciones estándar:

Para obtener una lista completa de las métricas estándar de Lambda, consulte Tipos de métricas para las funciones de Lambda.

Crear alarmas de CloudWatch

Cree alarmas de CloudWatch para que le notifiquen cuando las métricas superen los umbrales. Las alarmas frecuentes incluyen las siguientes:

Para obtener más información, consulte Uso de las alarmas de CloudWatch.

Eventos de EventBridge

Lambda publica eventos de cambio de estado de ejecución duradera en EventBridge. Puede utilizar estos eventos para desencadenar flujos de trabajo, enviar notificaciones o realizar un seguimiento de los cambios en el ciclo de vida de la ejecución en todas sus funciones duraderas.

Eventos de cambio de estado de ejecución duradera

Lambda emite un evento a EventBridge cada vez que una ejecución duradera cambia de estado. Estos eventos tienen las siguientes características:

Los eventos de cambio de estado se publican para los siguientes estados de ejecución:

En el siguiente ejemplo, se muestra un evento de cambio de estado de ejecución duradera:

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

Para los estados terminales (SUCCEEDED, STOPPED, FAILED, TIMED_OUT), el evento incluye un campo de endTimestamp que indica cuándo se completó la ejecución.

Creación de reglas de EventBridge

Cree reglas para enrutar eventos de cambio de estado de ejecución duradera a destinos como Amazon Simple Notification Service, Amazon Simple Queue Service u otras funciones de Lambda.

En el siguiente ejemplo, se crea una regla que coincide con todos los cambios de estado de ejecución duradera:

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

En el siguiente ejemplo se crea una regla que coincide solo con las ejecuciones fallidas:

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

En el siguiente ejemplo, se crea una regla que coincide con los cambios de estado de una función específica:

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

Para obtener más información sobre cómo crear reglas, consulte Tutoriales de Amazon EventBridge en la Guía del usuario de EventBridge.

AWS X-RayRastreo de

Puede habilitar el seguimiento de X-Ray en las funciones duraderas. Lambda pasa el encabezado de seguimiento de X-Ray a la ejecución duradera, lo que le permite seguir las solicitudes en todo el flujo de trabajo.

Para habilitar el seguimiento de X-Ray mediante la consola de Lambda, elija su función, a continuación elija Configuración, Supervisión y herramientas de operaciones y active el Seguimiento activo en X-Ray.

Cómo habilitar el seguimiento de X-Ray mediante la AWS CLI:

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

Cómo habilitar el seguimiento de AWS X-Ray mediante AWS SAM:

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

A fin de obtener más información sobre X-Ray, consulte la Guía para desarrolladores de AWS X-Ray.