Commit graph

9194 commits

Author SHA1 Message Date
renshuki
a22fb7cba0 Add the "Compile to JAR file" build command (#10810) 2020-01-07 19:27:00 -05:00
Lisa Cawley
90dc1cc359
[7.1][DOCS] Replaces occurrences of xpack-ref (#11374) 2019-12-03 10:09:46 -08:00
Karen Metts
e1d261047a Fix typo in doc-for-plugin
Fixes #11232
2019-10-17 16:05:04 +00:00
Karen Metts
1109b97293 Update reference to last 6.x version to be 6.8
Fixes #11200
2019-10-10 17:07:33 +00:00
Karen Metts
d79d8001f2 Add note about illegal reflective access
Fixes #11152
2019-09-19 20:56:55 +00:00
Karen Metts
d70daee99e
Update logstash to use shared version files (#11136) 2019-09-12 20:21:46 -04:00
Kuba Clark
eed26d9581 Fixed links in contributing-to-logstash page
Fixes #11126
2019-09-12 21:32:34 +00:00
Nik Everett
b418797cfb Docs: Fix formatting in table (#11016)
Fixes formatting in a table cell in `logstash-monitoring-overview.html`.
A `+` which was required by AsciiDoc was leaking into the output when
the doc is built with Asciidoctor.
2019-08-22 15:24:45 -04:00
Nik Everett
963d66de57 Docs: Fix backticks in how to docs (#11018)
In the "methods" sections of the how to develop a plugin docs
Asciidoctor as incorrectly passing backticks into the output when it
should have marked the words surrounded by backticks as code. I'm not
100% sure why it did that. The fix is to force macro evaluation
immediately on attribute assignment.
2019-08-21 09:17:59 -04:00
Aaron Mildenstein
b4e7f7ba59 Add missing "create" privilege to documentation
Users following our documentation are frustrated to discover that they get 403 errors from Logstash, even when following the instructions to the letter.  The problem is that the `create` privilege is missing. With this in place, it works as designed.

These changes may need to be back ported to previous branches, too.

Fixes #11013
2019-08-20 15:26:33 +00:00
Nik Everett
9c3aebc3c8 Docs: Add more missing subs for asciidoctor (#10991)
Adds a few missing `[attributes="subs"]` clauses for asciidoctor.
2019-07-24 15:16:13 -04:00
Karen Metts
9aea7163bd Fix formatting for nested version attributes
Fixes #10949
2019-07-12 23:56:21 +00:00
Rob Waight
1439a05fbd Document running Logstash on Windows (#10805)
* Create running-logstash-windows.asciidoc
Initial commit for #4005

* Update running-logstash-windows
1. Added section to validate JVM pre-requisites and shell sections for nssm, task scheduler, and PowerShell
2. Updated options to run Logstash on Windows, update section headers
3. Clarified JVM pre-requisites and included example to add environmental variables using SETX
4. Added example Logstash configuration, added steps for running Logstash manually with PowerShell
5. Removed `WIP` from the PowerShell section; updated the example to include output to Elasticsearch; Added notes for running Logstash as a service with NSSM
6. Removed `WIP` from the NSSM section; Added notes for running Logstash as a Scheduled Task; Added notes to stopping Logstash for each section; Removed `WIP` from the Scheduled Task section; Removed `WIP` from the page header
7. Updated initial section; moved the running manually section as the first configuration; added notes to the NSSM and Schedule Task sections.
8. Push headings down one level
9. Clarify this document contains examples for running Logstash on Windows.  Updated which NSSM file should be extracted for use.
10. Updated formatting for the example Logstash configuration
11. Update formatting for the command examples
12. Update the instructions in the Task Scheduler section
13. Update the instructions in the run Logstash manually section, the NSSM section, and update formatting
14. Update formatting
15. Add note regarding support for running multiple pipelines
16. Clarify use of command line options.  Re-state what is mentioned in the `Running Logstash from the Command Line` doc that: "Specifying command line options is useful when you are testing Logstash. However, in a production environment, we recommend that you use [logstash-settings-file] to control Logstash execution."
17. Clarify steps to accessing the Windows Environmental Variables window (i.e., link to Microsoft docs).
18. Remove unnecessary plus signs
19. Updated source types for examples, updated documents for specific Logstash versions with `{logstash_version}`

* Update running-logstash-command-line
1. Add note for running Logstash on Windows with `bin\logstash.bat`
2. Update formatting for running Logstash from the Windows command line

Fixes #10946
2019-07-12 23:38:27 +00:00
Karen Metts
ef861e04b3 Add homebrew as installation option
Fixes #10874
2019-06-20 14:54:19 +00:00
Joao Duarte
e1fc7f7e4b avoid clashes between Environment class methods
Fixes #10860
2019-06-14 17:44:38 +00:00
Jeff
c52c793b97 Add details about Elastic Search dependency
No Elastic Search dependency is mentioned in the guide for Logstash up to this point. This would be good for those who are getting started to Log Stash without knowing much about Elastic Search and unaware that it isn't already packages along with the install of Logstash.

Fixes #10852
2019-06-11 15:24:29 +00:00
Karen Metts
3073b84620 Remove note about j11
Fixes #10689
2019-06-05 18:18:40 +00:00
Florian Kelbert
d6a41fe17c Value of start_timestamp must to be quoted
Fixes #10836
2019-05-31 12:35:18 +00:00
Joao Duarte
e826e03689 name rpm/deb oss packages as logstash-oss
Fixes #10833
2019-05-29 14:25:21 +00:00
João Duarte
f0f7da2c36 bump version to 7.1.2 (#10831) 2019-05-28 13:30:05 -04:00
Dan Hermann
e640e4aa46 plugin type in Ruby module name should be uppercase
Fixes #10820
2019-05-28 16:05:57 +00:00
Joao Duarte
da49d84af9 release notes for 7.1.1
Fixes #10830
2019-05-28 15:21:28 +00:00
João Duarte
d409b6a258
Update index.asciidoc (#10829) 2019-05-28 16:10:21 +01:00
Joao Duarte
c221eb13b0 fix plugin doc version generation with default plugins
now that default plugins are read only from the json metadata file and
not from the lock file, the plugin version manifesto needs to be adapted
so the status of "default" plugin is read from the json file.

Fixes #10824
2019-05-27 19:43:46 +00:00
Karen Metts
8b4d27f754 Add structure for new windows topic
Added coming notice

Fixes #10809
2019-05-21 17:11:04 +00:00
João Duarte
d21e031a24
bump to 7.1.1 (#10804) 2019-05-20 17:23:51 -04:00
Karen Metts
f38c1b4ae1
Bump doc version to 7.1.0 (#10799) 2019-05-20 10:35:05 -04:00
Karen Metts
ae29c11e4d
Release notes for 7.1.0 (#10796)
* Release notes for 7.1.0

* Add text/link for 7.1.0 security changes

* Tweaks to security info
2019-05-20 10:34:21 -04:00
dedemorton
564454d0ff Comment out config examples that no longer work
Fixes #10671
2019-05-09 21:34:08 +00:00
Colin Surprenant
640fd80556
fix JRuby resolv.rb leak (#10740) 2019-05-07 16:09:28 -04:00
Guy Boertje
4bb7049557 Bump JrJackson to 0.4.8
Fixes #10748
2019-05-07 08:36:29 +00:00
Nik Everett
102bc02514 Remove two other newlines
Usually asciidoctor is ok with newlines like this but it doesn't like them in the definition list.

Fixes #10744
2019-05-06 19:10:00 +00:00
Karen Metts
358d02a4ba Tweaks to callouts
Fixes #10744
2019-05-06 19:10:00 +00:00
Karen Metts
3900035245 Remove return before callout defs
Fixes #10744
2019-05-06 19:10:00 +00:00
Karen Metts
5ad768bb15 Fix asciidoc formatting for conversion to asciidoctor
Fixes #10744
2019-05-06 19:10:00 +00:00
Joao Duarte
c37aac2e04
bump version to 7.1.0 2019-05-01 19:14:04 +01:00
Nik Everett
f7bc16b06d [Docs] Asciidoctor support (#10730)
Ports elastic/logstash-docs#688 to this repo. Asciidoctor doesn't quite
work on this repo, but it comes closer with these changes.
2019-05-01 14:03:21 -04:00
João Duarte
0edffd5ce4 bump version to 7.0.2 (#10736) 2019-05-01 10:46:14 -04:00
Karen Metts
a0bdd3b204
Bump doc versions to 7.0.1 (#10735) 2019-05-01 10:34:59 -04:00
Karen Metts
1b646e6269 Correct links to LS Ref Guide
Fixes #10727
2019-04-30 22:54:30 +00:00
Logstash Machine
e9ff763d84 Release notes for 7.0.1 (#10705) 2019-04-30 23:34:10 +01:00
Karen Metts
5485360166 Note doc file created with plugin generation
Fixes #9861
2019-04-26 21:38:06 +00:00
Karen Metts
229b124ee9 Incorporate review comments
Fixes #9861
2019-04-26 21:38:06 +00:00
Karen Metts
ed32680cec Add guidelines for writing plugin doc
Fix link formatting

Fixes #9861
2019-04-26 21:38:06 +00:00
Dan Hermann
d12d9b59b7 Clarify that Java codecs work only with Java inputs and outputs
Fixes #10716
2019-04-24 17:45:10 +00:00
urso
8f4b317dcc Rename filebeat.prospectors to filebeat.inputs
In filebeat prospectors settings have been renamed to inputs. When
prospectors is used a deprecation warning is printed. With 7.0
`filebeat.prospectors` will be removed.

This change updates all uses of prospectors with inputs. For now
filebeat events report `prospector.type` and `input.type` for
compatibility reasons.

Fixes #10711
2019-04-23 17:38:16 +00:00
Dan Hermann
1521144454 Correction on Java execution in docs on command-line arguments
Fixes #10710
2019-04-23 17:14:28 +00:00
João Duarte
a0929159f6
Update patch plugin versions in gemfile lock for 7.0.1 (#10702) 2019-04-23 10:10:04 +01:00
Joao Duarte
3393982422
rake task to generate dockerfile
* dont include docker tasks in artifact:all
* don't rebuild tar/zip if source hasn't changed
* allow SKIP_PREPARE to avoid tar creation if no modifications
* don't need a tarball to generate the dockerfile
* remove docker tests as they weren't working anymore

This commit adds a task to produce all necessary files to generate a docker image.

```
% RELEASE=1 rake artifact:dockerfile
....
Dockerfile created in /tmp/elastic/logstash/build/docker
% tree /tmp/elastic/logstash/build/docker
/tmp/elastic/logstash/build/docker
├── Dockerfile
├── bin
│   └── docker-entrypoint
├── config
│   ├── log4j2.properties
│   ├── logstash-full.yml
│   └── pipelines.yml
├── env2yaml
│   └── env2yaml
└── pipeline
    └── default.conf
% docker build --rm .
.....
Step 19/20 : LABEL org.label-schema.schema-version="1.0"   org.label-schema.vendor="Elastic"   org.label-schema.name="logstash"   org.label-schema.version="7.0.0"   org.label-schema.url="https://www.elastic.co/products/logstash"   org.label-schema.vcs-url="https://github.com/elastic/logstash" license="Elastic License"
 ---> Using cache
 ---> f622d7555220
Step 20/20 : ENTRYPOINT ["/usr/local/bin/docker-entrypoint"]
 ---> Using cache
 ---> b6feba7f4934
Successfully built b6feba7f4934
```

This task works only for releases (not snapshots).

This commit also adds a few tweaks to the artifacts building:

Using `SKIP_PREPARE=1` in `rake artifact:tar` or `rake artifact:tar_oss` will make a check to not rebuild the tarball if there are no code modifications.

These two changes are made since docker image build is new and we want to keep it out of artifact:all for a while. And if we're running these separately, we want to ensure the tarball built is used in the docker image (versus building a new one for each `rake artifact:tar` )

This means that, to generate all artifacts including docker images and dockerfile, it's necessary to run:

```
RELEASE=1 rake artifact:all
SKIP_PREPARE=1 RELEASE=1 rake artifact:docker
SKIP_PREPARE=1 RELEASE=1 rake artifact:docker_oss
RELEASE=1 rake artifact:dockerfile
```
2019-04-22 22:58:04 +01:00
Dan Hermann
4133be8dde Corrects the description of codec behavior in the output stage of Logstash pipelines
Fixes #10682
2019-04-22 15:56:37 +00:00