View a markdown version of this page

监控工作流程执行情况 - AWS Transfer Family
CloudWatch 记录工作流程CloudWatch 工作流程指标

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

监控工作流程执行情况

Amazon 实时 CloudWatch 监控您的 AWS 资源和您运行 AWS Cloud 的应用程序。您可以使用亚马逊 CloudWatch 收集和跟踪指标，这些变量是您可以衡量工作流程的变量。您可以使用亚马逊查看工作流程指标和合并日志 CloudWatch。

CloudWatch 记录工作流程

CloudWatch 为工作流程进度和结果提供统一的审计和记录。

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

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

    要配置结构化日志目的地，创建工作流程的委托人的 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 日志

  1. 在以下位置打开亚马逊 CloudWatch 控制台https://console.aws.amazon.com/cloudwatch/。

  2. 在左侧导航窗格中选择日志，然后选择日志组。

  3. 在日志组页面的导航栏上，为您的 AWS Transfer Family 服务器选择正确的区域。

  4. 选择包含您的工作流程日志的日志组。

    • 如果工作流使用结构化日志目标，请选择您在工作流StructuredLogDestinations参数中指定其 ARN 的日志组。

    • 如果工作流在服务器上使用日志记录角色，请选择与您的服务器对应的日志组。例如，如果您的服务器 ID 是 s-1234567890abcdef0，则您的日志组是 /aws/transfer/s-1234567890abcdef0。

  5. 在日志组详细信息页面上，显示最新的日志流。工作流的日志流名称取决于工作流使用的日志机制：

    • 对于结构化日志目的地，工作流日志流被命名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"
    }
}

CloudWatch 工作流程指标

AWS Transfer Family 为工作流程提供了多个指标。您可以查看前一分钟有多少工作流程执行启动、成功完成和失败的指标。中描述了 Transfer Family 的所有 CloudWatch 指标使用 Transfer Family 服务器的 CloudWatch 指标。