AWS Storage Gateway monitoring
Dynatrace ingests metrics for multiple preselected namespaces, including AWS Storage Gateway. You can view metrics for each service instance, split metrics into multiple dimensions, and create custom charts that you can pin to your dashboards.
Prerequisites
To enable monitoring for this service, you need
- ActiveGate version 1.197+, as follows:
- For Dynatrace SaaS deployments, you need an Environment ActiveGate or a Multi-environment ActiveGate.
- For Dynatrace Managed deployments, you can use any kind of ActiveGate.
Note: For role-based access (whether in a SaaS or Managed deployment), you need an Environment ActiveGate installed on an Amazon EC2 host.
- Dynatrace version 1.200+
- An updated AWS monitoring policy to include the additional AWS services.
To update the AWS IAM policy, use the JSON below, containing the monitoring policy (permissions) for all supporting services.
If you don't want to add permissions to all services, and just select permissions for certain services, consult the table below. The table contains a set of permissions that are required for all services (All monitored Amazon services) and, for each supporting service, a list of optional permissions specific to that service.
Example of JSON policy for one single service.
In this example, from the complete list of permissions you need to select
"apigateway:GET"for Amazon API Gateway"cloudwatch:GetMetricData","cloudwatch:GetMetricStatistics","cloudwatch:ListMetrics","sts:GetCallerIdentity","tag:GetResources","tag:GetTagKeys", and"ec2:DescribeAvailabilityZones"for All monitored Amazon services.
Enable monitoring
To enable monitoring for this service, you first need to integrate Dynatrace with Amazon Web Services:
Add the service to monitoring
In order to view the service metrics, you must add the service to monitoring in your Dynatrace environment.
All cloud services consume Davis data units (DDUs). The amount of DDU consumption per service instance depends on the number of monitored metrics and their dimensions (each metric dimension results in the ingestion of 1 data point; 1 data point consumes 0.001 DDUs).
Monitor resources based on tags
You can choose to monitor resources based on existing AWS tags, as Dynatrace automatically imports them from service instances. Nevertheless, the transition from AWS to Dynatrace tagging isn't supported for all AWS services. Expand the table below to see which cloud services are filtered by tagging.
To monitor resources based on tags
- In the Dynatrace menu, go to Settings > Cloud and virtualization > AWS and select Edit for the desired AWS instance.
- For Resources to be monitored, select Monitor resources selected by tags.
- Enter the Key and Value.
- Select Save.
Configure service metrics
Once you add a service, Dynatrace starts automatically collecting a suite of metrics for this particular service. These are recommended metrics.
Recommended metrics:
- Are enabled by default
- Can't be disabled
- Can have recommended dimensions (enabled by default, can't be disabled)
- Can have optional dimensions (disabled by default, can be enabled)
Apart from the recommended metrics, most services have the possibility of enabling optional metrics.
Optional metrics:
- Can be added and configured manually
View service metrics
You can view the service metrics in your Dynatrace environment either on the custom device overview page or on your Dashboards page.
View metrics on the custom device overview page
To access the custom device overview page
- In the Dynatrace menu, go to Technologies and processes.
- Filter by service name and select the relevant custom device group.
- Once you select the custom device group, you're on the custom device group overview page.
- The custom device group overview page lists all instances (custom devices) belonging to the group. Select an instance to view the custom device overview page.
View metrics on your dashboard
After you add the service to monitoring, a preset dashboard containing all recommended metrics is automatically listed on your Dashboards page. To look for specific dashboards, filter by Preset and then by Name.
Note: For existing monitored services, you might need to resave your credentials for the preset dashboard to appear on the Dashboards page. To resave your credentials, go to Settings > Cloud and virtualization > AWS, select the desired AWS instance, and then select Save.
You can't make changes on a preset dashboard directly, but you can clone and edit it. To clone a dashboard, open the browse menu (…) and select Clone.
To remove a dashboard from the dashboards page, you can hide it. To hide a dashboard, open the browse menu (…) and select Hide.
Note: Hiding a dashboard doesn't affect other users.
To check the availability of preset dashboards for each AWS service, see the list below.
Available metrics
| Name | Description | Unit | Statistics | Dimensions | Recommended |
|---|---|---|---|---|---|
| CacheFree | The total number of bytes available in the gateway's cache storage | Bytes | Sum | GatewayName, GatewayId | ✔️ |
| CacheHitPercent | Percentage of application reads served from the cache | Percent | Multi | Region, ShareId | ✔️ |
| CacheHitPercent | Percent | Multi | Region, VolumeId | ✔️ | |
| CacheHitPercent | Percent | Multi | GatewayName, GatewayId | ✔️ | |
| CachePercentDirty | Percentage of the cache that is dirty—that is, it contains content that has not been uploaded to AWS | Percent | Multi | Region, ShareId | ✔️ |
| CachePercentDirty | Percent | Multi | Region, VolumeId | ✔️ | |
| CachePercentDirty | Percent | Multi | GatewayName, GatewayId | ✔️ | |
| CachePercentUsed | Percentage of the gateway's cache storage being used | Percent | Multi | Region, ShareId | ✔️ |
| CachePercentUsed | Percent | Multi | Region, VolumeId | ✔️ | |
| CachePercentUsed | Percent | Multi | GatewayName, GatewayId | ✔️ | |
| CacheUsed | The total number of bytes being used in the gateway's cache storage | Bytes | Sum | GatewayName, GatewayId | ✔️ |
| CloudBytesDownloaded | The total number of bytes that the gateway sent to the cloud during the reporting period. This metric includes the activity of all the volumes on the gateway. | Bytes | Sum | Region, ShareId | ✔️ |
| CloudBytesDownloaded | Bytes | Count | Region, ShareId | ||
| CloudBytesDownloaded | Bytes | Sum | GatewayName, GatewayId | ✔️ | |
| CloudBytesDownloaded | Bytes | Count | GatewayName, GatewayId | ||
| CloudBytesUploaded | The total number of bytes that the gateway sent to the cloud during the reporting period | Bytes | Sum | Region, ShareId | ✔️ |
| CloudBytesUploaded | Bytes | Count | Region, ShareId | ||
| CloudBytesUploaded | Bytes | Sum | GatewayName, GatewayId | ||
| CloudBytesUploaded | Bytes | Count | GatewayName, GatewayId | ||
| CloudDownloadLatency | The latency in downloading the data from the cloud to the gateway | Milliseconds | Multi | GatewayName, GatewayId | |
| IndexFetches | The number of files for which metadata was fetched | Count | Sum | Region, ShareId | ✔️ |
| IndexFetches | Count | Sum | GatewayName, GatewayId | ✔️ | |
| IoWaitPercent | Percentage of time that the gateway is waiting on a response from the local disk | Percent | Multi | GatewayName | ✔️ |
| MemTotalBytes | Amount of RAM provisioned to the gateway VM, in bytes | Bytes | Sum | GatewayName | ✔️ |
| MemUsedBytes | Amount of RAM currently in use by the gateway VM, in bytes | Bytes | Sum | GatewayName | ✔️ |
| NfsSessions | The number of NFS session that are active on the gateway | Count | Sum | GatewayName | ✔️ |
| 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 | Bytes | Sum | Region, VolumeId | ✔️ |
| QueuedWrites | Bytes | Sum | GatewayName, GatewayId | ✔️ | |
| ReadBytes | The total number of bytes read from your on-premises applications in the reporting period for all volumes in the gateway | Bytes | Sum | Region, VolumeId | ✔️ |
| ReadBytes | Bytes | Count | Region, VolumeId | ||
| ReadBytes | Bytes | Sum | GatewayName, GatewayId | ✔️ | |
| ReadBytes | Bytes | Count | GatewayName, GatewayId | ||
| ReadTime | The total number of milliseconds spent on read operations from your on-premises applications in the reporting period for all volumes in the gateway | Milliseconds | Multi | Region, VolumeId | ✔️ |
| ReadTime | Milliseconds | Multi | GatewayNam, GatewayIde | ✔️ | |
| SmbV1Sessions | The number of Server Message Block (SMB) version 1 sessions that are active on the gateway | Count | Sum | GatewayName | |
| SmbV2Sessions | The number of SMB version 2 sessions that are active on the gateway | Count | Sum | GatewayName | |
| SmbV3Sessions | The number of SMB version 3 sessions that are active on the gateway | Count | Sum | GatewayName | |
| TimeSinceLastRecoveryPoint | The time since the last available recovery point | Seconds | Multi | Region, VolumeId | ✔️ |
| TimeSinceLastRecoveryPoint | Seconds | Multi | GatewayName, GatewayId | ||
| TotalCacheSize | The total size of the cache in bytes | Bytes | Sum | GatewayName, GatewayId | ✔️ |
| UploadBufferFree | Bytes | Sum | GatewayName, GatewayId | ✔️ | |
| UploadBufferPercentUsed | Percentage of the gateway's upload buffer used | Percent | Multi | GatewayName, GatewayId | ✔️ |
| UploadBufferUsed | The total number of bytes being used in the gateway's upload buffer | Bytes | Sum | GatewayName, GatewayId | ✔️ |
| UserCpuPercent | Percentage of CPU time spent on gateway processing, averaged across all cores | Percent | Multi | GatewayName | |
| WorkingStorageFree | The total amount of unused space in the gateway's working storage | Bytes | Sum | GatewayName, GatewayId | ✔️ |
| WorkingStoragePercentUsed | Percentage of the gateway's upload buffer used | Percent | Multi | GatewayName, GatewayId | ✔️ |
| WorkingStorageUsed | The total number of bytes being used in the gateway's upload buffer | Bytes | Sum | GatewayName, GatewayId | ✔️ |
| WriteBytes | The total number of bytes written to your on-premises applications in the reporting period for all volumes in the gateway | Bytes | Sum | Region, VolumeId | ✔️ |
| WriteBytes | Bytes | Count | Region, VolumeId | ||
| WriteBytes | Bytes | Sum | GatewayName, GatewayId | ✔️ | |
| WriteBytes | Bytes | Count | GatewayName, GatewayId | ||
| WriteTime | The total number of milliseconds spent on write operations from your on-premises applications in the reporting period for all volumes in the gateway | Milliseconds | Multi | Region, VolumeId | ✔️ |
| WriteTime | Milliseconds | Multi | GatewayName, GatewayId | ✔️ |