Menu
Amazon CloudWatch
User Guide

AWS Storage Gateway Metrics and Dimensions

AWS Storage Gateway sends data points to CloudWatch for several metrics. All active queues automatically send five-minute metrics to CloudWatch. Detailed monitoring, or one-minute metrics, is currently unavailable for AWS Storage Gateway. For more information, see Monitoring Your AWS Storage Gateway in the AWS Storage Gateway User Guide.

AWS Storage Gateway Metrics

The AWS/StorageGateway namespace includes the following metrics.

You can use these metrics to get information about your gateways. Specify the GatewayId or GatewayName dimension for each metric to view the data for a gateway. Note that these metrics are measured in 5-minute intervals.

MetricDescriptionGateway-CachedGateway-StoredGateway-VTL
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

yesnoyes
CachePercentUsed

Percent use 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

yesnoyes
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

yesnoyes
CloudBytesDownloaded

The total number of 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 input/output operations per second (IOPS).

Units: Bytes

yesyesyes
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

yesyesyes
CloudBytesUploaded

The total number of 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 IOPS.

Units: Bytes

yesyesyes
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

yesnoyes
CacheFree

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

Units: Bytes

yesnoyes
UploadBufferPercentUsed

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

Units: Percent

yesnoyes
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

yesnoyes
CacheUsed

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

Units: Bytes

yesnoyes
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

yesyesyes
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 IOPS.

Units: Bytes

yesyesyes
ReadTime

The total number of milliseconds spent to do read operations 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

yesyesyes
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

yesnoyes
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 IOPS.

Units: Bytes

yesyesyes
WriteTime

The total number of milliseconds spent to do write operations 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

yesyesyes
TimeSinceLastRecoveryPoint

The time since the last available recovery point.

Units: Seconds

yesyesno
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 might find it more convenient to use just the corresponding upload buffer metric, UploadBufferFree.

Units: Bytes

noyesno
WorkingStoragePercentUsed

Percent use 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 might find it more convenient to use just the corresponding upload buffer metric, UploadBufferPercentUsed.

Units: Percent

noyesno
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 might find it more convenient to use just the corresponding upload buffer metric, UploadBufferUsed.

Units: Bytes

noyesno

The following table describes the AWS Storage Gateway metrics that you can use to get information about your storage volumes. Specify the VolumeId dimension for each metric to view the data for a storage volume.

MetricDescriptionGateway-CachedGateway-Stored
CacheHitPercent

Percent of application read operations 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 are no application read operations from the volume, this metric reports 100 percent.

Units: Percent

yesno
CachePercentUsed

The volume's contribution to the overall percent use 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 CachePercentUsed metric of the gateway to view overall percent use of the gateway's cache storage.

Units: Percent

yesno
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 volumes in a gateway-cached setup. 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.

Units: Percent

yesno
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 IOPS.

Units: Bytes

yesyes
ReadTime

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

Use this metric with the Average statistic to measure latency.

Units: Milliseconds

yesyes
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 IOPS.

Units: Bytes

yesyes
WriteTime

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

Use this metric with the Average statistic to measure latency.

Units: Milliseconds

yesyes
QueuedWrites

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

Units: Bytes

yesyes

Dimensions for AWS Storage Gateway Metrics

The Amazon CloudWatch namespace for the AWS Storage Gateway service is AWS/StorageGateway. Data is available automatically in 5-minute periods at no charge.

Dimension

Description

GatewayId, GatewayName

These dimensions filter the data you request to gateway-specific metrics. You can identify a gateway to work by its GatewayId or its GatewayName. However, note that if the name of your gateway was changed for the time range that you are interested in viewing metrics, then you should use the GatewayId.

Throughput and latency data of a gateway is based on all the volumes for the gateway. For information about working with gateway metrics, see Measuring Performance Between Your Gateway and AWS.

VolumeId

This dimension filters the data you request to volume-specific metrics. Identify a storage volume to work with by its VolumeId. For information about working with volume metrics, see Measuring Performance Between Your Application and Gateway.