Breaking changes and Upgrading docs #2631
Merged
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
A first draft, containing general infos about upgrading but also specific information about the upgrade from 1.x to 5.x.
andrewkroh
approved these changes
Sep 26, 2016
| These changes are made automatically by the migration script. | ||
|
|
||
| In Filebeat, we refactored the configuration around when to close and when to | ||
| start ignore files. Options like `ignore_older` and `force_close_older` were |
There was a problem hiding this comment.
Either change to "start to ignore files" or "start ignoring files".
There was a problem hiding this comment.
ignore_older is one of the few options that stayed the same. close_older would be a good example.
|
|
||
| ==== Filebeat registry file location and format | ||
|
|
||
| Filebeat stores which the read offset in a registry file that it persist to |
There was a problem hiding this comment.
I think you can remove which from this sentence.
ruflin
reviewed
Oct 3, 2016
| ==== Configuration file changes | ||
|
|
||
| Beats 5.0 come with a more powerful and more robust <<config-file-format,file | ||
| configuration format>>. While this necessarily cause a few breaking changes, we |
|
|
||
| Similarly, common settings available in all Beats are now top level. As part of | ||
| this, the options under the `shipper` section are moved to the top level. For | ||
| example, the `shipper.name` settings becomes `shipper`. This change is made |
There was a problem hiding this comment.
shipper.name becomes name (not shipper).
| These changes are made automatically by the migration script. | ||
|
|
||
| In Filebeat, we refactored the configuration around when to close and when to | ||
| start ignore files. Options like `ignore_older` and `force_close_older` were |
There was a problem hiding this comment.
ignore_older is one of the few options that stayed the same. close_older would be a good example.
| ==== Filebeat registry file location and format | ||
|
|
||
| Filebeat stores which the read offset in a registry file that it persist to | ||
| disk. The format of this file has changed in version 5.0, but the Filebeat code |
There was a problem hiding this comment.
s/but the Filebeat code/but Filebeat/
| the Elasticsearch mapping, which can result in visualization problems or | ||
| incorect data. | ||
|
|
||
| You can set the `output.elasticsearch.template.overwrite` option to `true` to |
There was a problem hiding this comment.
Should we add here an example with the -E option that this could be also done only once on startup without having to modify the config file?
|
Comments should be addressed on this one. |
tsg
added a commit
to tsg/beats
that referenced
this pull request
Oct 7, 2016
A first draft, containing general infos about upgrading but also specific information about the upgrade from 1.x to 5.x. * Addressed comments, mostly typos * Added example -E command for overwritting the template
leweafan
pushed a commit
to leweafan/beats
that referenced
this pull request
Apr 28, 2023
A first draft, containing general infos about upgrading but also specific information about the upgrade from 1.x to 5.x. * Addressed comments, mostly typos * Added example -E command for overwritting the template
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
A first draft, containing general infos about upgrading but also
specific information about the upgrade from 1.x to 5.x.