This repository provides CloudFormation templates to quickly set up CloudWatch Metrics for Amazon Keyspaces. Using this template will allow you to get started more easily by providing deployable prebuilt CloudWatch dashboards with commonly observed metrics.
Amazon Keyspaces is a scalable, highly available, and managed Apache Cassandra–compatible database service. Amazon Keyspaces is serverless, so you pay for only the resources you use. The service can automatically scale tables up and down in response to application traffic. There are no nodes, instances, or servers to manage. There are also no Cassandra background processes to maintain such as compaction and repair. The service is designed to provide consistent low latencies at any scale.
You can monitor Amazon Keyspaces using CloudWatch, which collects raw data and processes it into readable, near real-time metrics. These statistics are kept for 15 months, so that you can access historical information and gain a better perspective on how your web application or service is performing. To read more see the Official Keyspaces Documentation
Following is an example of CloudWatch view of
AWS CloudFormation provides a common language for you to model and provision AWS and third-party application resources in your cloud environment. AWS CloudFormation allows you to use programming languages or a simple text file to model and provision, in an automated and secure manner, all the resources needed for your applications across all regions and accounts. This gives you a single source of truth for your AWS and third-party resources.
You can use AWS CloudFormation to create and manage settings for Amazon Keyspaces resources based on templates. The templates enable you to specify the name of keyspaces and tables. You can also specify the schema, read/write mode, and provisioned throughput settings for tables.
For more information, see the Cassandra Resource Type Reference in the AWS CloudFormation User Guide.
- Clone this repository or download the template file.
- Navigate to CloudFormation Home and Click Create Stack
- Import the CloudFormation Template
- Enter the parameters and go!
The CloudFormation Templates contained in this repository will continue to evolve over time. Follow this repo and check often for new and improved templates. If there are visualizations you would like to see or contribute please open a new issue and file a pull request.
keyspaces-table-cw.yaml This cloud formation template will setup a new cloud watch dashboard containing metrics for an Amazon Keyspaces' table of your choice. You must provide a valid keypspace name, table name and region. In seconds you will have a new dashboard in CloudWatch containing metrics for the provided table.
Some of the table metrics include
- Consumed and Provisioned Capacity per second
- Number of CQL Request per second
- Average Latency per Second
- User errors
- System Errors
- Current Account Quotas
keyspaces-keyspace-cw.yaml This cloud formation template will setup a new cloud watch dashboard containing metrics for an Amazon Keyspaces' keyspace. You must provide a valid keypsace name and region. When finished, you will have a new dashboard in CloudWatch containing metrics for the provided keyspace. This is an aggregate view of all tables in a keyspace. The graphs rely on CloudWatch Search Expressions and Dynamic Labels to aggregate data. For a more detailed view of an individual table see the keyspaces-table-cw.yaml template.
Some of the keyspace metrics include the following metrics.
- Consumed Capacity per second
- Number of CQL Request per second
- Average Latency per Second
- User errors
- System Errors
- Current Account Quotas
In this example we create a new CloudWatch dashboard containing metrics for an Amazon Keyspaces table. The following code snippet uses the AWS CLI to execute CloudFormation template from this GitHub repository. The script will pipe the contents of keyspaces-table-cw.yaml into an environment variable which we then pass into the --template-body parameter. Stack name and CloudWatch dashboard will be generated for you, but you must provide the following parameters for the below script to work.
In the script below, replace the following parameters with your table information
keyspace_nameThe name of your table's keyspacetable_nameThe name of your tableregion_nameThe name of the region where your table resides
#!/bin/bash
git clone https://github.com/aws-samples/amazon-keyspaces-cloudwatch-cloudformation-templates.git
cd amazon-keyspaces-cloudwatch-cloudformation-templates
#your table info here
export keyspace_name=my_keyspace
export table_name=my_table
export region_name=us-east-1
export mytemplate=$(cat keyspaces-table-cw.yaml)
export dashboard_name="keyspaces-$( echo ${keyspace_name}--${table_name}-$$ | tr '_' '-' )"
export stack_name="cw-${dashboard_name}"
aws cloudformation create-stack --stack-name "${stack_name}" --parameters ParameterKey=CloudwatchDashBoardNameParameter,ParameterValue=${dashboard_name} ParameterKey=CassandraKeyspaceParameter,ParameterValue=${keyspace_name} ParameterKey=CassandraTableParameter,ParameterValue=${table_name} ParameterKey=CassandraRegion,ParameterValue=${region_name} --template-body $mytemplate
This repository provides a Docker image for common tooling for Amazon Keyspaces. Keyspaces for functional testing, light operations, and data migration. The toolkit is optimized for Amazon Keyspaces, but will also work with Apache Cassandra clusters. https://github.com/aws-samples/amazon-keyspaces-toolkit
This repository contains driver policies, examples, and best practices when using the DataStax Java Driver with Amazon Keyspaces (for Apache Cassandra) https://github.com/aws-samples/amazon-keyspaces-java-driver-helpers
See CONTRIBUTING for more information.
This library is licensed under the MIT-0 License. See the LICENSE file.