Skip to content

Commit 06bb6cd

Browse files
committed
Merge branch 'mw-dm-license' of https://github.com/elastic/docs-content into mw-dm-license
2 parents 95d47bf + ce4f72e commit 06bb6cd

File tree

463 files changed

+4594
-8061
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

463 files changed

+4594
-8061
lines changed

deploy-manage/deploy/cloud-enterprise.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
mapped_urls:
3+
- https://www.elastic.co/guide/en/cloud-enterprise/current/index.html
34
- https://www.elastic.co/guide/en/cloud-enterprise/current/Elastic-Cloud-Enterprise-overview.html
45
- https://www.elastic.co/guide/en/cloud-enterprise/current/ece-administering-ece.html
56
---

deploy-manage/deploy/cloud-enterprise/ece-regional-deployment-aliases.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,5 +99,5 @@ While the `TransportClient` is deprecated, your custom endpoint aliases still wo
9999
```
100100

101101

102-
For more information on configuring the `TransportClient`, see [Configure the Java Transport Client](https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current/index.html).
102+
For more information on configuring the `TransportClient`, see [Configure the Java Transport Client](asciidocalypse://docs/elasticsearch-java/docs/reference/elasticsearch/elasticsearch-client-java-api-client/index.md).
103103

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

deploy-manage/deploy/cloud-on-k8s.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22
applies:
33
eck: all
44
mapped_urls:
5+
- https://www.elastic.co/guide/en/cloud-on-k8s/current/index.html
56
- https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-overview.html
67
- https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-advanced-topics.html
78
- https://www.elastic.co/guide/en/cloud-on-k8s/current/k8s-supported.html

deploy-manage/deploy/cloud-on-k8s/configure-eck.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ mapped_pages:
1111
This page explains the various methods for configuring and applying ECK settings.
1212

1313
::::{tip}
14-
For a detailed list and description of all available settings in ECK, refer to asciidocalypse://reference/cloud/cloud-on-k8s/eck-configuration-flags.md.
14+
For a detailed list and description of all available settings in ECK, refer to [ECK configuration flags](asciidocalypse://docs/cloud-on-k8s/docs/reference/cloud/cloud-on-k8s/eck-configuration-flags.md).
1515
::::
1616

1717
By default, the ECK installation includes a [ConfigMap](https://kubernetes.io/docs/concepts/configuration/configmap/) with an `eck.yaml` key where you can add, remove, or update configuration settings. This ConfigMap is mounted into the operator’s container as a file, and provided to the application through the `--config` flag.
@@ -55,7 +55,7 @@ If you installed ECK using the manifests and the commands listed in [Deploy ECK]
5555

5656
You can update the ConfigMap directly using the command `kubectl edit configmap elastic-operator -n elastic-operator` or modify the installation manifests and reapply them with `kubectl apply -f <your-manifest-file.yaml>`.
5757

58-
The following shows the default `elastic-operator` ConfigMap, for reference purposes. Refer to asciidocalypse://reference/cloud/cloud-on-k8s/eck-configuration-flags.md for a complete list of available settings.
58+
The following shows the default `elastic-operator` ConfigMap, for reference purposes. Refer to [ECK configuration flags](asciidocalypse://docs/cloud-on-k8s/docs/reference/cloud/cloud-on-k8s/eck-configuration-flags.md) for a complete list of available settings.
5959

6060
```yaml
6161
apiVersion: v1

deploy-manage/deploy/cloud-on-k8s/k8s-openshift-agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ mapped_pages:
77

88
# Grant host access permission to Elastic Agent [k8s-openshift-agent]
99

10-
Deploying Elastic Agent on Openshift may require additional permissions depending on the type of [integration](https://www.elastic.co/guide/en/fleet/current/index.html) Elastic Agent is supposed to run. In any case, Elastic Agent uses a [hostPath](https://kubernetes.io/docs/concepts/storage/volumes/#hostpath) volume as its data directory on OpenShift to maintain a stable identity. Therefore, the Service Account used for Elastic Agent needs permissions to use hostPath volumes.
10+
Deploying Elastic Agent on Openshift may require additional permissions depending on the type of [integration](asciidocalypse://docs/docs-content/docs/reference/ingestion-tools/fleet/index.md) Elastic Agent is supposed to run. In any case, Elastic Agent uses a [hostPath](https://kubernetes.io/docs/concepts/storage/volumes/#hostpath) volume as its data directory on OpenShift to maintain a stable identity. Therefore, the Service Account used for Elastic Agent needs permissions to use hostPath volumes.
1111

1212
The following example assumes that Elastic Agent is deployed in the Namespace `elastic` with the ServiceAccount `elastic-agent`. You can replace these values according to your environment.
1313

deploy-manage/deploy/elastic-cloud/add-plugins-extensions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ There are two ways to add plugins to a deployment in Elasticsearch Service:
2020

2121
Custom plugins can include the official {{es}} plugins not provided with Elasticsearch Service, any of the community-sourced plugins, or [plugins that you write yourself](asciidocalypse://docs/elasticsearch/docs/extend/create-elasticsearch-plugins/index.md). Uploading custom plugins is available only to Gold, Platinum, and Enterprise subscriptions. For more information, check [Upload custom plugins and bundles](upload-custom-plugins-bundles.md).
2222

23-
To learn more about the official and community-sourced plugins, refer to [{{es}} Plugins and Integrations](https://www.elastic.co/guide/en/elasticsearch/plugins/current/index.html).
23+
To learn more about the official and community-sourced plugins, refer to [{{es}} Plugins and Integrations](asciidocalypse://docs/elasticsearch/docs/reference/elasticsearch-plugins/index.md).
2424

2525
For a detailed guide with examples of using the Elasticsearch Service API to create, get information about, update, and delete extensions and plugins, check [Managing plugins and extensions through the API](manage-plugins-extensions-through-api.md).
2626

deploy-manage/deploy/elastic-cloud/cloud-hosted.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
mapped_urls:
3+
- https://www.elastic.co/guide/en/cloud/current/index.html
34
- https://www.elastic.co/guide/en/cloud/current/ec-getting-started.html
45
- https://www.elastic.co/guide/en/cloud/current/ec-prepare-production.html
56
- https://www.elastic.co/guide/en/cloud/current/ec-faq-getting-started.html

deploy-manage/deploy/elastic-cloud/ech-getting-started.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
mapped_pages:
33
- https://www.elastic.co/guide/en/cloud-heroku/current/ech-getting-started.html
4+
- https://www.elastic.co/guide/en/cloud-heroku/current/index.html
45
---
56

67
# Introducing Elasticsearch Add-On for Heroku [ech-getting-started]

0 commit comments

Comments
 (0)