Version information
This version is compatible with:
- , , , ,
Start using this module
Add this module to your Puppetfile:
mod 'MasterRoot24-cloudwatch', '0.1.1'
Learn more about managing modules with a PuppetfileDocumentation
cloudwatch
Table of Contents
- Description
- Setup - The basics of getting started with cloudwatch
- Usage - Configuration options and additional functionality
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Description
Installs AWS Cloudwatch Monitoring Scripts and sets up a cron entry to push monitoring information to Cloudwatch every minute.
More info on the monitoring scripts can be found here.
Setup
What cloudwatch affects
Creates a crontab entry in order to routinely push metrics to Cloudwatch. This cron job defaults to being run as the user running Puppet or root.
The Cloudwatch montitoring scripts that this module installs are dependent on the following packages and they will be installed automatically:
- RHEL/CentOS/Fedora:
perl-Switch
perl-DateTime
perl-Sys-Syslog
perl-LWP-Protocol-https
perl-Digest-SHA
unzip
- Amazon Linux:
perl-Switch
perl-DateTime
perl-Sys-Syslog
perl-LWP-Protocol-https
unzip
- Debian/Ubuntu:
libwww-perl
libdatetime-perl
unzip
Setup Requirements
Once this module has been installed and your manifest has been applied to your Puppet nodes, Cloudwatch metrics will be pushed every minute. You must setup AWS IAM credentials on your instances or assign an IAM role to your instances that has access to push data to Cloudwatch. More info on this can be found here.
Beginning with cloudwatch
Usage
- Install the module:
sudo puppet module install masterroot24-cloudwatch
- Include the module in your manifests:
node 'my-node.example.com' { include cloudwatch }
Limitations
Tested on CentOS 7, Debian 7, Debian 8, Ubuntu 12.04, Ubuntu 14.04 and Amazon Linux 2015.03. Tested with Puppet 4.x and 3.x.
Development
Please feel free to file an issue on the GitHub repo or create a PR if there's something here that you'd like to fix. I'll try to fix issues as and when they arise as soon as I can.
Release Notes/Contributors/Etc.
See the CHANGELOG.
Dependencies
- puppetlabs-stdlib (>= 1.0.0)
- camptocamp-archive (0.8.x)
The MIT License (MIT) Copyright (c) 2016 Joe Nyland Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.