From 43e3c089a122d7fc0472a19d97685e2176a21c36 Mon Sep 17 00:00:00 2001
From: Marci W <333176+marciw@users.noreply.github.com>
Date: Thu, 20 Feb 2025 08:18:16 -0500
Subject: [PATCH 01/13] Add Troubleshooting entry point (#524)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
[Preview](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/524/troubleshoot/)
Apply the new [troubleshooting entry point content
type](https://github.com/elastic/docs-projects/issues/408) and confirm
Asciidoc content is covered. More improvements to come
huge thanks to @shainaraskas for making this so easy ✨
---
.../get-support-help.md | 49 -----------
.../troubleshooting-and-faqs.md | 71 ----------------
raw-migrated-files/toc.yml | 2 -
troubleshoot/index.md | 85 +++++++++++++------
.../observability/amazon-data-firehose.md | 2 +-
5 files changed, 59 insertions(+), 150 deletions(-)
delete mode 100644 raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/get-support-help.md
delete mode 100644 raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/troubleshooting-and-faqs.md
diff --git a/raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/get-support-help.md b/raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/get-support-help.md
deleted file mode 100644
index 70825cdd6..000000000
--- a/raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/get-support-help.md
+++ /dev/null
@@ -1,49 +0,0 @@
-# Getting help [get-support-help]
-
-With your Elastic subscription, you get access to support from the creators of Elasticsearch, Kibana, Beats, Logstash, and much more. We’re here to help!
-
-::::{note}
-For users without an active subscription, visit the [Elastic community forums](https://discuss.elastic.co/) and get answers from the experts in the community, including people from Elastic.
-
-::::
-
-
-
-## How do I open a support case? [_how_do_i_open_a_support_case]
-
-There are three ways you can reach out to get support:
-
-* **From the Support Portal: [http://support.elastic.co](http://support.elastic.co.) The Elastic Support Portal is the central place where you can access all of your cases, subscriptions, and licenses. Within a few hours after subscribing, you receive an email with instructions on how to log in to the Support Portal, where you can track both current and archived cases.
-
- ::::{note}
- If you just signed up for a trial, you do not get access to the Support Portal until you subscribe. Instead, you can ask for help using the other methods detailed in this document.
- ::::
-
-* **From the {{ecloud}} Console.** Go to the [Support page](https://cloud.elastic.co/support?page=docs&placement=docs-body) or select the support icon, that looks like a life preserver, on any page in the console.
-* **By email: `support@elastic.co`**. If you contact us by email, please use the email address that you registered with, so that we can help you more quickly. If you are using a distribution list as your registered email, you can also register a second email address with us. Just open a case to let us know the name and email address you would like to be added.
-
-When opening a case, there are a few things you can do to get help faster:
-
-* Include the deployment ID that you want help with, especially if you have several deployments. You can find the deployment ID on the overview page for your cluster in the {{ecloud}} Console.
-* Describe the problem. Include any relevant details, including error messages you encountered, dates and times when the problem occurred, or anything else you think might be helpful.
-* Upload any pertinent files.
-
-
-## What level of support can I expect? [_what_level_of_support_can_i_expect]
-
-Support is governed by the [{{ecloud}} Standard Terms of Service](https://www.elastic.co/legal/terms-of-service/cloud). The level of support you can expect to receive depends on your subscription level:
-
-Standard subscriptions and active trials
-: The main focus of support is to ensure your deployment shows a green status and is available. There is no guaranteed initial or ongoing response time, but we do strive to engage on every issue within three business days. We do not offer weekend coverage, so we respond Monday through Friday only. To learn more, check [Working with {{ecloud}} Support](https://www.elastic.co/support/welcome/cloud).
-
-Gold, Platinum and Enterprise subscriptions
-: These subscription levels provide guaranteed response times for support issues, better support coverage hours, and support contacts at Elastic. It also includes support for how-to and development questions. The exact support coverage depends on your subscription level. To learn more, check [Premium Support Services Policy](https://www.elastic.co/legal/support_policy/cloud_premium).
-
-If you are on a Standard subscription, and you are interested in upgrading your support level, please [contact us](https://www.elastic.co/cloud/contact). We also recommend that you read our best practices guide for getting the most out of your support experience: [https://www.elastic.co/support/welcome](https://www.elastic.co/support/welcome).
-
-
-## Join the community forums [_join_the_community_forums]
-
-Elasticsearch, Logstash, and Kibana enjoy the benefit of having vibrant and helpful communities. You have our assurance of high-quality support and single source of truth as an {{ecloud}} user, but the Elastic community can also be a useful resource for you whenever you need it.
-
-If you have any technical questions that are not for our Support team, hop on our [Elastic community forums](https://discuss.elastic.co/) and get answers from the experts in the community, including people from Elastic.
diff --git a/raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/troubleshooting-and-faqs.md b/raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/troubleshooting-and-faqs.md
deleted file mode 100644
index 7cc8f381b..000000000
--- a/raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/troubleshooting-and-faqs.md
+++ /dev/null
@@ -1,71 +0,0 @@
-# Troubleshooting and FAQs [troubleshooting-and-faqs]
-
-Throughout the Elastic docs we have a number of troubleshooting and frequently asked questions (FAQ) pages to help you address problems and find answers about how to use our products.
-
-**{{stack}}**
-
-* [Troubleshooting {{ml}} anomaly detection](../../../explore-analyze/machine-learning/anomaly-detection/ml-ad-troubleshooting.md)
-* [Azure Marketplace and Resource Manager (ARM) template troubleshooting](https://www.elastic.co/guide/en/elastic-stack-deploy/current/azure-arm-template-troubleshooting.html)
-* [{{es}} for Apache Hadoop troubleshooting](../../../troubleshoot/elasticsearch/elasticsearch-hadoop/elasticsearch-for-apache-hadoop.md)
-* [Azure Marketplace and Resource Manager (ARM) template FAQ](https://www.elastic.co/guide/en/elastic-stack-deploy/current/azure-marketplace-faq.html)
-* [Troubleshooting {{alert-features}}](../../../troubleshoot/kibana/alerts.md)
-
-**{{es}}**
-
-* [{{es}} troubleshooting](../../../troubleshoot/elasticsearch/elasticsearch.md)
-* [Troubleshooting index lifecycle management errors](../../../troubleshoot/elasticsearch/index-lifecycle-management-errors.md)
-
-**{{ecloud}}**
-
-* [Sign up using an email address from another Elastic Cloud account](../../../deploy-manage/deploy/elastic-cloud/create-an-organization.md)
-* [{{ess}} AWS Marketplace troubleshooting](../../../deploy-manage/deploy/elastic-cloud/aws-marketplace.md#ec-billing-aws-troubleshooting)
-* [Native Azure integration troubleshooting](../../../deploy-manage/deploy/elastic-cloud/azure-native-isv-service.md#ec-azure-integration-troubleshooting)
-* [{{ece}} troubleshooting](https://www.elastic.co/guide/en/cloud-enterprise/current/ece-troubleshooting.html)
-* [Understanding deployment health FAQ](../../../deploy-manage/monitor/stack-monitoring.md#ec-health-best-practices)
-* [{{ess}} FAQ](../../../deploy-manage/deploy/elastic-cloud/cloud-hosted.md)
-* [{{ess}} billing FAQ](../../../deploy-manage/cloud-organization/billing/billing-faq.md)
-* [{{ess}} technical FAQ](../../../deploy-manage/index.md)
-* [Native Azure integration FAQ](../../../deploy-manage/deploy/elastic-cloud/azure-native-isv-service.md)
-
-**{{kib}}**
-
-* [Kibana troubleshooting](../../../troubleshoot/kibana.md)
-* [Osquery FAQ](../../../solutions/security/investigate/osquery-faq.md)
-
-**{{observability}}**
-
-* [Observability troubleshooting](../../../troubleshoot/observability.md)
-* [APM troubleshooting](/troubleshoot/observability/apm.md)
-* [{{apm-go-agent}} troubleshooting](../../../troubleshoot/observability/apm-agent-go/apm-go-agent.md)
-* [{{apm-ios-agent}} troubleshooting](../../../troubleshoot/observability/apm-agent-swift/apm-ios-agent.md)
-* [{{apm-java-agent}} troubleshooting](../../../troubleshoot/observability/apm-agent-java/apm-java-agent.md)
-* [{{apm-dotnet-agent}} troubleshooting](../../../troubleshoot/observability/apm-agent-dotnet/apm-net-agent.md)
-* [{{apm-node-agent}} troubleshooting](../../../troubleshoot/observability/apm-agent-nodejs/apm-nodejs-agent.md)
-* [{{apm-php-agent}} troubleshooting](../../../troubleshoot/observability/apm-agent-php/apm-php-agent.md)
-* [{{apm-py-agent}} troubleshooting](../../../troubleshoot/observability/apm-agent-python/apm-python-agent.md)
-* [{{apm-ruby-agent}} troubleshooting](../../../troubleshoot/observability/apm-agent-ruby/apm-ruby-agent.md)
-* [{{apm-rum-agent}} troubleshooting](../../../troubleshoot/observability/apm-agent-rum-js/apm-real-user-monitoring-javascript-agent.md)
-
-**{{elastic-sec}}**
-
-* [Troubleshoot missing alerts](../../../troubleshoot/security/detection-rules.md#troubleshoot-signals)
-
-**{{ls}}**
-
-* [{{ls}} troubleshooting](../../../troubleshoot/ingest/logstash.md)
-
-**{{fleet}} and {{agent}}**
-
-* [{{fleet}} and {{agent}} troubleshooting](../../../troubleshoot/ingest/fleet/fleet-elastic-agent.md)
-* [{{fleet}} and {{agent}} FAQ](../../../troubleshoot/ingest/fleet/frequently-asked-questions.md)
-
-**{{beats}}**
-
-* [{{auditbeat}} troubleshooting](https://www.elastic.co/guide/en/beats/auditbeat/current/troubleshooting.html)
-* [{{filebeat}} troubleshooting](https://www.elastic.co/guide/en/beats/filebeat/current/troubleshooting.html)
-* [{{heartbeat}} troubleshooting](https://www.elastic.co/guide/en/beats/heartbeat/current/troubleshooting.html)
-* [{{metricbeat}} troubleshooting](https://www.elastic.co/guide/en/beats/metricbeat/current/troubleshooting.html)
-* [{{packetbeat}} troubleshooting](https://www.elastic.co/guide/en/beats/packetbeat/current/troubleshooting.html)
-* [{{winlogbeat}} troubleshooting](https://www.elastic.co/guide/en/beats/winlogbeat/current/troubleshooting.html)
-* [{{log-driver-long}} troubleshooting](../../../troubleshoot/ingest/beats-loggingplugin/elastic-logging-plugin-for-docker.md)
-* [{{metricbeat}} Developer FAQ](https://www.elastic.co/guide/en/beats/devguide/current/dev-faq.html)
diff --git a/raw-migrated-files/toc.yml b/raw-migrated-files/toc.yml
index f642eae75..1c546b830 100644
--- a/raw-migrated-files/toc.yml
+++ b/raw-migrated-files/toc.yml
@@ -553,5 +553,3 @@ toc:
- file: tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/index.md
children:
- file: tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/get-elastic.md
- - file: tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/get-support-help.md
- - file: tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/troubleshooting-and-faqs.md
diff --git a/troubleshoot/index.md b/troubleshoot/index.md
index c2b18348d..9d728631f 100644
--- a/troubleshoot/index.md
+++ b/troubleshoot/index.md
@@ -6,47 +6,78 @@ mapped_urls:
- https://www.elastic.co/guide/en/cloud/current/ec-get-help.html
---
-# Troubleshoot
+# Troubleshooting
+
+
+% Scope notes: - Match new content type; TOC entry TBD - consider splitting out subsections?
+
+% see https://docs.elastic.dev/content-architecture/content-type/troubleshooting/entrypoint
+
+% TODO pull in product-specific tips etc. from other TS sections
-% What needs to be done: Refine
:::{admonition} WIP
⚠️ **This section is a work in progress.** ⚠️
-The documentation team is actively working on structure, user focus, and more.
+The documentation team is actively working on the pages in this section.
:::
-Use the topics in this section to troubleshoot Elastic products, features, and deployments.
-
+This section contains information about resolving common issues you might encounter with Elastic products, as well as troubleshooting resources and guidance.
-* [](/troubleshoot/elasticsearch/elasticsearch.md)
-* [](/troubleshoot/kibana.md)
-* [](/troubleshoot/observability.md)
-* [](/troubleshoot/security.md)
-* [](/troubleshoot/ingest.md)
-* [](/troubleshoot/deployments/elastic-cloud.md)
-* [](/troubleshoot/deployments/cloud-enterprise/cloud-enterprise.md)
-* [](/troubleshoot/deployments/cloud-on-k8s/kubernetes.md)
+If you can't find your issue here, explore the [additional resources](#troubleshoot-additional-resources) or [contact us](#contact-us).
+:::{note}
+You might need to review the troubleshooting content for more than one product or topic area. In most Elastic deployments, you use multiple components from the [Elastic Stack](/get-started/the-stack.md), plus software to orchestrate your deployment. Because these components communicate with each other, you might see errors in one product that originate from another part of the stack, or from your deployment infrastructure.
+:::
-## Contact us [contact-us]
+* [{{es}}](/troubleshoot/elasticsearch/elasticsearch.md)
+* [{{kib}}](/troubleshoot/kibana.md)
+* [Elastic {{observability}}](/troubleshoot/observability.md)
+* [{{elastic-sec}}](/troubleshoot/security.md)
+* [Ingest tools](/troubleshoot/ingest.md)
+* [{{ecloud}}](/troubleshoot/deployments/elastic-cloud.md)
+* [{{ece}}](/troubleshoot/deployments/cloud-enterprise/cloud-enterprise.md)
+* [{{eck}}](/troubleshoot/deployments/cloud-on-k8s/kubernetes.md)
-:::{warning}
+## Error reference
+:::{admonition} WIP
Work in progress
:::
-% Scope notes: - Match new content type; TOC entry TBD - consider splitting out subsections?
+## Additional resources [troubleshoot-additional-resources]
-% Use migrated content from existing pages that map to this page:
+* Find additional troubleshooting articles in the [Elastic Support Portal](https://support.elastic.co/).
-% - [ ] ./raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/get-support-help.md
-% - [ ] ./raw-migrated-files/tech-content/starting-with-the-elasticsearch-platform-and-its-solutions/troubleshooting-and-faqs.md
-% - next one added by marciw manually for tracking
-% - [ ] ./raw-migrated-files/cloud/cloud/ec-get-help.md (especially IDs -- no generated list because page was incorrectly mapped to a new v3 page instead of as a many-to-one for this page)
+ You can access the Support Portal using your {{ecloud}} account. {{ecloud}} accounts are free and do not require an active subscription.
-% WIP sections added by marciw
-% see https://docs.elastic.dev/content-architecture/content-type/troubleshooting/entrypoint
-% ## one for each grouping
-% ## Additional resources [troubleshoot-additional-resources]
-% ## Contact us [troubleshoot-contact-us]
-% ### Working with support
\ No newline at end of file
+* Visit the [Elastic community forums](https://discuss.elastic.co) to get answers from experts in the community, including Elastic team members.
+
+* Use the top search bar to search all our docs for your issue. Some troubleshooting content is contained in other sections of the Elastic documentation.
+
+
+## Contact us [contact-us]
+
+If you have an [Elastic subscription](https://www.elastic.co/pricing), you can contact Elastic support for assistance. You can reach us in the following ways:
+
+* **Through the [Elastic Support Portal](https://support.elastic.co/):** The Elastic Support Portal is the central place where you can access all of your cases, subscriptions, and licenses. Within a few hours after subscribing, you receive an email with instructions on how to log in to the Support Portal, where you can track both current and archived cases.
+
+ You can access the portal [directly](https://support.elastic.co/) or by clicking the life preserver icon on any Elastic Cloud page.
+
+
+* **By email:** [support@elastic.co](mailto:support@elastic.co)
+
+ :::{tip}
+ If you contact us by email, use the email address you registered with so we can help you more quickly. If you are using a distribution list as your registered email, you can also register a second email address with us. Just open a case to let us know the name and email address you want to add.
+ :::
+
+## Working with support [troubleshoot-work-with-support]
+
+Try these tips when opening a support case:
+
+* Include the deployment ID that you want help with, especially if you have several deployments.
+
+ You can find the deployment ID on the overview page for your cluster in the {{ecloud}} Console.
+
+* Describe the problem. Include any relevant details, including error messages you encountered, dates and times when the problem occurred, or anything else you think might be helpful.
+
+* Upload any pertinent files.
diff --git a/troubleshoot/observability/amazon-data-firehose.md b/troubleshoot/observability/amazon-data-firehose.md
index aa42d9e3d..1a5430c62 100644
--- a/troubleshoot/observability/amazon-data-firehose.md
+++ b/troubleshoot/observability/amazon-data-firehose.md
@@ -23,5 +23,5 @@ There are several facets to optimizing the underlying Elasticsearch performance,
## Support [aws-firehose-troubleshooting-support]
-If you encounter further problems, please contact [Elastic support](https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current/get-support-help.html).
+If you encounter further problems, please [contact us]](/troubleshoot/index.md#contact-us).
From c5cd76cf26460d083559bee70c04611c1dea8d35 Mon Sep 17 00:00:00 2001
From: natasha-moore-elastic
<137783811+natasha-moore-elastic@users.noreply.github.com>
Date: Thu, 20 Feb 2025 14:25:27 +0000
Subject: [PATCH 02/13] Security overview cleanup (#527)
Adds content to the Solutions and use cases > Security page.
Removes raw migrated files since they're not used elsewhere.
Preview:
[Security](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/527/solutions/security)
---
.../serverless/security-overview.md | 35 ----------------
.../security-docs/security/es-overview.md | 37 -----------------
raw-migrated-files/toc.yml | 3 --
solutions/security.md | 40 ++++++++++++++++---
4 files changed, 35 insertions(+), 80 deletions(-)
delete mode 100644 raw-migrated-files/docs-content/serverless/security-overview.md
delete mode 100644 raw-migrated-files/security-docs/security/es-overview.md
diff --git a/raw-migrated-files/docs-content/serverless/security-overview.md b/raw-migrated-files/docs-content/serverless/security-overview.md
deleted file mode 100644
index b10f90c4f..000000000
--- a/raw-migrated-files/docs-content/serverless/security-overview.md
+++ /dev/null
@@ -1,35 +0,0 @@
-# {{elastic-sec}} overview [security-overview]
-
-{{elastic-sec}} combines threat detection analytics, cloud native security, and endpoint protection capabilities in a single solution, so you can quickly detect, investigate, and respond to threats and vulnerabilities across your environment.
-
-{{elastic-sec}} provides:
-
-* A detection engine that identifies a wide range of threats
-* A workspace for event triage, investigation, and case management
-* Interactive data visualization tools
-* Integrations for collecting data from various sources
-
-
-## Learn more [siem-integration]
-
-* [{{elastic-sec}} UI overview](../../../solutions/security/get-started/elastic-security-ui.md): Navigate {{elastic-sec}}'s various tools and interfaces.
-* [Detection rules](../../../solutions/security/detect-and-alert/about-detection-rules.md): Use {{elastic-sec}}'s detection engine with custom and prebuilt rules.
-* [Cloud security](../../../solutions/security/cloud.md): Enable cloud native security capabilities such as Cloud and Kubernetes security posture management, cloud vulnerability management, and cloud workload protection for Kubernetes and VMs.
-* [Install {{elastic-defend}}](../../../solutions/security/configure-elastic-defend/install-elastic-defend.md): Enable key endpoint protection capabilities like event collection and malicious activity prevention.
-* [{{ml-cap}}](https://www.elastic.co/products/stack/machine-learning): Enable built-in {{ml}} tools to help you identify malicious behavior.
-* [Advanced entity analytics](../../../solutions/security/advanced-entity-analytics.md): Leverage {{elastic-sec}}'s detection engine and {{ml}} capabilities to generate comprehensive risk analytics for hosts and users.
-* [Elastic AI Assistant](../../../solutions/security/ai/ai-assistant.md): Ask AI Assistant questions about how to use {{elastic-sec}}, how to understand particular alerts and other documents, and how to write {{esql}} queries.
-
-
-## {{es}} and {{kib}} [elastic-search-and-kibana]
-
-{{elastic-sec}} uses {{es}} for data storage, management, and search, and {{kib}} is its main user interface. Learn more:
-
-* [{{es}}](https://www.elastic.co/products/elasticsearch): A real-time, distributed storage, search, and analytics engine. {{elastic-sec}} stores your data using {{es}}.
-* [{{kib}}](https://www.elastic.co/products/kibana): An open-source analytics and visualization platform designed to work with {{es}} and {{elastic-sec}}. {{kib}} allows you to search, view, analyze and visualize data stored in {{es}} indices.
-
-
-### {{elastic-endpoint}} self-protection [self-protection]
-
-For information about {{elastic-endpoint}}'s tamper-protection features, refer to [{{elastic-endpoint}} self-protection features](../../../solutions/security/manage-elastic-defend/elastic-endpoint-self-protection-features.md).
-
diff --git a/raw-migrated-files/security-docs/security/es-overview.md b/raw-migrated-files/security-docs/security/es-overview.md
deleted file mode 100644
index 7ac85dd21..000000000
--- a/raw-migrated-files/security-docs/security/es-overview.md
+++ /dev/null
@@ -1,37 +0,0 @@
-# {{elastic-sec}} overview [es-overview]
-
-{{elastic-sec}} combines threat detection analytics, cloud native security, and endpoint protection capabilities in a single solution, so you can quickly detect, investigate, and respond to threats and vulnerabilities across your environment.
-
-{{elastic-sec}} provides:
-
-* A detection engine that identifies a wide range of threats
-* A workspace for event triage, investigation, and case management
-* Interactive data visualization tools
-* Integrations for collecting data from various sources
-
-
-## Learn more [siem-integration]
-
-* [Get started](../../../solutions/security/get-started.md): Learn about system requirements, workspaces, configuration, and data ingestion.
-* [{{elastic-sec}} UI overview](../../../solutions/security/get-started/elastic-security-ui.md): Navigate {{elastic-sec}}'s various tools and interfaces.
-* [Detection rules](../../../solutions/security/detect-and-alert/about-detection-rules.md): Use {{elastic-sec}}'s detection engine with custom and prebuilt rules.
-* [Cloud security](../../../solutions/security/cloud.md): Enable cloud native security capabilities such as Cloud and Kubernetes security posture management, cloud native vulnerability management, and cloud workload protection for Kubernetes and VMs.
-* [Install {{elastic-defend}}](../../../solutions/security/configure-elastic-defend/install-elastic-defend.md): Enable key endpoint protection capabilities like event collection and malicious activity prevention.
-* [{{ml-cap}}](https://www.elastic.co/products/stack/machine-learning): Enable built-in {{ml}} tools to help you identify malicious behavior.
-* [Advanced entity analytics](../../../solutions/security/advanced-entity-analytics.md): Leverage {{elastic-sec}}'s detection engine and {{ml}} capabilities to generate comprehensive risk analytics for hosts and users.
-* [Elastic AI assistant](../../../solutions/security/ai/ai-assistant.md): Ask AI Assistant questions about how to use {{elastic-sec}}, how to understand particular alerts and other documents, and how to write {{esql}} queries.
-* [{{elastic-sec}} fields and object schemas](https://www.elastic.co/guide/en/security/current/security-ref-intro.html): Learn how to structure data for use with {{elastic-sec}}.
-
-
-## {{es}} and {{kib}} [elastic-search-and-kibana]
-
-{{elastic-sec}} uses {{es}} for data storage, management, and search, and {{kib}} is its main user interface. Learn more:
-
-* [{{es}}](https://www.elastic.co/products/elasticsearch): A real-time, distributed storage, search, and analytics engine. {{elastic-sec}} stores your data using {{es}}.
-* [{{kib}}](https://www.elastic.co/products/kibana): An open-source analytics and visualization platform designed to work with {{es}} and {{elastic-sec}}. {{kib}} allows you to search, view, analyze and visualize data stored in {{es}} indices.
-
-
-### Elastic Endpoint self-protection [self-protection]
-
-For information about {{elastic-endpoint}}'s tamper-protection features, refer to [{{elastic-endpoint}} self-protection](../../../solutions/security/manage-elastic-defend/elastic-endpoint-self-protection-features.md).
-
diff --git a/raw-migrated-files/toc.yml b/raw-migrated-files/toc.yml
index 1c546b830..3e71b4e3e 100644
--- a/raw-migrated-files/toc.yml
+++ b/raw-migrated-files/toc.yml
@@ -338,7 +338,6 @@ toc:
- file: docs-content/serverless/security-osquery-placeholder-fields.md
- file: docs-content/serverless/security-osquery-response-action.md
- file: docs-content/serverless/security-overview-dashboard.md
- - file: docs-content/serverless/security-overview.md
- file: docs-content/serverless/security-policies-page.md
- file: docs-content/serverless/security-posture-faq.md
- file: docs-content/serverless/security-posture-management.md
@@ -537,8 +536,6 @@ toc:
- file: observability-docs/observability/view-infrastructure-metrics.md
- file: observability-docs/observability/view-observability-alerts.md
- file: security-docs/security/index.md
- children:
- - file: security-docs/security/es-overview.md
- file: stack-docs/elastic-stack/index.md
children:
- file: stack-docs/elastic-stack/air-gapped-install.md
diff --git a/solutions/security.md b/solutions/security.md
index c1760244f..022ccc414 100644
--- a/solutions/security.md
+++ b/solutions/security.md
@@ -1,14 +1,44 @@
---
+navigation_title: "Security"
mapped_urls:
- https://www.elastic.co/guide/en/security/current/es-overview.html
- https://www.elastic.co/guide/en/serverless/current/security-overview.html
---
-# Security
+# {{elastic-sec}} overview [es-overview]
-% What needs to be done: Align serverless/stateful
+{{elastic-sec}} combines threat detection analytics, cloud native security, and endpoint protection capabilities in a single solution, so you can quickly detect, investigate, and respond to threats and vulnerabilities across your environment.
-% Use migrated content from existing pages that map to this page:
+{{elastic-sec}} provides:
+
+* A detection engine that identifies a wide range of threats
+* A workspace for event triage, investigation, and case management
+* Interactive data visualization tools
+* Integrations for collecting data from various sources
+
+
+## Learn more [siem-integration]
+
+* [Get started](security/get-started.md): Learn about system requirements, workspaces, configuration, and data ingestion.
+* [{{elastic-sec}} UI overview](security/get-started/elastic-security-ui.md): Navigate {{elastic-sec}}'s various tools and interfaces.
+* [Detection rules](security/detect-and-alert/about-detection-rules.md): Use {{elastic-sec}}'s detection engine with custom and prebuilt rules.
+* [Cloud security](security/cloud.md): Enable cloud native security capabilities such as Cloud and Kubernetes security posture management, cloud native vulnerability management, and cloud workload protection for Kubernetes and VMs.
+* [Install {{elastic-defend}}](security/configure-elastic-defend/install-elastic-defend.md): Enable key endpoint protection capabilities like event collection and malicious activity prevention.
+* [{{ml-cap}}](https://www.elastic.co/products/stack/machine-learning): Enable built-in {{ml}} tools to help you identify malicious behavior.
+* [Advanced entity analytics](security/advanced-entity-analytics.md): Leverage {{elastic-sec}}'s detection engine and {{ml}} capabilities to generate comprehensive risk analytics for hosts and users.
+* [Elastic AI assistant](security/ai/ai-assistant.md): Ask AI Assistant questions about how to use {{elastic-sec}}, how to understand particular alerts and other documents, and how to write {{esql}} queries.
+* [{{elastic-sec}} fields and object schemas](https://www.elastic.co/guide/en/security/current/security-ref-intro.html): Learn how to structure data for use with {{elastic-sec}}.
+
+
+## {{es}} and {{kib}} [elastic-search-and-kibana]
+
+{{elastic-sec}} uses {{es}} for data storage, management, and search, and {{kib}} is its main user interface. Learn more:
+
+* [{{es}}](https://www.elastic.co/products/elasticsearch): A real-time, distributed storage, search, and analytics engine. {{elastic-sec}} stores your data using {{es}}.
+* [{{kib}}](https://www.elastic.co/products/kibana): An open-source analytics and visualization platform designed to work with {{es}} and {{elastic-sec}}. {{kib}} allows you to search, view, analyze and visualize data stored in {{es}} indices.
+
+
+### {{elastic-endpoint}} self-protection [self-protection]
+
+For information about {{elastic-endpoint}}'s tamper-protection features, refer to [{{elastic-endpoint}} self-protection](security/manage-elastic-defend/elastic-endpoint-self-protection-features.md).
-% - [ ] ./raw-migrated-files/security-docs/security/es-overview.md
-% - [ ] ./raw-migrated-files/docs-content/serverless/security-overview.md
\ No newline at end of file
From 14f936a27605228c5875ef38f6ac61529a641250 Mon Sep 17 00:00:00 2001
From: natasha-moore-elastic
<137783811+natasha-moore-elastic@users.noreply.github.com>
Date: Thu, 20 Feb 2025 14:29:09 +0000
Subject: [PATCH 03/13] Remove unneeded version labels (#531)
Per [Versions and lifecycle
states](https://docs-v3-preview.elastic.dev/elastic/docs-builder/tree/main/versions/#versions-and-lifecycle-states)
guidance,
> "Add version labels only when a feature was added as part of the major
version release (e.g. 9.0.0), or added in subsequent minor releases
(e.g. 9.1.0). Do not add version information to features added before
these releases."
This PR removes unnecessary version labels in Solutions and use cases >
Security and Troubleshoot > Observability sections.
### Previews
Security
- [Hosts
page](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/531/solutions/security/explore/hosts-page)
- [Network
page](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/531/solutions/security/explore/network-page)
- [Configure network map
data](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/531/solutions/security/explore/configure-network-map-data)
- [Users
page](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/531/solutions/security/explore/users-page)
- [Indicators of
compromise](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/531/solutions/security/investigate/indicators-of-compromise)
Troubleshoot
-
[Logs](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/531/troubleshoot/observability/troubleshoot-logs)
-
[Synthetics](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/531/troubleshoot/observability/troubleshooting-synthetics)
---
solutions/security/explore/configure-network-map-data.md | 2 +-
solutions/security/explore/hosts-page.md | 2 +-
solutions/security/explore/network-page.md | 2 +-
solutions/security/explore/users-page.md | 2 +-
solutions/security/investigate/indicators-of-compromise.md | 2 +-
troubleshoot/observability/troubleshoot-logs.md | 2 +-
troubleshoot/observability/troubleshooting-synthetics.md | 4 ++--
7 files changed, 8 insertions(+), 8 deletions(-)
diff --git a/solutions/security/explore/configure-network-map-data.md b/solutions/security/explore/configure-network-map-data.md
index 990c057c8..703807ed8 100644
--- a/solutions/security/explore/configure-network-map-data.md
+++ b/solutions/security/explore/configure-network-map-data.md
@@ -21,7 +21,7 @@ To see source and destination connections lines on the map, you must configure `
## Permissions required [prereq-perms]
-To view the map in {{stack}} 9.0.0+, you need a role with at least `Read` [privileges](/deploy-manage/users-roles/cluster-or-deployment-auth/defining-roles.md#adding_kibana_privileges) for the `Maps` feature. In serverless, you need the appropriate [predefined user role](/deploy-manage/users-roles/cloud-organization/user-roles.md#general-assign-user-roles) or a [custom role](/deploy-manage/users-roles/cloud-organization/user-roles.md) with at least `Read` privileges for the `Maps` feature.
+To view the map in {{stack}}, you need a role with at least `Read` [privileges](/deploy-manage/users-roles/cluster-or-deployment-auth/defining-roles.md#adding_kibana_privileges) for the `Maps` feature. In serverless, you need the appropriate [predefined user role](/deploy-manage/users-roles/cloud-organization/user-roles.md#general-assign-user-roles) or a [custom role](/deploy-manage/users-roles/cloud-organization/user-roles.md) with at least `Read` privileges for the `Maps` feature.
## Create {{kib}} data views [kibana-index-pattern]
diff --git a/solutions/security/explore/hosts-page.md b/solutions/security/explore/hosts-page.md
index 36bf8f52e..c9fe35a14 100644
--- a/solutions/security/explore/hosts-page.md
+++ b/solutions/security/explore/hosts-page.md
@@ -34,7 +34,7 @@ Beneath the KPI charts are data tables, categorized by individual tabs, which ar
* **All hosts**: High-level host details.
* **Uncommon processes**: Uncommon processes running on hosts.
* **Anomalies**: Anomalies discovered by machine learning jobs.
-* **Host risk**: The latest recorded host risk score for each host, and its host risk classification. In {{stack}} 9.0.0+, this feature requires a [Platinum subscription](https://www.elastic.co/pricing) or higher. In serverless, this feature requires the Security Analytics Complete [project feature](/deploy-manage/deploy/elastic-cloud/project-settings.md). Click **Enable** on the **Host risk** tab to get started. To learn more, refer to our [entity risk scoring documentation](/solutions/security/advanced-entity-analytics/entity-risk-scoring.md).
+* **Host risk**: The latest recorded host risk score for each host, and its host risk classification. In {{stack}}, this feature requires a [Platinum subscription](https://www.elastic.co/pricing) or higher. In serverless, this feature requires the Security Analytics Complete [project feature](/deploy-manage/deploy/elastic-cloud/project-settings.md). Click **Enable** on the **Host risk** tab to get started. To learn more, refer to our [entity risk scoring documentation](/solutions/security/advanced-entity-analytics/entity-risk-scoring.md).
* **Sessions**: Linux process events that you can open in [Session View](/solutions/security/investigate/session-view.md), an investigation tool that allows you to examine Linux process data at a hierarchal level.
The tables within the **Events** and **Sessions** tabs include inline actions and several customization options. To learn more about what you can do with the data in these tables, refer to [*Manage detection alerts*](/solutions/security/detect-and-alert/manage-detection-alerts.md).
diff --git a/solutions/security/explore/network-page.md b/solutions/security/explore/network-page.md
index 3b30337d8..892f2c1eb 100644
--- a/solutions/security/explore/network-page.md
+++ b/solutions/security/explore/network-page.md
@@ -19,7 +19,7 @@ The Network page provides key network activity metrics in an interactive map, an
The map provides an interactive visual overview of your network traffic. Hover over source and destination points to show more information, such as host names and IP addresses.
::::{note}
-To access the interactive map in {{stack}} 9.0.0+, you need either `Read` or `All` privileges for `Maps` (**Kibana Privileges** → **Analytics** → **Maps**). In serverless, you must have the appropriate user role. To learn more about map setup, refer to [Configure network map data](/solutions/security/explore/configure-network-map-data.md).
+To access the interactive map in {{stack}}, you need either `Read` or `All` privileges for `Maps` (**Kibana Privileges** → **Analytics** → **Maps**). In serverless, you must have the appropriate user role. To learn more about map setup, refer to [Configure network map data](/solutions/security/explore/configure-network-map-data.md).
::::
diff --git a/solutions/security/explore/users-page.md b/solutions/security/explore/users-page.md
index 02cd41285..c910a4952 100644
--- a/solutions/security/explore/users-page.md
+++ b/solutions/security/explore/users-page.md
@@ -34,7 +34,7 @@ Beneath the KPI charts are data tables, which are useful for viewing and investi
* **All users**: A chronological list of unique user names, when they were last active, and the associated domains.
* **Authentications**: A chronological list of user authentication events and associated details, such as the number of successes and failures, and the host name of the last successful destination.
* **Anomalies**: Unusual activity discovered by machine learning jobs that contain user data.
-* **User risk**: The latest recorded user risk score for each user, and its user risk classification. In {{stack}} 9.0.0+, this feature requires a [Platinum subscription](https://www.elastic.co/pricing) or higher. In serverless, this feature requires the Security Analytics Complete [project feature](/deploy-manage/deploy/elastic-cloud/project-settings.md). Click **Enable** on the **User risk** tab to get started. To learn more, refer to our [entity risk scoring documentation](/solutions/security/advanced-entity-analytics/entity-risk-scoring.md).
+* **User risk**: The latest recorded user risk score for each user, and its user risk classification. In {{stack}}, this feature requires a [Platinum subscription](https://www.elastic.co/pricing) or higher. In serverless, this feature requires the Security Analytics Complete [project feature](/deploy-manage/deploy/elastic-cloud/project-settings.md). Click **Enable** on the **User risk** tab to get started. To learn more, refer to our [entity risk scoring documentation](/solutions/security/advanced-entity-analytics/entity-risk-scoring.md).
The Events table includes inline actions and several customization options. To learn more about what you can do with the data in these tables, refer to [*Manage detection alerts*](/solutions/security/detect-and-alert/manage-detection-alerts.md).
diff --git a/solutions/security/investigate/indicators-of-compromise.md b/solutions/security/investigate/indicators-of-compromise.md
index c5b2401e8..8fa6f5a49 100644
--- a/solutions/security/investigate/indicators-of-compromise.md
+++ b/solutions/security/investigate/indicators-of-compromise.md
@@ -9,7 +9,7 @@ mapped_urls:
The Indicators page collects data from enabled threat intelligence feeds and provides a centralized view of indicators, also known as indicators of compromise (IoCs). This topic helps you set up the Indicators page and explains how to work with IoCs.
::::{admonition} Requirements
-* In {{stack}} 9.0.0+, the Indicators page is an [Enterprise subscription](https://www.elastic.co/pricing) feature.
+* In {{stack}}, the Indicators page is an [Enterprise subscription](https://www.elastic.co/pricing) feature.
* In serverless, the Indicators page requires the Security Analytics Complete [project feature](/deploy-manage/deploy/elastic-cloud/project-settings.md)
* You must have *one* of the following installed on the hosts you want to monitor:
diff --git a/troubleshoot/observability/troubleshoot-logs.md b/troubleshoot/observability/troubleshoot-logs.md
index 533b41a37..be1db17b9 100644
--- a/troubleshoot/observability/troubleshoot-logs.md
+++ b/troubleshoot/observability/troubleshoot-logs.md
@@ -38,7 +38,7 @@ You need to either:
* Get an API key from an administrator and manually add the API to the {{agent}} configuration. See [Configure the {{agent}}](../../raw-migrated-files/docs-content/serverless/observability-stream-log-files.md#observability-stream-log-files-step-3-configure-the-agent) for more on manually updating the configuration and adding the API key.
::::
-::::{tab-item} {{stack}} 9.0.0+
+::::{tab-item} {{stack}}
If you don’t have the required privileges to create an API key, you’ll see the following error message:
```plaintext
diff --git a/troubleshoot/observability/troubleshooting-synthetics.md b/troubleshoot/observability/troubleshooting-synthetics.md
index 367ab2e77..02dd50968 100644
--- a/troubleshoot/observability/troubleshooting-synthetics.md
+++ b/troubleshoot/observability/troubleshooting-synthetics.md
@@ -55,7 +55,7 @@ When creating a {{private-location}}, you have to:
3. [Add a {{private-location}}](/solutions/observability/apps/monitor-resources-on-private-networks.md#synthetics-private-location-add) in the Synthetics UI.
:::
-:::{tab-item} {{stack}} 9.0.0+
+:::{tab-item} {{stack}}
1. [Set up {{fleet-server}} and {{agent}}](/solutions/observability/apps/monitor-resources-on-private-networks.md#synthetics-private-location-fleet-agent).
2. [Connect {{fleet}} to the {{stack}}](/solutions/observability/apps/monitor-resources-on-private-networks.md#synthetics-private-location-connect) and enroll an {{agent}} in {{fleet}}.
3. [Add a {{private-location}}](/solutions/observability/apps/monitor-resources-on-private-networks.md#synthetics-private-location-add) in the {{synthetics-app}}.
@@ -119,7 +119,7 @@ There are a few ways to fix this:
:::
-:::{tab-item} {{stack}} 9.0.0+
+:::{tab-item} {{stack}}
* If you have [write access](/solutions/observability/apps/writer-role.md) including the privileges for [creating new Private Locations](/solutions/observability/apps/writer-role.md#synthetics-role-write-private-locations), you can [create a new Private Location](/solutions/observability/apps/monitor-resources-on-private-networks.md#monitor-via-private-agent). Then try creating the monitor again.
* If you do *not* have the right privileges to create a Private Location, you can ask someone with the [necessary privileges](/solutions/observability/apps/writer-role.md#synthetics-role-write-private-locations) to create a Private Location or ask an administrator with a [setup role](/solutions/observability/apps/setup-role.md) to give you the necessary privileges and [create a new Private Location](/solutions/observability/apps/monitor-resources-on-private-networks.md#monitor-via-private-agent). Then try creating the monitor again.
* If you want to create a monitor to run on Elastic’s global managed infrastructure, ask an administrator with a [setup role](/solutions/observability/apps/setup-role.md) to update [`Synthetics and Uptime` sub-feature privileges](/solutions/observability/apps/writer-role.md#disable-managed-locations) for the role you’re currently assigned. Then try creating the monitor again.
From 1c2e6127db9c705ee469f4c9652e0dd8d4656fe7 Mon Sep 17 00:00:00 2001
From: natasha-moore-elastic
<137783811+natasha-moore-elastic@users.noreply.github.com>
Date: Thu, 20 Feb 2025 15:09:21 +0000
Subject: [PATCH 04/13] Update section-level applies tags in Troubleshoot
(#530)
Updates section-level applies tags in Troubleshoot section to use the
[new
syntax](https://docs-v3-preview.elastic.dev/elastic/docs-builder/tree/main/syntax/applies#sections).
Previews:
- [Common
problems](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/530/troubleshoot/observability/apm/common-problems)
-
[Logs](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/530/troubleshoot/observability/troubleshoot-logs)
-
[SLOs](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/530/troubleshoot/observability/troubleshoot-service-level-objectives-slos)
-
[Synthetics](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/530/troubleshoot/observability/troubleshooting-synthetics)
- [Detection
rules](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/530/troubleshoot/security/detection-rules)
---
.../observability/apm/common-problems.md | 60 +++++++++----------
.../observability/troubleshoot-logs.md | 6 +-
...ubleshoot-service-level-objectives-slos.md | 6 +-
.../troubleshooting-synthetics.md | 12 ++--
troubleshoot/security/detection-rules.md | 7 +--
5 files changed, 45 insertions(+), 46 deletions(-)
diff --git a/troubleshoot/observability/apm/common-problems.md b/troubleshoot/observability/apm/common-problems.md
index 4afa220d7..dd0c01ddf 100644
--- a/troubleshoot/observability/apm/common-problems.md
+++ b/troubleshoot/observability/apm/common-problems.md
@@ -26,9 +26,9 @@ This section describes common problems you might encounter when using APM Server
## No data is indexed [apm-no-data-indexed]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
If no data shows up in {{es}}, first make sure that your APM components are properly connected.
@@ -83,9 +83,9 @@ APM Server currently relies on {{es}} to create indices that do not exist. As a
:::::::
## Common SSL-related problems [apm-common-ssl-problems]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
* [SSL client fails to connect](#apm-ssl-client-fails)
* [x509: cannot validate certificate](#apm-cannot-validate-certificate)
@@ -134,9 +134,9 @@ A firewall is refusing the connection. Check if a firewall is blocking the traff
## I/O Timeout [apm-io-timeout]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
I/O Timeouts can occur when your timeout settings across the stack are not configured correctly, especially when using a load balancer.
@@ -177,17 +177,17 @@ In the agent logs, you won’t see a sign of failures as the APM server asynchro
## Tail-based sampling causing high system memory usage and high disk IO [apm-tail-based-sampling-memory-disk-io]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
Tail-based sampling requires minimal memory to run, and there should not be a noticeable increase in RSS memory usage. However, since tail-based sampling writes data to disk, it is possible to see a significant increase in OS page cache memory usage due to disk IO. If you see a drop in throughput and excessive disk activity after enabling tail-based sampling, please ensure that there is enough memory headroom in the system for OS page cache to perform disk IO efficiently.
## Too many unique transaction names [troubleshooting-too-many-transactions]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
Transaction names are defined in each APM agent; when an APM agent supports a framework, it includes logic for naming the transactions that the framework creates. In some cases though, like when using an APM agent’s API to create custom transactions, it is up to the user to define a pattern for transaction naming. When transactions are named incorrectly, each unique URL can be associated with a unique transaction group—causing an explosion in the number of transaction groups per service, and leading to inaccuracies in the Applications UI.
@@ -231,9 +231,9 @@ If your problem is occurring in a different APM agent, the tips above still appl
## Unknown route [troubleshooting-unknown-route]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
The [transaction overview](../../../solutions/observability/apps/transactions-2.md) will only display helpful information when the transactions in your services are named correctly. If you’re seeing "GET unknown route" or "unknown route" in the Applications UI, it could be a sign that something isn’t working as it should.
@@ -245,9 +245,9 @@ To resolve this, you’ll need to head over to the relevant [APM agent documenta
## Fields are not searchable [troubleshooting-fields-unsearchable]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
In Elasticsearch, index templates are used to define settings and mappings that determine how fields should be analyzed. The recommended index templates for APM come from the built-in {{es}} apm-data plugin. These templates, by default, enable and disable indexing on certain fields.
@@ -262,9 +262,9 @@ As an example, some APM agents store cookie values in `http.request.cookies`. Si
## Service Maps: no connection between client and server [service-map-rum-connections]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
If the service map is not showing an expected connection between the client and server, it’s likely because you haven’t configured [`distributedTracingOrigins`](https://www.elastic.co/guide/en/apm/agent/rum-js/current/distributed-tracing-guide.html).
@@ -272,9 +272,9 @@ This setting is necessary, for example, for cross-origin requests. If you have a
## No data shown in the infrastructure tab [troubleshooting-apm-infra-data]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
If you don’t see any data in the **Infrastructure** tab for a selected service in the Applications UI, there are a few possible causes and solutions.
@@ -292,9 +292,9 @@ For example, if the APM agent is not configured to use the correct host name, th
## Common response codes [observability-apm-troubleshooting-common-response-codes]
-:::{applies_to}
-:serverless: all
-:::
+```yaml {applies_to}
+serverless: all
+```
### HTTP 400: Data decoding error / Data validation error [bad-request]
diff --git a/troubleshoot/observability/troubleshoot-logs.md b/troubleshoot/observability/troubleshoot-logs.md
index be1db17b9..944bfb6c8 100644
--- a/troubleshoot/observability/troubleshoot-logs.md
+++ b/troubleshoot/observability/troubleshoot-logs.md
@@ -63,9 +63,9 @@ You need to either:
### Failed to create API key [logs-troubleshooting-API-key-failed]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
If you don’t have the privileges to create `savedObjects` in {{kib}}, you’ll see the following error message:
diff --git a/troubleshoot/observability/troubleshoot-service-level-objectives-slos.md b/troubleshoot/observability/troubleshoot-service-level-objectives-slos.md
index ed0a4eca1..dce292b0c 100644
--- a/troubleshoot/observability/troubleshoot-service-level-objectives-slos.md
+++ b/troubleshoot/observability/troubleshoot-service-level-objectives-slos.md
@@ -191,9 +191,9 @@ Refer to [SLO API calls](https://www.elastic.co/docs/api/doc/kibana/v8/operation
## Upgrade from beta to GA [slo-troubleshoot-beta]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
Starting in version 8.12.0, SLOs are generally available (GA). If you’re upgrading from a beta version of SLOs (available in 8.11.0 and earlier), you must migrate your SLO definitions to a new format. Otherwise SLOs won’t show up.
diff --git a/troubleshoot/observability/troubleshooting-synthetics.md b/troubleshoot/observability/troubleshooting-synthetics.md
index 02dd50968..0eb3186e3 100644
--- a/troubleshoot/observability/troubleshooting-synthetics.md
+++ b/troubleshoot/observability/troubleshooting-synthetics.md
@@ -18,9 +18,9 @@ For debugging synthetic tests locally, you can set an environment variable, `DEB
### Monitors stopped running after upgrading to 8.8.0 or above [synthetics-troubleshooting-missing-api-key]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
Synthetic monitors will stop running if you have gone through this workflow:
@@ -128,9 +128,9 @@ There are a few ways to fix this:
::::
### You do not have permission to use Elastic managed locations [synthetics-troubleshooting-public-locations-disabled]
-:::{applies_to}
-:stack: all
-:::
+```yaml {applies_to}
+stack: all
+```
If you try to create or edit a monitor hosted on Elastic’s global managed infrastructure but see a note that you do not have permission to use Elastic managed locations, an administrator has restricted the use of public locations.
diff --git a/troubleshoot/security/detection-rules.md b/troubleshoot/security/detection-rules.md
index 8585d398b..519689d20 100644
--- a/troubleshoot/security/detection-rules.md
+++ b/troubleshoot/security/detection-rules.md
@@ -182,10 +182,9 @@ For example, say an event occurred at 10:00 but wasn’t ingested into {{es}} un
### Troubleshoot missing alerts for {{ml}} jobs [ml-job-compatibility]
-:::{applies_to}
-:serverless: unavailable
-:::
-% doesn't apply to serverless
+```yaml {applies_to}
+stack: all
+```
{{ml-cap}} detection rules use {{ml}} jobs that have dependencies on data fields populated by the {{beats}} and {{agent}} integrations. In {{stack}} version 8.3, new {{ml}} jobs (prefixed with `v3`) were released to operate on the ECS fields available at that time.
From 7254fdc67e3f2ee5eabb5fd1c4de2629d358a4e1 Mon Sep 17 00:00:00 2001
From: wajihaparvez
Date: Thu, 20 Feb 2025 11:02:23 -0500
Subject: [PATCH 05/13] [Docs] Add Ingest tools overview and Upload data files
(#526)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Closes: [#327](https://github.com/elastic/docs-projects/issues/372) and
[#444](https://github.com/elastic/docs-projects/issues/444)
Previews: [Ingest tools
overview](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/526/manage-data/ingest/tools)
and [Upload data
files](https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/526/manage-data/ingest/upload-data-files)
### Summary
- As discussed, combined content from linked resources to add a table
for the tools overview. A lot of pages have moved around so I'd really
appreciate a quick double-check of the links to make sure they're
pointing to the right location 🙏
- Added content to the Upload data files page and changed its location
(see questions below)
### Questions
1. Since we decided that a table would work best for the overview, I'm
not sure how to incorporate
https://www.elastic.co/guide/en/cloud/current/ec-cloud-ingest-data.html
on this page. I don't think all of its content fits here based on the
new IA. Maybe it could go in the reference section? I'm open to any
ideas!!
2. The Upload data files page was originally nested under the Ingest
tools overview, but I think it's better suited as a sibling in the
overall Manage data/Ingest section. What do you think?
---
.../nlp/ml-nlp-ner-example.md | 2 +-
.../ml-nlp-text-emb-vector-search-example.md | 2 +-
manage-data/ingest.md | 2 +-
manage-data/ingest/tools.md | 34 ++++++++--
manage-data/ingest/tools/upload-data-files.md | 19 ------
manage-data/ingest/upload-data-files.md | 63 +++++++++++++++++++
manage-data/toc.yml | 3 +-
.../semantic-search-inference.md | 2 +-
.../fleet/beats-agent-comparison.md | 6 +-
solutions/search/hybrid-semantic-text.md | 2 +-
solutions/search/ingest-for-search.md | 2 +-
.../semantic-search-elser-ingest-pipelines.md | 2 +-
.../semantic-search-inference.md | 2 +-
.../semantic-search-semantic-text.md | 2 +-
.../serverless-elasticsearch-get-started.md | 2 +-
15 files changed, 105 insertions(+), 40 deletions(-)
delete mode 100644 manage-data/ingest/tools/upload-data-files.md
create mode 100644 manage-data/ingest/upload-data-files.md
diff --git a/explore-analyze/machine-learning/nlp/ml-nlp-ner-example.md b/explore-analyze/machine-learning/nlp/ml-nlp-ner-example.md
index 36625fd7b..143b05b61 100644
--- a/explore-analyze/machine-learning/nlp/ml-nlp-ner-example.md
+++ b/explore-analyze/machine-learning/nlp/ml-nlp-ner-example.md
@@ -113,7 +113,7 @@ Using the example text "Elastic is headquartered in Mountain View, California.",
## Add the NER model to an {{infer}} ingest pipeline [ex-ner-ingest]
-You can perform bulk {{infer}} on documents as they are ingested by using an [{{infer}} processor](https://www.elastic.co/guide/en/elasticsearch/reference/current/inference-processor.html) in your ingest pipeline. The novel *Les Misérables* by Victor Hugo is used as an example for {{infer}} in the following example. [Download](https://github.com/elastic/stack-docs/blob/8.5/docs/en/stack/ml/nlp/data/les-miserables-nd.json) the novel text split by paragraph as a JSON file, then upload it by using the [Data Visualizer](../../../manage-data/ingest/tools/upload-data-files.md). Give the new index the name `les-miserables` when uploading the file.
+You can perform bulk {{infer}} on documents as they are ingested by using an [{{infer}} processor](https://www.elastic.co/guide/en/elasticsearch/reference/current/inference-processor.html) in your ingest pipeline. The novel *Les Misérables* by Victor Hugo is used as an example for {{infer}} in the following example. [Download](https://github.com/elastic/stack-docs/blob/8.5/docs/en/stack/ml/nlp/data/les-miserables-nd.json) the novel text split by paragraph as a JSON file, then upload it by using the [Data Visualizer](../../../manage-data/ingest/upload-data-files.md). Give the new index the name `les-miserables` when uploading the file.
Now create an ingest pipeline either in the [Stack management UI](ml-nlp-inference.md#ml-nlp-inference-processor) or by using the API:
diff --git a/explore-analyze/machine-learning/nlp/ml-nlp-text-emb-vector-search-example.md b/explore-analyze/machine-learning/nlp/ml-nlp-text-emb-vector-search-example.md
index bed59cf75..a2885dac1 100644
--- a/explore-analyze/machine-learning/nlp/ml-nlp-text-emb-vector-search-example.md
+++ b/explore-analyze/machine-learning/nlp/ml-nlp-text-emb-vector-search-example.md
@@ -103,7 +103,7 @@ In this step, you load the data that you later use in an ingest pipeline to get
The data set `msmarco-passagetest2019-top1000` is a subset of the MS MARCO Passage Ranking data set used in the testing stage of the 2019 TREC Deep Learning Track. It contains 200 queries and for each query a list of relevant text passages extracted by a simple information retrieval (IR) system. From that data set, all unique passages with their IDs have been extracted and put into a [tsv file](https://github.com/elastic/stack-docs/blob/8.5/docs/en/stack/ml/nlp/data/msmarco-passagetest2019-unique.tsv), totaling 182469 passages. In the following, this file is used as the example data set.
-Upload the file by using the [Data Visualizer](../../../manage-data/ingest/tools/upload-data-files.md). Name the first column `id` and the second one `text`. The index name is `collection`. After the upload is done, you can see an index named `collection` with 182469 documents.
+Upload the file by using the [Data Visualizer](../../../manage-data/ingest/upload-data-files.md). Name the first column `id` and the second one `text`. The index name is `collection`. After the upload is done, you can see an index named `collection` with 182469 documents.
:::{image} ../../../images/machine-learning-ml-nlp-text-emb-data.png
:alt: Importing the data
diff --git a/manage-data/ingest.md b/manage-data/ingest.md
index e48a513fd..facc81f2c 100644
--- a/manage-data/ingest.md
+++ b/manage-data/ingest.md
@@ -28,7 +28,7 @@ Elastic offer tools designed to ingest specific types of general content. The co
* To send **application data** directly to {{es}}, use an [{{es}} language client](https://www.elastic.co/guide/en/elasticsearch/client/index.html).
* To index **web page content**, use the Elastic [web crawler](https://www.elastic.co/web-crawler).
* To sync **data from third-party sources**, use [connectors](https://www.elastic.co/guide/en/elasticsearch/reference/current/es-connectors.html). A connector syncs content from an original data source to an {{es}} index. Using connectors you can create *searchable*, read-only replicas of your data sources.
-* To index **single files** for testing in a non-production environment, use the {{kib}} [file uploader](ingest/tools/upload-data-files.md).
+* To index **single files** for testing in a non-production environment, use the {{kib}} [file uploader](ingest/upload-data-files.md).
If you would like to try things out before you add your own data, try using our [sample data](ingest/sample-data.md).
diff --git a/manage-data/ingest/tools.md b/manage-data/ingest/tools.md
index a5477ee44..d26ba6aad 100644
--- a/manage-data/ingest/tools.md
+++ b/manage-data/ingest/tools.md
@@ -18,15 +18,37 @@ mapped_urls:
% Use migrated content from existing pages that map to this page:
-% - [ ] ./raw-migrated-files/cloud/cloud/ec-cloud-ingest-data.md
+% - [x] ./raw-migrated-files/cloud/cloud/ec-cloud-ingest-data.md
% Notes: These are resources to pull from, but this new "Ingest tools overiew" page will not be a replacement for any of these old AsciiDoc pages. File upload: https://www.elastic.co/guide/en/kibana/current/connect-to-elasticsearch.html#upload-data-kibana https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-file-upload.html API: https://www.elastic.co/guide/en/kibana/current/connect-to-elasticsearch.html#_add_data_with_programming_languages https://www.elastic.co/guide/en/elasticsearch/reference/current/docs.html https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-api.html OpenTelemetry: https://github.com/elastic/opentelemetry Fleet and Agent: https://www.elastic.co/guide/en/fleet/current/fleet-overview.html https://www.elastic.co/guide/en/serverless/current/fleet-and-elastic-agent.html Logstash: https://www.elastic.co/guide/en/logstash/current/introduction.html https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-logstash.html https://www.elastic.co/guide/en/serverless/current/logstash-pipelines.html Beats: https://www.elastic.co/guide/en/beats/libbeat/current/beats-reference.html https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-beats.html APM: /solutions/observability/apps/application-performance-monitoring-apm.md Application logging: https://www.elastic.co/guide/en/observability/current/application-logs.html ECS logging: https://www.elastic.co/guide/en/observability/current/logs-ecs-application.html Elastic serverless forwarder for AWS: https://www.elastic.co/guide/en/esf/current/aws-elastic-serverless-forwarder.html Integrations: https://www.elastic.co/guide/en/integrations/current/introduction.html Search connectors: https://www.elastic.co/guide/en/elasticsearch/reference/current/es-connectors.html https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-integrations-connector-client.html Web crawler: https://github.com/elastic/crawler/tree/main/docs
-% - [ ] ./raw-migrated-files/ingest-docs/fleet/beats-agent-comparison.md
-% - [ ] ./raw-migrated-files/kibana/kibana/connect-to-elasticsearch.md
-% - [ ] https://www.elastic.co/customer-success/data-ingestion
-% - [ ] https://github.com/elastic/ingest-docs/pull/1373
+% - [This comparison page is being moved to the reference section, so I'm linking to that from the current page - Wajiha] ./raw-migrated-files/ingest-docs/fleet/beats-agent-comparison.md
+% - [x] ./raw-migrated-files/kibana/kibana/connect-to-elasticsearch.md
+% - [x] https://www.elastic.co/customer-success/data-ingestion
+% - [x] https://github.com/elastic/ingest-docs/pull/1373
-% Internal links rely on the following IDs being on this page (e.g. as a heading ID, paragraph ID, etc):
+% Internal links rely on the following IDs being on this page (e.g. as a heading ID, paragraph ID, etc):
+% These IDs are from content that I'm not including on this current page. I've resolved them by changing the internal links to anchor links where needed. - Wajiha
$$$supported-outputs-beats-and-agent$$$
$$$additional-capabilities-beats-and-agent$$$
+
+Depending on the type of data you want to ingest, you have a number of methods and tools available for use in your ingestion process. The table below provides more information about the available tools. Refer to our [Ingestion](/manage-data/ingest.md) overview for some guidelines to help you select the optimal tool for your use case.
+
+
+
+| Tools | Usage | Links to more information |
+| ------- | --------------- | ------------------------- |
+| Integrations | Ingest data using a variety of Elastic integrations. | [Elastic Integrations](https://www.elastic.co/guide/en/integrations/current/index.html) |
+| File upload | Upload data from a file and inspect it before importing it into {{es}}. | [Upload data files](/manage-data/ingest/upload-data-files.md) |
+| APIs | Ingest data through code by using the APIs of one of the language clients or the {{es}} HTTP APIs. | [Document APIs](https://www.elastic.co/guide/en/elasticsearch/reference/current/docs.html) |
+| OpenTelemetry | Collect and send your telemetry data to Elastic Observability | [Elastic Distributions of OpenTelemetry](https://github.com/elastic/opentelemetry?tab=readme-ov-file#elastic-distributions-of-opentelemetry) |
+| Fleet and Elastic Agent | Add monitoring for logs, metrics, and other types of data to a host using Elastic Agent, and centrally manage it using Fleet. | [Fleet and {{agent}} overview](https://www.elastic.co/guide/en/fleet/current/fleet-overview.html)
[{{fleet}} and {{agent}} restrictions (Serverless)](https://www.elastic.co/guide/en/fleet/current/fleet-agent-serverless-restrictions.html)
[{{beats}} and {{agent}} capabilities](https://www.elastic.co/guide/en/fleet/current/beats-agent-comparison.html)||
+| {{elastic-defend}} | {{elastic-defend}} provides organizations with prevention, detection, and response capabilities with deep visibility for EPP, EDR, SIEM, and Security Analytics use cases across Windows, macOS, and Linux operating systems running on both traditional endpoints and public cloud environments. | [Configure endpoint protection with {{elastic-defend}}](/solutions/security/configure-elastic-defend.md) |
+| {{ls}} | Dynamically unify data from a wide variety of data sources and normalize it into destinations of your choice with {{ls}}. | [Logstash (Serverless)](https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-logstash.html)
[Logstash pipelines](/manage-data/ingest/transform-enrich/logstash-pipelines.md) |
+| {{beats}} | Use {{beats}} data shippers to send operational data to Elasticsearch directly or through Logstash. | [{{beats}} (Serverless)](https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-beats.html)
[What are {{beats}}?](https://www.elastic.co/guide/en/beats/libbeat/current/beats-reference.html)
[{{beats}} and {{agent}} capabilities](https://www.elastic.co/guide/en/fleet/current/beats-agent-comparison.html)|
+| APM | Collect detailed performance information on response time for incoming requests, database queries, calls to caches, external HTTP requests, and more. | [Application performance monitoring (APM)](/solutions/observability/apps/application-performance-monitoring-apm.md) |
+| Application logs | Ingest application logs using Filebeat, {{agent}}, or the APM agent, or reformat application logs into Elastic Common Schema (ECS) logs and then ingest them using Filebeat or {{agent}}. | [Stream application logs](/solutions/observability/logs/stream-application-logs.md)
[ECS formatted application logs](/solutions/observability/logs/ecs-formatted-application-logs.md) |
+| Elastic Serverless forwarder for AWS | Ship logs from your AWS environment to cloud-hosted, self-managed Elastic environments, or {{ls}}. | [Elastic Serverless Forwarder](https://www.elastic.co/guide/en/esf/current/aws-elastic-serverless-forwarder.html) |
+| Connectors | Use connectors to extract data from an original data source and sync it to an {{es}} index. | [Ingest content with Elastic connectors
+](https://www.elastic.co/guide/en/elasticsearch/reference/current/es-connectors.html)
[Connector clients](https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-integrations-connector-client.html) |
+| Web crawler | Discover, extract, and index searchable content from websites and knowledge bases using the web crawler. | [Elastic Open Web Crawler](https://github.com/elastic/crawler#readme) |
\ No newline at end of file
diff --git a/manage-data/ingest/tools/upload-data-files.md b/manage-data/ingest/tools/upload-data-files.md
deleted file mode 100644
index 84f43298b..000000000
--- a/manage-data/ingest/tools/upload-data-files.md
+++ /dev/null
@@ -1,19 +0,0 @@
----
-mapped_urls:
- - https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-file-upload.html
- - https://www.elastic.co/guide/en/kibana/current/connect-to-elasticsearch.html#upload-data-kibana
----
-
-# Upload data files [upload-data-kibana]
-
-% What needs to be done: Align serverless/stateful
-
-% Use migrated content from existing pages that map to this page:
-
-% - [ ] ./raw-migrated-files/docs-content/serverless/elasticsearch-ingest-data-file-upload.md
-% - [ ] ./raw-migrated-files/kibana/kibana/connect-to-elasticsearch.md
-
-
-
-% Note from David: I've removed the ID $$$upload-data-kibana$$$ from manage-data/ingest.md as those links should instead point to this page. So, please ensure that the following ID is included on this page. I've added it beside the title.
-
diff --git a/manage-data/ingest/upload-data-files.md b/manage-data/ingest/upload-data-files.md
new file mode 100644
index 000000000..212fe3842
--- /dev/null
+++ b/manage-data/ingest/upload-data-files.md
@@ -0,0 +1,63 @@
+---
+mapped_urls:
+ - https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-file-upload.html
+ - https://www.elastic.co/guide/en/kibana/current/connect-to-elasticsearch.html#upload-data-kibana
+---
+
+# Upload data files [upload-data-kibana]
+
+% What needs to be done: Align serverless/stateful
+
+% Use migrated content from existing pages that map to this page:
+
+% - [x] ./raw-migrated-files/docs-content/serverless/elasticsearch-ingest-data-file-upload.md
+% - [x] ./raw-migrated-files/kibana/kibana/connect-to-elasticsearch.md
+
+% Note from David: I've removed the ID $$$upload-data-kibana$$$ from manage-data/ingest.md as those links should instead point to this page. So, please ensure that the following ID is included on this page. I've added it beside the title.
+
+You can upload files, view their fields and metrics, and optionally import them to {{es}} with the Data Visualizer.
+
+To use the Data Visualizer, click **Upload a file** on the {{es}} **Getting Started** page or navigate to the **Integrations** view and search for **Upload a file**. Clicking **Upload a file** opens the Data Visualizer UI.
+
+:::{image} /images/serverless-file-uploader-UI.png
+:alt: File upload UI
+:class: screenshot
+:::
+
+Drag a file into the upload area or click **Select or drag and drop a file** to choose a file from your computer.
+
+You can upload different file formats for analysis with the Data Visualizer:
+
+File formats supported up to 500 MB:
+
+* CSV
+* TSV
+* NDJSON
+* Log files
+
+File formats supported up to 60 MB:
+
+* PDF
+* Microsoft Office files (Word, Excel, PowerPoint)
+* Plain Text (TXT)
+* Rich Text (RTF)
+* Open Document Format (ODF)
+
+The Data Visualizer displays the first 1000 rows of the file. You can inspect the data and make any necessary changes before importing it. Click **Import** continue the process.
+
+This process will create an index and import the data into {{es}}. Once your data is in {{es}}, you can start exploring it, see [Explore and analyze](/explore-analyze/index.md) for more information.
+
+::::{important}
+The upload feature is not intended for use as part of a repeated production process, but rather for the initial exploration of your data.
+
+::::
+
+## Required privileges
+
+The {{stack-security-features}} provide roles and privileges that control which users can upload files. To upload a file in {{kib}} and import it into an {{es}} index, you’ll need:
+
+* `manage_pipeline` or `manage_ingest_pipelines` cluster privilege
+* `create`, `create_index`, `manage`, and `read` index privileges for the index
+* `all` {{kib}} privileges for **Discover** and **Data Views Management**
+
+You can manage your roles, privileges, and spaces in **{{stack-manage-app}}**.
\ No newline at end of file
diff --git a/manage-data/toc.yml b/manage-data/toc.yml
index 62e359f72..1c5e611a7 100644
--- a/manage-data/toc.yml
+++ b/manage-data/toc.yml
@@ -91,6 +91,7 @@ toc:
- file: ingest/ingest-reference-architectures/agent-es-airgapped.md
- file: ingest/ingest-reference-architectures/agent-ls-airgapped.md
- file: ingest/sample-data.md
+ - file: ingest/upload-data-files.md
- file: ingest/transform-enrich.md
children:
- file: ingest/transform-enrich/ingest-pipelines-serverless.md
@@ -106,8 +107,6 @@ toc:
- file: ingest/transform-enrich/example-enrich-data-by-matching-value-to-range.md
- file: ingest/transform-enrich/index-mapping-text-analysis.md
- file: ingest/tools.md
- children:
- - file: ingest/tools/upload-data-files.md
- file: lifecycle.md
children:
- file: lifecycle/data-tiers.md
diff --git a/raw-migrated-files/elasticsearch/elasticsearch-reference/semantic-search-inference.md b/raw-migrated-files/elasticsearch/elasticsearch-reference/semantic-search-inference.md
index 1486e3d7b..0401d8551 100644
--- a/raw-migrated-files/elasticsearch/elasticsearch-reference/semantic-search-inference.md
+++ b/raw-migrated-files/elasticsearch/elasticsearch-reference/semantic-search-inference.md
@@ -824,7 +824,7 @@ In this step, you load the data that you later use in the {{infer}} ingest pipel
Use the `msmarco-passagetest2019-top1000` data set, which is a subset of the MS MARCO Passage Ranking data set. It consists of 200 queries, each accompanied by a list of relevant text passages. All unique passages, along with their IDs, have been extracted from that data set and compiled into a [tsv file](https://github.com/elastic/stack-docs/blob/main/docs/en/stack/ml/nlp/data/msmarco-passagetest2019-unique.tsv).
-Download the file and upload it to your cluster using the [Data Visualizer](../../../manage-data/ingest/tools/upload-data-files.md) in the {{ml-app}} UI. After your data is analyzed, click **Override settings**. Under **Edit field names***, assign `id` to the first column and `content` to the second. Click ***Apply***, then ***Import**. Name the index `test-data`, and click **Import**. After the upload is complete, you will see an index named `test-data` with 182,469 documents.
+Download the file and upload it to your cluster using the [Data Visualizer](../../../manage-data/ingest/upload-data-files.md) in the {{ml-app}} UI. After your data is analyzed, click **Override settings**. Under **Edit field names***, assign `id` to the first column and `content` to the second. Click ***Apply***, then ***Import**. Name the index `test-data`, and click **Import**. After the upload is complete, you will see an index named `test-data` with 182,469 documents.
## Ingest the data through the {{infer}} ingest pipeline [reindexing-data-infer]
diff --git a/raw-migrated-files/ingest-docs/fleet/beats-agent-comparison.md b/raw-migrated-files/ingest-docs/fleet/beats-agent-comparison.md
index 0a5d7e0d9..4acf7eaf5 100644
--- a/raw-migrated-files/ingest-docs/fleet/beats-agent-comparison.md
+++ b/raw-migrated-files/ingest-docs/fleet/beats-agent-comparison.md
@@ -23,8 +23,8 @@ This article summarizes the features and functionality you need to be aware of b
The following steps will help you determine if {{agent}} can support your use case:
1. Determine if the integrations you need are supported and Generally Available (GA) on {{agent}}. To find out if an integration is GA, see the [{{integrations}} quick reference table](https://docs.elastic.co/en/integrations/all_integrations).
-2. If the integration is available, check [Supported outputs](../../../manage-data/ingest/tools.md#supported-outputs-beats-and-agent) to see whether the required output is also supported.
-3. Review [Capabilities comparison](../../../manage-data/ingest/tools.md#additional-capabilities-beats-and-agent) to determine if any features required by your deployment are supported. {{agent}} should support most of the features available on {{beats}} and is updated for each release.
+2. If the integration is available, check [Supported outputs](#supported-outputs-beats-and-agent) to see whether the required output is also supported.
+3. Review [Capabilities comparison](#additional-capabilities-beats-and-agent) to determine if any features required by your deployment are supported. {{agent}} should support most of the features available on {{beats}} and is updated for each release.
If you are satisfied with all three steps, then {{agent}} is suitable for your deployment. However, if any steps fail your assessment, you should continue using {{beats}}, and review future updates or contact us in the [discuss forum](https://discuss.elastic.co/).
@@ -67,7 +67,7 @@ The following table shows the outputs supported by the {{agent}} in 9.0.0-beta1:
| [Project paths](https://www.elastic.co/guide/en/beats/filebeat/current/configuration-path.html) | {{agent}} configures these paths to provide a simpler and more streamlinedconfiguration experience. |
| [External configuration file loading](https://www.elastic.co/guide/en/beats/filebeat/current/filebeat-configuration-reloading.html) | Config is distributed via policy. |
| [Live reloading](https://www.elastic.co/guide/en/beats/filebeat/current/_live_reloading.html) | Related to the config file reload. |
-| [Outputs](https://www.elastic.co/guide/en/beats/filebeat/current/configuring-output.html) | Configured through {{fleet}}. See [Supported outputs](../../../manage-data/ingest/tools.md#supported-outputs-beats-and-agent). |
+| [Outputs](https://www.elastic.co/guide/en/beats/filebeat/current/configuring-output.html) | Configured through {{fleet}}. See [Supported outputs](#supported-outputs-beats-and-agent). |
| [SSL](https://www.elastic.co/guide/en/beats/filebeat/current/configuration-ssl.html) | Supported |
| [{{ilm-cap}}](https://www.elastic.co/guide/en/beats/filebeat/current/ilm.html) | Enabled by default although the Agent uses [data streams](https://www.elastic.co/guide/en/fleet/current/data-streams.html). |
| [{{es}} index template loading](https://www.elastic.co/guide/en/beats/filebeat/current/configuration-template.html) | No longer applicable |
diff --git a/solutions/search/hybrid-semantic-text.md b/solutions/search/hybrid-semantic-text.md
index 7f906f6a0..1b7670c7e 100644
--- a/solutions/search/hybrid-semantic-text.md
+++ b/solutions/search/hybrid-semantic-text.md
@@ -56,7 +56,7 @@ In this step, you load the data that you later use to create embeddings from.
Use the `msmarco-passagetest2019-top1000` data set, which is a subset of the MS MARCO Passage Ranking data set. It consists of 200 queries, each accompanied by a list of relevant text passages. All unique passages, along with their IDs, have been extracted from that data set and compiled into a [tsv file](https://github.com/elastic/stack-docs/blob/main/docs/en/stack/ml/nlp/data/msmarco-passagetest2019-unique.tsv).
-Download the file and upload it to your cluster using the [Data Visualizer](../../manage-data/ingest/tools/upload-data-files.md) in the {{ml-app}} UI. After your data is analyzed, click **Override settings**. Under **Edit field names***, assign `id` to the first column and `content` to the second. Click ***Apply***, then ***Import**. Name the index `test-data`, and click **Import**. After the upload is complete, you will see an index named `test-data` with 182,469 documents.
+Download the file and upload it to your cluster using the [Data Visualizer](../../manage-data/ingest/upload-data-files.md) in the {{ml-app}} UI. After your data is analyzed, click **Override settings**. Under **Edit field names***, assign `id` to the first column and `content` to the second. Click ***Apply***, then ***Import**. Name the index `test-data`, and click **Import**. After the upload is complete, you will see an index named `test-data` with 182,469 documents.
## Reindex the data for hybrid search [hybrid-search-reindex-data]
diff --git a/solutions/search/ingest-for-search.md b/solutions/search/ingest-for-search.md
index 507225594..14659c8c3 100644
--- a/solutions/search/ingest-for-search.md
+++ b/solutions/search/ingest-for-search.md
@@ -41,7 +41,7 @@ You can use these specialized tools to add general content to {{es}} indices.
|--------|-------------|-------|
| [**Web crawler**](https://github.com/elastic/crawler) | Programmatically discover and index content from websites and knowledge bases | Crawl public-facing web content or internal sites accessible via HTTP proxy |
| [**Search connectors**](https://github.com/elastic/connectors) | Third-party integrations to popular content sources like databases, cloud storage, and business applications | Choose from a range of Elastic-built connectors or build your own in Python using the Elastic connector framework|
-| [**File upload**](/manage-data/ingest/tools/upload-data-files.md)| One-off manual uploads through the UI | Useful for testing or very small-scale use cases, but not recommended for production workflows |
+| [**File upload**](/manage-data/ingest/upload-data-files.md)| One-off manual uploads through the UI | Useful for testing or very small-scale use cases, but not recommended for production workflows |
### Process data at ingest time
diff --git a/solutions/search/semantic-search/semantic-search-elser-ingest-pipelines.md b/solutions/search/semantic-search/semantic-search-elser-ingest-pipelines.md
index 5a7689eeb..528477218 100644
--- a/solutions/search/semantic-search/semantic-search-elser-ingest-pipelines.md
+++ b/solutions/search/semantic-search/semantic-search-elser-ingest-pipelines.md
@@ -102,7 +102,7 @@ The `msmarco-passagetest2019-top1000` dataset was not utilized to train the mode
::::
-Download the file and upload it to your cluster using the [File Uploader](../../../manage-data/ingest/tools/upload-data-files.md) in the UI. After your data is analyzed, click **Override settings**. Under **Edit field names***, assign `id` to the first column and `content` to the second. Click ***Apply***, then ***Import**. Name the index `test-data`, and click **Import**. After the upload is complete, you will see an index named `test-data` with 182,469 documents.
+Download the file and upload it to your cluster using the [File Uploader](../../../manage-data/ingest/upload-data-files.md) in the UI. After your data is analyzed, click **Override settings**. Under **Edit field names***, assign `id` to the first column and `content` to the second. Click ***Apply***, then ***Import**. Name the index `test-data`, and click **Import**. After the upload is complete, you will see an index named `test-data` with 182,469 documents.
### Ingest the data through the {{infer}} ingest pipeline [reindexing-data-elser]
diff --git a/solutions/search/semantic-search/semantic-search-inference.md b/solutions/search/semantic-search/semantic-search-inference.md
index fe0335eb7..2f5d61066 100644
--- a/solutions/search/semantic-search/semantic-search-inference.md
+++ b/solutions/search/semantic-search/semantic-search-inference.md
@@ -829,7 +829,7 @@ In this step, you load the data that you later use in the {{infer}} ingest pipel
Use the `msmarco-passagetest2019-top1000` data set, which is a subset of the MS MARCO Passage Ranking data set. It consists of 200 queries, each accompanied by a list of relevant text passages. All unique passages, along with their IDs, have been extracted from that data set and compiled into a [tsv file](https://github.com/elastic/stack-docs/blob/main/docs/en/stack/ml/nlp/data/msmarco-passagetest2019-unique.tsv).
-Download the file and upload it to your cluster using the [Data Visualizer](../../../manage-data/ingest/tools/upload-data-files.md) in the {{ml-app}} UI. After your data is analyzed, click **Override settings**. Under **Edit field names***, assign `id` to the first column and `content` to the second. Click ***Apply***, then ***Import**. Name the index `test-data`, and click **Import**. After the upload is complete, you will see an index named `test-data` with 182,469 documents.
+Download the file and upload it to your cluster using the [Data Visualizer](../../../manage-data/ingest/upload-data-files.md) in the {{ml-app}} UI. After your data is analyzed, click **Override settings**. Under **Edit field names***, assign `id` to the first column and `content` to the second. Click ***Apply***, then ***Import**. Name the index `test-data`, and click **Import**. After the upload is complete, you will see an index named `test-data` with 182,469 documents.
## Ingest the data through the {{infer}} ingest pipeline [reindexing-data-infer]
diff --git a/solutions/search/semantic-search/semantic-search-semantic-text.md b/solutions/search/semantic-search/semantic-search-semantic-text.md
index 896d77500..6c968fb40 100644
--- a/solutions/search/semantic-search/semantic-search-semantic-text.md
+++ b/solutions/search/semantic-search/semantic-search-semantic-text.md
@@ -63,7 +63,7 @@ In this step, you load the data that you later use to create embeddings from it.
Use the `msmarco-passagetest2019-top1000` data set, which is a subset of the MS MARCO Passage Ranking data set. It consists of 200 queries, each accompanied by a list of relevant text passages. All unique passages, along with their IDs, have been extracted from that data set and compiled into a [tsv file](https://github.com/elastic/stack-docs/blob/main/docs/en/stack/ml/nlp/data/msmarco-passagetest2019-unique.tsv).
-Download the file and upload it to your cluster using the [Data Visualizer](../../../manage-data/ingest/tools/upload-data-files.md) in the {{ml-app}} UI. After your data is analyzed, click **Override settings**. Under **Edit field names***, assign `id` to the first column and `content` to the second. Click ***Apply***, then ***Import**. Name the index `test-data`, and click **Import**. After the upload is complete, you will see an index named `test-data` with 182,469 documents.
+Download the file and upload it to your cluster using the [Data Visualizer](../../../manage-data/ingest/upload-data-files.md) in the {{ml-app}} UI. After your data is analyzed, click **Override settings**. Under **Edit field names***, assign `id` to the first column and `content` to the second. Click ***Apply***, then ***Import**. Name the index `test-data`, and click **Import**. After the upload is complete, you will see an index named `test-data` with 182,469 documents.
## Reindex the data [semantic-text-reindex-data]
diff --git a/solutions/search/serverless-elasticsearch-get-started.md b/solutions/search/serverless-elasticsearch-get-started.md
index b6463e8a4..c71dd2845 100644
--- a/solutions/search/serverless-elasticsearch-get-started.md
+++ b/solutions/search/serverless-elasticsearch-get-started.md
@@ -109,7 +109,7 @@ If you’re already familiar with Elasticsearch, you can jump right into setting
* [{{es}} API](ingest-for-search.md)
* [Connector clients](https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-integrations-connector-client.html)
- * [File Uploader](../../manage-data/ingest/tools/upload-data-files.md)
+ * [File Uploader](../../manage-data/ingest/upload-data-files.md)
* [{{beats}}](https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-beats.html)
* [{{ls}}](https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-logstash.html)
* [Elastic Open Web Crawler](https://github.com/elastic/crawler)
From c9130558664b59549daeb0eba42cdb7fa2ab1624 Mon Sep 17 00:00:00 2001
From: Colleen McGinnis
Date: Thu, 20 Feb 2025 10:07:40 -0600
Subject: [PATCH 06/13] [cross-repo links] Add ID that cross-repo links depends
on (#533)
Add another ID that cross-repo links depends on like we did in
https://github.com/elastic/docs-content/pull/495.
---
deploy-manage/deploy/kibana-reporting-configuration.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/deploy-manage/deploy/kibana-reporting-configuration.md b/deploy-manage/deploy/kibana-reporting-configuration.md
index f1dac36bf..25cb0281e 100644
--- a/deploy-manage/deploy/kibana-reporting-configuration.md
+++ b/deploy-manage/deploy/kibana-reporting-configuration.md
@@ -21,6 +21,8 @@ mapped_urls:
$$$reporting-chromium-sandbox$$$
+$$$grant-user-access$$$
+
⚠️ **This page is a work in progress.** ⚠️
The documentation team is working to combine content pulled from the following pages:
From 31304e9c2e24b6a1922ecef814841711b9b8cc49 Mon Sep 17 00:00:00 2001
From: George Wallace
Date: Thu, 20 Feb 2025 09:15:44 -0700
Subject: [PATCH 07/13] merging connectors content (#484)
Co-authored-by: shainaraskas <58563081+shainaraskas@users.noreply.github.com>
---
deploy-manage/manage-connectors.md | 89 +++++++++++--
images/kibana-connector-listing.png | Bin 120935 -> 0 bytes
images/kibana-connectors-import-banner.png | Bin 281591 -> 0 bytes
.../serverless/action-connectors.md | 40 ------
.../kibana/kibana/action-types.md | 123 ------------------
.../kibana/kibana/management.md | 2 +-
raw-migrated-files/toc.yml | 2 -
7 files changed, 78 insertions(+), 178 deletions(-)
delete mode 100644 images/kibana-connector-listing.png
delete mode 100644 images/kibana-connectors-import-banner.png
delete mode 100644 raw-migrated-files/docs-content/serverless/action-connectors.md
delete mode 100644 raw-migrated-files/kibana/kibana/action-types.md
diff --git a/deploy-manage/manage-connectors.md b/deploy-manage/manage-connectors.md
index ba5c8cdfe..f85d84be1 100644
--- a/deploy-manage/manage-connectors.md
+++ b/deploy-manage/manage-connectors.md
@@ -2,25 +2,90 @@
mapped_urls:
- https://www.elastic.co/guide/en/kibana/current/action-types.html
- https://www.elastic.co/guide/en/serverless/current/action-connectors.html
+applies_to:
+ stack:
+ serverless:
---
-# Manage connectors
+# Manage connectors [connector-management]
-% What needs to be done: Align serverless/stateful
+Connectors serve as a central place to store connection information for both Elastic and third-party systems. They enable the linking of actions to rules, which execute as background tasks on the {{kib}} server when rule conditions are met. This allows rules to route actions to various destinations such as log files, ticketing systems, and messaging tools. Different {{kib}} apps may have their own rule types, but they typically share connectors. The **{{stack-manage-app}} > {{connectors-ui}}** provides a central location to view and manage all connectors in the current space.
-% GitHub issue: https://github.com/elastic/docs-projects/issues/352
+::::{note}
+This page is about {{kib}} connectors that integrate with services like generative AI model providers. If you’re looking for Search connectors that synchronize third-party data into {{es}}, refer to [Connector clients](https://www.elastic.co/guide/en/serverless/current/elasticsearch-ingest-data-through-integrations-connector-client.html).
-% Scope notes: Connectors management, probably moving some content to reference. We should align the serverless and stateful documentation.
+::::
-% Use migrated content from existing pages that map to this page:
+## Required permissions [_required_permissions_2]
-% - [ ] ./raw-migrated-files/kibana/kibana/action-types.md
-% Notes: 28 children
-% - [ ] ./raw-migrated-files/docs-content/serverless/action-connectors.md
+Access to connectors is granted based on your privileges to alerting-enabled features. For more information, go to [Security](../explore-analyze/alerts-cases/alerts/alerting-setup.md#alerting-security).
-$$$connector-management$$$
+## Connector networking configuration [_connector_networking_configuration]
-**This page is a work in progress.** The documentation team is working to combine content pulled from the following pages:
+```yaml {applies_to}
+stack:
+```
-* [/raw-migrated-files/kibana/kibana/action-types.md](/raw-migrated-files/kibana/kibana/action-types.md)
-* [/raw-migrated-files/docs-content/serverless/action-connectors.md](/raw-migrated-files/docs-content/serverless/action-connectors.md)
\ No newline at end of file
+If you're using {{stack}}, use the [action configuration settings](https://www.elastic.co/guide/en/kibana/current/alert-action-settings-kb.html#action-settings) to customize connector networking configurations, such as proxies, certificates, or TLS settings. You can set configurations that apply to all your connectors or use `xpack.actions.customHostSettings` to set per-host configurations.
+
+## Connector list [connectors-list]
+
+In **{{stack-manage-app}} > {{connectors-ui}}**, you can find a list of the connectors in the current space. You can use the search bar to find specific connectors by name and type. The **Type** dropdown also enables you to filter to a subset of connector types.
+
+:::{image} ../images/kibana-connector-filter-by-type.png
+:alt: Filtering the connector list by types of connectors
+:class: screenshot
+:::
+
+You can delete individual connectors using the trash icon. Alternatively, select multiple connectors and delete them in bulk using the **Delete** button.
+
+:::{image} ../images/kibana-connector-delete.png
+:alt: Deleting connectors individually or in bulk
+:class: screenshot
+:::
+
+::::{note}
+You can delete a connector even if there are still actions referencing it. When this happens the action will fail to run and errors appear in the {{kib}} logs.
+
+::::
+
+## Creating a new connector [creating-new-connector]
+
+New connectors can be created with the **Create connector** button, which guides you to select the type of connector and configure its properties. For a full list of available connectors, see [Available connectors](asciidocalypse://docs/kibana/docs/reference/connectors-kibana/connectors-kibana.md).
+
+::::{note}
+Some connector types are paid commercial features, while others are free. For a comparison of the Elastic subscription levels, go to [the subscription page](https://www.elastic.co/subscriptions).
+::::
+
+:::{image} ../images/kibana-connector-select-type.png
+:alt: Connector select type
+:class: screenshot
+:width: 75%
+:::
+
+After you create a connector, it is available for use any time you set up an action in the current space.
+
+::::{tip}
+For out-of-the-box and standardized connectors, refer to [preconfigured connectors](https://www.elastic.co/guide/en/kibana/current/pre-configured-connectors.html).
+
+You can also manage connectors as resources with the [Elasticstack provider](https://registry.terraform.io/providers/elastic/elasticstack/latest) for Terraform. For more details, refer to the [elasticstack_kibana_action_connector](https://registry.terraform.io/providers/elastic/elasticstack/latest/docs/resources/kibana_action_connector) resource.
+
+Preconfigured connectors and the Terraform resource are not available in {{serverless-full}} projects.
+::::
+
+## Importing and exporting connectors [importing-and-exporting-connectors]
+
+To import and export connectors, use the [Saved Objects Management UI](/explore-analyze/find-and-organize/saved-objects.md).
+
+If a connector is missing sensitive information after the import, a **Fix** button appears in **{{connectors-ui}}**.
+
+:::{image} ../images/kibana-connectors-with-missing-secrets.png
+:alt: Connectors with missing secrets
+:class: screenshot
+:::
+
+## Monitoring connectors [monitoring-connectors]
+
+You can query the [Event log index](/explore-analyze/alerts-cases/alerts/event-log-index.md) to gather information on connector successes and failures.
+
+If you're using {{stack}}, then you can also use the [Task Manager health API](/deploy-manage/monitor/kibana-task-manager-health-monitoring.md) to monitor connector performance. However, if connectors fail to run, they will report as successful to Task Manager. The failure stats will not accurately depict connector failures.
diff --git a/images/kibana-connector-listing.png b/images/kibana-connector-listing.png
deleted file mode 100644
index 9bd55b49dd8429a39015dab192505dccf85fe652..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001
literal 120935
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