AWS DynamoDB is a great service, but it falls short when it comes to automated throughput scaling. This is where Dynamic DynamoDB enters the stage. It provides automatic read and write provisioning for DynamoDB.
All you need to do is to tell Dynamic DynamoDB at which point and how much you want to scale up or down your DynamoDB. An example is in place. Let’s say you have way more traffic on your database during sales hours 4pm - 10pm. DynamicDB can monitor the increased throughput on your DynamoDB instance (via CloudWatch) and provision more throughput as needed. When the load is reducing Dynamic DynamoDB will sence that and automatically reduce your provisioning.
See an example of how to configure Dynamic DynamoDB under Basic usage or checkout dynamic-dynamodb --help
.
- Scale up and down DynamoDB automatically
- Restrict scaling to certain time slots
- Monitor multiple DynamoDB tables at the same time
- Gives you control over how much reads and writes you want to scale up and down with
- Dynamic DynamoDB has support for max and min limits so that you always knows how much money you spend at most and how much capacity you can be guaranteed
- Support for circuit breaker API call. If your service is experiencing disturbances, Dynamic DynamoDB will not scale down your DynamoDB tables
This example will configure Dynamic DynamoDB to:
- Scale up your DynamoDB table when the consumed reads 90% of the total provisioned reads
- Scale up your DynamoDB table when the consumed writes 90% of the total provisioned writes
- Scale up your reads with 50%
- Scale up your writes with 40%
- Scale down your DynamoDB table when the consumed reads 30% of the total provisioned reads
- Scale down your DynamoDB table when the consumed writes 40% of the total provisioned writes
- Scale down your reads with 40%
- Scale down your writes with 70%
- Check for changes every 5 minutes
Command:
dynamic-dynamodb --table-name my-table \
--reads-upper-threshold 90 \
--reads-lower-threshold 30 \
--increase-reads-with 50 \
--decrease-reads-with 40 \
--writes-upper-threshold 90 \
--writes-lower-threshold 40 \
--increase-writes-with 40 \
--decrease-writes-with 70 \
--check-interval 300
Please note that using configuration files instead of command line options will give you even more control over the service.
The easiest way to install Dynamic DynamoDB is through PyPI:
pip install dynamic-dynamodb
[global]
# AWS access keys
#aws-access-key-id: AWS_ACCESS_KEY
#aws-secret-access-key-id: AWS_SECRET_KEY
# AWS region to use
region: us-east-1
# How often should Dynamic DynamoDB monitor changes (in seconds)
check-interval: 300
# Circuit breaker configuration
# No provisioning updates will be made unless this URL returns
# a HTTP 200 OK status code
#circuit-breaker-url: http://my.service.com/v1/is_up
#circuit-breaker-timeout: 500
[logging]
# Log level [debug|info|warning|error]
log-level: info
# Log file (comment out to get only console output)
log-file: /var/log/dynamic-dynamodb.log
[table: my_table]
#
# Read provisioning configuration
#
# Thresholds for scaling up or down the provisioning (%)
reads-upper-threshold: 90
reads-lower-threshold: 30
# How many percent should Dynamic DynamoDB increase/decrease provisioning with (%)
increase-reads-with: 50
decrease-reads-with: 50
# Units to increase or decrease reads with, must be either percent or units
increase-reads-unit: percent
decrease-reads-unit: percent
# Maximum and minimum read provisioning
# Dynamic DynamoDB will not provision any more or less reads than this
#min-provisioned-reads: 100
#max-provisioned-reads: 500
#
# Write provisioning configuration
#
# Thresholds for scaling up or down the provisioning (%)
writes-upper-threshold: 90
writes-lower-threshold: 30
# How many percent should Dynamic DynamoDB increase/decrease provisioning with (%)
increase-writes-with: 50
decrease-writes-with: 50
# Units to increase or decrease writes with, must be either percent or units
increase-writes-unit: percent
decrease-writes-unit: percent
# Maximum and minimum write provisioning
# Dynamic DynamoDB will not provision any more or less writes than this
#min-provisioned-writes: 100
#max-provisioned-writes: 500
#
# Maintenance windows (in UTC)
#
#maintenance-windows: 22:00-23:59,00:00-06:00
#
# Other settings
#
# Allow down scaling when at 0% consumed reads
#allow-scaling-down-reads-on-0-percent: true
#allow-scaling-down-writes-on-0-percent: true
# Restric scale down to only happend when BOTH reads AND writes are in need
# of scaling down. Set this to "true" to minimize down scaling.
#always-decrease-rw-together: true
usage: dynamic-dynamodb [-h] [-c CONFIG] [--dry-run]
[--check-interval CHECK_INTERVAL]
[--log-file LOG_FILE] [--log-level LOG_LEVEL]
[--version] [--aws-access-key-id AWS_ACCESS_KEY_ID]
[--aws-secret-access-key AWS_SECRET_ACCESS_KEY]
[--daemon DAEMON] [--instance INSTANCE] [-r REGION]
[-t TABLE_NAME]
[--reads-upper-threshold READS_UPPER_THRESHOLD]
[--reads-lower-threshold READS_LOWER_THRESHOLD]
[--increase-reads-with INCREASE_READS_WITH]
[--decrease-reads-with DECREASE_READS_WITH]
[--increase-reads-unit INCREASE_READS_UNIT]
[--decrease-reads-unit DECREASE_READS_UNIT]
[--min-provisioned-reads MIN_PROVISIONED_READS]
[--max-provisioned-reads MAX_PROVISIONED_READS]
[--writes-upper-threshold WRITES_UPPER_THRESHOLD]
[--writes-lower-threshold WRITES_LOWER_THRESHOLD]
[--increase-writes-with INCREASE_WRITES_WITH]
[--decrease-writes-with DECREASE_WRITES_WITH]
[--increase-writes-unit INCREASE_WRITES_UNIT]
[--decrease-writes-unit DECREASE_WRITES_UNIT]
[--min-provisioned-writes MIN_PROVISIONED_WRITES]
[--max-provisioned-writes MAX_PROVISIONED_WRITES]
Dynamic DynamoDB - Auto provisioning AWS DynamoDB
optional arguments:
-h, --help show this help message and exit
-c CONFIG, --config CONFIG
Read configuration from a configuration file
--dry-run Run without making any changes to your DynamoDB table
--check-interval CHECK_INTERVAL
How many seconds should we wait between the checks
(default: 300)
--log-file LOG_FILE Send output to the given log file
--log-level LOG_LEVEL
Log level to use (default: info)
--version Print current version number
--aws-access-key-id AWS_ACCESS_KEY_ID
Override Boto configuration with the following AWS
access key
--aws-secret-access-key AWS_SECRET_ACCESS_KEY
Override Boto configuration with the following AWS
secret key
Daemon options:
--daemon DAEMON Run Dynamic DynamoDB as a daemon [start|stop|restart]
--instance INSTANCE Name of the Dynamic DynamoDB instance. Used to run
multiple instances of Dynamic DynamoDB. Give each
instance a unique name and control them separately
with the --daemon flag. (default: default)
DynamoDB options:
-r REGION, --region REGION
AWS region to operate in (default: us-east-1
-t TABLE_NAME, --table-name TABLE_NAME
How many percent should we decrease the read units
with?
Read units scaling properties:
--reads-upper-threshold READS_UPPER_THRESHOLD
Scale up the reads with --increase-reads-with percent
if the currently consumed read units reaches this many
percent (default: 90)
--reads-lower-threshold READS_LOWER_THRESHOLD
Scale down the reads with --decrease-reads-with
percent if the currently consumed read units is as low
as this percentage (default: 30)
--increase-reads-with INCREASE_READS_WITH
How many percent should we increase the read units
with? (default: 50, max: 100)
--decrease-reads-with DECREASE_READS_WITH
How many percent should we decrease the read units
with? (default: 50)
--increase-reads-unit INCREASE_READS_UNIT
Do you want to scale in percent or units? (default:
percent)
--decrease-reads-unit DECREASE_READS_UNIT
Do you want to scale in percent or units? (default:
percent)
--min-provisioned-reads MIN_PROVISIONED_READS
Minimum number of provisioned reads
--max-provisioned-reads MAX_PROVISIONED_READS
Maximum number of provisioned reads
--increase-writes-unit INCREASE_WRITES_UNIT
Do you want to scale in percent or units? (default:
percent)
--decrease-writes-unit DECREASE_WRITES_UNIT
Do you want to scale in percent or units? (default:
percent)
Write units scaling properties:
--writes-upper-threshold WRITES_UPPER_THRESHOLD
Scale up the writes with --increase-writes-with
percent if the currently consumed write units reaches
this many percent (default: 90)
--writes-lower-threshold WRITES_LOWER_THRESHOLD
Scale down the writes with --decrease-writes-with
percent if the currently consumed write units is as
low as this percentage (default: 30)
--increase-writes-with INCREASE_WRITES_WITH
How many percent should we increase the write units
with? (default: 50, max: 100)
--decrease-writes-with DECREASE_WRITES_WITH
How many percent should we decrease the write units
with? (default: 50)
--min-provisioned-writes MIN_PROVISIONED_WRITES
Minimum number of provisioned writes
--max-provisioned-writes MAX_PROVISIONED_WRITES
Maximum number of provisioned writes
Please help me by providing feedback and bug reports. You can file bugs in the project's GitHub Issues page.
Provide as much details as possible to make bug fixing as swift as possible.
This project uses git-flow for handling branching and releasing in Git. See the following blog post for more details on how it works.
1.3.6 (2013-07-21)
1.3.5 (2013-06-17)
1.3.4 (2013-06-13)
1.3.3 (2013-06-08)
- Increasing to a minimum provisioned throughput value doesn't take into account the current table's throughput (#45)
- dynamic-dynamodb --version causes AttributeError in cli (#44)
1.3.2 (2013-05-14)
1.3.1 (2013-05-10)
1.3.0 (2013-05-01)
This Dynamic DynamoDB release makes it possible to use multiple Dynamic DynamoDB instances in parallel in daemon mode. Simply use the --instance
flag to separate the difference instances with a unique name. Then control them as usual with the --daemon
flag.
1.2.5 (2013-04-29)
1.2.4 (2013-04-26)
- Mix up between percent and units (#35)
- Broken build fixed
1.2.0 (2013-04-20)
1.1.0 (2013-04-17)
- Update provisioning in units not just percentage (#22)
- Increase in percent does not add to current provisioning properly (#33)
- Enhance configuration option validation (#32)
1.0.1 (2013-04-17)
- Minor fix: Ugly output removed
1.0.0 (2013-04-16)
The 1.0.0 release is a leap forward when it comes to module structure and extendability. Please remember that this is still released in beta in PyPI, so all bug reports are very welcome. File any odd behavior or bugs in GitHub Issues.
- Restructure the Dynamic DynamoDB code base (#30)
- Support multiple tables in one configuration file (#19)
- Change pid file name (#31)
- Handle combinations of configuration file and command line options better (#24)
0.5.0 (2013-04-12)
- Add --log-file command line option (#20)
- Allow scale down at 0% consumed count (#17)
- "only downscale reads AND writes" option would be useful (#23)
0.4.2 (2013-04-11)
- Unhandled exception: ValidationException (#28)
- Handle DynamoDB provisioning exceptions cleaner (#29)
0.4.1 (2013-04-10)
0.4.0 (2013-04-06)
- Support for daemonizing Dynamic DynamoDB (#11)
- Enhanced logging options (#4)
- Add --version flag to dynamic-dynamodb command (#18)
0.3.5 (2013-04-05)
- Handle missing table exceptions (#12)
- Bug fix: No upscaling happening when scaling limit is exceeded (#16)
0.3.4 (2013-04-05)
0.3.3 (2013-04-05)
0.3.2 (2013-04-05)
0.3.1 (2013-04-04)
0.3.0 (2013-03-27)
This release contains support for configuration files, custom AWS access keys and configurable maintenance windows. The maintenance feature will restrict Dynamic DynamoDB to change your provisioning only during specific time slots.
- Add support for configuration files (#6)
- Configure AWS credentials on command line (#5)
- Support for maintenance windows (#1)
0.2.0 (2013-03-24)
- First public release
0.1.1 (2013-03-24)
- Initial release
make release
This project is maintained by Sebastian Dahlgren (GitHub | Twitter | LinkedIn)
APACHE LICENSE 2.0 Copyright 2013 Sebastian Dahlgren
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.