Clean backport of #16959 from 8.x to 8.17
----
Reimplements `LogStash::Setting::String` Ruby setting class into the `org.logstash.settings.SettingString` and exposes it through `java_import` as `LogStash::Setting::SettingString`.
Updates the rspec tests in two ways:
- logging mock is now converted to real Log4J appender that spy log line that are later verified
- verifies `java.lang.IllegalArgumentException` instead of `ArgumentError` is thrown because the kind of exception thrown by Java code, during verification.
* Fixed the rename of NullableString to SettingNullableString
* Fixed runner test to use real spy logger from Java Settings instead of mock test double
(cherry picked from commit
|
||
---|---|---|
.. | ||
ci | ||
lib | ||
modules | ||
qa/integration | ||
spec | ||
src/test/java/org/logstash/xpack/test | ||
build.gradle | ||
CHANGELOG.md | ||
gradle.properties | ||
README.md | ||
settings.gradle |
Elastic License Functionality
This directory tree contains files subject to the Elastic License. The files subject to the Elastic License are grouped in this directory to clearly separate them from files licensed under the Apache License 2.0.
Logstash X-Pack
Set of plugins that form Logstash X-Pack features.
Setup
Logstash X-Pack features are a default part of Logstash; as X-Pack features provide integrations with the rest of the Elastic Stack, they will need to be configured to point to an Elasticsearch instance in order to work.
Opting Out of X-Pack
If you are unable or unwilling to run the Elastic-Licensed X-Pack Features and Functions, OSS-only distributions are available from the downloads page; to run Logstash from source without X-Pack, ensure that your environment variable OSS
is exported with a value of true
:
export OSS=true
Configuration
To configure x-pack settings, you can edit config/logstash.yml and add xpack.*
configs from the logstash x-pack settings.
Building documentation
This repo contains information that is used in the Logstash Reference.
To build the Logstash Reference on your local machine, use the docbldls or docbldlsx build commands defined in https://github.com/elastic/docs/blob/master/doc_build_aliases.sh