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.

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

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 exprés no registran el historial de ejecución 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 lo necesario AWS Identity and Access Management (IAM) política para CloudWatch registros. Si crea un flujo de trabajo estándar o un flujo de trabajo rápido con APICLI, o AWS CloudFormation, Step Functions no habilitará el registro de forma predeterminada y tendrás que asegurarte de que tu función cuenta con 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 configurarlo como gestionado por el cliente AWS KMS claves para cifrar sus registros. Consulte Cifrado de datos en reposo para obtener información detallada 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 salida enviada a CloudWatch Logs supera los 248 KB, se truncará como resultado de las cuotas de Logs. CloudWatch

IAMPolíticas para iniciar sesión en CloudWatch Logs

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

IAMejemplo de política

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 APIlas acciones, 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 de los eventos de ejecución de Step Functions

Los niveles de registro van de ALL ERROR a FATAL aOFF. Se registran todos los tipos de eventosALL, no se registra ningún tipo de evento cuando se establece enOFF. 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 Las consolas Standard y Express experimentan diferencias.