Uso de CloudWatch registros para registrar el historial de ejecuciones en Step Functions

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Los flujos de trabajo estándar registran el historial de ejecución en AWS Step Functions, aunque si lo desea, puede configurar el registro en Amazon CloudWatch Logs.

A diferencia de los flujos de trabajo estándar, los flujos de trabajo rápidos no registran el historial de ejecuciones en AWS Step Functions. Para ver el historial de ejecución y los resultados de un flujo de trabajo rápido, debe configurar el registro en Amazon CloudWatch Logs. La publicación de registros no bloquea ni ralentiza las ejecuciones.

Configuración de registros

Al crear un flujo de trabajo estándar mediante la consola Step Functions, esa máquina de estados no se configurará para enviar CloudWatch registros a Logs. Al crear un flujo de trabajo rápido mediante la consola Step Functions, esa máquina de estados se configurará de forma predeterminada para enviar CloudWatch registros a Logs.

Para los flujos de trabajo exprés, Step Functions puede crear un rol con la política AWS Identity and Access Management (IAM) necesaria para CloudWatch los registros. Si se crea un flujo de trabajo estándar o un flujo de trabajo rápido mediante la API, la CLI o AWS CloudFormation, Step Functions no habilitará el registro de forma predeterminada y tendrá que asegurarse de que el rol tenga los permisos necesarios.

Para cada ejecución iniciada desde la consola, Step Functions proporciona un enlace a CloudWatch los registros, configurado con el filtro correcto para recuperar los eventos de registro específicos de esa ejecución.

Si lo desea, puede configurar AWS KMS las claves administradas por el cliente para cifrar sus registros. Consulte Cifrado de datos en reposo para obtener más información y configurar los permisos.

Para configurar el registro, puede pasar el LoggingConfigurationparámetro cuando utilice CreateStateMachineo UpdateStateMachine. Puede analizar más a fondo sus datos en CloudWatch CloudWatch Logs Insights. Para obtener más información, consulte Análisis de datos de registro con CloudWatch Logs Insights.

CloudWatch Registra las cargas útiles

Los eventos del historial de ejecución pueden contener propiedades de entrada o salida en sus definiciones. Si la entrada de escape o la salida de escape enviada a CloudWatch Logs supera los 248 KiB, se truncará como resultado de las cuotas de CloudWatch Logs.

Políticas de IAM para iniciar sesión en Logs CloudWatch

También tendrá que configurar la función de IAM de ejecución de su máquina de estado para tener el permiso adecuado para iniciar sesión en CloudWatch los registros, como se muestra en el siguiente ejemplo.

Ejemplo de políticas de IAM

A continuación se muestra una política de ejemplo que puede utilizar para configurar los permisos. Como se muestra en el siguiente ejemplo, debe especificar* en el Resource campo. CloudWatch Las acciones de la API, como CreateLogDelivery y DescribeLogGroups, no admiten los tipos de recursos definidos por Amazon CloudWatch Logs. Para obtener más información, consulte Acciones definidas por Amazon CloudWatch Logs.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogDelivery",
                "logs:CreateLogStream",
                "logs:GetLogDelivery",
                "logs:UpdateLogDelivery",
                "logs:DeleteLogDelivery",
                "logs:ListLogDeliveries",
                "logs:PutLogEvents",
                "logs:PutResourcePolicy",
                "logs:DescribeResourcePolicies",
                "logs:DescribeLogGroups"
            ],
            "Resource": "*"
        }
    ]
}

Solución de problemas con el registro automático de estados en CloudWatch Logs

Si su máquina de estado no puede enviar CloudWatch registros a Logs, intente los siguientes pasos:

Niveles de registro para eventos de ejecución de Step Functions

Los niveles de registro van de ALL a ERROR a FATAL y a OFF. Todos los tipos de eventos se registran cuando se configura en ALL; no se registra ningún tipo de evento cuando se configura en OFF. Para ERROR y FATAL, consulte la tabla siguiente.

Para obtener más información sobre los datos de ejecución que se muestran para las ejecuciones de flujos de trabajo rápidos en función de estos Niveles de registro, consulte Diferencias de experiencia entre las consolas estándar y rápidas.