cookbook 'cloudwatch-logs', '= 0.0.6'
cloudwatch-logs (4) Versions 0.0.6 Follow3
Installs and configures AWS CloudWatch Logs
cookbook 'cloudwatch-logs', '= 0.0.6', :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.6 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Foodcritic Metric
0.0.6 failed this metric
FC048: Prefer Mixlib::ShellOut: /tmp/80f47d94cffd5130507b3bd9/cloudwatch-logs/recipes/installer.rb:30
FC064: Ensure issues_url is set in metadata: /tmp/80f47d94cffd5130507b3bd9/cloudwatch-logs/metadata.rb:1
FC065: Ensure source_url is set in metadata: /tmp/80f47d94cffd5130507b3bd9/cloudwatch-logs/metadata.rb:1
0.0.6 failed this metric
0.0.6 failed this metric
FC048: Prefer Mixlib::ShellOut: /tmp/80f47d94cffd5130507b3bd9/cloudwatch-logs/recipes/installer.rb:30
FC064: Ensure issues_url is set in metadata: /tmp/80f47d94cffd5130507b3bd9/cloudwatch-logs/metadata.rb:1
FC065: Ensure source_url is set in metadata: /tmp/80f47d94cffd5130507b3bd9/cloudwatch-logs/metadata.rb:1
