Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status


cloudwatch_monitoring (4) Versions 1.1.1

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.1.1', :supermarket
cookbook 'cloudwatch_monitoring', '= 1.1.1'
knife supermarket install cloudwatch_monitoring
knife supermarket download cloudwatch_monitoring
Quality -%


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.



  • Ubuntu/Debian
  • RHEL


  • node[:cw_mon][:user] - the user to run the script as. Created if necessary. Defaults to cw_monitoring.
  • node[:cw_mon][:group] - the group the files should belong to. Defaults to cw_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 to 1.1.0
  • node[:cw_mon][:release_url] - the URL to download from. Defaults to
  • node[:cw_mon][:aws_users_databag] - the encrypted databag containing the AWS key. See section below for details. Defaults to aws_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


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

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:

  1. using the encrypted data bad specified by node[:cw_mon][:aws_users_databag]. That bag must contain an item for node[:cw_mon][:user] with 2 attributes: access_key_id and secret_access_key
  2. using the node attributes: node[:cw_mon][:secret_access_key] and node[: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

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

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
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.

No quality metric results found