AWS DynamoDB DAX¶
The displayed Metrics for AWS DynamoDB DAX include CPU usage of nodes or clusters, the number of bytes received or sent on all network interfaces, the number of packets, etc. These Metrics reflect the operational status of DynamoDB DAX.
Configuration¶
Install Func¶
It is recommended to enable Guance integration - extension - DataFlux Func (Automata): all prerequisites will be automatically installed. Please continue with script installation.
If you deploy Func manually, refer to Manual Deployment of Func
Installation 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
)
Script for Enabling Managed Version¶
- Log in to the Guance console.
- Click on the 【Integration】 menu and select 【Cloud Account Management】.
- Click 【Add Cloud Account】, choose 【AWS】, and fill in the required information on the interface. If you have already configured cloud account information before, skip this step.
- Click 【Test】, and after a successful test, click 【Save】. If the test fails, check whether the related configuration information is correct and retest.
- In the 【Cloud Account Management】 list, you can see the added cloud accounts. Click the corresponding cloud account and go to the details page.
- Click the 【Integration】 button on the cloud account details page. Under the
Not Installed
list, findAWS DynamoDB DAX
, click the 【Install】 button, and follow the prompts to complete the installation.
Manual Enablement Script¶
- Log in to the Func console, click 【Script Market】, enter the official script market, and search for
guance_aws_dynamodb_dax
. - After clicking 【Install】, input the corresponding parameters: AWS AK ID, AK Secret, and account name.
- Click 【Deploy Startup Script】, and the system will automatically create a
Startup
Measurement set and automatically configure the corresponding startup script. - After enabling, you can see the corresponding automatic trigger configuration in 「Manage / Auto Trigger Configuration」. Click 【Execute】 to immediately execute once without waiting for the scheduled time. Wait a moment, and you can view the execution task records and corresponding logs.
Verification¶
- In 「Manage / Auto Trigger Configuration」, confirm whether the corresponding tasks have the corresponding automatic trigger configurations. You can also view the corresponding task records and logs to check for any anomalies.
- In Guance, under 「Infrastructure / Custom」, check if there is any asset information.
- In Guance, under 「Metrics」, check if there are corresponding monitoring data.
Metrics¶
After configuring Amazon Cloud Monitoring, the default Measurement sets are as follows. You can collect more Metrics through configuration:
Amazon Cloud Monitoring DynamoDB Accelerator (DAX) Metrics Details
Metric Name | Description | Unit | Valid Statistics |
---|---|---|---|
CPUUtilization |
Percentage of CPU usage for nodes or clusters. | Percent | Minimum Maximum Average |
CacheMemoryUtilization |
Percentage of available cache memory used by item caching and query caching on nodes or clusters. Cache data begins 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 larger node types. | Percent | Minimum Maximum Average |
NetworkBytesIn |
Number of bytes received by nodes or clusters on all network interfaces. | Bytes | Minimum Maximum Average |
NetworkBytesOut |
Number of bytes sent by nodes or clusters on all network interfaces. This Metric identifies outbound traffic based on packet counts on individual instances. | Bytes | Minimum Maximum Average |
NetworkPacketsIn |
Number of packets received by nodes or clusters on all network interfaces. | Count | Minimum Maximum Average |
NetworkPacketsOut |
Number of packets sent by nodes or clusters on all network interfaces. This Metric identifies outbound traffic based on packet counts on individual instances. | Count | Minimum Maximum Average |
GetItemRequestCount |
Number of GetItem requests processed by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
BatchGetItemRequestCount |
Number of BatchGetItem requests processed by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
BatchWriteItemRequestCount |
Number of BatchWriteItem requests processed by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
DeleteItemRequestCount |
Number of DeleteItem requests processed by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
PutItemRequestCount |
Number of PutItem requests processed by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
UpdateItemRequestCount |
Number of UpdateItem requests processed by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
TransactWriteItemsCount |
Number of TransactWriteItems requests processed by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
TransactGetItemsCount |
Number of TransactGetItems requests processed by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
ItemCacheHits |
Number of times items were returned from the cache by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
ItemCacheMisses |
Number of times items were not found in the cache of nodes or clusters and had to be retrieved from DynamoDB. | Count | Minimum Maximum Average SampleCount Sum |
QueryCacheHits |
Number of times query results were returned from the cache of nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
QueryCacheMisses |
Number of times query results were not found in the cache of nodes or clusters and had to be retrieved from DynamoDB. | Count | Minimum Maximum Average SampleCount Sum |
ScanCacheHits |
Number of times scan results were returned from the cache of nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
ScanCacheMisses |
Number of times scan results were not found in the cache of nodes or clusters and had to be retrieved from DynamoDB. | Count | Minimum Maximum Average SampleCount Sum |
TotalRequestCount |
Total number of requests processed by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
ErrorRequestCount |
Total number of requests leading to user errors reported by nodes or clusters. Includes requests throttled by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
ThrottledRequestCount |
Total number of requests throttled by nodes or clusters. Does not include requests throttled by DynamoDB, which can be monitored using DynamoDB Metrics. | Count | Minimum Maximum Average SampleCount Sum |
FaultRequestCount |
Total number of requests leading to internal errors reported by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
FailedRequestCount |
Total number of requests leading to errors reported by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
QueryRequestCount |
Number of query requests processed by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
ScanRequestCount |
Number of scan requests processed by nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
ClientConnections |
Number of simultaneous connections established between clients and nodes or clusters. | Count | Minimum Maximum Average SampleCount Sum |
EstimatedDbSize |
Approximate amount of data cached in item cache and query cache per node or cluster. | Bytes | Minimum Maximum Average |
EvictedSize |
Amount of data evicted by nodes or clusters to make space for new requested data. If error rates rise and you observe this Metric growing, it may indicate your working set has increased. You should consider switching to a cluster with larger node types. | Bytes | Minimum Maximum Average Sum |
Objects¶
The structure of AWS DynamoDB objects collected can be viewed under 「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 information}"
}
}
Note: Fields in
tags
andfields
may change with subsequent updates.