https://github.com/chassis/chassis_logstash
A Chassis extension to install and configure Elastic Logstash
https://github.com/chassis/chassis_logstash
Last synced: 2 days ago
JSON representation
A Chassis extension to install and configure Elastic Logstash
- Host: GitHub
- URL: https://github.com/chassis/chassis_logstash
- Owner: Chassis
- Created: 2020-04-11T07:04:29.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2020-06-07T04:50:38.000Z (about 6 years ago)
- Last Synced: 2025-01-04T19:28:17.463Z (over 1 year ago)
- Language: Puppet
- Size: 16.6 KB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Logstash
A Chassis extension to install and configure [Logstash](https://www.elastic.co/logstash) on your Chassis server.
## Activation
Ensure you have a Chassis instance set up locally already.
```
# In your Chassis dir:
git clone --recursive https://github.com/Chassis/chassis_logstash.git extensions/chassis_logstash
```
Then you'll need to reprovision
```
cd ..
vagrant provision
```
Alternatively you can add the extension to one of your yaml config files. e.g.
```
# Extensions
#
# Install a list of extensions automatically
extensions:
- chassis/chassis_logstash
```
Then you'll need to reprovision
```
cd ..
vagrant provision
```
Logstash has now been installed inside your Chassis box.
## Configuration
Chassis Logstash provides some default options you can override from your
config file(s).
```yaml
logstash:
repo_version: '5.x'
version: '5.5.3'
# You may want to increase the memory limit here if you are indexing images & files.
# Note you may also need to increase the memory limits for the VM and PHP also.
# Value is in Megabytes.
memory: 256
# You can override the default JVM options here as an array. For more information
# see the docs at https://www.elastic.co/guide/en/elasticsearch/reference/master/jvm-options.html
jvm_options:
# Alternative way to configure the memory heap size settings at a more granular level.
- '-Xms256m'
- '-Xmx256m'
```
### A note on memory usage
If you do increase the memory available to Elasticsearch you should generally ensure the VM itself has double that amount of memory to ensure all extensions and services run smoothly.
The below example gives Elasticsearch 1Gig of memory and increases the VM memory to 2Gig.
```yaml
logstash:
memory: 1024
virtualbox:
memory: 2048
```