AWS Storage Gateway
User Guide (API Version 2012-06-30)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Understanding AWS Storage Gateway Metrics

Gateway Metrics

For the discussion here, we define gateway metrics as metrics that are scoped to the gateway—that is, they measure something about the gateway. Since a gateway contains one or more volumes, a gateway-specific metric is representative of all volumes on the gateway. For example, the CloudBytesUploaded metric is the total number of bytes that the gateway sent to the cloud during the reporting period. This includes the activity of all the volumes on the gateway.

When working with gateway metric data, you will specify the unique identification of the gateway that you are interested in viewing metrics for. To do this, you can either specify the GatewayId or the GatewayName. When you want to work with metric for a gateway, you specify the gateway dimension in the metrics namespace, which distinguishes a gateway-specific metric from a volume-specific metric. For more information, see Using the Amazon CloudWatch Console.

The following table describes the AWS Storage Gateway metrics that you can use to get information about your gateway. The entries in the table are grouped functionally by measure.

MetricDescription
CacheHitPercent

Percent of application reads served from the cache. This metric applies only to the gateway-cached volume setup. The sample is taken at the end of the reporting period.

Units: Percent

CachePercentageUsed

Percent utilization of the gateway's cache storage. This metric applies only to the gateway-cached volume setup. The sample is taken at the end of the reporting period.

Units: Percent

CachePercentDirty

Percent of the gateway's cache that has not been persisted to AWS. This metric applies only to the gateway-cached volume setup. The sample is taken at the end of the reporting period.

Units: Percent

CloudBytesDownloaded

The total number of pre-compressed bytes that the gateway downloaded from AWS during the reporting period.

Use this metric with the Sum statistic to measure throughput and with the Samples statistic to measure operations per second (IOPS).

Units: Bytes

CloudDownloadLatency

The total number of milliseconds spent reading data from AWS during the reporting period.

Use this metric with the Average statistic to measure latency.

Units: Milliseconds

CloudBytesUploaded

The total number of pre-compressed bytes that the gateway uploaded to AWS during the reporting period.

Use this metric with the Sum statistic to measure throughput and with the Samples statistic to measure operations per second (IOPS).

Units: Bytes

UploadBufferFree

The total amount of unused space in the gateway's upload buffer. The sample is taken at the end of the reporting period.

Units: Bytes

UploadBufferPercentUsed

Percent utilization of the gateway's upload buffer. The sample is taken at the end of the reporting period.

Units: Percent

UploadBufferUsed

The total number of bytes being used in the gateway's upload buffer. The sample is taken at the end of the reporting period.

Units: Bytes

QueuedWrites

The number of bytes waiting to be written to AWS, sampled at the end of the reporting period for all volumes in the gateway. These bytes are kept in your gateway's working storage.

Units: Bytes

ReadBytes

The total number of bytes read from your on-premises applications in the reporting period for all volumes in the gateway.

Use this metric with the Sum statistic to measure throughput and with the Samples statistic to measure operations per second (IOPS).

Units: Bytes

ReadTime

The total number of milliseconds spent to do reads from your on-premises applications in the reporting period for all volumes in the gateway.

Use this metric with the Average statistic to measure latency.

Units: Milliseconds

TotalCacheSize

The total size of the cache in bytes. This metric applies only to the gateway-cached volume setup. The sample is taken at the end of the reporting period.

Units: Bytes

WriteBytes

The total number of bytes written to your on-premises applications in the reporting period for all volumes in the gateway.

Use this metric with the Sum statistic to measure throughput and with the Samples statistic to measure operations per second (IOPS).

Units: Bytes

WriteTime

The total number of milliseconds spent to do writes from your on-premises applications in the reporting period for all volumes in the gateway.

Use this metric with the Average statistic to measure latency.

Units: Milliseconds

WorkingStorageFree

The total amount of unused space in the gateway's working storage. The sample is taken at the end of the reporting period.

Note

Working storage applies only to the gateway-stored volume setup. The upload buffer applies to both the gateway-stored and gateway-cached volume setups. If you are working with both types of gateway setups, you may find it more convenient to use just the corresponding upload buffer metric, UploadBufferFree.

Units: Bytes

WorkingStoragePercentageUsed

Percent utilization of the gateway's upload buffer. The sample is taken at the end of the reporting period.

Note

Working storage applies only to the gateway-stored volume setup. The upload buffer applies to both the gateway-stored and gateway-cached volume setups. If you are working with both types of gateway setups, you may find it more convenient to use just the corresponding upload buffer metric, UploadBufferPercentUsed.

Units: Percent

WorkingStorageUsed

The total number of bytes being used in the gateway's upload buffer. The sample is taken at the end of the reporting period.

Note

Working storage applies only to the gateway-stored volume setup. The upload buffer applies to both the gateway-stored and gateway-cached volume setups. If you are working with both types of gateway setups, you may find it more convenient to use just the corresponding upload buffer metric, UploadBufferUsed.

Units: Bytes

Storage Volume Metrics

In this section, we discuss the AWS Storage Gateway metrics that give you information about a storage volume of a gateway. Each volume of a gateway has a set of metrics associated with it. Note that some volume-specific metrics have the same name as a gateway-specific metric. These metrics represent the same kinds of measurements, but are scoped to the volume instead of the gateway. You must always specify whether you want to work with either a gateway or a storage volume metric before working with a metric. Specifically, when working with volume metrics, you must specify the VolumeId of the storage volume for which you are interested in viewing metrics. For more information, see Using the Amazon CloudWatch Console.

The following table describes the AWS Storage Gateway metrics that you can use to get information about your storage volumes.

MetricDescription
CacheHitPercent

Percent of application reads from the volume that are served from cache. This metric applies only to cached volumes. The sample is taken at the end of the reporting period.

When there is no application reads from the volume, this metric reports 100%.

Units: Percent

CachePercentageUsed

The volume's contribution to the overall percent utilization of the gateway's cache storage. This metric applies only to cached volumes. The sample is taken at the end of the reporting period.

Use the CachePercentageUsed metric of the gateway to view overall percent utilization of the gateway's cache storage. For more information, see Gateway Metrics.

Units: Percent

CachePercentDirty

The volume's contribution to the overall percentage of the gateway's cache that has not been persisted to AWS. This metric applies only to the cached-volumes. The sample is taken at the end of the reporting period.

Use the CachePercentDirty metric of the gateway to view the overall percentage of the gateway's cache that has not been persisted to AWS. For more information, see Gateway Metrics.

Units: Percent

ReadBytes

The total number of bytes read from your on-premises applications in the reporting period.

Use this metric with the Sum statistic to measure throughput and with the Samples statistic to measure operations per second (IOPS).

Units: Bytes

ReadTime

The total number of milliseconds spent to do reads from your on-premises applications in the reporting period.

Use this metric with the Average statistic to measure latency.

Units: Milliseconds

WriteBytes

The total number of bytes written to your on-premises applications in the reporting period.

Use this metric with the Sum statistic to measure throughput and with the Samples statistic to measure operations per second (IOPS).

Units: Bytes

WriteTime

The total number of milliseconds spent to do writes from your on-premises applications in the reporting period.

Use this metric with the Average statistic to measure latency.

Units: Milliseconds

QueuedWrites

The number of bytes waiting to be written to AWS, sampled at the end of the reporting period.

Units: Bytes