Skip to content

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

  1. Log in to the Guance console.
  2. Click on the 【Integration】 menu and select 【Cloud Account Management】.
  3. 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.
  4. Click 【Test】, and after a successful test, click 【Save】. If the test fails, check whether the related configuration information is correct and retest.
  5. In the 【Cloud Account Management】 list, you can see the added cloud accounts. Click the corresponding cloud account and go to the details page.
  6. Click the 【Integration】 button on the cloud account details page. Under the Not Installed list, find AWS DynamoDB DAX, click the 【Install】 button, and follow the prompts to complete the installation.

Manual Enablement Script

  1. Log in to the Func console, click 【Script Market】, enter the official script market, and search for guance_aws_dynamodb_dax.
  2. After clicking 【Install】, input the corresponding parameters: AWS AK ID, AK Secret, and account name.
  3. Click 【Deploy Startup Script】, and the system will automatically create a Startup Measurement set and automatically configure the corresponding startup script.
  4. 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

  1. 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.
  2. In Guance, under 「Infrastructure / Custom」, check if there is any asset information.
  3. 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 and fields may change with subsequent updates.

Feedback

Is this page helpful? ×