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

RSS

papertrail (3) Versions 1.0.1

Installs/Configures Papertrail's remote_syslog2

Policyfile
Berkshelf
Knife
cookbook 'papertrail', '= 1.0.1', :supermarket
cookbook 'papertrail', '= 1.0.1'
knife supermarket install papertrail
knife supermarket download papertrail
README
Dependencies
Changelog
Quality 43%

Papertrail Cookbook

This cookbook configures the Papertrail remote_syslog2 agent. If you want to configure rsyslog for use with Papertrail, check out the documentation on the Papertrail website.

Supported Platforms

  • RHEL 6 / CentOS 6
  • RHEL 7 / CentOS 7
  • Amazon Linux 2017.03
  • Ubuntu 14.04
  • Ubuntu 16.04
  • Debian 9

Usage

Quickstart

  1. Set the attributes node['papertrail']['destination_host'], node['papertrail']['destination_port'], nd at least one file/directory in node['papertrail']['files'].
  2. Include papertrail in your node's run_list:
{
  "run_list": [
    "recipe[papertrail]"
  ]
}

This will install remote_syslog2 with the configured settings you set in the Chef node attributes.

Recipes & their attributes

This cookbook only has one recipe, which does all setup and configuration. There are a number of attributes you can configure, all of which mirror the configuration items found in the remote_syslog2 README.

  • node['papertrail']['files']

Type: Array

A list of files or patterns to send to Papertrail. At least one entry is required.

Example:
ruby
node['papertrail']['files'] = [
'/tmp/test.log',
'/srv/foo.txt',
'/var/log/*.bar'
]

If you want to tag a file/path, the structure is slightly different:
ruby
node['papertrail']['files'] = [
'/tmp/test.log',
'/srv/foo.txt',
{'path' => '/srv/foo.txt', 'tag' => 'my_tag'}
]

  • node['papertrail']['exclude_files']

Type: Array

A list of files or patterns to exclude.

Example:
ruby
node['papertrail']['exclude_files'] = [
'/tmp/exlude.log',
'/srv/dont-include.log',
'/var/log/skip-me.log'
]

  • node['papertrail']['exclude_patterns']

Type: Array

A regex of log message patterns to exclude.

Example:
ruby
node['papertrail']['exclude_patterns'] = ['\d+ things']

- node['papertrail']['hostname']

Type: String

Override the default hostname.

Example:
ruby
node['papertrail']['hostname'] = 'my-super-awesome-hostname'

  • node['papertrail']['destination_host'], node['papertrail']['destination_port'], & node['papertrail']['destination_protocol']

Type: String

The Papertrail host, port, and protocol for sending your logs to. These are required. Destination and port default to empty, while Protocol defaults to tls.

Example:
ruby
node['papertrail']['destination_host'] = 'YOUR-HOST-HERE'
node['papertrail']['destination_port'] = 'YOUR-PORT-HERE'
node['papertrail']['destination_protocol'] = 'tls'

  • node['papertrail']['new_file_check_interval']

Type: Integer

Overrides the default file check interval.

Example:
ruby
node['papertrail']['new_file_check_interval'] = 30

  • node['papertrail']['version']

Type: String

Use a different version of remote_syslog than the default. The default is specified in map.jinja.

Example:
ruby
node['papertrail']['version'] = '0.18'

Testing

See [TESTING.md](TESTING.md)

Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md)

License and Authors

License: See [LICENSE](LICENSE.md)

Author: Mike Julian (@mjulian)

Dependent cookbooks

yum >= 0.0.0
yum-epel >= 0.0.0
apt >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

1.0.0

Initial release of chef-papertrail

Collaborator Number Metric
            

1.0.1 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

1.0.1 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
            

1.0.1 passed this metric

License Metric
            

1.0.1 passed this metric

No Binaries Metric
            

1.0.1 passed this metric

Testing File Metric
            

1.0.1 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
            

1.0.1 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