cookbook 'simple-logstash', '= 1.0.0'
simple-logstash (16) Versions 1.0.0 Follow2
Installs/Configures simple-logstash. No less. No more.
cookbook 'simple-logstash', '= 1.0.0', :supermarket
knife supermarket install simple-logstash
knife supermarket download simple-logstash
Description
This cookbook installs only logstash and provides few typical configurations.
It doesn't install or depends on java, apache, nginx, elasticsearch, kibana, etc...
It also skips lumberjack.
Usage
Default recipe only creates user/group and arks logstash.
You are free to do anything with installation.
Also cookbook provides HWRPs for managing services and configs of logstash.
You can define multiple services and configs.
HWRP
logstash_config
Generic HWRP for managing logstashs' configs. It also creates parent directory for your config.
You better want to use its child classes.
Actions
- create - default, creates new config
- delete - deletes config
Attributes
-
user - sets owner of the config file. Defaults to
logstash
-
group - sets group of config file. Defaults to
logstash
-
prefix_conf - sets prefix configuration dir. Defaults to
/etc
-
service - sets logstash service name config belongs to. Defaults to
logstash
-
config_dir - sets logstash config dir with pipelines. Defaults to
conf.d
-
config_name - sets logstash config name. Defaults to
<name>.conf
-
template_source - sets config template to use. Defaults to
logstash/<name>.conf.erb
-
template_mode - sets mode on the config file. Defaults to
0640
-
template_variables - set variables for the config template. Defaults to
{}
logstash_input
This resource based on logstash_config. It has the same actions and attributes.
But it has some different default values:
-
config_name - Defaults to
/etc/<service>/10_input_<name>.conf
-
template_source - Defaults to
logstash/input/<name>.conf.erb
logstash_filter
This resource based on logstash_config. It has the same actions and attributes.
But it has some different default values:
-
config_name - Defaults to
/etc/<service>/20_filter_<name>.conf
-
template_source - Defaults to
logstash/filter/<name>.conf.erb
logstash_output
This resource based on logstash_config. It has the same actions and attributes.
But it has some different default values:
-
config_name - Defaults to
/etc/<service>/90_output_<name>.conf
-
template_source - Defaults to
logstash/output/<name>.conf.erb
logstash_service
Defines logstash service. Currentl supported implementations:
- systemd
- runit
Cookbook tries to use systemd, but fallbacks to the runit.
Consider:
- [Systemd Implementation](libraries/logstash_service_systemd.rb)
- [Runit Implementation](libraries/logstash_service_runit.rb)
Example
You can visit fixture cookbook [simple-logstash-test](test/fixtures/cookbooks/simple-logstash-test)
Requirements
Platform:
- debian (>= 8.0)
- ubuntu (>= 16.0)
- centos (>= 7.0)
Cookbooks:
- ark
- runit
Attributes
-
node['logstash']['download_url']
- Defaults tohttps://artifacts.elastic.co/downloads/logstash/logstash-6.2.3.tar.gz
. -
node['logstash']['checksum']
- Defaults to0c326917ce035543e44042e95042d2e6f80f5b9119f514dbe275b236b964cbe7
. -
node['logstash']['version']
- Defaults to6.2.3
. -
node['logstash']['user']
- Defaults tologstash
. -
node['logstash']['group']
- Defaults tologstash
. -
node['logstash']['prefix_root']
- Defaults to/opt
.
Recipes
- simple-logstash::default - Installs/Configures simple-logstash. No less. No more.
License and Maintainer
Maintainer:: Yauhen Artsiukhou (jsirex@gmail.com)
Source:: https://github.com/jsirex/simple-logstash-cookbook
Issues:: https://github.com/jsirex/simple-logstash-cookbook/issues
License:: Apache-2.0
Dependent cookbooks
ark >= 0.0.0 |
runit >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
1.0.0 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.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 https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
1.0.0 passed this metric
No Binaries Metric
1.0.0 passed this metric
Testing File Metric
1.0.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 https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 passed this metric
1.0.0 failed this metric
1.0.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 https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
1.0.0 passed this metric
No Binaries Metric
1.0.0 passed this metric
Testing File Metric
1.0.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 https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 passed this metric
1.0.0 passed this metric
1.0.0 passed this metric
Testing File Metric
1.0.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 https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 passed this metric
1.0.0 failed this metric
1.0.0 passed this metric