diff --git a/CHANGELOG.md b/CHANGELOG.md index 47978707..126a8877 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,6 @@ +## 11.22.2 + - [DOC] Add content for sending data to Elasticsearch on serverless [#1164](https://github.com/logstash-plugins/logstash-output-elasticsearch/pull/1164) + ## 11.22.1 - Fix, avoid to populate `version` and `version_type` attributes when processing integration metadata and datastream is enabled. [#1161](https://github.com/logstash-plugins/logstash-output-elasticsearch/pull/1161) diff --git a/docs/index.asciidoc b/docs/index.asciidoc index 97f2484f..68834e22 100644 --- a/docs/index.asciidoc +++ b/docs/index.asciidoc @@ -30,7 +30,7 @@ the website landing page or in the {ref}[Elasticsearch documentation]. .Compatibility Note [NOTE] -================================================================================ +===== When connected to Elasticsearch 7.x, modern versions of this plugin don't use the document-type when inserting documents, unless the user explicitly sets <>. @@ -42,9 +42,30 @@ picks up changes to the Elasticsearch index template. If you are using a custom <>, ensure your template uses the `_doc` document-type before connecting to Elasticsearch 7.x. -================================================================================ +===== -===== Hosted {es} Service on Elastic Cloud +[id="plugins-{type}s-{plugin}-serverless"] +==== {ls} to {es-serverless} + +You can use this plugin to send your {ls} data to {es-serverless}. +Some differences to note between {es-serverless} and self-managed {es}: + +* Use *API keys* to access {serverless-full} from {ls}. +Any user-based security settings in your in your <> configuration are ignored and may cause errors. +* {es-serverless} uses *data streams* and {ref}/data-stream-lifecycle.html[{dlm} ({dlm-init})] instead of {ilm} ({ilm-init}). +Any {ilm-init} settings in your <> configuration are ignored and may cause errors. +* *{ls} monitoring* is available through the https://github.com/elastic/integrations/blob/main/packages/logstash/_dev/build/docs/README.md[{ls} Integration] in {serverless-docs}/observability/what-is-observability-serverless[Elastic Observability] on {serverless-full}. + +.Known issue for {ls} to {es-serverless} +**** +The logstash-output-elasticsearch `hosts` setting on {serverless-short} defaults the port to 9200 when omitted. +Set the value to port :443 instead. +**** + +For more info on sending data from {ls} to {es-serverless}, check out the {serverless-docs}/elasticsearch/what-is-elasticsearch-serverless[{es-serverless} docs]. + +[id="plugins-{type}s-{plugin}-ess"] +==== Hosted {es} Service on Elastic Cloud {ess-leadin} @@ -68,8 +89,8 @@ and will correctly reject events with fields that conflict and cannot be coerced The {es} output plugin can store both time series datasets (such as logs, events, and metrics) and non-time series data in Elasticsearch. -The data stream options are recommended for indexing time series datasets (such -as logs, metrics, and events) into {es}: +Use the data stream options for indexing time series datasets (such +as logs, metrics, and events) into {es} and {es-serverless}: * <> * <> @@ -200,27 +221,28 @@ The list of error codes accepted for DLQ could be customized with <