Using CloudWatch metrics for Transfer Family servers - AWS Transfer Family

Using CloudWatch metrics for Transfer Family servers

Note

You can also get metrics for Transfer Family from within the Transfer Family console itself. For details, see Monitoring usage in the console

You can get information about your server using CloudWatch metrics. A metric represents a time-ordered set of data points that are published to CloudWatch. When using metrics, you must specify the Transfer Family namespace, metric name, and dimension. For more information about metrics, see Metrics in the Amazon CloudWatch User Guide.

The following table describes the CloudWatch metrics for Transfer Family.

Namespace Metric Description

AWS/Transfer

BytesIn

The total number of bytes transferred into the server.

Reporting criteria:

  • For SFTP/FTP/FTPS: emitted every 5 minutes while a connection is established to the Transfer Family server. If no files or bytes are transferred in the period, "0" is emitted.

  • For AS2: when the customer receives a message in their AS2 server and emitted as soon as the inbound message has finished processing

Units: Count

Period: 5 minutes

BytesOut

The total number of bytes transferred out of the server.

Reporting criteria:

  • For SFTP/FTP/FTPS: emitted every 5 minutes while a connection is established to the Transfer Family server. If no files or bytes are transferred in the period, "0" is emitted.

  • For AS2: when the customer calls StartFileTransfer from their AS2 connector and emitted as soon as the outbound message has finished processing.

Units: Count

Period: 5 minutes

FilesIn

The total number of files transferred into the server.

For servers using the AS2 protocol, this metric represents the number of messages received.

Reporting criteria:

  • For SFTP/FTP/FTPS: emitted every 5 minutes while a connection is established to the Transfer Family server. If no files or bytes are transferred in the period, "0" is emitted.

  • For AS2: when the customer receives a message in their AS2 server and emitted as soon as the inbound message has finished processing.

Units: Count

Period: 5 minutes

FilesOut

The total number of files transferred out of the server.

Reporting criteria:

  • For SFTP/FTP/FTPS: emitted every 5 minutes while a connection is established to the Transfer Family server. If no files or bytes are transferred in the period, "0" is emitted.

  • For AS2: when the customer calls StartFileTransfer from their AS2 connector and emitted as soon as the outbound message has finished processing.

Units: Count

Period: 5 minutes

InboundMessage

The total number of AS2 messages successfully received from a trading partner.

Reporting criteria: When the customer receives a message in their AS2 server and emitted as soon as the inbound message has finished processing successfully

Units: Count

Period: 5 minutes

InboundFailedMessage

The total number of AS2 messages that were unsuccessfully received from a trading partner. That is, a trading partner sent a message, but the Transfer Family server was not able to successfully process it.

Reporting criteria: When the customer receives a message in their AS2 server and emitted as soon as the inbound message has finished processing unsuccessfully

Units: Count

Period: 5 minutes

OnUploadExecutionsStarted

The total number of workflow executions started on the server.

Reporting criteria: Triggered every time an execution starts

Units: Count

Period: 1 minute

OnUploadExecutionsSuccess

The total number of successful workflow executions on the server.

Reporting criteria: Triggered every time an execution successfully finishes

Units: Count

Period: 1 minute

OnUploadExecutionsFailed

The total number of unsuccessful workflow executions on the server.

Reporting criteria: Triggered every time an execution does not successfully finish

Units: Count

Period: 1 minute

OutboundMessage

The total number of AS2 messages successfully sent to a a trading partner.

Reporting criteria: When the customer calls StartFileTransfer from their AS2 connector and emitted as soon as the outbound message has finished processing successfully

Units: Count

Period: 5 minutes

OutboundFailedMessage

The total number of AS2 messages that were unsuccessfully sent to a trading partner.

Reporting criteria: When the customer calls StartFileTransfer from their AS2 connector and emitted as soon as the outbound message has finished processing unsuccessfully

Units: Count

Period: 5 minutes

Transfer Family dimensions

A dimension is a name/value pair that is part of the identity of a metric. For more information about dimensions, see Dimensions in the Amazon CloudWatch User Guide.

The following table describes the CloudWatch dimensions for Transfer Family.

Dimension Description

ServerId

The unique ID of the server.

ConnectorId

The unique ID of the connector. Used for AS2, for OutboundMessage and OutboundFailedMessage