diff --git a/docs/static/ls-to-serverless.asciidoc b/docs/static/ls-to-serverless.asciidoc new file mode 100644 index 00000000000..558a117fef6 --- /dev/null +++ b/docs/static/ls-to-serverless.asciidoc @@ -0,0 +1,63 @@ +[[logstash-to-elasticsearch-serverless]] +=== Sending data to {es-serverless} + +When you use Elasticsearch on Elastic Cloud Serverless you don’t need to worry about managing the infrastructure that keeps Elasticsearch distributed and available. These resources are automated on the serverless platform and are designed to scale up and down with your workload. + + +.{ls} to {serverless-full} +**** +You'll use the {ls} link:https://www.elastic.co/guide/en/logstash/8.18/plugins-outputs-elasticsearch.html[{es} output plugin] to send data to {serverless-full}. +Note these differences between {es-serverless} and both {ech} and self-managed {es}: + +* Use link:https://www.elastic.co/guide/en/logstash/8.18/ls-security.html#ls-api-keys[API keys] to access {serverless-full} from {ls} as it does not support native user authentication. + Any user-based security settings in your {ls} link:https://www.elastic.co/guide/en/logstash/8.18/plugins-outputs-elasticsearch.html[{es} output plugin] configuration are ignored and may cause errors. +* {serverless-full} uses **data streams** and link:https://www.elastic.co/guide/en/elasticsearch/reference/8.18/data-stream-lifecycle.html[{dlm} ({dlm-init})] instead of {ilm} ({ilm-init}). Any {ilm-init} settings in your link:https://www.elastic.co/guide/en/logstash/8.18/plugins-outputs-elasticsearch.html[{es} output plugin] configuration are ignored and may cause errors. +* **{ls} monitoring** is available through the link:https://github.com/elastic/integrations/blob/main/packages/logstash/docs/README.md[{ls} Integration] in link:https://www.elastic.co/guide/en/observability/8.18/index.html[Elastic Observability] on {serverless-full}. + +*Known issue for Logstash to Elasticsearch Serverless.* + +The logstash-output-elasticsearch `hosts` setting defaults to port :9200. + +Set the value to port :443 instead. +**** + +[[connecting-to-elasticsearch-serverless]] +==== Communication between {ls} and {es-serverless} + +{es-serverless} simplifies safe, secure communication between {ls} and {es}. +When you configure the Elasticsearch output plugin to use link:https://www.elastic.co/guide/en/logstash/8.18/plugins-outputs-elasticsearch.html#plugins-outputs-elasticsearch-cloud_id[`cloud_id`] and an https://www.elastic.co/guide/en/logstash/8.18/plugins-outputs-elasticsearch.html#plugins-outputs-elasticsearch-api_key[`api_key`], no additional SSL configuration is needed. + +Example: + +* `output {elasticsearch { cloud_id => "" api_key => "" } }` + +The value of the https://www.elastic.co/guide/en/logstash/8.18/plugins-outputs-elasticsearch.html#plugins-outputs-elasticsearch-api_key[`api_key` option] is in the format `id:api_key`, where `id` and `api_key` are the values returned by the link:https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-create-api-key[Create API key API]. + +[[cloud-id-serverless]] +===== Cloud ID + +{ls} uses the Cloud ID, found in the Elastic Cloud web console, to build the Elasticsearch and Kibana hosts settings. It is a base64 encoded text value of about 120 characters made up of upper and lower case letters and numbers. If you have several Cloud IDs, you can add a label, which is ignored internally, to help you tell them apart. To add a label, prefix your Cloud ID with a label and a `:` separator in this format "