metadata.json

{
  "name": "cloudwatch_monitoring",
  "description": "cloudwatch_monitoring installs the Amazon CloudWatch Monitoring Scripts for Linux - custom metrics that reports memory, swap, and disk space utilization metrics.",
  "long_description": "cloudwatch_monitoring\n==========\n\nInstall Amazon AWS Cloud Watch Monitoring Scripts\n\nCloudwatch_monitoring: The Amazon CloudWatch Monitoring Scripts for Linux are sample Perl scripts that\ndemonstrate how to produce and consume Amazon CloudWatch custom metrics.\n\nThe scripts comprise a fully functional example that reports memory, swap, and disk space utilization metrics\nfor an Amazon Elastic Compute Cloud (Amazon EC2) Linux instance.\n\n\nhttp://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/mon-scripts-perl.html\n\n\nRequirements\n==========\n\n## Platform:\n\n* Ubuntu/Debian\n\n\nAttributes\n==========\n\n\n* `node[:cw_mon][:user]` - the user to run the script as. Created if necessary. Defaults to `cw_monitoring`.\n* `node[:cw_mon][:group]` - the group the files should belong to. Defaults to `cw_monitoring`.\n* `node[:cw_mon][:home_dir]` - the directory to install the scripts in. Defaults to  `/home/#{node[:cw_mon][:user]}`\n* `node[:cw_mon][:version]`  - the version of the scripts to install. Defaults to `1.1.0`\n* `node[:cw_mon][:release_url]` - the URL to download from. Defaults to `http://ec2-downloads.s3.amazonaws.com/cloudwatch-samples/CloudWatchMonitoringScripts-v1.1.0.zip`\n* `node[:cw_mon][:aws_users_databag]` - the encrypted databag containing the AWS key. See section below for details. Defaults to `aws_users`\n* `node[:cw_mon][:access_key_id]`     - the AWS access key id the script should authenticate with. See section below for details.\n* `node[:cw_mon][:secret_access_key]` - the AWS access key the script should authenticate with. See section below for details.\n* `node[:cw_mon][:options]` - the list of options to pass to the script. By default, all options are included:\n            `--disk-space-util  --disk-path=/ --disk-space-used --disk-space-avail`\n             `--swap-util --swap-used --mem-util --mem-used --mem-avail`\n\n\nUsage\n=====\n\nPut `recipe[cloudwatch_monitoring]` in a run list, or `include_recipe 'cloud_watch_monitoring'` to ensure that\nthe CloudWatch script is installed and cron'ed on your systems.\n\n## AWS authentication\n\n### with IAM role (recommended)\n\nIf your instance has an IAM role, then the script will use it to and you don't have to worry about setting keys.\n\nMake sure that the role has permissions to perform the Amazon CloudWatch `PutMetricData` operation.\n\n\n### with a key\n\nIf your instance does not have a role, you need to specify a key. This can be done in 2 ways:\n\n1. 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`\n2. using the node attributes: `node[:cw_mon][:secret_access_key]` and `node[:cw_mon][:secret_access_key]`\n\nIf the key get be loaded from the databag, the node attributes will be used.\n\nMake sure that the user associated to the key has permissions to perform the Amazon CloudWatch `PutMetricData` operation.\n\n\n\nChanges\n=======\n\n## v1.0.0:\n\nLicense and Author\n==================\n\nAuthor:: Alexis Midon <alexismidon@gmail.com>\n\nCopyright 2013, Alexis Midon\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\n",
  "maintainer": "Alexis Midon",
  "maintainer_email": "alexismidon@gmail.com",
  "license": "Apache 2.0",
  "platforms": {
    "ubuntu": ">= 0.0.0",
    "debian": ">= 0.0.0",
    "redhat": ">= 0.0.0",
    "centos": ">= 0.0.0"
  },
  "dependencies": {
      "cron": ">= 0.0.0"
  },
  "recommendations": {
  },
  "suggestions": {
  },
  "conflicting": {
  },
  "providing": {
  },
  "replacing": {
  },
  "attributes": {
  },
  "groupings": {
  },
  "recipes": {
  },
  "version": "1.1.1"
}