Spotdog

Spotdog is a command line tool to send EC2 Spot Instance Pricing History to Datadog. Spotdog enables us to monitor pricing history on Datadog.

Ruby 2.x

See spotdog-heroku for details.

Add this line to your application's Gemfile:

gem 'spotdog'

And then execute:

$ bundle

Or install it yourself as:

$ gem install spotdog

You need to set AWS credentials and Datadog API key as environment variables.

export AWS_ACCESS_KEY_ID=XXXXXXXXXXXXXXXXXXXX
export AWS_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
export AWS_DEFAULT_REGION=xx-yyyy-0

export DATADOG_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

$ spotdog help
Commands:
  spotdog help [COMMAND]  # Describe available commands or one specific command
  spotdog history         # Send spot instance price history
  spotdog requests        # Send spot instance requests

spotdog history sends spot instance price history during the specified range.

$ spotdog help history
Usage:
  spotdog history

Options:
  i, [--instance-types=INSTANCE_TYPES]              # List of instance types
  m, [--max-results=N]                              # Number of results
  p, [--product-descriptions=PRODUCT_DESCRIPTIONS]  # List of product descriptions
  s, [--start-time=START_TIME]                      # The time which to start retriving the prices
  e, [--end-time=END_TIME]                          # The time which to stop retriving the prices
  l, [--last-minutes=N]                             # The duration in minutes which to retrive the prices

• -i, --instance-type
• List of instance types, like m4.large,c4.xlarge.
• -m, --max-results
• Number of results
• -p, --product-descriptions
• List of product descriptions, like linux_vpc,suse_vpc. These values are allowed: linux_vpc, linux_classic, suse_vpc, suse_classic, windows_vpc and windows_classic.
• -s, --start-time
• The time which to start retriving the prices, like 2015-10-06 18:00 JST
• -e, --end-time
• The time which to stop retriving the prices, like 2015-10-06 19:00 JST
• -l, --last-minutes
• The duration in minutes which to retrive the prices.

spotdog requests sends the number of spot instance requests per status (open, active, failed, closed, canceled).

$ spotdog help requests
Usage:
  spotdog requests

After checking out the repo, run bin/setup to install dependencies. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/dtan4/spotdog. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.