Commit graph

1406 commits

Author SHA1 Message Date
Karen Metts
3314f2fbdf
Doc: Rework PQ content (#13173)
Co-authored-by: Rob Bavey <rob.bavey@elastic.co>
2021-10-06 18:46:27 -04:00
Karen Metts
1299f336d9
Doc: Remove outdated info and folder (#13259) 2021-10-06 11:56:50 -04:00
Karen Metts
44ea102a7e
Doc: Add topic and expand info for in-memory queue (#13246)
Co-authored-by: Rob Bavey <rob.bavey@elastic.co>
2021-10-05 18:12:02 -04:00
Karen Metts
2d8abc4597
Doc: Add shared attribute for messaging ecs default info (#13083)
Co-authored-by: Ry Biesemeyer <yaauie@users.noreply.github.com>
2021-10-01 13:15:44 -04:00
Karen Metts
37e1db0c12
Doc: Add note and example for date math in conditionals (#13199)
Co-authored-by: Rob Bavey <rob.bavey@elastic.co>
2021-09-21 15:09:15 -04:00
Rob Bavey
642875d705
[Docs] Remove outdated roadmap content (#13233) 2021-09-16 13:00:11 -04:00
Logstash Machine
0ce03de17f
Release notes for 8.0.0-alpha2 (#13228)
Co-authored-by: Rob Bavey <rob.bavey@elastic.co>
Co-authored-by: lcawl <lcawley@elastic.co>
Co-authored-by: Karen Metts <35154725+karenzone@users.noreply.github.com>
2021-09-15 20:52:16 -04:00
Andrea Selva
d51afe54d5
Removed JAVA_HOME using only LS_JAVA_HOME (#13214)
Removes the usage of JAVA_HOME completely which is not anymore used for JDK path resolution.

Updated all the Logstash launching scripts to use only LS_JAVA_HOME as environment variable to
determine the JDK to use to launch Logstash. JAVA_HOME is abandoned for this job.
2021-09-15 09:29:07 +02:00
Andrea Selva
3ffdb99119
Deprecate JAVA_HOME preferring LS_JAVA_HOME (#13207)
Adds print of deprecation notices on stdout when Logstash is starting with JAVA_HOME instead of LS_JAVA_HOME
2021-09-08 11:06:53 +02:00
Andrea Selva
979ea21c5e
Introduce LS_JAVA_HOME environment variable (#13204)
This commit modifies the launch scripts to take care of the LS_JAVA_HOME giving precedence over the JAVA_HOME, which is still used it the first is not found.
2021-09-06 10:22:51 +02:00
Mat Schaffer
8073b0c35e
Add beta tag to pipeline viewer docs (#13167) 2021-09-06 10:31:31 +09:00
Rob Bavey
4707cbd94c
Bundler: freeze lockfile on run, and "normalize" platform on plugin changes (#13015)
This PR enables the upgrade of bundler to the latest version.

Prior to this PR, the ability to do so was blocked by bundler.setup in versions of bundler > `2.23` making runtime changes to `Gemfile.lock` (unless the lock file was `frozen`) based on the specific platform the application was being run on, overriding any platforms (including generic `java` platform) set during build time. This was in conflict with changes made in #12782, which prevented the logstash user writing to files in `/usr/share/logstash`.

This PR will freeze the lockfile when logstash is run, and unfreeze it when manipulating plugins (install, update, remove, install from offline pack) to allow new plugins to be added. While unfrozen, changes are also made to ensure that the platform list remains as the generic `java` platform, and not changed to the specific platform for the runtime JVM.

This PR also introduces a new runtime flag, `--enable-local-plugin-development`. This flag is intended for use by Logstash developers only, and enables a mode of operation where a Gemfile can be manipulated, eg

```
gem "logstash-integration-kafka", :path => '/users/developer/code/plugins/logstash-integration-kafka'
```

to facilitate quick and simple plugin testing.

This PR also sets the `silence_root_warning` flag to avoid bundler printing out alarming looking warning messages when `sudo` is used. This warning message was concerning for users - it would be printed out during normal operation of `bin/logstash-plugin install/update/remove` when run under `sudo`, which is the expected mode of operation when logstash is installed to run as a service via rpm/deb packages. 

This PR also updates the vagrant based integration tests to ensure that Logstash still runs after plugin update/install/remove operations, fixes up some regular expressions that would cause test failures, and removes some dead code from tests.

## Release notes

* Updated Bundler to latest version
* Ensured that `Gemfile.lock` are appropriately frozen
* Added new developer-only flag to facilitate local plugin development to allow unfrozen lockfile in a development environment
2021-08-17 09:35:30 -04:00
Karen Metts
771844c070
Doc: Move shared region tags for breaking changes to 8.0.0 content (#13131) 2021-08-16 19:14:22 -04:00
Karen Metts
b7416cad37
Doc: Add breaking changes to breaking changes page (#13130)
Adds breaking changes noted in 8.0.0-alpha1 release notes to breaking changes page
Updates [float] tags to [discrete]
2021-08-13 11:02:18 -04:00
Logstash Machine
c679de1542
Release notes draft for 8.0.0-alpha1 (#13098)
Co-authored-by: Jenkins CI <jenkins@logstash-ci-immutable-fedora-32-1626957762752525520.c.elastic-ci-prod.internal>
Co-authored-by: andsel <selva.andre@gmail.com>
Co-authored-by: Karen Metts <karen.metts@elastic.co>
2021-08-03 13:46:32 -04:00
Karen Metts
f0504588df
Doc: Enhance and expand DLQ docs (#12959)
Fixes: #12923
Related: #10493
2021-07-22 16:13:23 -04:00
Karen Metts
426e883f11
Doc:Fix typo and adjust keystore text (#12779) 2021-07-20 18:14:12 -04:00
Ry Biesemeyer
4056cb1b9a
doc: add pipeline.ecs_compatibility docs (#12421) 2021-07-20 14:59:34 -07:00
Ry Biesemeyer
68f3cf3d90
ecs_compatibility: revert breaking change; keep disabled as default for 8.0.0 (#13080)
As we close in on the availability of 8.0.0 alphas, we are reassessing which
breaking changes are _necessary_, and which are merely _desired_. And while
we would love to be in a world where ECS was on by default, and have put
substantial effort into designing an upgrade path that would be as simple as
possible, we have determined that the time may not be right to change the
default value out of under our users.

This change restores the default value for `pipeline.ecs_compatibility` to
`disabled`, ensuring pipelines will continue running in Logstash 8 as they have
in Logstash 7 without modification. We will still encourage our users to be
explicit about which behaviour they desire, and will revisit making ECS on by
default at a later date.
2021-07-20 14:45:36 -07:00
Karen Metts
3f38e2b83a
Doc: Add kafka schema registry setting to troubleshooting (#13073) 2021-07-14 12:40:09 -04:00
Karen Metts
a31a7a4736
Doc: Add geoip database API to node stats (#13019) 2021-06-24 08:37:56 -04:00
Ry Biesemeyer
1a4be956c4
ecs: on-by-default plus docs (#12830)
* noop: avoid declaring default value in config file

* docs: ecs compatibility from 7.x perspective

Co-authored-by: Karen Metts <karen.metts@elastic.co>

* ecs: on by default

We know that ECS version 8 will release along-side Logstash 8.0, but its scope
is still coming into focus. In this changeset, we change the default value
of `pipeline.ecs_compatibility` from `disabled` to `v1`, which is a
significantly closer approximation to what will eventually ship in Logstash
8.0.0.

* docs: ecs from 8.x perspective

Co-authored-by: Karen Metts <karen.metts@elastic.co>

Co-authored-by: Karen Metts <karen.metts@elastic.co>
2021-06-21 11:00:08 -07:00
Karen Metts
328fc9e7e6
Doc: Add tip for checking for existing field (#12899)
Co-authored-by: Sebastian <gentunian@users.noreply.github.com>
Co-authored-by: Karol Bucek <kares@users.noreply.github.com>
2021-06-15 13:33:09 -04:00
Karen Metts
f481386039
Doc: Remove unused tagged regions (#12976) 2021-06-09 19:51:07 -04:00
Andres Rodriguez
51b359b011
Add a template on how to create an issue when requesting to list a plugin in docs (#12944)
In the List a Plugin docs, we suggest users to create an issue to request we list community plugins. This commit improves that page by adding a template to create an issue.
2021-06-01 09:10:09 -04:00
Karen Metts
da3157c013
Doc: Expand definition and fix typo (#12936) 2021-05-26 15:03:22 -04:00
Karen Metts
3885b751cb
Doc: Update contributing steps and guidelines (#12879) 2021-05-10 19:09:22 -04:00
Karen Metts
ec6b05d65d
Doc: Keystore must be accessible to logstash user (#12775)
Updates docs to propagate change to other branches. The original was a direct commit to the 7.10 branch.
2021-04-30 17:41:58 -04:00
Karol Bucek
19afb54841
Docs: note on quoted field references (#12801)
see GH-5591

Co-authored-by: Karen Metts <35154725+karenzone@users.noreply.github.com>
2021-04-14 10:41:38 +02:00
Andres Rodriguez
2caea13672
[doc] Add example to cross-plugin-concepts (#12672)
Adds an example showing users how to use the environment variable to define multiple whitespace-delimited URIs
2021-04-13 10:34:18 -04:00
Roshan Poudel
5dcfea5308
Update logstash.asciidoc (#12730)
Change protocol from HTTP to HTTPS
2021-03-16 15:08:51 -04:00
Karen Metts
ddda11ba71
Doc: Add unix command for running basic pipeline (#12714)
Adds framework for showing both windows and unix examples.
Co-authored-by: Rob Bavey <rob.bavey@elastic.co>
2021-03-05 13:49:31 -05:00
Karen Metts
26a154b3df
Docs: Replace relative paths with docs-root attributes (#12719) 2021-03-05 11:42:51 -05:00
Megan Humphreys
af641a1662
Update getting-started-with-logstash.asciidoc (#12706)
Single quotations cause errors, should be double quotes for Windows
2021-03-02 15:20:58 -05:00
Inbar Shimshon
35c0f06943
Update keystore.asciidoc 2021-02-04 11:59:53 +02:00
kaisecheng
4f6d81ded7
remove CMS from jvm options in java 14 (#12638) 2021-02-03 12:16:28 +01:00
andsel
fd446c9b70 [Doc] added instruction on how to update and when an existing LS installation is update to LS 7.12+ and use JDK15
co-authored-by: karenzone@users.noreply.github.com
2021-02-02 00:12:31 -08:00
Karen Metts
49131d826d
Doc: Clarify minimum privileges for logstash_writer role (#12613)
Fixes: #12612
2021-01-28 12:19:48 -05:00
andsel
7ba8c75458 Introduction of conditional in jvm.options file (#12530)
- moved parsing of jvm.options file into Java code
- chnaged the parsing code to consider conditional notation to bind the applicability of certain JVM flags to specific JVM versions
- changed the launch scripts (.sh and .bat) to use the options string composition
- binded CMS flags to JVM specifications 8-14
2021-01-25 05:16:18 -08:00
kaisecheng
4bc9dad69c
Remove ruby execution engine (#12517)
* remove Logstash::Pipeline
* remove logstash/event, Logstash::SignalEvent
* remove Engine.Ruby on java side
* remove config pipeline.java_execution
Fixed: #11236
2020-12-15 10:41:27 +01:00
Ry Biesemeyer
0ff682040d
plugin: adds :validate => :field_reference (#12459)
* plugin: adds `:validate => :field_reference`

Provide plugins a way of validating that an input is a literal field-reference.

This is useful for input plugins that implement a `target` or other
non-interpolated directive, and allows these plugins to reject invalid
configuration before start-up instead of at run-time.

Plugins should not use this named validator directly, as doing so would cause
validation to fail with "Unknown validator" when the plugin is run on older
releases of Logstash. Instead, plugins should use the `validator_support`
adapter mixin that provides back-ports when necessary.

Co-authored-by: Karen Metts <35154725+karenzone@users.noreply.github.com>
2020-12-14 22:05:34 -08:00
Andres Rodriguez
6d9ff9c880
Change text to use Elastic Cloud (#12404)
Make use of the term 'Elastic Cloud' as this is the term being used to refer to the service we provide.
2020-11-30 15:55:35 -05:00
kaisecheng
7cccf7ddc8
[Doc] Remove field reference parser (#12478)
Fixed: #12355
2020-11-26 14:16:07 +01:00
andsel
7db4692044 [Doc] expanded the description of how to obtain the logger's names form Java and Ruby class names 2020-11-25 03:12:59 -08:00
kaisecheng
69451e5017
clean up field-reference-parser (#12466)
remove field-reference-parser for version 8
Fixed: #12355
2020-11-24 17:58:10 +01:00
Karen Metts
6bb2bd6044
Doc: Add bundled JDK info (#12369)
Document options and impacts of bundled JDK
2020-11-05 12:24:11 -05:00
kaisecheng
1723dc547c
Doc: wildcards in xpack.management.pipeline.id (#12396)
document wildcard support in pipeline IDs
#12370
2020-11-05 17:19:50 +01:00
Karen Metts
4b163a9e91
Doc:Restructure troubleshooting docs and add plugin tracing (#12270)
Restructures troubleshooting docs in preparation for expanding content.
Adds info for plugin tracing to help users track down plugins that might be causing problems.

Co-authored-by: João Duarte <jsvd@users.noreply.github.com>

Fixes: #12228
2020-11-02 15:48:39 -05:00
Karen Metts
d7a9dcd887
[Doc]Relocate logstash-to-cloud topic for increased visibility (#11884)
Moves Cloud info to Configuration section to make it more obvious and easier to find
Expands content for using cloud id and cloud auth outside of modules
Moves module-specific info into modules section
2020-10-30 13:49:56 -04:00
kaisecheng
55637c8aaf
document system indices api privilege (#12391)
* update privilege requirement
2020-10-28 17:15:04 +01:00