Amazon DocumentDB (with MongoDB compatibility) monitoring

Dynatrace ingests metrics for multiple preselected namespaces, including Amazon DocumentDB. You can view graphs per service instance, with a set of dimensions, and create custom graphs that you can pin to your dashboards.

Prerequisites

To enable monitoring for this service, you need

  • An Environment or Cluster ActiveGate version 1.197+
    Note: For role-based access (whether in a SaaS or Managed deployment), you need an Environment ActiveGate installed on an AWS EC2 host.
  • Dynatrace version 1.203+
  • 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.

Cloud-service monitoring consumption

As of 2021, 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 supporting services are filtered by tagging.

To monitor resources based on tags

  1. In the Dynatrace menu, go to Settings > Cloud and virtualization > AWS and select Edit for the desired AWS instance.
  2. For Resources to be monitored, select Monitor resources selected by tags.
  3. Enter the Key and Value.
  4. 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

  1. In the Dynatrace menu, go to Technologies and processes.
  2. Filter by service name and select the relevant custom device group.
  3. Once you select the custom device group, you're on the custom device group overview page.
  4. 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.
aws-presets
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. clone-hide-aws

To check the availability of preset dashboards for each AWS service, see the list below.

docdb-dash

Available metrics

Name Description Unit Statistics Dimensions Recommended
BackupRetentionPeriodStorageUsed The total amount of backup storage in GiB used to support the point-in-time restore feature within the Amazon DocumentDB's retention window Bytes Multi DBClusterIdentifier ✔️
BackupRetentionPeriodStorageUsed Bytes Multi Region, EngineName
BufferCacheHitRatio The percentage of requests that are served by the buffer cache Percent Multi Region, DBInstanceIdentifier
BufferCacheHitRatio Percent Multi DBClusterIdentifier, Role
BufferCacheHitRatio Percent Multi DBClusterIdentifier ✔️
CPUUtilization The percentage of CPU used by an instance Percent Multi Region, DBInstanceIdentifier
CPUUtilization Percent Multi DBClusterIdentifier, Role
CPUUtilization Percent Multi DBClusterIdentifier ✔️
ChangeStreamLogSize The amount of storage used by your cluster to store the change stream log in megabytes Megabytes Multi Region, DBInstanceIdentifier
ChangeStreamLogSize Megabytes Multi DBClusterIdentifier, Role
ChangeStreamLogSize Megabytes Multi DBClusterIdentifier
DBClusterReplicaLagMaximum The maximum amount of lag, in milliseconds, between the primary instance and each Amazon DocumentDB instance in the cluster Milliseconds Multi Region, DBInstanceIdentifier
DBClusterReplicaLagMaximum Milliseconds Multi DBClusterIdentifier
DBClusterReplicaLagMaximum Milliseconds Multi DBClusterIdentifier, Role
DBClusterReplicaLagMinimum The minimum amount of lag, in milliseconds, between the primary instance and each replica instance in the cluster Milliseconds Multi Region, DBInstanceIdentifier
DBClusterReplicaLagMinimum Milliseconds Multi DBClusterIdentifier
DBClusterReplicaLagMinimum Milliseconds Multi DBClusterIdentifier, Role
DBInstanceReplicaLag The amount of lag, in milliseconds, when replicating updates from the primary instance to a replica instance Milliseconds Multi Region, DBInstanceIdentifier
DBInstanceReplicaLag Milliseconds Multi DBClusterIdentifier
DBInstanceReplicaLag Milliseconds Multi DBClusterIdentifier, Role
DatabaseConnections The number of connections open on an instance taken at a one-minute frequency Count Multi Region, DBInstanceIdentifier
DatabaseConnections Count Multi DBClusterIdentifier, Role
DatabaseConnections Count Multi DBClusterIdentifier ✔️
DiskQueueDepth The number of outstanding read/write requests waiting to access the disk Count Average Region, DBInstanceIdentifier
DiskQueueDepth Count Average DBClusterIdentifier,Role
DiskQueueDepth Count Average DBClusterIdentifier
EngineUptime The amount of time, in seconds, that the instance has been running Seconds Multi DBClusterIdentifier, Role
EngineUptime Seconds Multi DBClusterIdentifier
EngineUptime Seconds Multi Region, DBInstanceIdentifier
FreeLocalStorage The amount of storage available to each instance for temporary tables and logs Bytes Multi Region, DBInstanceIdentifier
FreeLocalStorage Bytes Multi DBClusterIdentifier, Role
FreeLocalStorage Bytes Multi DBClusterIdentifier
FreeableMemory The amount of available random access memory, in bytes Bytes Multi Region, DBInstanceIdentifier
FreeableMemory Bytes Multi DBClusterIdentifier, Role
FreeableMemory Bytes Multi DBClusterIdentifier
NetworkReceiveThroughput The amount of network throughput, in bytes per second, received from clients by each instance in the cluster Bytes/Second Multi Region, DBInstanceIdentifier
NetworkReceiveThroughput Bytes/Second Multi DBClusterIdentifier, Role
NetworkReceiveThroughput Bytes/Second Multi DBClusterIdentifier ✔️
NetworkThroughput The amount of network throughput, in bytes per second, both received from and transmitted to clients by each instance in the Amazon DocumentDB cluster Bytes/Second Multi Region, DBInstanceIdentifier
NetworkThroughput Bytes/Second Multi DBClusterIdentifier, Role
NetworkThroughput Bytes/Second Multi DBClusterIdentifier ✔️
NetworkTransmitThroughput The amount of network throughput, in bytes per second, sent to clients by each instance in the cluster Bytes/Second Multi Region, DBInstanceIdentifier
NetworkTransmitThroughput Bytes/Second Multi DBClusterIdentifier, Role
NetworkTransmitThroughput Bytes/Second Multi DBClusterIdentifier ✔️
ReadIOPS The average number of disk read I/O operations per second Count/Second Multi Region, DBInstanceIdentifier
ReadIOPS Count/Second Multi DBClusterIdentifier, Role
ReadIOPS Count/Second Multi DBClusterIdentifier ✔️
ReadLatency The average amount of time taken per disk I/O operation Seconds Multi Region, DBInstanceIdentifier ✔️
ReadLatency Seconds Multi DBClusterIdentifier, Role
ReadLatency Seconds Multi DBClusterIdentifier ✔️
ReadThroughput The average number of bytes read from disk per second Bytes/Second Multi Region, DBInstanceIdentifier
ReadThroughput Bytes/Second Multi DBClusterIdentifier, Role
ReadThroughput Bytes/Second Multi DBClusterIdentifier ✔️
SnapshotStorageUsed The total amount of backup storage in GiB consumed by all snapshots for a given Amazon DocumentDB cluster outside its backup retention window Bytes Multi Region, EngineName
SnapshotStorageUsed Bytes Multi DBClusterIdentifier ✔️
SwapUsage The amount of swap space used on the instance Bytes Multi Region, DBInstanceIdentifier
SwapUsage Bytes Multi DBClusterIdentifier, Role
SwapUsage Bytes Multi DBClusterIdentifier
TotalBackupStorageBilled The total amount of backup storage in GiB for which you are billed for a given Amazon DocumentDB cluster Bytes Multi Region, EngineName
TotalBackupStorageBilled Bytes Multi DBClusterIdentifier ✔️
VolumeBytesUsed The amount of storage used by your cluster in bytes Bytes Average DBClusterIdentifier ✔️
VolumeReadIOPs The average number of billed read I/O operations from a cluster volume, reported at 5-minute intervals Count Average DBClusterIdentifier ✔️
VolumeWriteIOPs The average number of billed write I/O operations from a cluster volume, reported at 5-minute intervals Count Average DBClusterIdentifier ✔️
WriteIOPS The average number of disk write I/O operations per second Count/Second Multi Region, DBInstanceIdentifier
WriteIOPS Count/Second Multi DBClusterIdentifier, Role
WriteIOPS Count/Second Multi DBClusterIdentifier ✔️
WriteLatency The average amount of time, in milliseconds, taken per disk I/O operation Seconds Multi Region, DBInstanceIdentifier
WriteLatency Seconds Multi DBClusterIdentifier, Role
WriteLatency Seconds Multi DBClusterIdentifier ✔️
WriteThroughput The average number of bytes written to disk per second Bytes/Second Multi Region, DBInstanceIdentifier
WriteThroughput Bytes/Second Multi DBClusterIdentifier, Role
WriteThroughput Bytes/Second Multi DBClusterIdentifier ✔️