IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Contributing a Java Plugin
editContributing a Java Plugin
editThis functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
Now you can write your own Java plugin for use with Logstash. We have provided instructions and GitHub examples to give you a head start.
Native support for Java plugins in Logstash consists of several components including:
- Extensions to the Java execution engine to support running Java plugins in Logstash pipelines
-
APIs for developing Java plugins.
The APIs are in the
co.elastic.logstash.api.v0
package. A Java plugin might break if it references classes or specific concrete implementations of API interfaces outside that package. The implementation of classes outside of the API package may change at any time. - Coming in a future release: Tooling to automate the packaging and deployment of Java plugins in Logstash. (Currently, this process is manual.)
Process overview
editHere are the steps:
- Choose the type of plugin you want to create: input, filter, or output.
- Set up your environment.
- Code the plugin.
- Package and deploy the plugin.
- Run Logstash with your new plugin.
Let’s get started
editHere are the example repos:
Here are the instructions: