Introduction

Amazon DocumentDB (with MongoDB compatibility) is a fast, reliable, and fully managed database service.

Amazon DocumentDB makes it easy to set up, operate, and scale MongoDB-compatible databases in the cloud. With Amazon DocumentDB, you can run the same application code and use the same drivers and tools that you use with MongoDB.

DocumentDB cluster

A cluster consists of:

  • 0 to 16 instances.
  • A cluster storage volume that manages the data for those instances.

In addition:

  • All writes are done through the primary instance.
  • All instances (primary and replicas) support reads.
  • Cluster’s data is stored in the cluster volume with copies in three (3) different availability zones.

DocumentDB instance

An Amazon DocumentDB instance is an isolated database environment in the cloud.

An instance has the following capability:

  • Setup of multiple user-created databases.
  • Selection of computation and memory capacity of an instance via the instance class. For example, you can select the instance that best meets your needs and if your needs change, you can choose a different instance class.

Setup

To set up the OpsRamp AWS integration and discover the AWS service, go to AWS Integration Discovery Profile and select DocDB Cluster.

Metrics

Cluster metrics

OpsRamp MetricMetric Display NameUnitAggregation TypeDescription
aws_docdb_BackupRetentionPeriodStorageUsedBackupRetentionPeriodStorageUsedBytesAverageBackupRetentionPeriodStorageUsed
aws_docdb_BufferCacheHitRatioBufferCacheHitRatioPercentAverageBufferCacheHitRatio
aws_docdb_ChangeStreamLogSizeChangeStreamLogSizeMegabytesAverageChangeStreamLogSize
aws_docdb_DBInstanceReplicaLagDBInstanceReplicaLagMillisecondsAverageDBInstanceReplicaLag
aws_docdb_DBClusterReplicaLagMaximumDBClusterReplicaLagMaximumMillisecondsAverageDBClusterReplicaLagMaximum
aws_docdb_DBClusterReplicaLagMinimumDBClusterReplicaLagMinimumMillisecondsAverageDBClusterReplicaLagMinimum
aws_docdb_DiskQueueDepthDiskQueueDepthCountAverageDiskQueueDepth
aws_docdb_EngineUptimeEngineUptimeSecondsAverageEngineUptime
aws_docdb_FreeableMemoryFreeableMemoryBytesAverageFreeableMemory
aws_docdb_FreeLocalStorageFreeLocalStorageBytesAverageFreeLocalStorage
aws_docdb_NetworkReceiveThroughputNetworkReceiveThroughputBytes/SecondAverageNetworkReceiveThroughput
aws_docdb_NetworkThroughputNetworkThroughputBytes/SecondAverageNetworkThroughput
aws_docdb_NetworkTransmitThroughputNetworkTransmitThroughputBytes/SecondAverageNetworkTransmitThroughput
aws_docdb_ReadLatencyReadLatencySecondsAverageReadLatency
aws_docdb_ReadThroughputReadThroughputBytes/SecondAverageReadThroughput
aws_docdb_SnapshotStorageUsedSnapshotStorageUsedBytesAverageSnapshotStorageUsed
aws_docdb_SwapUsageSwapUsageBytesAverageSwapUsage
aws_docdb_TotalBackupStorageBilledTotalBackupStorageBilledBytesAverageTotalBackupStorageBilled
aws_docdb_VolumeBytesUsedVolumeBytesUsedBytesAverageVolumeBytesUsed
aws_docdb_VolumeReadIOPsVolumeReadIOPsCountAverageVolumeReadIOPs
aws_docdb_VolumeWriteIOPsVolumeWriteIOPsCountAverageVolumeWriteIOPs
aws_docdb_WriteLatencyWriteLatencySecondsAverageWriteLatency
aws_docdb_WriteIOPSWriteIOPSCount/SecondAverageWriteIOPS
aws_docdb_WriteThroughputWriteThroughputBytes/SecondAverageWriteThroughput
aws_docdb_CPUUtilizationPercentAverageCPUUtilization
cloud.instance.stateStatus/Staten/an/aStatus/State

Instance metrics

OpsRamp MetricMetric Display NameUnitAggregation TypeDescription
aws_docdb_ChangeStreamLogSizeChangeStreamLogSizeMegabytesAverageChangeStreamLogSize
aws_docdb_DatabaseConnectionsDatabaseConnectionsCountAverageDatabaseConnections
aws_docdb_FreeLocalStorageFreeLocalStorageBytesAverageFreeLocalStorage
aws_docdb_FreeableMemoryFreeableMemoryBytesAverageFreeableMemory
aws_docdb_WriteIOPSWriteIOPSCount/SecondAverageWriteIOPS
aws_docdb_ReadIOPSReadIOPSCount/SecondAverageReadIOPS
aws_docdb_WriteLatencyWriteLatencySecondsAverageWriteLatency
aws_docdb_ReadLatencyReadLatencySecondsAverageReadLatency
aws_docdb_WriteThroughputWriteThroughputBytes/SecondAverageWriteThroughput
aws_docdb_ReadThroughputReadThroughputBytes/SecondAverageReadThroughput
aws_docdb_NetworkThroughputNetworkThroughputBytes/SecondAverageNetworkThroughput
aws_docdb_NetworkTransmitThroughputNetworkTransmitThroughputBytes/SecondAverageNetworkTransmitThroughput
aws_docdb_NetworkReceiveThroughputNetworkReceiveThroughputBytes/SecondAverageNetworkReceiveThroughput
aws_docdb_EngineUptimeEngineUptimeSecondsAverageEngineUptime
aws_docdb_SwapUsageSwapUsageBytesAverageSwapUsage
aws_docdb_DiskQueueDepthDiskQueueDepthCountAverageDiskQueueDepth
aws_docdb_BufferCacheHitRatioBufferCacheHitRatioPercentAverageBufferCacheHitRatio
aws_docdb_BackupRetentionPeriodStorageUsedBackupRetentionPeriodStorageUsedBytesAverageBackupRetentionPeriodStorageUsed
aws_docdb_SnapshotStorageUsedSnapshotStorageUsedBytesAverageSnapshotStorageUsed
aws_docdb_TotalBackupStorageBilledTotalBackupStorageBilledBytesAverageTotalBackupStorageBilled
aws_docdb_CPUUtilizationPercentAverageCPUUtilization
cloud.instance.stateStatus/Staten/an/aStatus/State

Event support

CloudTrail event support

  • Not Supported

CloudWatch alarm support

  • Supported
  • Configurable in OpsRamp AWS Integration Discovery Profile.

External reference