cookbook 'cloudwatch_monitoring', '~> 1.2.0'
cloudwatch_monitoring (4) Versions 1.2.0 Follow4
cloudwatch_monitoring installs the Amazon CloudWatch Monitoring Scripts for Linux - custom metrics that reports memory, swap, and disk space utilization metrics.
cookbook 'cloudwatch_monitoring', '~> 1.2.0', :supermarket
knife supermarket install cloudwatch_monitoring
knife supermarket download cloudwatch_monitoring
cloudwatch_monitoring
Install Amazon AWS Cloud Watch Monitoring Scripts
Cloudwatch_monitoring: The Amazon CloudWatch Monitoring Scripts for Linux are sample Perl scripts that
demonstrate how to produce and consume Amazon CloudWatch custom metrics.
The scripts comprise a fully functional example that reports memory, swap, and disk space utilization metrics
for an Amazon Elastic Compute Cloud (Amazon EC2) Linux instance.
http://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/mon-scripts-perl.html
Requirements
Platform:
- Ubuntu/Debian
- RHEL
Attributes
-
node[:cw_mon][:user]
- the user to run the script as. Created if necessary. Defaults tocw_monitoring
. -
node[:cw_mon][:group]
- the group the files should belong to. Defaults tocw_monitoring
. -
node[:cw_mon][:home_dir]
- the directory to install the scripts in. Defaults to/home/#{node[:cw_mon][:user]}
-
node[:cw_mon][:version]
- the version of the scripts to install. Defaults to1.1.0
-
node[:cw_mon][:release_url]
- the URL to download from. Defaults tohttp://ec2-downloads.s3.amazonaws.com/cloudwatch-samples/CloudWatchMonitoringScripts-v1.1.0.zip
-
node[:cw_mon][:aws_users_databag]
- the encrypted databag containing the AWS key. See section below for details. Defaults toaws_users
-
node[:cw_mon][:access_key_id]
- the AWS access key id the script should authenticate with. See section below for details. -
node[:cw_mon][:secret_access_key]
- the AWS access key the script should authenticate with. See section below for details. -
node[:cw_mon][:options]
- the list of options to pass to the script. By default, all options are included:--disk-space-util --disk-path=/ --disk-space-used --disk-space-avail
--swap-util --swap-used --mem-util --mem-used --mem-avail
Usage
Put recipe[cloudwatch_monitoring]
in a run list, or include_recipe 'cloud_watch_monitoring'
to ensure that
the CloudWatch script is installed and cron'ed on your systems.
AWS authentication
with IAM role (recommended)
If your instance has an IAM role, then the script will use it to and you don't have to worry about setting keys.
Make sure that the role has permissions to perform the Amazon CloudWatch PutMetricData
operation.
with a key
If your instance does not have a role, you need to specify a key. This can be done in 2 ways:
- using the encrypted data bad specified by
node[:cw_mon][:aws_users_databag]
. That bag must contain an item fornode[:cw_mon][:user]
with 2 attributes:access_key_id
andsecret_access_key
- using the node attributes:
node[:cw_mon][:secret_access_key]
andnode[:cw_mon][:secret_access_key]
If the key get be loaded from the databag, the node attributes will be used.
Make sure that the user associated to the key has permissions to perform the Amazon CloudWatch PutMetricData
operation.
License and Author
Author:: Alexis Midon alexismidon@gmail.com
Copyright 2013, Alexis Midon
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
Dependent cookbooks
cron >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
1.2.0 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
1.2.0 failed this metric
Foodcritic Metric
1.2.0 failed this metric
FC064: Ensure issues_url is set in metadata: cloudwatch_monitoring/metadata.rb:1
FC065: Ensure source_url is set in metadata: cloudwatch_monitoring/metadata.rb:1
FC066: Ensure chef_version is set in metadata: cloudwatch_monitoring/metadata.rb:1
FC069: Ensure standardized license defined in metadata: cloudwatch_monitoring/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
1.2.0 failed this metric
FC065: Ensure source_url is set in metadata: cloudwatch_monitoring/metadata.rb:1
FC066: Ensure chef_version is set in metadata: cloudwatch_monitoring/metadata.rb:1
FC069: Ensure standardized license defined in metadata: cloudwatch_monitoring/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
1.2.0 passed this metric
1.2.0 passed this metric