cookbook 'cloudwatch-logs', '~> 0.0.7'
cloudwatch-logs (4) Versions 0.0.7 Follow3
Installs and configures AWS CloudWatch Logs
cookbook 'cloudwatch-logs', '~> 0.0.7', :supermarket
knife supermarket install cloudwatch-logs
knife supermarket download cloudwatch-logs
Description
Installs the CloudWatch Logs client and enables easy configuration of multiple
logs via attributes.
Supported OS
Currently all linux OS's are supported.
On Amazon Linux the yum package will be used.
Usage
Logs are configured by appending to the ['cwlogs']['logfiles'] attribute from
any recipe. You can configure as many logs as needed. Simply include the
default cwlogs recipe in your runlist after all recipes which define a log.
If you do not want each chef run to risk pulling in the latest cloudwatch
installer from AWS, then you can set the following attribute to false:
['cwlogs']['attempt_upgrade'] = false
Example
default['cwlogs']['logfiles']['mysite-httpd_access'] = { :log_stream_name => '{instance_id}-{hostname}', :log_group_name => 'mysite-httpd_access-group', :file => '/var/log/httpd/mysite.com/access_log', :datetime_format => '%d/%b/%Y:%H:%M:%S %z', :initial_position => 'end_of_file' } default['cwlogs']['logfiles']['mysite-httpd_error'] = { :log_stream_name => '{instance_id}-{hostname}', :log_group_name => 'mysite-httpd_error-group', :file => '/var/log/httpd/mysite.com/error_log', :datetime_format => '%d/%b/%Y:%H:%M:%S %z', :initial_position => 'end_of_file' } default['cwlogs']['logfiles']['mysite-mod_security_log'] = { :log_stream_name => '{instance_id}-{hostname}', :log_group_name => 'mysite-mod_security_log', :file => '/var/log/modsec_audit.log', :datetime_format => '[%d/%b/%Y:%H:%M:%S %z]', :multi_line_start_pattern => '^--([0-9a-fA-F]*){8}-[A]{1}--', :initial_position => 'end_of_file' }
From any attributes file will generate the following CloudWatch Logs config:
[mysite-httpd_access]
log_stream_name = {instance_id}-{hostname}
log_group_name = mysite-httpd_access-group
file = /var/log/httpd/mysite.com/access_log
datetime_format = %d/%b/%Y:%H:%M:%S %z
initial_position = end_of_file
[mysite-httpd_error]
log_stream_name = {instance_id}-{hostname}
log_group_name = mysite-httpd_error-group
file = /var/log/httpd/mysite.com/error_log
datetime_format = %d/%b/%Y:%H:%M:%S %z
initial_position = end_of_file
[mysite-mod_security_log]
log_stream_name = {instance_id}-{hostname}
log_group_name = mysite-mod_security_log
file = /var/log/modsec_audit.log
datetime_format = [%d/%b/%Y:%H:%M:%S %z]
multi_line_start_pattern = ^--([0-9a-fA-F]*){8}-[A]{1}--
initial_position = end_of_file
All hash elements will pass through to the config file, so for example you can
use encoding or any other supported config element.
See the AWS CloudWatch Logs configuration reference for details.
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
0.0.7 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
0.0.7 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
0.0.7 failed this metric
FC064: Ensure issues_url is set in metadata: cloudwatch-logs/metadata.rb:1
FC065: Ensure source_url is set in metadata: cloudwatch-logs/metadata.rb:1
FC066: Ensure chef_version is set in metadata: cloudwatch-logs/metadata.rb:1
FC069: Ensure standardized license defined in metadata: cloudwatch-logs/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
0.0.7 passed this metric
Testing File Metric
0.0.7 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.0.7 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.0.7 failed this metric
0.0.7 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
0.0.7 failed this metric
FC064: Ensure issues_url is set in metadata: cloudwatch-logs/metadata.rb:1
FC065: Ensure source_url is set in metadata: cloudwatch-logs/metadata.rb:1
FC066: Ensure chef_version is set in metadata: cloudwatch-logs/metadata.rb:1
FC069: Ensure standardized license defined in metadata: cloudwatch-logs/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
0.0.7 passed this metric
Testing File Metric
0.0.7 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.0.7 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.0.7 failed this metric
FC065: Ensure source_url is set in metadata: cloudwatch-logs/metadata.rb:1
FC066: Ensure chef_version is set in metadata: cloudwatch-logs/metadata.rb:1
FC069: Ensure standardized license defined in metadata: cloudwatch-logs/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
0.0.7 passed this metric
Testing File Metric
0.0.7 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
0.0.7 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
0.0.7 failed this metric
0.0.7 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
