Monitor workflow execution - Amazon Transfer Family
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Monitor workflow execution

Amazon CloudWatch monitors your Amazon resources and the applications that you run in the Amazon Web Services Cloud in real time. You can use Amazon CloudWatch to collect and track metrics, which are variables that you can measure for your workflows. You can view workflow metrics and consolidated logs by using Amazon CloudWatch.

CloudWatch logging for a workflow

CloudWatch provides consolidated auditing and logging for workflow progress and results.

View Amazon CloudWatch logs for workflows

  1. Open the Amazon CloudWatch console at https://console.amazonaws.cn/cloudwatch/.

  2. In the left navigation pane, choose Logs, then choose Log groups.

  3. On the Log groups page, on the navigation bar, choose the correct Region for your Amazon Transfer Family server.

  4. Choose the log group that corresponds to your server.

    For example, if your server ID is s-1234567890abcdef0, your log group is /aws/transfer/s-1234567890abcdef0.

  5. On the log group details page for your server, the most recent log streams are displayed. There are two log streams for the user that you are exploring:

    • One for each Secure Shell (SSH) File Transfer Protocol (SFTP) session.

    • One for the workflow that is being executed for your server. The format for the log stream for the workflow is username.workflowID.uniqueStreamSuffix.

    For example, if your user is bob-usa, you have the following log streams:

    bob-usa-east.1234567890abcdef0 bob.w-abcdef01234567890.021345abcdef6789
    Note

    The 16-digit alphanumeric identifiers listed in this example are fictitious; the values that you see in Amazon CloudWatch are different.

The Log events page for bob-usa-east.1234567890abcdef0 displays the details for each user session, and the bob.w-abcdef01234567890.021345abcdef6789 log stream contains the details for the workflow.

The following is a sample log stream for bob.w-abcdef01234567890.021345abcdef6789, based on a workflow (w-abcdef01234567890) that contains a copy step.

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

CloudWatch metrics for workflows

Amazon Transfer Family provides several metrics for workflows. You can view metrics for how many workflows executions started, completed successfully, and failed in the previous minute. All of the CloudWatch metrics for Transfer Family are described in Using CloudWatch metrics for Transfer Family.