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


papertrail-rsyslog (3) Versions 1.2.0

Installs/Configures rsyslog streaming into Papertrail

cookbook 'papertrail-rsyslog', '~> 1.2.0', :supermarket
cookbook 'papertrail-rsyslog', '~> 1.2.0'
knife supermarket install papertrail-rsyslog
knife supermarket download papertrail-rsyslog
Quality 57%

Description Build Status

A simple cookbook for setting up a server to stream logs into Papertrail via a secure
TCP connection.


Built to run on systems with Rsyslog installed. Tested on Ubuntu 12.04


['papertrail']['port'] = The Papertrail log destination port number (required)
['papertrail']['host'] = The Papertrail host address (defaults to logs)
['papertrail']['syslog_selector'] = The syslog tags and types to stream into Papertrail (defaults to "*.*")
['papertrail']['resume_retry_count'] = The number of times to retry the sending of failed messages (defaults to unlimited)
['papertrail']['queue_disk_space'] = The maximum disk space allowed for queues (default to 100M)
['papertrail']['enable_tls'] = Whether to encrypt all log traffic going into Papertrail (default to True)
['papertrail']['certificate_src'] = The URL of the certificate file on the Papertrail server
['papertrail']['certificate_checksum'] = The sha256 checksum for the Papertrail certificate file


First, make sure you set the ['papertrail']['port'] attribute in your Role/Environment,
to the destination port created in Papertrail. Then include the papertrail::default recipe
in you run list to start streaming all syslog entries to Papertrail.

Tailing log files

This functionality is currently not available, but will be provided via the Opscode Rsyslog cookbook
(included as a dependency), where there is an open pull request for it at the time of this writing.


Please refer to the Readme here

License and Author

Author:: Adam Borocz (on GitHub)
Maintainer:: Simon Detheridge (on GitHub)

Copyright:: 2013, HipSnip Ltd.
Copyright:: 2014, Symbols Worldwide Ltd.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

rsyslog ~> 1.12.1

Contingent cookbooks

There are no cookbooks that are contingent upon this one.



  • Update dependencies and bring tests back into working order
  • Update documentation and metadata to show change of maintainer


  • Fix for Papertrail logging endpoint

Collaborator Number Metric

1.2.0 passed this metric

Contributing File Metric

1.2.0 passed this metric

Foodcritic Metric

1.2.0 failed this metric

FC064: Ensure issues_url is set in metadata: papertrail-rsyslog/metadata.rb:1
FC065: Ensure source_url is set in metadata: papertrail-rsyslog/metadata.rb:1
FC066: Ensure chef_version is set in metadata: papertrail-rsyslog/metadata.rb:1
FC069: Ensure standardized license defined in metadata: papertrail-rsyslog/metadata.rb:1
FC072: Metadata should not contain "attribute" keyword: papertrail-rsyslog/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

1.2.0 failed this metric

Failure: Cookbook should not contain binaries. Found:

Supported Platforms Metric

1.2.0 passed this metric

Testing File Metric

1.2.0 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, and your repo must contain a file

Version Tag Metric

1.2.0 passed this metric