Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update to v8.0.0 #544

Merged
merged 1 commit into from
Feb 10, 2022
Merged

Update to v8.0.0 #544

merged 1 commit into from
Feb 10, 2022

Conversation

antoineco
Copy link
Collaborator

@antoineco antoineco commented Oct 15, 2020

Sending this PR early so people can experiment with the new v8.x series.
Marking as draft until v8.0.0 gets officially released (2022-02-08 according to the Elastic product end of life dates page).


Closes #543

List of changes impacting docker-elk:

Logstash

Elasticsearch

Kibana

  • An index pattern for logs-* indices is automatically created.

    It used to be required to manually create an index pattern for indices managed by Logstash, even when using the default Logstash indices. This is no longer the case since the output data is now being handled as a data stream, and Kibana automatically creates index patterns for these.

Enterprise Search

@antoineco antoineco force-pushed the future branch 6 times, most recently from 80f3591 to 86f2134 Compare October 17, 2020 00:09
@antoineco antoineco force-pushed the future branch 4 times, most recently from a559a97 to 1ca91e9 Compare October 19, 2020 07:44
@antoineco antoineco force-pushed the future branch 2 times, most recently from 85118d5 to 353ef47 Compare October 26, 2020 10:54
@antoineco antoineco closed this Dec 23, 2020
@antoineco antoineco deleted the future branch December 23, 2020 13:22
@antoineco antoineco restored the future branch December 23, 2020 13:30
@antoineco antoineco reopened this Dec 23, 2020
Base automatically changed from master to main January 19, 2021 19:12
@antoineco antoineco changed the title Update to v8.0.0-SNAPSHOT Update to v8.0.0 Aug 11, 2021
@antoineco
Copy link
Collaborator Author

antoineco commented Aug 11, 2021

Tests are currently failing with a pesky error, which seems to be caused by the Logstash TCP input in particular (possibly related to logstash-plugins/logstash-input-tcp#176):

object mapping for [host] tried to parse field [host] as object, but found a concrete value

It feels to me like all this is related to the ECS schema Elastic is pushing to their products.

Possibly relevant:


edit: Indeed, the tcp output automatically injects a host and a port fields at the top level of the generated documents (see the issue I linked above):

{
      "@version" => "1",
          "host" => "gateway",
          "port" => 45732,
       "message" => "dockerelk",
    "@timestamp" => 2021-08-11T17:06:55.679Z
}

Where the mapping for that host field is defined is a mystery for me though. I couldn't find a reference to such field in the index template that gets automatically created by the elasticsearch output.

I started a forum discussion to try clarifying it.


edit 2: I originally fixed this using a Logstash filter, but it turns out this is no longer required starting with 8.0.0-rc1. Logstash doesn't "pollute" the top scope anymore.

List of changes impacting docker-elk:

- [logstash]: The output to Elasticsearch is handled as a data stream.

  Starting with v8.0.0, the `elasticsearch` output for Logstash sends
  log data to a data stream instead of `logstash-*` indices by default.
  The name of the default data stream is `logs-generic-default`.
  docker-elk remains unopinionated and simply uses Elastic's defaults
  like it always has, so users who prefer to retain the old behaviour
  need to explicitly opt-out of data streams in their Logstash
  pipelines.

  Refs:
  - https://www.elastic.co/guide/en/elasticsearch/reference/current/data-streams.html
  - https://www.elastic.co/guide/en/logstash/current/plugins-outputs-elasticsearch.html#plugins-outputs-elasticsearch-data-streams

- [logstash]: The (legacy) monitoring data collection is now disabled.

  This feature was deprecated since v7.9.0, and removed in v8.0.0.

  Ref: https://www.elastic.co/guide/en/logstash/current/monitoring-internal-collection-legacy.html

- [kibana]: An index pattern for `logs-*` indices is automatically
  created.

  It used to be required to manually create an index pattern for indices
  managed by Logstash, even when using the default Logstash indices.
  This is no longer the case since the output data is now being handled
  as a data stream, and Kibana automatically creates index patterns for
  these.

- [elasticsearch]: The command line tool `elasticsearch-setup-passwords`
  was deprecated in favour of a new `elasticsearch-reset-password` tool.

  Passwords for built-in users must now be generated one by one.

  Ref: https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-passwords.html

- [enterprise-search]: Kibana is now the new management interface, and
  the only one available moving forward.

  The old standalone Enterprise Search interface was removed in v8.0.0.

  Ref: https://www.elastic.co/guide/en/enterprise-search/current/user-interfaces.html
@antoineco antoineco merged commit 6704d9f into deviantony:main Feb 10, 2022
@antoineco antoineco deleted the future branch February 10, 2022 16:19
DanBrown47 pushed a commit to DanBrown47/docker-elk that referenced this pull request Jun 22, 2023
List of changes impacting docker-elk:

- [logstash]: The output to Elasticsearch is handled as a data stream.

  Starting with v8.0.0, the `elasticsearch` output for Logstash sends
  log data to a data stream instead of `logstash-*` indices by default.
  The name of the default data stream is `logs-generic-default`.
  docker-elk remains unopinionated and simply uses Elastic's defaults
  like it always has, so users who prefer to retain the old behaviour
  need to explicitly opt-out of data streams in their Logstash
  pipelines.

  Refs:
  - https://www.elastic.co/guide/en/elasticsearch/reference/current/data-streams.html
  - https://www.elastic.co/guide/en/logstash/current/plugins-outputs-elasticsearch.html#plugins-outputs-elasticsearch-data-streams

- [logstash]: The (legacy) monitoring data collection is now disabled.

  This feature was deprecated since v7.9.0, and removed in v8.0.0.

  Ref: https://www.elastic.co/guide/en/logstash/current/monitoring-internal-collection-legacy.html

- [kibana]: An index pattern for `logs-*` indices is automatically
  created.

  It used to be required to manually create an index pattern for indices
  managed by Logstash, even when using the default Logstash indices.
  This is no longer the case since the output data is now being handled
  as a data stream, and Kibana automatically creates index patterns for
  these.

- [elasticsearch]: The command line tool `elasticsearch-setup-passwords`
  was deprecated in favour of a new `elasticsearch-reset-password` tool.

  Passwords for built-in users must now be generated one by one.

  Ref: https://www.elastic.co/guide/en/elasticsearch/reference/current/setup-passwords.html

- [enterprise-search]: Kibana is now the new management interface, and
  the only one available moving forward.

  The old standalone Enterprise Search interface was removed in v8.0.0.

  Ref: https://www.elastic.co/guide/en/enterprise-search/current/user-interfaces.html
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update to v8.0.0
1 participant