本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 Step Functions 中使用 CloudWatch 日志记录执行历史记录

标准工作流程在中记录执行历史记录 AWS Step Functions，但您可以选择配置对 Amazon 日志的 CloudWatch 日志记录。

与标准工作流程不同，Express Workflows 不记录执行历史记录 AWS Step Functions。 要查看 Express 工作流程的执行历史和结果，您必须配置对 Amazon Logs 的 CloudWatch 日志记录。发布日志不会阻止或减慢执行速度。

配置日志记录

使用 Step Functions 控制台创建标准工作流程时，该状态机不会配置为向日志发送 CloudWatch 日志。使用 Step Functions 控制台创建 Express Workflow 时，该状态机将默认配置为向日志发送 CloudWatch 日志。

对于 Express 工作流程，Step Functions 可以创建具有必要功能的角色 AWS Identity and Access Management (IAM) CloudWatch 日志策略。如果您使用、或创建了标准工作流程或快速工作流程 API CLI AWS CloudFormation，Step Functions 默认不启用日志记录，您需要确保自己的角色具有必要的权限。

对于从控制台启动的每次执行，Step Functions 都会提供一个指向 CloudWatch 日志的链接，该链接配置了正确的过滤器，用于获取特定于该执行的日志事件。

您可以选择配置客户托管 AWS KMS 加密日志的密钥。静态数据加密有关详细信息和权限设置，请参阅。

要配置日志记录，可以在使用CreateStateMachine或时传递LoggingConfiguration参数UpdateStateMachine。您可以使用 Logs Insights 进一步分析 CloudWatch CloudWatch 日志中的数据。有关更多信息，请参阅使用 Log CloudWatchs Insights 分析日志数据。

CloudWatch 记录有效负载

执行历史事件的定义中可能包含输入或输出属性。如果发送到 CloudWatch 日志的转义输入或转义输出超过 248KB，则会由于日志配额而被截断。 CloudWatch

IAM登录 CloudWatch 日志的策略

您还需要将状态机的执行IAM角色配置为具有登录日志的适当权限， CloudWatch 如以下示例所示。

IAM策略示例

以下是可用于配置权限的示例策略。如以下示例所示，您需要在Resource字段中指定 *。 CloudWatch API诸如 CreateLogDelivery 和 DescribeLogGroups之类的操作不支持由定义的资源类型 Amazon CloudWatch Logs。 有关更多信息，请参阅由定义的操作 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": "*"
        }
    ]
}

对状态机登录 CloudWatch 日志进行故障排除

如果您的状态机无法将日志发送到 CloudWatch 日志，请尝试以下步骤：

Step Functions 执行事件的日志级别

日志级别的范围从ALLERROR到FATAL到OFF。将记录所有事件类型ALL，设置为时不记录任何事件类型OFF。对于 ERROR 和 FATAL，请参阅下表。

有关根据这些日志级别为快速工作流执行显示的执行数据的更多信息，请参阅标准版和 Express 主机体验差异。