History

Colin Johnson 76444ca1f9 formating changes for README.md files.		2012-12-09 17:01:16 +00:00
..
ec2cc-mysql	using decimal instead of float for mysql cost table.	2012-08-13 22:46:16 +00:00
Resources	removing file ec2cc - IAM User Required Permissions.txt	2012-11-12 04:20:47 +00:00
ec2-cost-calculate.rb	fix of summarization of ASG cost - resolve errors if ASG name is same in different region, also more clear reporting if instances are not part of an Auto Scaling Group.	2012-08-04 18:11:08 +00:00
README.md	formating changes for README.md files.	2012-12-09 17:01:16 +00:00

README.md

Introduction:

ec2-cost-calculate.rb was created to easily sum the total of instances running in one or all regions. The typical use would be to run the ec2-cost-calculate.rb script and then import into a spreadsheet application for further analysis. Another use would be to run the ec2-cost-calculate.rb script with cron, producing a weekly output file (an example of this: echo "0 0 * * 0 ec2-user /home/ec2-user/ec2-cost-calculate.rb --period day --region all --output file --file /home/ec2-user/ec2-cost-reportdate +"%Y%m%d".txt" > /etc/cron.d/ec2-cost-calculate).

Directions For Use:

Example of Use:

ec2-cost-calculate.rb --period day

the above example would provide a list of all instances in all regions along with the daily cost of running each instance.

Required Parameters:

ec2-cost-calculate.rb has no parameter requirements. ec2-cost-calculate.rb defaults to all regions and hourly cost if no parameters are provided.

Optional Parameters:

optional parameters are available by running ec2-cost-calculate.rb --help.

Running with IAM Credentials

the file "ec2cc - IAM User Required Permissions.json" contains the permissions required to run ec2-cost-calculate.rb in with the "Least Permissions" required as of 2012-11-11.

Additional Information:

Author: Colin Johnson / colin@cloudavail.com
Date: 2012-12-09
Version 0.2
License Type: GNU GENERAL PUBLIC LICENSE, Version 3