cookbook 'loggly_rsyslog_ng', '= 4.1.0'
loggly_rsyslog_ng (6) Versions 4.1.0 Follow0
LWRP for configuring rsyslog to send data to Loggly
cookbook 'loggly_rsyslog_ng', '= 4.1.0', :supermarket
knife supermarket install loggly_rsyslog_ng
knife supermarket download loggly_rsyslog_ng
Loggly rsyslog LWRP
Provide LWRP for configuring rsyslog for use with Loggly. This cookbook was built upon the work from an existing cookbook, https://github.com/kdaniels/loggly-rsyslog.
Requirements
- Chef 11 or higher
- Ruby 2.0.0 or higher
Platform
Tested against Debian 7
Usage
loggly_rsyslog_ng '/etc/rsyslog.d/22-loggly.conf' do
loggly_token 'my_very_secret_token'
tags [ node.chef_environment ]
end
Resources
default
tags
- A list of event tags to apply to a message (https://www.loggly.com/docs/tags/) (optional)log_files
- A list of files rsyslog should monitor. (optional). Below is an example
of a hash used to describe a file to monitor.
{
:filename => "/var/log/filename.log",
:tag => "tag you want for this logfile",
:statefile => "unique-name-for-statefile",
:facility => 'local5' # Optional
}
```
* `log_dirs` - A list of directories to monitor (optional). The loggly configuration template will create an [imfile](http://www.rsyslog.com/doc/imfile.html) block for each file ending in '.log' in that directory. Each logdir in the list is of the format:
```
{
:directory => "/var/log/directory",
:tag => "tag for all files in this directory",
:facility => 'local5' # Optional
}
```
* `tls_enabled` - Set to true if communication to the remote service should use TLS (defaults to true)
* `tls_path` - Directory where the loggly certificate should be placed
* `tls_name` - File where the loggly certificate should be placed
* `loggly_value` - The Loggly token. Set from the Data Bag above by default.
* `conf` - Name of the loggly rsyslog confiugration file (defaults to /etc/rsyslog.d/10-loggly.conf)
* `host` - Name of the remote loggly syslog host (defaults to logs-01.loggly.com)
* `port` - Port of the remote loggly syslog host (defaults to 514 and if TLS is enabled to 6514)
* `input_file_poll_interval` - Specifies how often files are to be polled for new data (defaults to 10)
### tls
* `tls_cert_url` - Url to the loggly.com certificate
* `tls_intermediate_cert_url` - Url to the intermediate certificate
* `tls_cert_checksum` - Cchecksum of the loggly.com certificate
* `tls_intermediate_cert_checksum` - Checksum of the intermediate certificate
License & Authors
-----------------
- Author: Matt Veitas
- Author: Kostiantyn Lysenko
```text
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
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
Dependent cookbooks
apt ~> 2.0 |
rsyslog ~> 1.13.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
loggly_rsyslog_ng Cookbook CHANGELOG
This file is used to list changes made in each version of the loggly_rsyslog_ng cookbook.
v4.1.0
- Add: optional facility opgion go log_file and log_dir hashes.
v4.0.0
- Modify: rewrite the cookbook as LWRP
v3.0.0
- Modify: fork cookbook from loggly-rsyslog cookbook
- Modify: cookbook name, from loggly-rsyslog to loggly_rsyslog_ng to avoid name collisions
- Fix: checksum for loggly SSL certificate
v2.0.0
- Use an encrypted databag to retrieve the loggly token instead of a node attribute
v1.0.1
- Set rsyslog configuration values to be configurable via attributes
v1.0.0 (1/25/2014)
- Initial cookbook version
- Support for sending messages using TLS
- Configuration for monitoring a list of files
- Configuration for monitoring a list of directories
Foodcritic Metric
4.1.0 passed this metric
4.1.0 passed this metric