Skip to content

Commit afe0b53

Browse files
authored
ECE cloud id and endpoint docs refined (#529)
Related with elastic/docs-projects#339 ECE connect to cluster docs refined.
1 parent 0e86aed commit afe0b53

File tree

2 files changed

+21
-16
lines changed

2 files changed

+21
-16
lines changed

deploy-manage/deploy/cloud-enterprise/find-cloud-id.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,34 @@
11
---
2+
navigation_title: Connect to your deployment using Cloud ID
3+
applies_to:
4+
deployment:
5+
ece: all
26
mapped_pages:
37
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-cloud-id.html
48
---
59

610
# Find your Cloud ID [ece-cloud-id]
711

8-
The Cloud ID reduces the number of steps required to start sending data from Beats or Logstash to your hosted Elasticsearch cluster on Elastic Cloud Enterprise. Because we made it easier to send data, you can start exploring visualizations in Kibana on Elastic Cloud Enterprise that much more quickly.
12+
The Cloud ID reduces the number of steps required to start sending data from Beats or Logstash to your hosted Elasticsearch cluster on {{ece}}. Because we made it easier to send data, you can start exploring visualizations in Kibana on {{ece}} that much more quickly.
913

1014
:::{image} ../../../images/cloud-enterprise-ec-ce-cloud-id-beats-logstash.png
1115
:alt: Exploring data from Beats or Logstash in Kibana after sending it to a hosted Elasticsearch cluster
1216
:::
1317

14-
The Cloud ID works by assigning a unique ID to your hosted Elasticsearch cluster on Elastic Cloud Enterprise. All deployments automatically get a Cloud ID.
18+
The Cloud ID works by assigning a unique ID to your hosted Elasticsearch cluster on {{ece}}. All deployments automatically get a Cloud ID.
1519

16-
You include your Cloud ID along with your Elastic Cloud Enterprise user credentials (defined in `cloud.auth`) when you run Beats or Logstash locally, and then let Elastic Cloud Enterprise handle all of the remaining connection details to send the data to your hosted cluster on Elastic Cloud Enterprise safely and securely.
20+
You include your Cloud ID along with your {{ece}} user credentials (defined in `cloud.auth`) when you run Beats or Logstash locally, and then let {{ece}} handle all of the remaining connection details to send the data to your hosted cluster on {{ece}} safely and securely.
1721

1822
:::{image} ../../../images/cloud-enterprise-ec-ce-cloud-id.png
1923
:alt: The Cloud ID and `elastic` user information shown when you create a deployment
2024
:::
2125

22-
2326
## What are Beats and Logstash? [ece_what_are_beats_and_logstash]
2427

2528
Not sure why you need Beats or Logstash? Here’s what they do:
2629

27-
* [Beats](https://www.elastic.co/products/beats) is our open source platform for single-purpose data shippers. The purpose of Beats is to help you gather data from different sources and to centralize the data by shipping it to Elasticsearch. Beats install as lightweight agents and ship data from hundreds or thousands of machines to your hosted Elasticsearch cluster on Elastic Cloud Enterprise. If you want more processing muscle, Beats can also ship to Logstash for transformation and parsing before the data gets stored in Elasticsearch.
28-
* [Logstash](https://www.elastic.co/products/logstash) is an open source, server-side data processing pipeline that ingests data from a multitude of sources simultaneously, transforms it, and then sends it to your favorite place where you stash things, here your hosted Elasticsearch cluster on Elastic Cloud Enterprise. Logstash supports a variety of inputs that pull in events from a multitude of common sources — logs, metrics, web applications, data stores, and various AWS services — all in continuous, streaming fashion.
29-
30+
* [Beats](https://www.elastic.co/products/beats) is our open source platform for single-purpose data shippers. The purpose of Beats is to help you gather data from different sources and to centralize the data by shipping it to Elasticsearch. Beats install as lightweight agents and ship data from hundreds or thousands of machines to your hosted Elasticsearch cluster on {{ece}}. If you want more processing muscle, Beats can also ship to Logstash for transformation and parsing before the data gets stored in Elasticsearch.
31+
* [Logstash](https://www.elastic.co/products/logstash) is an open source, server-side data processing pipeline that ingests data from a multitude of sources simultaneously, transforms it, and then sends it to your favorite place where you stash things, here your hosted Elasticsearch cluster on {{ece}}. Logstash supports a variety of inputs that pull in events from a multitude of common sources — logs, metrics, web applications, data stores, and various AWS services — all in continuous, streaming fashion.
3032

3133
## Before you begin [ece_before_you_begin_16]
3234

@@ -41,18 +43,15 @@ To use the Cloud ID, you need:
4143

4244
In our examples, we use the `elastic` superuser that every Elasticsearch cluster comes with. The password for the `elastic` user is provided when you create a deployment (and can also be [reset](../../users-roles/cluster-or-deployment-auth/built-in-users.md) if you forget it). On a production system, you should adapt these examples by creating a user that can write to and access only the minimally required indices. For each Beat, review the specific feature and role table, similar to the one in [Metricbeat](asciidocalypse://docs/beats/docs/reference/ingestion-tools/beats-metricbeat/feature-roles.md) documentation.
4345

44-
45-
4646
## Configure Beats with your Cloud ID [ece-cloud-id-beats]
4747

48-
The following example shows how you can send operational data from Metricbeat to Elastic Cloud Enterprise by using the Cloud ID. Any of the available Beats will work, but we had to pick one for this example.
48+
The following example shows how you can send operational data from Metricbeat to {{ece}} by using the Cloud ID. Any of the available Beats will work, but we had to pick one for this example.
4949

5050
::::{tip}
5151
For others, you can learn more about [getting started](asciidocalypse://docs/beats/docs/reference/ingestion-tools/index.md) with each Beat.
5252
::::
5353

54-
55-
To get started with Metricbeat and Elastic Cloud Enterprise:
54+
To get started with Metricbeat and {{ece}}:
5655

5756
1. [Log into the Cloud UI](log-into-cloud-ui.md).
5857
2. [Create a new deployment](create-deployment.md) and copy down the password for the `elastic` user.

deploy-manage/deploy/cloud-enterprise/find-endpoint-url.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,17 @@
11
---
2+
navigation_title: Connect to your deployment using endpoint URLs
3+
applies_to:
4+
deployment:
5+
ece: all
26
mapped_pages:
37
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-connect.html
48
---
59

10+
% note: this document is super outdated, the curl example doesn't use authentication and we add a note about Elasticsearch 5.0 or later to add user & password
11+
612
# Find your endpoint URL [ece-connect]
713

8-
To connect to your Elasticsearch cluster, you need to look up the the cluster Endpoint URL:
14+
To connect to your Elasticsearch cluster, you need to look up the the Endpoint URLs:
915

1016
1. [Log into the Cloud UI](log-into-cloud-ui.md), if you aren’t logged in already.
1117
2. On the **Deployments** page, select one of your deployments.
@@ -33,7 +39,7 @@ To connect to your Elasticsearch cluster, you need to look up the the cluster En
3339
Currently, we support the following ways of connecting to an Elasticsearch cluster:
3440

3541
RESTful API with JSON over HTTP and HTTPS
36-
: Used by the `curl` command and most programming languages that aren’t Java. To interact with your cluster, use your Elasticsearch cluster endpoint information from the **Overview** page in the Cloud UI. Port 9200 is used for plain text, insecure HTTP connections while port 9243 is used for HTTPS. Using HTTPS is generally recommended, as it is more secure.
42+
: Used by the `curl` command and most programming languages that aren’t Java. To interact with your cluster, use your Elasticsearch cluster endpoint information from the deployment overview page in the Cloud UI. Port 9200 is used for plain text, insecure HTTP connections, while port 9243 is used for HTTPS. Using HTTPS is generally recommended, as it is more secure.
3743

3844
If this is your first time using Elasticsearch, you can try out some `curl` commands to become familiar with the basics. If you’re on an operating system like macOS or Linux, you probably already have the `curl` command installed. For example, to connect to your cluster from the command line over HTTPS with the `curl` command:
3945

@@ -60,7 +66,7 @@ RESTful API with JSON over HTTP and HTTPS
6066
If you created a cluster on Elasticsearch 5.0 or later or if you already enabled the security features, you must include authentication details with the -u parameter. For example: `curl -u elastic:W0UN0Rh9WX8eKeN69grVk3bX https://85943ce00a934471cb971009e73d2d39.us-east-1.aws.found.io:9243`. You can check [Get existing ECE security certificates](../../security/secure-your-elastic-cloud-enterprise-installation/manage-security-certificates.md) for how to get the CA certificate (`elastic-ece-ca-cert.pem` in this example) and use it to connect to the Elasticsearch cluster.
6167
::::
6268

69+
## Ingest methods
6370

64-
Ingest methods
65-
: There are several ways to connect to Elasticsearch, perform searches, insert data, and more. See the [ingesting data](https://www.elastic.co/guide/en/cloud-enterprise/current/ece-cloud-ingest-data.html) documentation.
71+
There are several ways to connect to Elasticsearch, perform searches, insert data, and more. See the [ingesting data](https://www.elastic.co/guide/en/cloud-enterprise/current/ece-cloud-ingest-data.html) documentation.
6672

0 commit comments

Comments
 (0)