AWS DynamoDB DAX¶
The Metrics displayed for AWS DynamoDB DAX include CPU utilization of nodes or clusters, bytes received or sent on all network interfaces, number of packets, etc. These Metrics reflect the operational status of DynamoDB DAX.
Configuration¶
Install Func¶
It is recommended to activate Guance Integration - Extensions - DataFlux Func (Automata): All prerequisites are automatically installed, please proceed with script installation.
For self-deploying Func, refer to Self-deploying Func
Install Script¶
Note: Please prepare an Amazon Cloud AK that meets the requirements in advance (for simplicity, you can directly grant the CloudWatch read-only permission
CloudWatchReadOnlyAccess
)
Managed Version Activation Script¶
- Log in to the Guance console
- Click on the 【Integration】 menu and select 【Cloud Account Management】
- Click on 【Add Cloud Account】, select 【AWS】, and fill in the required information on the interface. If the cloud account information has been configured before, ignore this step
- Click on 【Test】, and after a successful test, click on 【Save】. If the test fails, please check if the relevant configuration information is correct and retest
- Click on the 【Cloud Account Management】 list to see the added cloud account, click on the corresponding cloud account to enter the details page
- Click on the 【Integration】 button on the cloud account details page, find
AWS DynamoDB DAX
in theNot Installed
list, and click on the 【Install】 button to pop up the installation interface for installation.
Manual Activation Script¶
-
Log in to the Func console, click on 【Script Market】, enter the Guance script market, search for:
integration_aws_dynamodb_dax
-
Click on 【Install】, then enter the corresponding parameters: AWS AK ID, AK Secret, and account name.
-
Click on 【Deploy Startup Script】, the system will automatically create the
Startup
script set and automatically configure the corresponding startup script. -
After enabling, you can see the corresponding automatic trigger configuration in 「Management / Automatic Trigger Configuration」. Click on 【Execute】 to immediately execute once without waiting for the scheduled time. After a while, you can view the execution task records and corresponding logs.
Verification¶
- Confirm in 「Management / Automatic Trigger Configuration」 whether the corresponding task has the corresponding automatic trigger configuration, and you can also check the corresponding task records and logs for any exceptions
- In Guance, check if asset information exists in 「Infrastructure / Custom」
- In Guance, check if there is corresponding monitoring data in 「Metrics」
Metrics¶
After configuring Amazon CloudWatch, the default Measurement is as follows. More Metrics can be collected through configuration:
Amazon CloudWatch DynamoDB Accelerator (DAX) Metrics Details
Metric Name | Description | Unit | Valid Statistics |
---|---|---|---|
CPUUtilization |
The percentage of CPU utilization for a node or cluster. | Percent | Minimum Maximum Average |
CacheMemoryUtilization |
The percentage of available cache memory being used by the item cache and query cache on a node or cluster. Cache data starts to be evicted before memory utilization reaches 100% (see EvictedSize Metric). If CacheMemoryUtilization reaches 100% on any node, write requests will be throttled, and you should consider switching to a cluster with a larger node type. | Percent | Minimum Maximum Average |
NetworkBytesIn |
The number of bytes received on all network interfaces by a node or cluster. | Bytes | Minimum Maximum Average |
NetworkBytesOut |
The number of bytes sent on all network interfaces by a node or cluster. This Metric identifies outgoing traffic based on the number of packets on a single instance. | Bytes | Minimum Maximum Average |
NetworkPacketsIn |
The number of packets received on all network interfaces by a node or cluster. | Count | Minimum Maximum Average |
NetworkPacketsOut |
The number of packets sent on all network interfaces by a node or cluster. This Metric identifies outgoing traffic based on the number of packets on a single instance. | Count | Minimum Maximum Average |
GetItemRequestCount |
The number of GetItem requests processed by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
BatchGetItemRequestCount |
The number of BatchGetItem requests processed by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
BatchWriteItemRequestCount |
The number of BatchWriteItem requests processed by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
DeleteItemRequestCount |
The number of DeleteItem requests processed by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
PutItemRequestCount |
The number of PutItem requests processed by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
UpdateItemRequestCount |
The number of UpdateItem requests processed by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
TransactWriteItemsCount |
The number of TransactWriteItems requests processed by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
TransactGetItemsCount |
The number of TransactGetItems requests processed by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
ItemCacheHits |
The number of times items were returned from the cache by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
ItemCacheMisses |
The number of times items were not in the cache of a node or cluster and had to be retrieved from DynamoDB. | Count | Minimum Maximum Average SampleCount Sum |
QueryCacheHits |
The number of times query results were returned from the cache of a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
QueryCacheMisses |
The number of times query results were not in the cache of a node or cluster and had to be retrieved from DynamoDB. | Count | Minimum Maximum Average SampleCount Sum |
ScanCacheHits |
The number of times scan results were returned from the cache of a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
ScanCacheMisses |
The number of times scan results were not in the cache of a node or cluster and had to be retrieved from DynamoDB. | Count | Minimum Maximum Average SampleCount Sum |
TotalRequestCount |
The total number of requests processed by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
ErrorRequestCount |
The total number of requests that resulted in a user error reported by a node or cluster. Includes requests that were throttled by the node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
ThrottledRequestCount |
The total number of requests that were throttled by a node or cluster. Does not include requests throttled by DynamoDB, which can be monitored using DynamoDB Metrics. | Count | Minimum Maximum Average SampleCount Sum |
FaultRequestCount |
The total number of requests that resulted in an internal error reported by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
FailedRequestCount |
The total number of requests that resulted in an error reported by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
QueryRequestCount |
The number of query requests processed by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
ScanRequestCount |
The number of scan requests processed by a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
ClientConnections |
The number of simultaneous client connections established with a node or cluster. | Count | Minimum Maximum Average SampleCount Sum |
EstimatedDbSize |
The approximate amount of data cached in the item cache and query cache of a node or cluster. | Bytes | Minimum Maximum Average |
EvictedSize |
The amount of data evicted by a node or cluster to make room for new requested data. If error rates are rising and you see this Metric also increasing, it may mean your working set has increased. You should consider switching to a cluster with a larger node type. | Bytes | Minimum Maximum Average Sum |
Object¶
The collected AWS DynamoDB object data structure can be seen in 「Infrastructure - Custom」
{
"measurement": "aws_dynamodb_dax",
"tags": {
"RegionId" : "cn-north-1",
"ClusterArn" : "arn:aws-cn:dynamodb:cn-north-1:",
"NodeType" : "0ce8d4f9b35",
"ClusterName" : "eks-tflock",
"IamRoleArn" : "ACTIVE",
"Status" : "ACTIVE"
},
"fields": {
"Description" : "[{\"AttributeName\": \"LockID\", \"AttributeType\": \"S\"}]",
"TotalNodes" : "1",
"ActiveNodes" : "1",
"NodeType" : "1",
"PreferredMaintenanceWindow" : "[{\"AttributeName\": \"LockID\", \"KeyType\": \"HASH\"}]",
"message" : "{instance json info}"
}
}
Note: The fields in
tags
andfields
may change with subsequent updates