管理工作流程日志

CloudWatch 为工作流程进度和结果提供统一的审计和记录。此外，还为工作流程 Amazon Transfer Family 提供了多个指标。您可以查看前一分钟有多少工作流程执行启动、成功完成和失败的指标。中描述了 Transfer Family 的所有 CloudWatch 指标使用 Transfer Family 服务器的 CloudWatch 指标。

Amazon Transfer Family 提供了两种向亚马逊交付托管工作流程执行日志的方法 CloudWatch：

您指定的日志组（结构化日志目的地）-您将 CloudWatch 日志组指定为工作流的结构化日志目的地，Transfer Family 会将工作流程执行日志交付给该日志组。此选项不需要日志记录角色。要使用它，请在创建工作流程时在StructuredLogDestinations参数中提供日志组的亚马逊资源名称 (ARN)（参见 Amazon Transfer Family API 参考StructuredLogDestinations中）。日志组必须与工作流程处于相同 Amazon Web Services 账户和 Amazon Web Services 区域相同的位置。

要配置结构化日志目的地，创建工作流程的委托人的 IAM 策略必须包含以下权限：
- logs:CreateLogDelivery
- logs:DeleteLogDelivery
- logs:DescribeLogGroups
- logs:DescribeResourcePolicies
- logs:GetLogDelivery
- logs:ListLogDeliveries
- logs:PutResourcePolicy
- logs:UpdateLogDelivery
日志记录角色 -您将 IAM 日志记录角色附加到工作流程所连接的服务器。Transfer Family 负责将工作流程执行日志写入名为的日志组/aws/transfer/server-id。有关更多信息，请参阅配置 CloudWatch 日志角色。

两种机制都以相同的 JSON 格式写入相同的工作流程执行日志内容。区别仅在于日志的传输位置：传送到您指定的日志组，或通过/aws/transfer/server-id日志角色传送到服务器上的日志组。

查看亚马逊工作流程 CloudWatch 日志

在以下位置打开亚马逊 CloudWatch 控制台https://console.aws.amazon.com/cloudwatch/。
在左侧导航窗格中选择日志，然后选择日志组。
在日志组页面的导航栏上，为您的 Amazon Transfer Family 服务器选择正确的区域。
选择包含您的工作流程日志的日志组。
- 如果工作流使用结构化日志目标，请选择您在工作流StructuredLogDestinations参数中指定其 ARN 的日志组。
- 如果工作流在服务器上使用日志记录角色，请选择与您的服务器对应的日志组。例如，如果您的服务器 ID 是 s-1234567890abcdef0，则您的日志组是 /aws/transfer/s-1234567890abcdef0。
在日志组详细信息页面上，显示最新的日志流。工作流的日志流名称取决于工作流使用的日志机制：
- 对于结构化日志目的地，工作流日志流被命名workflowID/executionID。例如：
```
w-abcdef01234567890/021345abcdef6789
```
- 对于日志记录角色，服务器日志组包含两个日志流，供您正在浏览的用户使用：一个用于每个 Secure Shell (SSH) 文件传输协议 (SFTP) 会话，一个用于正在执行的工作流。工作流日志流的格式为username.workflowID.uniqueStreamSuffix。
例如，如果您的用户是 mary-major，您具有以下日志流：
```
mary-major-east.1234567890abcdef0
mary.w-abcdef01234567890.021345abcdef6789
```
注意
此示例中列出的 16 位字母数字标识符是虚构的。您在亚马逊上看到的值 CloudWatch 是不同的。

工作流日志流的日志事件页面包含工作流程执行的详细信息。如果工作流使用日志记录角色，则该mary-major-usa-east.1234567890abcdef0流将显示每个用户会话的详细信息，并且该mary.w-abcdef01234567890.021345abcdef6789流包含工作流的详细信息。如果工作流使用结构化日志目标，则该w-abcdef01234567890/021345abcdef6789流包含工作流的详细信息。

以下是基于包含复制步骤的工作流程 (w-abcdef01234567890) 的 mary.w-abcdef01234567890.021345abcdef6789 日志流示例。


{
    "type": "ExecutionStarted",
    "details": {
        "input": {
            "initialFileLocation": {
                "bucket": "amzn-s3-demo-bucket",
                "key": "mary/workflowSteps2.json",
                "versionId": "version-id",
                "etag": "etag-id"
            }
        }
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails": {
        "serverId":"s-server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
},
{
    "type":"StepStarted",
    "details": {
        "input": {
            "fileLocation": {
                "backingStore":"S3",
                "bucket":"amzn-s3-demo-bucket",
                "key":"mary/workflowSteps2.json",
                "versionId":"version-id",
                "etag":"etag-id"
            }
        },
        "stepType":"COPY",
        "stepName":"copyToShared"
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails": {
        "serverId":"s-server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
},
{
    "type":"StepCompleted",
    "details":{
        "output":{},
        "stepType":"COPY",
        "stepName":"copyToShared"
    },
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails":{
        "serverId":"server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
},
{
    "type":"ExecutionCompleted",
    "details": {},
    "workflowId":"w-abcdef01234567890",
    "executionId":"execution-id",
    "transferDetails":{
        "serverId":"s-server-id",
        "username":"mary",
        "sessionId":"session-id"
    }
}

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

为服务器创建日志

为配置角色 CloudWatch

管理工作流程日志

查看亚马逊工作流程 CloudWatch 日志

注意