diff --git a/docs/docset.yml b/docs/docset.yml
index 2c8aafee1..14f47bbb9 100644
--- a/docs/docset.yml
+++ b/docs/docset.yml
@@ -13,482 +13,5 @@ toc:
- toc: reference
- toc: release-notes
subs:
- ref: "https://www.elastic.co/guide/en/elasticsearch/reference/current"
- ref-bare: "https://www.elastic.co/guide/en/elasticsearch/reference"
- ref-8x: "https://www.elastic.co/guide/en/elasticsearch/reference/8.1"
- ref-80: "https://www.elastic.co/guide/en/elasticsearch/reference/8.0"
- ref-7x: "https://www.elastic.co/guide/en/elasticsearch/reference/7.17"
- ref-70: "https://www.elastic.co/guide/en/elasticsearch/reference/7.0"
- ref-60: "https://www.elastic.co/guide/en/elasticsearch/reference/6.0"
- ref-64: "https://www.elastic.co/guide/en/elasticsearch/reference/6.4"
- xpack-ref: "https://www.elastic.co/guide/en/x-pack/6.2"
- logstash-ref: "https://www.elastic.co/guide/en/logstash/current"
- kibana-ref: "https://www.elastic.co/guide/en/kibana/current"
- kibana-ref-all: "https://www.elastic.co/guide/en/kibana"
- beats-ref-root: "https://www.elastic.co/guide/en/beats"
- beats-ref: "https://www.elastic.co/guide/en/beats/libbeat/current"
- beats-ref-60: "https://www.elastic.co/guide/en/beats/libbeat/6.0"
- beats-ref-63: "https://www.elastic.co/guide/en/beats/libbeat/6.3"
- beats-devguide: "https://www.elastic.co/guide/en/beats/devguide/current"
- auditbeat-ref: "https://www.elastic.co/guide/en/beats/auditbeat/current"
- packetbeat-ref: "https://www.elastic.co/guide/en/beats/packetbeat/current"
- metricbeat-ref: "https://www.elastic.co/guide/en/beats/metricbeat/current"
- filebeat-ref: "https://www.elastic.co/guide/en/beats/filebeat/current"
- functionbeat-ref: "https://www.elastic.co/guide/en/beats/functionbeat/current"
- winlogbeat-ref: "https://www.elastic.co/guide/en/beats/winlogbeat/current"
- heartbeat-ref: "https://www.elastic.co/guide/en/beats/heartbeat/current"
- journalbeat-ref: "https://www.elastic.co/guide/en/beats/journalbeat/current"
- ingest-guide: "https://www.elastic.co/guide/en/ingest/current"
- fleet-guide: "https://www.elastic.co/guide/en/fleet/current"
- apm-guide-ref: "https://www.elastic.co/guide/en/apm/guide/current"
- apm-guide-7x: "https://www.elastic.co/guide/en/apm/guide/7.17"
- apm-app-ref: "https://www.elastic.co/guide/en/kibana/current"
- apm-agents-ref: "https://www.elastic.co/guide/en/apm/agent"
- apm-android-ref: "https://www.elastic.co/guide/en/apm/agent/android/current"
- apm-py-ref: "https://www.elastic.co/guide/en/apm/agent/python/current"
- apm-py-ref-3x: "https://www.elastic.co/guide/en/apm/agent/python/3.x"
- apm-node-ref-index: "https://www.elastic.co/guide/en/apm/agent/nodejs"
- apm-node-ref: "https://www.elastic.co/guide/en/apm/agent/nodejs/current"
- apm-node-ref-1x: "https://www.elastic.co/guide/en/apm/agent/nodejs/1.x"
- apm-rum-ref: "https://www.elastic.co/guide/en/apm/agent/rum-js/current"
- apm-ruby-ref: "https://www.elastic.co/guide/en/apm/agent/ruby/current"
- apm-java-ref: "https://www.elastic.co/guide/en/apm/agent/java/current"
- apm-go-ref: "https://www.elastic.co/guide/en/apm/agent/go/current"
- apm-dotnet-ref: "https://www.elastic.co/guide/en/apm/agent/dotnet/current"
- apm-php-ref: "https://www.elastic.co/guide/en/apm/agent/php/current"
- apm-ios-ref: "https://www.elastic.co/guide/en/apm/agent/swift/current"
- apm-lambda-ref: "https://www.elastic.co/guide/en/apm/lambda/current"
- apm-attacher-ref: "https://www.elastic.co/guide/en/apm/attacher/current"
- docker-logging-ref: "https://www.elastic.co/guide/en/beats/loggingplugin/current"
- esf-ref: "https://www.elastic.co/guide/en/esf/current"
- kinesis-firehose-ref: "https://www.elastic.co/guide/en/kinesis/{{kinesis_version}}"
- estc-welcome-current: "https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current"
- estc-welcome: "https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions/current"
- estc-welcome-all: "https://www.elastic.co/guide/en/starting-with-the-elasticsearch-platform-and-its-solutions"
- hadoop-ref: "https://www.elastic.co/guide/en/elasticsearch/hadoop/current"
- stack-ref: "https://www.elastic.co/guide/en/elastic-stack/current"
- stack-ref-67: "https://www.elastic.co/guide/en/elastic-stack/6.7"
- stack-ref-68: "https://www.elastic.co/guide/en/elastic-stack/6.8"
- stack-ref-70: "https://www.elastic.co/guide/en/elastic-stack/7.0"
- stack-ref-80: "https://www.elastic.co/guide/en/elastic-stack/8.0"
- stack-ov: "https://www.elastic.co/guide/en/elastic-stack-overview/current"
- stack-gs: "https://www.elastic.co/guide/en/elastic-stack-get-started/current"
- stack-gs-current: "https://www.elastic.co/guide/en/elastic-stack-get-started/current"
- javaclient: "https://www.elastic.co/guide/en/elasticsearch/client/java-api/current"
- java-api-client: "https://www.elastic.co/guide/en/elasticsearch/client/java-api-client/current"
- java-rest: "https://www.elastic.co/guide/en/elasticsearch/client/java-rest/current"
- jsclient: "https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current"
- jsclient-current: "https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/current"
- es-ruby-client: "https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current"
- es-dotnet-client: "https://www.elastic.co/guide/en/elasticsearch/client/net-api/current"
- es-php-client: "https://www.elastic.co/guide/en/elasticsearch/client/php-api/current"
- es-python-client: "https://www.elastic.co/guide/en/elasticsearch/client/python-api/current"
- defguide: "https://www.elastic.co/guide/en/elasticsearch/guide/2.x"
- painless: "https://www.elastic.co/guide/en/elasticsearch/painless/current"
- plugins: "https://www.elastic.co/guide/en/elasticsearch/plugins/current"
- plugins-8x: "https://www.elastic.co/guide/en/elasticsearch/plugins/8.1"
- plugins-7x: "https://www.elastic.co/guide/en/elasticsearch/plugins/7.17"
- plugins-6x: "https://www.elastic.co/guide/en/elasticsearch/plugins/6.8"
- glossary: "https://www.elastic.co/guide/en/elastic-stack-glossary/current"
- upgrade_guide: "https://www.elastic.co/products/upgrade_guide"
- blog-ref: "https://www.elastic.co/blog/"
- curator-ref: "https://www.elastic.co/guide/en/elasticsearch/client/curator/current"
- curator-ref-current: "https://www.elastic.co/guide/en/elasticsearch/client/curator/current"
- metrics-ref: "https://www.elastic.co/guide/en/metrics/current"
- metrics-guide: "https://www.elastic.co/guide/en/metrics/guide/current"
- logs-ref: "https://www.elastic.co/guide/en/logs/current"
- logs-guide: "https://www.elastic.co/guide/en/logs/guide/current"
- uptime-guide: "https://www.elastic.co/guide/en/uptime/current"
- observability-guide: "https://www.elastic.co/guide/en/observability/current"
- observability-guide-all: "https://www.elastic.co/guide/en/observability"
- siem-guide: "https://www.elastic.co/guide/en/siem/guide/current"
- security-guide: "https://www.elastic.co/guide/en/security/current"
- security-guide-all: "https://www.elastic.co/guide/en/security"
- endpoint-guide: "https://www.elastic.co/guide/en/endpoint/current"
- sql-odbc: "https://www.elastic.co/guide/en/elasticsearch/sql-odbc/current"
- ecs-ref: "https://www.elastic.co/guide/en/ecs/current"
- ecs-logging-ref: "https://www.elastic.co/guide/en/ecs-logging/overview/current"
- ecs-logging-go-logrus-ref: "https://www.elastic.co/guide/en/ecs-logging/go-logrus/current"
- ecs-logging-go-zap-ref: "https://www.elastic.co/guide/en/ecs-logging/go-zap/current"
- ecs-logging-go-zerolog-ref: "https://www.elastic.co/guide/en/ecs-logging/go-zap/current"
- ecs-logging-java-ref: "https://www.elastic.co/guide/en/ecs-logging/java/current"
- ecs-logging-dotnet-ref: "https://www.elastic.co/guide/en/ecs-logging/dotnet/current"
- ecs-logging-nodejs-ref: "https://www.elastic.co/guide/en/ecs-logging/nodejs/current"
- ecs-logging-php-ref: "https://www.elastic.co/guide/en/ecs-logging/php/current"
- ecs-logging-python-ref: "https://www.elastic.co/guide/en/ecs-logging/python/current"
- ecs-logging-ruby-ref: "https://www.elastic.co/guide/en/ecs-logging/ruby/current"
- ml-docs: "https://www.elastic.co/guide/en/machine-learning/current"
- eland-docs: "https://www.elastic.co/guide/en/elasticsearch/client/eland/current"
- eql-ref: "https://eql.readthedocs.io/en/latest/query-guide"
- extendtrial: "https://www.elastic.co/trialextension"
- wikipedia: "https://en.wikipedia.org/wiki"
- forum: "https://discuss.elastic.co/"
- xpack-forum: "https://discuss.elastic.co/c/50-x-pack"
- security-forum: "https://discuss.elastic.co/c/x-pack/shield"
- watcher-forum: "https://discuss.elastic.co/c/x-pack/watcher"
- monitoring-forum: "https://discuss.elastic.co/c/x-pack/marvel"
- graph-forum: "https://discuss.elastic.co/c/x-pack/graph"
- apm-forum: "https://discuss.elastic.co/c/apm"
- enterprise-search-ref: "https://www.elastic.co/guide/en/enterprise-search/current"
- app-search-ref: "https://www.elastic.co/guide/en/app-search/current"
- workplace-search-ref: "https://www.elastic.co/guide/en/workplace-search/current"
- enterprise-search-node-ref: "https://www.elastic.co/guide/en/enterprise-search-clients/enterprise-search-node/current"
- enterprise-search-php-ref: "https://www.elastic.co/guide/en/enterprise-search-clients/php/current"
- enterprise-search-python-ref: "https://www.elastic.co/guide/en/enterprise-search-clients/python/current"
- enterprise-search-ruby-ref: "https://www.elastic.co/guide/en/enterprise-search-clients/ruby/current"
- elastic-maps-service: "https://maps.elastic.co"
- integrations-docs: "https://docs.elastic.co/en/integrations"
- integrations-devguide: "https://www.elastic.co/guide/en/integrations-developer/current"
- time-units: "https://www.elastic.co/guide/en/elasticsearch/reference/current/api-conventions.html#time-units"
- byte-units: "https://www.elastic.co/guide/en/elasticsearch/reference/current/api-conventions.html#byte-units"
- apm-py-ref-v: "https://www.elastic.co/guide/en/apm/agent/python/current"
- apm-node-ref-v: "https://www.elastic.co/guide/en/apm/agent/nodejs/current"
- apm-rum-ref-v: "https://www.elastic.co/guide/en/apm/agent/rum-js/current"
- apm-ruby-ref-v: "https://www.elastic.co/guide/en/apm/agent/ruby/current"
- apm-java-ref-v: "https://www.elastic.co/guide/en/apm/agent/java/current"
- apm-go-ref-v: "https://www.elastic.co/guide/en/apm/agent/go/current"
- apm-ios-ref-v: "https://www.elastic.co/guide/en/apm/agent/swift/current"
- apm-dotnet-ref-v: "https://www.elastic.co/guide/en/apm/agent/dotnet/current"
- apm-php-ref-v: "https://www.elastic.co/guide/en/apm/agent/php/current"
ecloud: "Elastic Cloud"
- esf: "Elastic Serverless Forwarder"
- ess: "Elasticsearch Service"
- ece: "Elastic Cloud Enterprise"
- eck: "Elastic Cloud on Kubernetes"
- serverless-full: "Elastic Cloud Serverless"
- serverless-short: "Serverless"
- es-serverless: "Elasticsearch Serverless"
- es3: "Elasticsearch Serverless"
- obs-serverless: "Elastic Observability Serverless"
- sec-serverless: "Elastic Security Serverless"
- serverless-docs: "https://docs.elastic.co/serverless"
- cloud: "https://www.elastic.co/guide/en/cloud/current"
- ess-utm-params: "?page=docs&placement=docs-body"
- ess-baymax: "?page=docs&placement=docs-body"
- ess-trial: "https://cloud.elastic.co/registration?page=docs&placement=docs-body"
- ess-product: "https://www.elastic.co/cloud/elasticsearch-service?page=docs&placement=docs-body"
- ess-console: "https://cloud.elastic.co?page=docs&placement=docs-body"
- ess-console-name: "Elasticsearch Service Console"
- ess-deployments: "https://cloud.elastic.co/deployments?page=docs&placement=docs-body"
- ece-ref: "https://www.elastic.co/guide/en/cloud-enterprise/current"
- eck-ref: "https://www.elastic.co/guide/en/cloud-on-k8s/current"
- ess-leadin: "You can run Elasticsearch on your own hardware or use our hosted Elasticsearch Service that is available on AWS, GCP, and Azure. https://cloud.elastic.co/registration{ess-utm-params}[Try the Elasticsearch Service for free]."
- ess-leadin-short: "Our hosted Elasticsearch Service is available on AWS, GCP, and Azure, and you can https://cloud.elastic.co/registration{ess-utm-params}[try it for free]."
- ess-icon: "image:https://doc-icons.s3.us-east-2.amazonaws.com/logo_cloud.svg[link=\"https://cloud.elastic.co/registration{ess-utm-params}\", title=\"Supported on Elasticsearch Service\"]"
- ece-icon: "image:https://doc-icons.s3.us-east-2.amazonaws.com/logo_cloud_ece.svg[link=\"https://cloud.elastic.co/registration{ess-utm-params}\", title=\"Supported on Elastic Cloud Enterprise\"]"
- cloud-only: "This feature is designed for indirect use by https://cloud.elastic.co/registration{ess-utm-params}[Elasticsearch Service], https://www.elastic.co/guide/en/cloud-enterprise/{ece-version-link}[Elastic Cloud Enterprise], and https://www.elastic.co/guide/en/cloud-on-k8s/current[Elastic Cloud on Kubernetes]. Direct use is not supported."
- ess-setting-change: "image:https://doc-icons.s3.us-east-2.amazonaws.com/logo_cloud.svg[link=\"{ess-trial}\", title=\"Supported on {ess}\"] indicates a change to a supported https://www.elastic.co/guide/en/cloud/current/ec-add-user-settings.html[user setting] for Elasticsearch Service."
- ess-skip-section: "If you use Elasticsearch Service, skip this section. Elasticsearch Service handles these changes for you."
- api-cloud: "https://www.elastic.co/docs/api/doc/cloud"
- api-ece: "https://www.elastic.co/docs/api/doc/cloud-enterprise"
- api-kibana-serverless: "https://www.elastic.co/docs/api/doc/serverless"
- es-feature-flag: "This feature is in development and not yet available for use. This documentation is provided for informational purposes only."
- es-ref-dir: "'{{elasticsearch-root}}/docs/reference'"
- apm-app: "APM app"
- uptime-app: "Uptime app"
- synthetics-app: "Synthetics app"
- logs-app: "Logs app"
- metrics-app: "Metrics app"
- infrastructure-app: "Infrastructure app"
- siem-app: "SIEM app"
- security-app: "Elastic Security app"
- ml-app: "Machine Learning"
- dev-tools-app: "Dev Tools"
- ingest-manager-app: "Ingest Manager"
- stack-manage-app: "Stack Management"
- stack-monitor-app: "Stack Monitoring"
- alerts-ui: "Alerts and Actions"
- rules-ui: "Rules"
- rac-ui: "Rules and Connectors"
- connectors-ui: "Connectors"
- connectors-feature: "Actions and Connectors"
- stack-rules-feature: "Stack Rules"
- user-experience: "User Experience"
- ems: "Elastic Maps Service"
- ems-init: "EMS"
- hosted-ems: "Elastic Maps Server"
- ipm-app: "Index Pattern Management"
- ingest-pipelines: "ingest pipelines"
- ingest-pipelines-app: "Ingest Pipelines"
- ingest-pipelines-cap: "Ingest pipelines"
- ls-pipelines: "Logstash pipelines"
- ls-pipelines-app: "Logstash Pipelines"
- maint-windows: "maintenance windows"
- maint-windows-app: "Maintenance Windows"
- maint-windows-cap: "Maintenance windows"
- custom-roles-app: "Custom Roles"
- data-source: "data view"
- data-sources: "data views"
- data-source-caps: "Data View"
- data-sources-caps: "Data Views"
- data-source-cap: "Data view"
- data-sources-cap: "Data views"
- project-settings: "Project settings"
- manage-app: "Management"
- index-manage-app: "Index Management"
- data-views-app: "Data Views"
- rules-app: "Rules"
- saved-objects-app: "Saved Objects"
- tags-app: "Tags"
- api-keys-app: "API keys"
- transforms-app: "Transforms"
- connectors-app: "Connectors"
- files-app: "Files"
- reports-app: "Reports"
- maps-app: "Maps"
- alerts-app: "Alerts"
- crawler: "Enterprise Search web crawler"
- ents: "Enterprise Search"
- app-search-crawler: "App Search web crawler"
- agent: "Elastic Agent"
- agents: "Elastic Agents"
- fleet: "Fleet"
- fleet-server: "Fleet Server"
- integrations-server: "Integrations Server"
- ingest-manager: "Ingest Manager"
- ingest-management: "ingest management"
- package-manager: "Elastic Package Manager"
- integrations: "Integrations"
- package-registry: "Elastic Package Registry"
- artifact-registry: "Elastic Artifact Registry"
- aws: "AWS"
- stack: "Elastic Stack"
- xpack: "X-Pack"
- es: "Elasticsearch"
- kib: "Kibana"
- esms: "Elastic Stack Monitoring Service"
- esms-init: "ESMS"
- ls: "Logstash"
- beats: "Beats"
- auditbeat: "Auditbeat"
- filebeat: "Filebeat"
- heartbeat: "Heartbeat"
- metricbeat: "Metricbeat"
- packetbeat: "Packetbeat"
- winlogbeat: "Winlogbeat"
- functionbeat: "Functionbeat"
- journalbeat: "Journalbeat"
- es-sql: "Elasticsearch SQL"
- esql: "ES|QL"
- elastic-agent: "Elastic Agent"
- k8s: "Kubernetes"
- log-driver-long: "Elastic Logging Plugin for Docker"
- security: "X-Pack security"
- security-features: "security features"
- operator-feature: "operator privileges feature"
- es-security-features: "Elasticsearch security features"
- stack-security-features: "Elastic Stack security features"
- endpoint-sec: "Endpoint Security"
- endpoint-cloud-sec: "Endpoint and Cloud Security"
- elastic-defend: "Elastic Defend"
- elastic-sec: "Elastic Security"
- elastic-endpoint: "Elastic Endpoint"
- swimlane: "Swimlane"
- sn: "ServiceNow"
- sn-itsm: "ServiceNow ITSM"
- sn-itom: "ServiceNow ITOM"
- sn-sir: "ServiceNow SecOps"
- jira: "Jira"
- ibm-r: "IBM Resilient"
- webhook: "Webhook"
- webhook-cm: "Webhook - Case Management"
- opsgenie: "Opsgenie"
- bedrock: "Amazon Bedrock"
- gemini: "Google Gemini"
- hive: "TheHive"
- monitoring: "X-Pack monitoring"
- monitor-features: "monitoring features"
- stack-monitor-features: "Elastic Stack monitoring features"
- watcher: "Watcher"
- alert-features: "alerting features"
- reporting: "X-Pack reporting"
- report-features: "reporting features"
- graph: "X-Pack graph"
- graph-features: "graph analytics features"
- searchprofiler: "Search Profiler"
- xpackml: "X-Pack machine learning"
- ml: "machine learning"
- ml-cap: "Machine learning"
- ml-init: "ML"
- ml-features: "machine learning features"
- stack-ml-features: "Elastic Stack machine learning features"
- ccr: "cross-cluster replication"
- ccr-cap: "Cross-cluster replication"
- ccr-init: "CCR"
- ccs: "cross-cluster search"
- ccs-cap: "Cross-cluster search"
- ccs-init: "CCS"
- ilm: "index lifecycle management"
- ilm-cap: "Index lifecycle management"
- ilm-init: "ILM"
- dlm: "data lifecycle management"
- dlm-cap: "Data lifecycle management"
- dlm-init: "DLM"
- search-snap: "searchable snapshot"
- search-snaps: "searchable snapshots"
- search-snaps-cap: "Searchable snapshots"
- slm: "snapshot lifecycle management"
- slm-cap: "Snapshot lifecycle management"
- slm-init: "SLM"
- rollup-features: "data rollup features"
- ipm: "index pattern management"
- ipm-cap: "Index pattern"
- rollup: "rollup"
- rollup-cap: "Rollup"
- rollups: "rollups"
- rollups-cap: "Rollups"
- rollup-job: "rollup job"
- rollup-jobs: "rollup jobs"
- rollup-jobs-cap: "Rollup jobs"
- dfeed: "datafeed"
- dfeeds: "datafeeds"
- dfeed-cap: "Datafeed"
- dfeeds-cap: "Datafeeds"
- ml-jobs: "machine learning jobs"
- ml-jobs-cap: "Machine learning jobs"
- anomaly-detect: "anomaly detection"
- anomaly-detect-cap: "Anomaly detection"
- anomaly-job: "anomaly detection job"
- anomaly-jobs: "anomaly detection jobs"
- anomaly-jobs-cap: "Anomaly detection jobs"
- dataframe: "data frame"
- dataframes: "data frames"
- dataframe-cap: "Data frame"
- dataframes-cap: "Data frames"
- watcher-transform: "payload transform"
- watcher-transforms: "payload transforms"
- watcher-transform-cap: "Payload transform"
- watcher-transforms-cap: "Payload transforms"
- transform: "transform"
- transforms: "transforms"
- transform-cap: "Transform"
- transforms-cap: "Transforms"
- dataframe-transform: "transform"
- dataframe-transform-cap: "Transform"
- dataframe-transforms: "transforms"
- dataframe-transforms-cap: "Transforms"
- dfanalytics-cap: "Data frame analytics"
- dfanalytics: "data frame analytics"
- dataframe-analytics-config: "'{dataframe} analytics config'"
- dfanalytics-job: "'{dataframe} analytics job'"
- dfanalytics-jobs: "'{dataframe} analytics jobs'"
- dfanalytics-jobs-cap: "'{dataframe-cap} analytics jobs'"
- cdataframe: "continuous data frame"
- cdataframes: "continuous data frames"
- cdataframe-cap: "Continuous data frame"
- cdataframes-cap: "Continuous data frames"
- cdataframe-transform: "continuous transform"
- cdataframe-transforms: "continuous transforms"
- cdataframe-transforms-cap: "Continuous transforms"
- ctransform: "continuous transform"
- ctransform-cap: "Continuous transform"
- ctransforms: "continuous transforms"
- ctransforms-cap: "Continuous transforms"
- oldetection: "outlier detection"
- oldetection-cap: "Outlier detection"
- olscore: "outlier score"
- olscores: "outlier scores"
- fiscore: "feature influence score"
- evaluatedf-api: "evaluate {dataframe} analytics API"
- evaluatedf-api-cap: "Evaluate {dataframe} analytics API"
- binarysc: "binary soft classification"
- binarysc-cap: "Binary soft classification"
- regression: "regression"
- regression-cap: "Regression"
- reganalysis: "regression analysis"
- reganalysis-cap: "Regression analysis"
- depvar: "dependent variable"
- feature-var: "feature variable"
- feature-vars: "feature variables"
- feature-vars-cap: "Feature variables"
- classification: "classification"
- classification-cap: "Classification"
- classanalysis: "classification analysis"
- classanalysis-cap: "Classification analysis"
- infer-cap: "Inference"
- infer: "inference"
- lang-ident-cap: "Language identification"
- lang-ident: "language identification"
- data-viz: "Data Visualizer"
- file-data-viz: "File Data Visualizer"
- feat-imp: "feature importance"
- feat-imp-cap: "Feature importance"
- nlp: "natural language processing"
- nlp-cap: "Natural language processing"
- apm-agent: "APM agent"
- apm-go-agent: "Elastic APM Go agent"
- apm-go-agents: "Elastic APM Go agents"
- apm-ios-agent: "Elastic APM iOS agent"
- apm-ios-agents: "Elastic APM iOS agents"
- apm-java-agent: "Elastic APM Java agent"
- apm-java-agents: "Elastic APM Java agents"
- apm-dotnet-agent: "Elastic APM .NET agent"
- apm-dotnet-agents: "Elastic APM .NET agents"
- apm-node-agent: "Elastic APM Node.js agent"
- apm-node-agents: "Elastic APM Node.js agents"
- apm-php-agent: "Elastic APM PHP agent"
- apm-php-agents: "Elastic APM PHP agents"
- apm-py-agent: "Elastic APM Python agent"
- apm-py-agents: "Elastic APM Python agents"
- apm-ruby-agent: "Elastic APM Ruby agent"
- apm-ruby-agents: "Elastic APM Ruby agents"
- apm-rum-agent: "Elastic APM Real User Monitoring (RUM) JavaScript agent"
- apm-rum-agents: "Elastic APM RUM JavaScript agents"
apm-lambda-ext: "Elastic APM AWS Lambda extension"
- project-monitors: "project monitors"
- project-monitors-cap: "Project monitors"
- private-location: "Private Location"
- private-locations: "Private Locations"
- pwd: "YOUR_PASSWORD"
- esh: "ES-Hadoop"
- default-dist: "default distribution"
- oss-dist: "OSS-only distribution"
- observability: "Observability"
- api-request-title: "Request"
- api-prereq-title: "Prerequisites"
- api-description-title: "Description"
- api-path-parms-title: "Path parameters"
- api-query-parms-title: "Query parameters"
- api-request-body-title: "Request body"
- api-response-codes-title: "Response codes"
- api-response-body-title: "Response body"
- api-example-title: "Example"
- api-examples-title: "Examples"
- api-definitions-title: "Properties"
- multi-arg: "†footnoteref:[multi-arg,This parameter accepts multiple arguments.]"
- multi-arg-ref: "†footnoteref:[multi-arg]"
- yes-icon: "image:https://doc-icons.s3.us-east-2.amazonaws.com/icon-yes.png[Yes,20,15]"
- no-icon: "image:https://doc-icons.s3.us-east-2.amazonaws.com/icon-no.png[No,20,15]"
- es-repo: "https://github.com/elastic/elasticsearch/"
- es-issue: "https://github.com/elastic/elasticsearch/issues/"
- es-pull: "https://github.com/elastic/elasticsearch/pull/"
- es-commit: "https://github.com/elastic/elasticsearch/commit/"
- kib-repo: "https://github.com/elastic/kibana/"
- kib-issue: "https://github.com/elastic/kibana/issues/"
- kibana-issue: "'{kib-repo}issues/'"
- kib-pull: "https://github.com/elastic/kibana/pull/"
- kibana-pull: "'{kib-repo}pull/'"
- kib-commit: "https://github.com/elastic/kibana/commit/"
- ml-repo: "https://github.com/elastic/ml-cpp/"
- ml-issue: "https://github.com/elastic/ml-cpp/issues/"
- ml-pull: "https://github.com/elastic/ml-cpp/pull/"
- ml-commit: "https://github.com/elastic/ml-cpp/commit/"
- apm-repo: "https://github.com/elastic/apm-server/"
- apm-issue: "https://github.com/elastic/apm-server/issues/"
- apm-pull: "https://github.com/elastic/apm-server/pull/"
- kibana-blob: "https://github.com/elastic/kibana/blob/current/"
- apm-get-started-ref: "https://www.elastic.co/guide/en/apm/get-started/current"
- apm-server-ref: "https://www.elastic.co/guide/en/apm/server/current"
- apm-server-ref-v: "https://www.elastic.co/guide/en/apm/server/current"
- apm-server-ref-m: "https://www.elastic.co/guide/en/apm/server/master"
- apm-server-ref-62: "https://www.elastic.co/guide/en/apm/server/6.2"
- apm-server-ref-64: "https://www.elastic.co/guide/en/apm/server/6.4"
- apm-server-ref-70: "https://www.elastic.co/guide/en/apm/server/7.0"
- apm-overview-ref-v: "https://www.elastic.co/guide/en/apm/get-started/current"
- apm-overview-ref-70: "https://www.elastic.co/guide/en/apm/get-started/7.0"
- apm-overview-ref-m: "https://www.elastic.co/guide/en/apm/get-started/master"
- infra-guide: "https://www.elastic.co/guide/en/infrastructure/guide/current"
- a-data-source: "a data view"
- icon-bug: "pass:[]"
- icon-checkInCircleFilled: "pass:[]"
- icon-warningFilled: "pass:[]"
diff --git a/docs/reference/configuration.md b/docs/reference/configuration.md
index 2930b1587..8cc897b01 100644
--- a/docs/reference/configuration.md
+++ b/docs/reference/configuration.md
@@ -29,7 +29,7 @@ ELASTIC_APM = {
The precedence is as follows:
-* [Central configuration](#config-central_config) (supported options are marked with [ ](#dynamic-configuration))
+* [Central configuration](#config-central_config) (supported options are marked with [ ](#dynamic-configuration))
* Environment variables
* Inline configuration
* Framework-specific configuration
@@ -38,7 +38,7 @@ The precedence is as follows:
## Dynamic configuration [dynamic-configuration]
-Configuration options marked with the  badge can be changed at runtime when set from a supported source.
+Configuration options marked with the  badge can be changed at runtime when set from a supported source.
The Python Agent supports [Central configuration](docs-content://solutions/observability/apps/apm-agent-central-configuration.md), which allows you to fine-tune certain configurations from in the APM app. This feature is enabled in the Agent by default with [`central_config`](#config-central_config).
@@ -108,7 +108,7 @@ Enable or disable the agent. When set to false, the agent will not collect any d
## `recording` [config-recording]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -122,7 +122,7 @@ Enable or disable recording of events. If set to false, then the Python agent do
### `log_level` [config-log_level]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -320,7 +320,7 @@ A list of exception types to be filtered. Exceptions of these types will not be
### `transaction_ignore_urls` [config-transaction-ignore-urls]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default | Example |
| --- | --- | --- | --- |
@@ -460,7 +460,7 @@ Especially for spans, collecting source code can have a large impact on storage
### `capture_body` [config-capture-body]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -482,7 +482,7 @@ Request bodies often contain sensitive values like passwords and credit card num
### `capture_headers` [config-capture-headers]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -500,7 +500,7 @@ Request headers often contain sensitive values like session IDs and cookies. See
### `transaction_max_spans` [config-transaction-max-spans]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -511,7 +511,7 @@ This limits the amount of spans that are recorded per transaction. This is helpf
### `stack_trace_limit` [config-stack-trace-limit]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -524,7 +524,7 @@ Setting the limit to `0` will disable stack trace collection, while any positive
### `span_stack_trace_min_duration` [config-span-stack-trace-min-duration]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -541,7 +541,7 @@ Except for the special values `-1` and `0`, this setting should be provided in *
### `span_frames_min_duration` [config-span-frames-min-duration]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -555,7 +555,7 @@ This config value is being deprecated. Use [`span_stack_trace_min_duration`](#co
### `span_compression_enabled` [config-span-compression-enabled]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -568,7 +568,7 @@ If enabled, the agent will compress very short, repeated spans into a single spa
### `span_compression_exact_match_max_duration` [config-span-compression-exact-match-max_duration]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -581,7 +581,7 @@ Two spans are considered exact matches if the following attributes are identical
### `span_compression_same_kind_max_duration` [config-span-compression-same-kind-max-duration]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -594,7 +594,7 @@ Two spans are considered to be of the same kind if the following attributes are
### `exit_span_min_duration` [config-exit-span-min-duration]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -612,7 +612,7 @@ if a span propagates distributed tracing IDs, it will not be ignored, even if it
### `api_request_size` [config-api-request-size]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -630,7 +630,7 @@ Due to internal buffering of gzip, the actual request size can be a few kilobyte
### `api_request_time` [config-api-request-time]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -662,7 +662,7 @@ We recommend always including the default set of validators if you customize thi
### `sanitize_field_names` [config-sanitize-field-names]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -678,7 +678,7 @@ We recommend always including the default set of field name matches if you custo
### `transaction_sample_rate` [config-transaction-sample-rate]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
@@ -930,7 +930,7 @@ Additionally, when this setting is set to `True`, the agent will set `elasticapm
### `trace_continuation_strategy` [config-trace-continuation-strategy]
-[ ](#dynamic-configuration)
+[ ](#dynamic-configuration)
| Environment | Django/Flask | Default |
| --- | --- | --- |
diff --git a/docs/reference/django-support.md b/docs/reference/django-support.md
index 9db46e864..e85f5a8a8 100644
--- a/docs/reference/django-support.md
+++ b/docs/reference/django-support.md
@@ -171,7 +171,7 @@ ELASTIC_APM = {
To easily send Python `logging` messages as "error" objects to Elasticsearch, we provide a `LoggingHandler` which you can use in your logging setup. The log messages will be enriched with a stack trace, data from the request, and more.
::::{note}
-the intended use case for this handler is to send high priority log messages (e.g. log messages with level `ERROR`) to Elasticsearch. For normal log shipping, we recommend using [filebeat](beats://reference/filebeat/filebeat-overview.md).
+the intended use case for this handler is to send high priority log messages (e.g. log messages with level `ERROR`) to Elasticsearch. For normal log shipping, we recommend using [filebeat](beats://reference/filebeat/index.md).
::::
diff --git a/docs/images/choose-a-layer.png b/docs/reference/images/choose-a-layer.png
similarity index 100%
rename from docs/images/choose-a-layer.png
rename to docs/reference/images/choose-a-layer.png
diff --git a/docs/images/config-layer.png b/docs/reference/images/config-layer.png
similarity index 100%
rename from docs/images/config-layer.png
rename to docs/reference/images/config-layer.png
diff --git a/docs/images/dynamic-config.svg b/docs/reference/images/dynamic-config.svg
similarity index 100%
rename from docs/images/dynamic-config.svg
rename to docs/reference/images/dynamic-config.svg
diff --git a/docs/images/python-lambda-env-vars.png b/docs/reference/images/python-lambda-env-vars.png
similarity index 100%
rename from docs/images/python-lambda-env-vars.png
rename to docs/reference/images/python-lambda-env-vars.png
diff --git a/docs/reference/lambda-support.md b/docs/reference/lambda-support.md
index f720b9ccc..60f9eb114 100644
--- a/docs/reference/lambda-support.md
+++ b/docs/reference/lambda-support.md
@@ -29,7 +29,7 @@ Both the [{{apm-lambda-ext}}](apm-aws-lambda://reference/index.md) and the Pytho
To add the layers to your Lambda function through the AWS Management Console:
1. Navigate to your function in the AWS Management Console
-2. Scroll to the Layers section and click the *Add a layer* button 
+2. Scroll to the Layers section and click the *Add a layer* button 
3. Choose the *Specify an ARN* radio button
4. Copy and paste the following ARNs of the {{apm-lambda-ext}} layer and the APM agent layer in the *Specify an ARN* text input:
* APM Extension layer:
@@ -44,7 +44,7 @@ To add the layers to your Lambda function through the AWS Management Console:
```
1. Replace `{AWS_REGION}` with the AWS region of your Lambda function.
- 
+ 
5. Click the *Add* button
::::::
@@ -159,7 +159,7 @@ ELASTIC_APM_SEND_STRATEGY = background <4>
3. This is your APM secret token.
4. The [ELASTIC_APM_SEND_STRATEGY](apm-aws-lambda://reference/aws-lambda-config-options.md#_elastic_apm_send_strategy) defines when APM data is sent to your Elastic APM backend. To reduce the execution time of your lambda functions, we recommend to use the background strategy in production environments with steady load scenarios.
-
+
::::::
::::::{tab-item} AWS CLI