diff --git a/README.md b/README.md index e99dd3b..6dc5dda 100644 --- a/README.md +++ b/README.md @@ -95,7 +95,7 @@ If you want to override the default configuration, add the *LS_HEAP_SIZE* enviro ```yml logstash: - image: logstash:latest + build: logstash/ command: logstash -f /etc/logstash/conf.d/logstash.conf volumes: - ./logstash/config:/etc/logstash/conf.d @@ -107,6 +107,13 @@ logstash: - LS_HEAP_SIZE=2048m ``` +## How can I add Logstash plugins? ## + +To add plugins to logstash you have to: + +1. Add a RUN statement to the `logstash/Dockerfile` (ex. `RUN logstash-plugin install logstash-filter-json`) +2. Add the associated plugin code configuration to the `logstash/config/logstash.conf` file + ## How can I enable a remote JMX connection to Logstash? As for the Java heap memory, another environment variable allows to specify JAVA_OPTS used by Logstash. You'll need to specify the appropriate options to enable JMX and map the JMX port on the docker host. @@ -115,7 +122,7 @@ Update the container in the `docker-compose.yml` to add the *LS_JAVA_OPTS* envir ```yml logstash: - image: logstash:latest + build: logstash/ command: logstash -f /etc/logstash/conf.d/logstash.conf volumes: - ./logstash/config:/etc/logstash/conf.d diff --git a/docker-compose.yml b/docker-compose.yml index 863a109..72237bb 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -4,8 +4,9 @@ elasticsearch: ports: - "9200:9200" - "9300:9300" + logstash: - image: logstash:latest + build: logstash/ command: logstash -f /etc/logstash/conf.d/logstash.conf volumes: - ./logstash/config:/etc/logstash/conf.d diff --git a/logstash/Dockerfile b/logstash/Dockerfile new file mode 100644 index 0000000..10d3bdb --- /dev/null +++ b/logstash/Dockerfile @@ -0,0 +1,4 @@ +FROM logstash:latest + +# Add your logstash plugins setup here +# Example: RUN logstash-plugin install logstash-filter-json \ No newline at end of file diff --git a/logstash/config/logstash.conf b/logstash/config/logstash.conf index 5718b33..10e442e 100644 --- a/logstash/config/logstash.conf +++ b/logstash/config/logstash.conf @@ -4,7 +4,7 @@ input { } } -## Add your filters here +## Add your filters / logstash plugins configuration here output { elasticsearch {