You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/reference/connecting-to-serverless.md
+26-24Lines changed: 26 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,21 +25,29 @@ Set the value to port :443 instead.
25
25
## Communication between {{ls}} and {{es-serverless}} [connecting-to-elasticsearch-serverless]
26
26
27
27
[{{es-serverless}}](docs-content://solutions/search/serverless-elasticsearch-get-started.md) simplifies safe, secure communication between {{ls}} and {{es}}.
28
-
When you configure the Elasticsearch output plugin to use [`cloud_id`](logstash-docs-md://lsr/plugins-outputs-elasticsearch.md#plugins-outputs-elasticsearch-cloud_id) and an [`api_key`](logstash-docs-md://lsr/plugins-outputs-elasticsearch.md#plugins-outputs-elasticsearch-api_key), no additional SSL configuration is needed.
28
+
To send data to a {{serverless-short}} project, configure the {{ls}} {{es}} output plugin to connect using the project's **{{es}} endpoint URL** and an **API key**.
The value of the [`api_key` option](logstash-docs-md://lsr/plugins-outputs-elasticsearch.md#plugins-outputs-elasticsearch-api_key) is in the format `id:api_key`, where `id` and `api_key` are the values returned by the [Create API key API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-create-api-key).
33
35
34
-
Note that the value of the [`api_key` option](logstash-docs-md://lsr/plugins-outputs-elasticsearch.md#plugins-outputs-elasticsearch-api_key) is in the format `id:api_key`, where `id` and `api_key` are the values returned by the [Create API key API](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-security-create-api-key).
35
36
37
+
### {{es}} endpoint URL
36
38
37
-
### Cloud ID [cloud-id]
39
+
1. Log in to [Elastic Cloud](https://cloud.elastic.co/).
38
40
39
-
{{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 "<label>:<cloud-id>".
41
+
2. Find your **{{es}} endpoint URL**:
40
42
43
+
Select **Manage** next to your project. Then find the {{es}} endpoint under **Application endpoints, cluster and component IDs**.
41
44
42
-
### API key [api-key]
45
+
Alternatively, open your project, select the help icon, then select **Connection details**.
46
+
47
+
48
+
### API key [api-key]
49
+
50
+
Create an **API key** with the appropriate privileges. Refer to [Create API key](docs-content://solutions/search/search-connection-details.md#create-an-api-key-serverless) for detailed steps. For information on the required privileges, refer to [Grant access using API keys](/reference/secure-connection.md#ls-create-api-key).
43
51
44
52
When you create an API key for {{ls}}, select **Logstash** from the **API key format** dropdown.
45
53
This option formats the API key in the correct `id:api_key` format required by {{ls}}.
@@ -50,24 +58,18 @@ This option formats the API key in the correct `id:api_key` format required by {
50
58
:width: 400px
51
59
:::
52
60
53
-
The UI for API keys may look different depending on the deployment type.
54
-
55
-
## Using Cloud ID with plugins [cloud-id-serverless]
56
-
57
-
The Elasticsearch input, output, and filter plugins, as well as the Elastic_integration filter plugin, support cloud_id in their configurations.
The [Elasticsearch input](logstash-docs-md://lsr/plugins-inputs-elasticsearch.md#plugins-inputs-elasticsearch-api_key),
63
+
[Elasticsearch output](logstash-docs-md://lsr/plugins-outputs-elasticsearch.md#plugins-outputs-elasticsearch-api_key), and
64
+
[Elasticsearch filter](logstash-docs-md://lsr/plugins-filters-elasticsearch.md#plugins-filters-elasticsearch-api_key) plugins, as well as the
65
+
[Elastic_integration filter](logstash-docs-md://lsr/plugins-filters-elastic_integration.md#plugins-filters-elastic_integration-api_key) plugin, all support the `api_key` option in their configurations.
66
+
:::
65
67
66
68
## Using {{ls}} Central Pipeline Management with {{es-serverless}} [cpm-serverless]
67
69
68
-
This setting in the `logstash.yml` config file can help you get set up to use Central Pipeline management in Elastic Cloud:
69
-
70
-
*`xpack.management.elasticsearch.cloud_id`
71
-
72
-
You can use the `xpack.management.elasticsearch.cloud_id` setting as an alternative to `xpack.management.elasticsearch.hosts`.
70
+
To set up Central Pipeline management in {{es-serverless}}, update the `logstash.yml` config file to provide the API key and set the value for `xpack.management.elasticsearch.hosts` to your Elasticsearch endpoint URL.
73
71
72
+
```ruby
73
+
xpack.management.elasticsearch.hosts:"ELASTICSEARCH_ENDPOINT_URL"# Use the `hosts` option with the Elasticsearch endpoint URL to connect to Elasticsearch Serverless
74
+
xpack.management.elasticsearch.api_key:"<api_key>"# API key formatted for Logstash: `id:api_key`
0 commit comments