logstash-plugins/logstash-output-elasticsearch

SSL settings changed and not documented

Closed this issue · 1 comments

itaynvn-runai commented

Logstash version: 8.5.1

Description:
I've tried to configure SSL settings and found 2 inconsistencies:

  1. The documentation specifies the ssl_enabled option for the plugin, but it is not recognized.
    placement inlogstash.conf:
    output {
      elasticsearch {
        ssl_enabled => true
      }
    }

error log:

[2024-04-15T08:49:14,869][ERROR][logstash.outputs.elasticsearch] Unknown setting 'ssl_enabled' for elasticsearch

Issue resolved when i changed it to ssl => true.

  1. The documentation specifies the ssl_verification_mode option for the plugin, but it is not recognized.
    placement inlogstash.conf:
    output {
      elasticsearch {
        ssl_verification_mode => "none"
      }
    }

error log:

[2024-04-15T09:08:18,575][ERROR][logstash.outputs.elasticsearch] Unknown setting 'ssl_verification_mode' for elasticsearch

Issue resolved when i changed it to ssl_certificate_verification => false.

Both of these 'deprecations' hapenned ~1 year ago:
PR: #1118
release notes:

logstash-output-elasticsearch/CHANGELOG.md

Line 76 in 81de72e

## 11.14.0

so it's either the changes weren't applied properly, or the documentation needs to be updated.

edmocosta commented

Hi @itaynvn-runai 👋!

Thank you for reporting. Logstash 8.5.1 still embeds logstash-output-elasticsearch version 11.9.3, which does not contains the #1118 changes. It was added only on the plugin version 11.14, released by default with Logstash versions >= v8.8.0.

You can find the docs for that specific version here. If you want, you can also update the plugin to the latest version by running following command:

bin/logstash-plugin update logstash-output-elasticsearch
  • ❤️1