cookbook 'logentries', '= 0.1.2'
logentries (2) Versions 0.1.2 Follow1
Installs and manages Logentries.
cookbook 'logentries', '= 0.1.2', :supermarket
knife supermarket install logentries
knife supermarket download logentries
chef-logentries
Description
Installs the Logentries Agent, and provides definitions to manage registering servers and following logs.
Requirements
Supported Platforms
The following platforms are supported by this cookbook, meaning that the recipes run on these platforms without error:
- Ubuntu
Recipes
-
logentries
- Set up the apt repository and install the logentries package
Usage
This cookbook installs the Logentries Agent package from the Logentries apt repository.
Additionally this cookbook provides a logentries
definition which you can use to register hosts, follow logs, and execute other le
based commands.
# register a server logentries do account_key 'abcdefgh-ijkl-mnop-qrst-uvwxyz123456' server_name 'appserver' action :register end # follow a log (if it hasn't already been logged) logentries '/var/log/syslog' do log_name 'Syslog' action :follow end
You can use logentries from a json node config too by specifying a logentries element in your config with an account_key
, server_name
, and optionally some log_files
.
{ "logentries": { "account_key": "abcdefgh-ijkl-mnop-qrst-uvwxyz123456", "server_name": "My Server", "log_files": { "App Server": "/var/www/myapp/log/production.log", "Syslog": "/var/log/syslog" } } }
Notes
Logentries is split into two packages, logentries
and logentries-daemon
, the former contains the command-line tools and the latter is the reporting agent. Unfortunately, when you install the logentries-daemon
package it immediately tries to start the agent and will fail if you haven't pre-configured your host settings; this is problematic in a Chef script, because we haven't had an opportunity to set things up yet.
To solve this problem, the commandline tools are installed immediately, then the logentries-daemon
package will only be installed at the end of your chef run; it will be triggered by the use of any of the logentries
definitions.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
License
chef-logentries
- Freely distributable and licensed under the MIT license.
- Copyright (c) 2012 James Gregory (james@jagregory.com)
- http://www.jagregory.com
- @jagregory
Dependent cookbooks
apt >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.