will/aws-missing-tools
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

initial commit from code.google.com

Browse Source
This commit is contained in:
Colin Johnson
2012-06-17 22:46:53 +00:00
commit 52dcc5c58e
24 changed files with 1764 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
rds-apply-alarms/README.txt Normal file
View File

@@ -0,0 +1,29 @@
# Introduction:
rds-apply-alarms was created to easily apply alarms to anywhere from one to a number of Amazon RDS instances. The tool applies alarms for CPU Utilization, Feeable Memory, Swap Usage and Free Storage Space. rds-apply-alarms will run "out of the box", however the intent is rather to provide a template (and the logic) for managing multiple RDS instance's alarms.
# Directions For Use:
#
## Example of Use:
#
rds-apply-alarms -d rds-instance-name -t name-of-sns-topic
-
the above example would apply alarms to "rds-instance-name" and, if any of these Alarms enter state "Alarm" would send a message to "name-of-topic."
#
## Required Parameters:
#
rds-apply-alarms requires the following two arguments:
-d <rds-instance-name> - the name of the Database Instance for which you wish to apply alarms.
-t <name-of-topic> - the name of the sns-topic where Alarms should be sent.
#
## Optional Parameters:
#
-a - pass the -a parameter to apply alarms to ALL RDS instances in a given region.
-r <region> - region that contains the RDS instances(s) where alarms should be applied
-e <evaluation period> - set to the number of evaluation periods before an SNS topic is notified.
-p <previewmode> - set to "true" to preview what alarms would be applied.
#
# Additional Information:
#
Author: Colin Johnson / colin@cloudavail.com
Date: 2012-03-07
Version 0.5
License Type: GNU GENERAL PUBLIC LICENSE, Version 3

115
rds-apply-alarms/rds-apply-alarms.sh Executable file
View File

@@ -0,0 +1,115 @@
#!/bin/bash -
# Author: Colin Johnson / colin@cloudavail.com
# Date: 2011-10-30
# Version 0.1
# License Type: GNU GENERAL PUBLIC LICENSE, Version 3
#
#rds-alarm-apply start
#confirms that executables required for succesful script execution are available
prerequisitecheck()
{
for prerequisite in basename cut grep mon-put-metric-alarm rds-describe-db-instances
do
#use of "hash" chosen as it is a shell builtin and will add programs to hash table, possibly speeding execution. Use of type also considered - open to suggestions.
hash $prerequisite &> /dev/null
if [[ $? == 1 ]] #has exits with exit status of 70, executable was not found
then echo "In order to use `basename $0`, the executable \"$prerequisite\" must be installed." 1>&2 ; exit 70
fi
done
}
#calls prerequisitecheck function to ensure that all executables required for script execution are available
prerequisitecheck
region="us-east-1"
#handles options processing
while getopts :d:r:t:p:e:a opt
do
case $opt in
d) dbname="$OPTARG";;
r) region="$OPTARG";;
t) topicname="$OPTARG";;
e) evaluationperiod="$OPTARG";;
p) previewmode="$OPTARG";;
a) allrds="true";;
*) echo "Error with Options Input. Cause of failure is most likely that an unsupported parameter was passed or a parameter was passed without a corresponding option." 1>&2 ; exit 64;;
esac
done
#sets previewmode - will echo commands rather than performing work
case $previewmode in
true|True) previewmode="echo"; echo "Preview Mode is set to \"True.\"" 1>&2 ;;
""|false|False) previewmode="";;
*) echo "You specified \"$previewmode\" for Preview Mode. If specifying a Preview Mode you must specificy either \"true\" or \"false.\"" 1>&2 ; exit 64;;
esac
# evaluationperiod validator - must be a number between 1 and 99
case $evaluationperiod in
"") evaluationperiod=1;;
[1-99]) ;;
*) echo "You specified \"$evaluationperiod\" for your evaluation period. If specifying an evalaution period you must specify a period between 1 and 99." 1>&2 ; exit 64;;
esac
# region validator
case $region in
us-east-1|us-west-2|us-west-1|eu-west-1|ap-southeast-1|ap-northeast-1|sa-east-1) ;;
*) echo "The \"$region\" region does not exist. You must specify a valid region (example: -r us-east-1 or -r us-west-2)." 1>&2 ; exit 64;;
esac
# single RDS instance validator - runs if applying to only one instance
if [[ $allrds != "true" ]]
then
if [[ $dbname == "" ]]
then echo "You did not specify an RDS instance. You must select an RDS instance to apply alarms to." 1>&2 ; exit 64
fi
if [[ `rds-describe-db-instances $dbname --region $region 2> /dev/null` =~ .*DBINSTANCE.*$dbame ]]
then echo "RDS instance $dbname has been found."
else echo "The RDS instance \"$dbname\" does not exist. You must specify a valid RDS instance." 1>&2 ; exit 64
fi
fi
# multiple RDS instance validator - runs if applying to all instances
if [[ $allrds == "true" ]]
then
if [[ $dbname != "" ]]
then
echo "You specified both \"All\" RDS instances and \"$dbname\" to apply alarms to. You must specify either one particular RDS instance (-d <dbname>) or all RDS instances (-a)." 1>&2 ; exit 64
else
echo "Alarms will be applied to all RDS instances."
fi
fi
rdsinstancelist=`rds-describe-db-instances $dbname --region $region --show-long | grep -i DBINSTANCE | cut -d ',' -f2`
for rdsinstancename in $rdsinstancelist
do
echo "Applying Alarms to RDS instance $rdsinstancename."
#start of apply-alarms
rdsinstancetype=`rds-describe-db-instances $rdsinstancename --region $region --show-long | cut -d ',' -f4`
rdstorage=`rds-describe-db-instances $rdsinstancename --region $region --show-long | cut -d ',' -f6`
#given rds instance type, determines what 5% of freeable memory is
case $rdsinstancetype in
db.m1.small) lowfreeablememory=0.85E8;; #1.7 GB memory
db.m1.large) lowfreeablememory=3.75E8;; #7.5 GB memory
db.m1.xlarge) lowfreeablememory=7.5E8;; #15 GB memory
db.m2.xlarge) lowfreeablememory=8.55E8;; #17.1 GB memory
db.m2.2xlarge) lowfreeablememory=17.0E8;; #34 GB memory
db.m2.4xlarge) lowfreeablememory=34.0E8;; #68 GB memory
*) echo "An error has occured when attempting to set low memory threshold. Please contact the author of rds-apply-alarms." 1>&2 ; exit 64;;
esac
#determines the low storage alert - at less than 10% of rdsstorage
lowstorage="${rdstorage}.0E8"
$previewmode mon-put-metric-alarm --alarm-name $rdsinstancename-RDS-CPUUtilization-Critical --metric-name CPUUtilization --namespace AWS/RDS --statistic Average --period 300 --threshold 90 --comparison-operator GreaterThanThreshold --dimensions DBInstanceIdentifier=$rdsinstancename --evaluation-periods $evaluationperiod --unit Percent --alarm-actions $topicname --region $region
$previewmode mon-put-metric-alarm --alarm-name $rdsinstancename-RDS-FreeableMemory-Critical --metric-name FreeableMemory --namespace AWS/RDS --statistic Average --period 300 --threshold $lowfreeablememory --comparison-operator LessThanThreshold --dimensions DBInstanceIdentifier=$rdsinstancename --evaluation-periods $evaluationperiod --unit Bytes --alarm-actions $topicname --region $region
$previewmode mon-put-metric-alarm --alarm-name $rdsinstancename-RDS-SwapUsage-Critical --metric-name SwapUsage --namespace AWS/RDS --statistic Maximum --period 300 --threshold 1048576 --comparison-operator GreaterThanThreshold --dimensions DBInstanceIdentifier=$rdsinstancename --evaluation-periods $evaluationperiod --unit Bytes --alarm-actions $topicname --region $region
$previewmode mon-put-metric-alarm --alarm-name $rdsinstancename-RDS-FreeStorageSpace-Critical --metric-name FreeStorageSpace --namespace AWS/RDS --statistic Minimum --period 300 --threshold $lowstorage --comparison-operator LessThanThreshold --dimensions DBInstanceIdentifier=$rdsinstancename --evaluation-periods $evaluationperiod --unit Bytes --alarm-actions $topicname --region $region
done