AWS Integration - DocumentDB

Mackerel supports obtaining and monitoring Amazon DocumentDB metrics in AWS Integration. When integrating with AWS Integration, billable targets are determined using the conversion 1 Instance = 1 Micro Host. In addition to this, depending on the number of metrics retrieved, you may be charged for exceeding the maximum number of metrics per micro host.

Please refer to the following page for AWS Integration configuration methods and a list of supported AWS services.
AWS Integration

Obtaining metrics

The metrics obtainable with AWS Integration's DocumentDB support are as follows. For Metric explanations, refer to the AWS help page.

The maximum number of metrics obtainable is 53.

Graph name Metric Metric name in Mackerel Unit Statistics
CPU CPUUtilization docdb.cpu.used percentage Average
Database Connections DatabaseConnections
DatabaseConnectionsMax		 docdb.database_connections.used
docdb.database_connections.max		 integer Sum
Database Cursor DatabaseCursors
DatabaseCursorsMax
DatabaseCursorsTimedOut		 docdb.database_cursor.used
docdb.database_cursor.max
docdb.database_cursor.timeout		 integer Sum
Memory FreeableMemory
SwapUsage		 docdb.memory.free
docdb.memory.swap		 bytes Average
Storage FreeLocalStorage docdb.storage.free bytes Average
Transaction TransactionsOpen
TransactionsOpenMax
TransactionsStarted
TransactionsCommitted
TransactionsAborted		 docdb.transaction.open
docdb.transaction.open_max
docdb.transaction.started
docdb.transaction.committed
docdb.transaction.aborted		 integer Sum
Replica Lag DBClusterReplicaLagMaximum *1
DBClusterReplicaLagMinimum *1
DBInstanceReplicaLag *2		 docdb.replica_lag.max
docdb.replica_lag.min
docdb.replica_lag.lag		 float Average
Operation OpcountersCommand
OpcountersDelete
OpcountersGetmore
OpcountersInsert
OpcountersQuery
OpcountersUpdate		 docdb.operation.command
docdb.operation.delete
docdb.operation.getmore
docdb.operation.insert
docdb.operation.query
docdb.operation.update		 integer Sum
Disk Latency ReadLatency
WriteLatency		 docdb.disk_latency.read
docdb.disk_latency.write		 float Average
Disk IOPS ReadIOPS
WriteIOPS		 docdb.disk_iops.read
docdb.disk_iops.write		 iops Average
Documents DocumentsDeleted
DocumentsInserted
DocumentsReturned
DocumentsUpdated
TTLDeletedDocuments		 docdb.documents.deleted
docdb.documents.inserted
docdb.documents.returned
docdb.documents.updated
docdb.documents.ttl_deleted		 integer Sum
Network Throughput NetworkReceiveThroughput
NetworkTransmitThroughput
NetworkThroughput		 docdb.network_throughput.receive
docdb.network_throughput.transmit
docdb.network_throughput.all		 integer Average
Disk Throughput ReadThroughput
WriteThroughput		 docdb.disk_throughput.read
docdb.disk_throughput.write		 bytes Average
CPU Credit CPUCreditUsage *3
CPUCreditBalance *3
CPUSurplusCreditBalance *3
CPUSurplusCreditsCharged *3		 docdb.cpu_credit.usage
docdb.cpu_credit.balance
docdb.cpu_credit.surplus
docdb.cpu_credit.charged		 float Average
Cache Hit Ratio BufferCacheHitRatio
IndexBufferCacheHitRatio		 docdb.cache_hit_ratio.buffer
docdb.cache_hit_ratio.index		 percentage Average
Throttle Queue Depth LowMemThrottleQueueDepth
LowMemThrottleMaxQueueDepth		 docdb.throttle_queue_depth.low_mem
docdb.throttle_queue_depth.low_mem_max		 integer Sum
Disk Queue Depth DiskQueueDepth docdb.disk_queue_depth.disk integer Sum
Uptime EngineUptime docdb.uptime.engine integer Sum
Throttled LowMemNumOperationsThrottled docdb.throttled.low_mem integer Sum
Change Stream Log ChangeStreamLogSize docdb.change_stream_log.size integer Sum
Volume Used VolumeBytesUsed *4 docdb.volume_used.bytes bytes Sum
Backup Storage Used SnapshotStorageUsed *4
TotalBackupStorageBilled *4
BackupRetentionPeriodStorageUsed *4		 docdb.backup_storage_used.snapshot
docdb.backup_storage_used.total_billed
docdb.backup_storage_used.retention_period		 bytes Sum
*1 Only generated on the PRIMARY instance
*2 Only generated on the REPLICA instance
*3 Only generated on T3 instances
*4 Metric is generated per cluster, and instances of the same cluster show the same metrics.

Notes

Among the graphs/metrics obtainable with AWS Integration, metrics included in the following graphs are usually obtained in 5 minute intervals.

  • CPU Credit
  • Volume Used

Metrics included in the following graphs are usually obtained in 1 day intervals.

  • Backup Storage Used

This is specified by the AWS CloudWatch API.