Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion deploy-manage/api-keys.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,10 @@ applies_to:
ece: ga
self: ga
serverless: ga
navigation_title: API keys
---

# API keys
# Elastic API keys

API keys are security mechanisms used to authenticate and authorize access to your deployments and {{es}} resources.

Expand Down
2 changes: 1 addition & 1 deletion deploy-manage/deploy/cloud-enterprise.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ In ECE, a deployment is a managed {{stack}} environment that provides users with

The section covers the following tasks:

* [Deploy ECE orchestrator](./cloud-enterprise/deploy-an-orchestrator.md)
* [Deploy an ECE orchestrator](./cloud-enterprise/deploy-an-orchestrator.md)
- [Prepare the environment](./cloud-enterprise/prepare-environment.md)
- [Install ECE](./cloud-enterprise/install.md)
- [Air gapped installations](./cloud-enterprise/air-gapped-install.md)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,9 @@
applies_to:
deployment:
ece: all
navigation_title: Deploy an orchestrator
---
# Deploy an orchestrator
# Deploy an {{ece}} orchestrator

{{ece}} (ECE) provides a centralized platform that allows organizations to run {{es}}, {{kib}}, and other {{stack}} components across multiple machines, whether in a private or public cloud, virtual machines, or your own premises.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,10 @@ applies_to:
ece: all
products:
- id: cloud-enterprise
navigation_title: Custom endpoint aliases
---

# Custom endpoint aliases [ece-regional-deployment-aliases]
# Configure custom endpoint aliases on {{ece}} [ece-regional-deployment-aliases]

Custom aliases for your deployment endpoints on {{ece}} allow you to have predictable, human-readable URLs that can be shared easily.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,10 @@ applies_to:
ece: all
products:
- id: cloud-enterprise
navigation_title: Switch from APM to Integrations Server
---

# Switch from APM to Integrations Server payload [ece-integrations-server-apm-switch]
# Switch from APM to Integrations Server payload on {{ece}} [ece-integrations-server-apm-switch]

This example shows how to use the {{ece}} RESTful API to switch from using the legacy [APM & Fleet Server](https://www.elastic.co/guide/en/cloud-enterprise/3.8/ece-manage-apm-and-fleet.html) to [Integrations Server](manage-integrations-server.md).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,5 +38,5 @@ ECK also facilitates configuration and operation activities with advanced featur
* [**{{stack}} configuration policies**](elastic-stack-configuration-policies.md): Organize your {{es}} and {{kib}} configuration settings through `StackConfigPolicy` resources that can be referenced within your deployments. This helps to keep your manifests simplified.

::::{important}
Explore the [Security](/deploy-manage/security.md) and [Users and roles](/deploy-manage/users-roles.md) sections to to learn more about how to secure and control access your deployments.
Explore the [](/deploy-manage/security.md) and [Users and roles](/deploy-manage/users-roles.md) sections to to learn more about how to secure and control access your deployments.
::::
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,10 @@ applies_to:
eck: all
products:
- id: cloud-kubernetes
navigation_title: Deploy an orchestrator
---

# Deploy an orchestrator [k8s-quickstart]
# Deploy an {{eck}} orchestrator [k8s-quickstart]

With {{eck}} (ECK), you can extend the basic Kubernetes orchestration capabilities to easily deploy, secure, upgrade your {{es}} cluster, along with other Elastic applications.

Expand Down
2 changes: 1 addition & 1 deletion deploy-manage/deploy/cloud-on-k8s/quickstart-beats.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ products:

# Quickstart [k8s-beat-quickstart]

1. Apply the following specification to deploy Filebeat and collect the logs of all containers running in the Kubernetes cluster. ECK automatically configures the secured connection to an {{es}} cluster named `quickstart`, created in the [{{es}} quickstart](deploy-an-orchestrator.md).
1. Apply the following specification to deploy Filebeat and collect the logs of all containers running in the Kubernetes cluster. ECK automatically configures the secured connection to an {{es}} cluster named `quickstart`, created in [](/deploy-manage/deploy/cloud-on-k8s/elasticsearch-deployment-quickstart.md).

```yaml
cat <<EOF | kubectl apply -f -
Expand Down
2 changes: 1 addition & 1 deletion deploy-manage/deploy/cloud-on-k8s/quickstart-logstash.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ products:

# Quickstart [k8s-logstash-quickstart]

Add the following specification to create a minimal {{ls}} deployment that will listen to a Beats agent or Elastic Agent configured to send to Logstash on port 5044, create the service and write the output to an {{es}} cluster named `quickstart`, created in the [{{es}} quickstart](deploy-an-orchestrator.md).
Add the following specification to create a minimal {{ls}} deployment that will listen to a Beats agent or Elastic Agent configured to send to Logstash on port 5044, create the service and write the output to an {{es}} cluster named `quickstart`, created in [](/deploy-manage/deploy/cloud-on-k8s/elasticsearch-deployment-quickstart.md).

```yaml subs=true
cat <<'EOF' | kubectl apply -f -
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ products:

# Quickstart [k8s-elastic-agent-quickstart]

1. Apply the following specification to deploy Elastic Agent with the System metrics integration to harvest CPU metrics from the Agent Pods. ECK automatically configures the secured connection to an {{es}} cluster named `quickstart`, created in the [{{es}} quickstart](deploy-an-orchestrator.md).
1. Apply the following specification to deploy Elastic Agent with the System metrics integration to harvest CPU metrics from the Agent Pods. ECK automatically configures the secured connection to an {{es}} cluster named `quickstart`, created in [](/deploy-manage/deploy/cloud-on-k8s/elasticsearch-deployment-quickstart.md).
Copy link
Contributor

@vishaangelova vishaangelova Sep 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Apply the following specification to deploy Elastic Agent with the System metrics integration to harvest CPU metrics from the Agent Pods. ECK automatically configures the secured connection to an {{es}} cluster named `quickstart`, created in [](/deploy-manage/deploy/cloud-on-k8s/elasticsearch-deployment-quickstart.md).
1. Apply the following specification to deploy Elastic Agent with the System metrics integration to harvest CPU metrics from the Agent Pods. ECK automatically configures the secured connection to an {{es}} cluster named `quickstart`, created in [](/deploy-manage/deploy/cloud-on-k8s/deploy-an-orchestrator.md).

Copy link
Contributor

@vishaangelova vishaangelova Sep 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a recurrent thing across the PR, could you please update all instances? Or rename the file. (but then check for /deploy-manage/deploy/cloud-on-k8s/deploy-an-orchestrator.md or deploy-an-orchestrator.md because I think there’s at least one instance of that)

Copy link
Collaborator Author

@shainaraskas shainaraskas Sep 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this change was intentional - I have updated the link to make it better reflect the context. the old link was not very helpful and this page is the one in which we actually create the quickstart cluster.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh I see... I assumed this was meant to be a link to the same file. 🤦 Sorry!


```yaml subs=true
cat <<EOF | kubectl apply -f -
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,10 @@ applies_to:
eck: all
products:
- id: cloud-kubernetes
navigation_title: Troubleshooting
---

# Troubleshooting [k8s-beat-troubleshooting]
# Troubleshooting Beats on {{eck}} [k8s-beat-troubleshooting]

## Beat Pods are crashing when kibanaRef is specified [k8s-beat-beat-pods-are-crashing-when-kibanaref-is-specified]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,10 @@ applies_to:
eck: all
products:
- id: cloud-kubernetes
navigation_title: Update strategy
---

# Update Strategy [k8s-logstash-update-strategy]
# Pod update strategy for Logstash on ECK [k8s-logstash-update-strategy]

The operator takes a Pod down to restart and applies a new configuration value. All Pods are restarted in reverse ordinal order.

Expand Down
3 changes: 2 additions & 1 deletion deploy-manage/deploy/cloud-on-k8s/update-strategy.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,10 @@ applies_to:
eck: all
products:
- id: cloud-kubernetes
navigation_title: Update strategy
---

# Update strategy [k8s-update-strategy]
# Pod update strategy for Elastic Cloud on Kubernetes [k8s-update-strategy]

You can use the `updateStrategy` specification to limit the number of simultaneous changes, like for example in the following cases:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ products:

Managing APM Server, {{kib}} and {{es}} with ECK allows a smooth and secured integration between the stack components. The output configuration of the APM Server is setup automatically to establish a trust relationship with {{es}}. Specifying the {{kib}} reference allows ECK to automatically configure the [{{kib}} endpoint](/solutions/observability/apm/configure-kibana-endpoint.md).

1. To deploy an APM Server and connect it to the {{es}} cluster and {{kib}} instance you created in the [quickstart](deploy-an-orchestrator.md), apply the following specification:
1. To deploy an APM Server and connect it to the {{es}} cluster and {{kib}} instance you created in [](/deploy-manage/deploy/cloud-on-k8s/elasticsearch-deployment-quickstart.md), apply the following specification:

```yaml subs=true
cat <<EOF | kubectl apply -f -
Expand All @@ -27,11 +27,11 @@ Managing APM Server, {{kib}} and {{es}} with ECK allows a smooth and secured int
elasticsearchRef:
name: quickstart
kibanaRef:
name: quickstart
name: quickstart <1>
EOF
```

1. A reference to a {{kib}} instance is only required for APM Server versions 8.0.0 and later.
1. A reference to a {{kib}} instance is only required for APM Server versions 8.0.0 and later.


::::{note}
Expand Down
2 changes: 1 addition & 1 deletion deploy-manage/deploy/cloud-on-k8s/virtual-memory.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ products:

# Virtual memory [k8s-virtual-memory]

By default, {{es}} uses memory mapping (`mmap`) to efficiently access indices. Usually, default values for virtual address space on Linux distributions are too low for {{es}} to work properly, which may result in out-of-memory exceptions. This is why [the quickstart example](deploy-an-orchestrator.md) disables `mmap` through the `node.store.allow_mmap: false` setting. For production workloads, it is strongly recommended to increase the kernel setting `vm.max_map_count` to `262144` and leave `node.store.allow_mmap` unset.
By default, {{es}} uses memory mapping (`mmap`) to efficiently access indices. Usually, default values for virtual address space on Linux distributions are too low for {{es}} to work properly, which may result in out-of-memory exceptions. This is why [the quickstart example](/deploy-manage/deploy/cloud-on-k8s/elasticsearch-deployment-quickstart.md) disables `mmap` through the `node.store.allow_mmap: false` setting. For production workloads, it is strongly recommended to increase the kernel setting `vm.max_map_count` to `262144` and leave `node.store.allow_mmap` unset.

The kernel setting `vm.max_map_count=262144` can be set on the host directly, by a dedicated init container which must be privileged, or a dedicated Daemonset.

Expand Down
11 changes: 2 additions & 9 deletions deploy-manage/deploy/elastic-cloud/custom-endpoint-aliases.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,17 +7,10 @@ applies_to:
ess: ga
products:
- id: cloud-hosted
navigation_title: Custom endpoint aliases
---

# Custom endpoint aliases

% What needs to be done: Lift-and-shift

% Use migrated content from existing pages that map to this page:

% - [ ] ./raw-migrated-files/cloud/cloud/ec-regional-deployment-aliases.md
% - [ ] ./raw-migrated-files/cloud/cloud-heroku/ech-regional-deployment-aliases.md

# Configure custom endpoint aliases on {{ech}}

Custom aliases for your deployment endpoints on {{ech}} allow you to have predictable, human-readable URLs that can be shared easily. An alias is unique to only one deployment within a region.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,10 @@ applies_to:
ess: ga
products:
- id: cloud-hosted
navigation_title: Switch from APM to Integrations Server
---

# Switch from APM to Integrations Server payload [ec-integrations-server-apm-switch]
# Switch from APM to Integrations Server payload on {{ech}} [ec-integrations-server-apm-switch]

This example shows how to use the {{ecloud}} RESTful API to switch from using [APM & Fleet Server](#ec-manage-apm-and-fleet) to [Integrations Server](manage-integrations-server.md).

Expand Down
2 changes: 1 addition & 1 deletion deploy-manage/kibana-reporting-configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -229,7 +229,7 @@ These steps apply only to **self-managed deployments**. Orchestrated deployments

To automatically generate reports with {{watcher}}, you must configure {{watcher}} to trust the {{kib}} server certificate.

1. Enable {{stack-security-features}} on your {{es}} cluster. For more information, see [Getting started with security](/deploy-manage/security.md).
1. Enable {{stack-security-features}} on your {{es}} cluster. For more information, see [](/deploy-manage/security.md).
2. Configure TLS/SSL encryption for the {{kib}} server. For more information, see [*Encrypt TLS communications in {{kib}}*](/deploy-manage/security/set-up-basic-security-plus-https.md#encrypt-kibana-http).
3. Specify the {{kib}} server CA certificate chain in [`elasticsearch.yml`](/deploy-manage/stack-settings.md):

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ products:
% this page probably needs to be moved


# Troubleshooting [monitor-troubleshooting]
# Troubleshooting visualizing monitoring data in {{kib}} [monitor-troubleshooting]


Use the information in this section to troubleshoot common problems and find answers for frequently asked questions related to the {{kib}} {{monitor-features}}.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -93,8 +93,8 @@ On the **Stack Monitoring** page, you’ll see cluster alerts that require your
:screenshot:
:::

If you encounter problems, see [Troubleshooting monitoring](../monitoring-data/monitor-troubleshooting.md).
If you encounter problems, refer to [](/deploy-manage/monitor/monitoring-data/monitor-troubleshooting.md).

:::{tip}
If you're using {{ech}} or {{ece}}, then you can also get a direct link to the relevant **Stack Monitoring** page from the deployment's **Logs and metrics** page. [Learn more](/deploy-manage/monitor/stack-monitoring/ece-ech-stack-monitoring.md#access-kibana-monitoring).
::::
:::
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,10 @@ applies_to:
ess:
products:
- id: cloud-hosted
navigation_title: AWS S3
---

# Configure a snapshot repository using AWS S3 [ec-aws-custom-repository]
# Configure an AWS S3 snapshot repository in {{ech}} [ec-aws-custom-repository]

Configure a custom snapshot repository using an S3 storage bucket in your AWS account.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,12 @@ applies_to:
ess:
products:
- id: cloud-hosted
navigation_title: Azure Blob Storage
---

# Configure a snapshot repository using Azure Blob storage [ec-azure-snapshotting]
# Configure an Azure Blob Storage snapshot repository in {{ech}} [ec-azure-snapshotting]

Configure a custom snapshot repository using your Azure Blob storage account.
Configure a custom snapshot repository using your Azure Blob Storage account.


## Prepare a container [ec-prepare-azure-container]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,10 @@ applies_to:
ess:
products:
- id: cloud-hosted
navigation_title: Google Cloud Storage
---

# Configure a snapshot repository using GCS [ec-gcs-snapshotting]
# Configure a GCS snapshot repository in {{ech}}

Configure a custom snapshot repository using your Google Cloud Storage account.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ applies_to:
ece:
---

# Configure a snapshot repository using AWS S3 [ece-aws-custom-repository]
# Configure an AWS S3 snapshot repository in {{ece}} [ece-aws-custom-repository]

To store {{es}} snapshots in AWS S3, you need to configure a snapshot repository in {{ece}} (ECE). This guide explains how to add an Amazon S3 repository using the Cloud UI and provides details on required settings and advanced configurations.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,12 @@ applies_to:
ece:
products:
- id: cloud-enterprise
navigation_title: Google Cloud Storage
---

# Google Cloud Storage (GCS) repository [ece-configure-gcp-snapshotting]
# Configure a Google Cloud Storage snapshot repository in {{ece}}

Snapshots to GCS are supported using an [advanced repository configuration](cloud-enterprise.md) and service account credentials that can administer your GCS bucket.
Snapshots to Google Cloud Storage (GCS) are supported using an [advanced repository configuration](cloud-enterprise.md) and service account credentials that can administer your GCS bucket.

## Set up your service account credentials [ece_set_up_your_service_account_credentials]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ applies_to:
ess:
products:
- id: cloud-hosted
navigation_title: AWS and GCP
---

# Repository isolation on AWS and GCP [ec-snapshot-repository-aws-gcp-migration]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ applies_to:
ess:
products:
- id: cloud-hosted
navigation_title: Azure
---

# Repository isolation on Azure [ec-snapshot-repository-azure-migration]
Expand Down
3 changes: 2 additions & 1 deletion deploy-manage/upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,10 @@ products:
- id: cloud-hosted
- id: cloud-kubernetes
- id: elasticsearch
navigation_title: Upgrade
---

# Upgrade
# Upgrade your deployment, cluster, or orchestrator

Upgrading to the latest version provides access to the newest Elastic features, security patches, performance improvements, and bug fixes. These updates reduce costs, speed up threat response, and improve investigative and analytical data tools.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ $$$built-in-roles-kibana-dashboard$$$ `kibana_dashboard_only_user`
: (This role is deprecated, use [{{kib}} feature privileges](../../../deploy-manage/users-roles/cluster-or-deployment-auth/kibana-privileges.md#kibana-feature-privileges) instead). Grants read-only access to the {{kib}} Dashboard in every [space in {{kib}}](/deploy-manage/manage-spaces.md). This role does not have access to editing tools in {{kib}}.

$$$built-in-roles-kibana-system$$$ `kibana_system`
: Grants access necessary for the {{kib}} system user to read from and write to the {{kib}} indices, manage index templates and tokens, and check the availability of the {{es}} cluster. It also permits activating, searching, and retrieving user profiles, as well as updating user profile data for the `kibana-*` namespace. This role grants read access to the `.monitoring-*` indices and read and write access to the `.reporting-*` indices. For more information, see [Configuring Security in {{kib}}](/deploy-manage/security.md).
: Grants access necessary for the {{kib}} system user to read from and write to the {{kib}} indices, manage index templates and tokens, and check the availability of the {{es}} cluster. It also permits activating, searching, and retrieving user profiles, as well as updating user profile data for the `kibana-*` namespace. This role grants read access to the `.monitoring-*` indices and read and write access to the `.reporting-*` indices.

::::{note}
This role should not be assigned to users as the granted permissions may change between releases.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -52,7 +52,7 @@ spec:

## Rotate auto-generated credentials [k8s-rotate-credentials]

You can force the auto-generated credentials to be regenerated with new values by deleting the appropriate Secret. For example, to change the password for the `elastic` user from the [quickstart example](../../../deploy-manage/deploy/cloud-on-k8s/deploy-an-orchestrator.md), use the following command:
You can force the auto-generated credentials to be regenerated with new values by deleting the appropriate Secret. For example, to change the password for the `elastic` user from the [quickstart example](/deploy-manage/deploy/cloud-on-k8s/elasticsearch-deployment-quickstart.md), use the following command:

```sh
kubectl delete secret quickstart-es-elastic-user
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ You can also [convert an index alias to a data stream](#convert-index-alias-to-d
::::{important}
If you use {{fleet}}, {{agent}}, or {{ls}}, skip this tutorial. They all set up data streams for you.

For {{fleet}} and {{agent}}, check out this [data streams documentation](/reference/fleet/data-streams.md). For {{ls}}, check out the [data streams settings](logstash-docs-md://lsr/plugins-outputs-elasticsearch.md#plugins-outputs-elasticsearch-data_stream) for the `elasticsearch output` plugin.
For {{fleet}} and {{agent}}, refer to [](/reference/fleet/data-streams.md). For {{ls}}, refer to the [data streams settings](logstash-docs-md://lsr/plugins-outputs-elasticsearch.md#plugins-outputs-elasticsearch-data_stream) for the `elasticsearch output` plugin.

::::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -85,9 +85,9 @@ The `found-snapshots` repository is specific to your cluster. To use another clu

You can also use any of the following custom repository types with {{search-snaps}}:

* [Google Cloud Storage (GCS)](../deploy-manage/tools/snapshot-and-restore/ec-gcs-snapshotting.md)
* [Azure Blob Storage](../deploy-manage/tools/snapshot-and-restore/ec-azure-snapshotting.md)
* [Amazon Web Services (AWS)](../deploy-manage/tools/snapshot-and-restore/ec-aws-custom-repository.md)
* [Google Cloud Storage (GCS)](/deploy-manage/tools/snapshot-and-restore/ec-gcs-snapshotting.md)
* [Azure Blob Storage](/deploy-manage/tools/snapshot-and-restore/ec-azure-snapshotting.md)
* [Amazon Web Services (AWS)](/deploy-manage/tools/snapshot-and-restore/ec-aws-custom-repository.md)
::::::

::::::{tab-item} Self-managed
Expand Down
3 changes: 2 additions & 1 deletion reference/fleet/data-streams.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,10 @@ mapped_pages:
products:
- id: fleet
- id: elastic-agent
navigation_title: Data streams
---

# Data streams [data-streams]
# Agent-created data streams [data-streams]

{{agent}} uses data streams to store time series data across multiple indices while giving you a single named resource for requests. Data streams are well-suited for logs, metrics, traces, and other continuously generated data. They offer a host of benefits over other indexing strategies:

Expand Down
Loading