diff --git a/docs/docset.yml b/docs/docset.yml
index cfc068c8e..b28fc3645 100644
--- a/docs/docset.yml
+++ b/docs/docset.yml
@@ -11,482 +11,4 @@ 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/config-all-options-summary.md b/docs/reference/config-all-options-summary.md
index f528ffafe..ce8466daf 100644
--- a/docs/reference/config-all-options-summary.md
+++ b/docs/reference/config-all-options-summary.md
@@ -5,7 +5,7 @@ mapped_pages:
# All options summary [config-all-options-summary]
-| Option name | [ ](/reference/configuration.md#dynamic-configuration) | Keywords |
+| Option name | [ ](/reference/configuration.md#dynamic-configuration) | Keywords |
| --- | --- | --- |
| [`ApiKey`](/reference/config-reporter.md#config-api-key) | No | Reporter |
| [`ApplicationNamespaces`](/reference/config-stacktrace.md#config-application-namespaces) | No | Stacktrace |
diff --git a/docs/reference/config-core.md b/docs/reference/config-core.md
index bb68b667c..a318ac70d 100644
--- a/docs/reference/config-core.md
+++ b/docs/reference/config-core.md
@@ -8,7 +8,7 @@ mapped_pages:
## `Recording` ([1.7.0]) [config-recording]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
A Boolean specifying if the agent should be recording or not. When recording, the agent captures HTTP requests, tracks errors, and collects and sends metrics. When not recording, the agent works as a noop, where it does not collect data or communicate with the APM server, except for polling the central configuration endpoint. This is a reversible switch, so the agent threads are not killed when deactivated, but they will be mostly idle in this state, so the overhead should be negligible.
@@ -135,7 +135,7 @@ On ASP.NET Core application the agent uses [EnvironmentName from IHostingEnviron
## `TransactionSampleRate` [config-transaction-sample-rate]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
By default, the agent samples every transaction (e.g. a request to your service). To reduce overhead and storage requirements, set the sample rate to a value between 0.0 and 1.0. The agent will still record the overall time and result for unsampled transactions, but no context information, labels, or spans will be recorded.
@@ -157,7 +157,7 @@ This setting can be changed after the agent starts.
## `TransactionMaxSpans` (performance) ([1.1.1]) [config-transaction-max-spans]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
This limits the amount of spans that are recorded per transaction. This is helpful when a transaction creates a very high amount of spans, for example, thousands of SQL queries. Setting an upper limit helps prevent overloading the Agent and APM server in these edge cases.
@@ -192,7 +192,7 @@ If set to `true`, the agent makes periodic requests to the APM Server to fetch t
## `SanitizeFieldNames` ([1.2]) [config-sanitize-field-names]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
Sometimes, sanitizing, i.e., redacting sensitive data sent to Elastic APM, is necessary. This configuration accepts a comma-separated list of wildcard patterns of field names that should be sanitized. These apply to HTTP headers for requests and responses, cookies and `application/x-www-form-urlencoded` data.
@@ -243,7 +243,7 @@ This option requires APM Server 7.2 or later. It will have no effect on older ve
## `SpanCompressionEnabled` ([1.14]) [config-span-compression-enabled]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
Setting this option to true will enable span compression feature. Span compression reduces the collection, processing, and storage overhead, and removes clutter from the UI. The tradeoff is that some information such as DB statements of all the compressed spans will not be collected.
@@ -258,7 +258,7 @@ Setting this option to true will enable span compression feature. Span compressi
## `SpanCompressionExactMatchMaxDuration` ([1.14]) [config-span-compression-exact-match-max-duration]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
Consecutive spans that are exact match and that are under this threshold will be compressed into a single composite span. This option does not apply to composite spans. This reduces the collection, processing, and storage overhead, and removes clutter from the UI. The tradeoff is that the DB statements of all the compressed spans will not be collected.
@@ -273,7 +273,7 @@ Consecutive spans that are exact match and that are under this threshold will be
## `SpanCompressionSameKindMaxDuration` ([1.14]) [config-span-compression-same-kind-max-duration]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
Consecutive spans to the same destination that are under this threshold will be compressed into a single composite span. This option does not apply to composite spans. This reduces the collection, processing, and storage overhead, and removes clutter from the UI. The tradeoff is that the DB statements of all the compressed spans will not be collected.
@@ -288,7 +288,7 @@ Consecutive spans to the same destination that are under this threshold will be
## `ExitSpanMinDuration` ([1.14]) [config-exit-span-min-duration]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
Sets the minimum duration of exit spans. Exit spans with a duration lesser than this threshold are attempted to be discarded. If the exit span is equal or greater the threshold, it should be kept. In some cases exit spans cannot be discarded. For example, spans that propagate the trace context to downstream services, such as outgoing HTTP requests, can’t be discarded. However, external calls that don’t propagate context, such as calls to a database, can be discarded using this threshold. Additionally, spans that lead to an error can’t be discarded.
diff --git a/docs/reference/config-http.md b/docs/reference/config-http.md
index bbc9e7fc3..1b7bda983 100644
--- a/docs/reference/config-http.md
+++ b/docs/reference/config-http.md
@@ -8,7 +8,7 @@ mapped_pages:
## `CaptureBody` (performance) ([1.0.1]) [config-capture-body]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
For transactions that are HTTP requests, the agent can optionally capture the request body, e.g., POST variables. If the request has a body and this setting is disabled, the body will be shown as [REDACTED]. This option is case-insensitive.
@@ -65,7 +65,7 @@ This setting can be changed after the agent starts.
## `CaptureHeaders` (performance) [config-capture-headers]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
If set to `true`, the agent will capture request and response headers, including cookies.
@@ -85,7 +85,7 @@ Setting this to `false` reduces memory allocations, network bandwidth, and disk
## `TraceContinuationStrategy` (performance) ([1.17.0]) [config-trace-continuation-strategy]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
Valid options: `continue`, `restart`, `restart_external`.
@@ -110,7 +110,7 @@ In order to handle this properly, the agent offers trace continuation strategies
## `TransactionIgnoreUrls` (performance) [config-transaction-ignore-urls]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
This is used to restrict requests to certain URLs from being instrumented.
@@ -151,7 +151,7 @@ Changing this configuration will overwrite the default value.
## `TransactionNameGroups` ([1.27.0]) [config-transaction-name-groups]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
With this option, you can group transaction names that contain dynamic parts with a wildcard expression. For example, the pattern `GET /user/*/cart` would consolidate transactions, such as `GET /users/42/cart` and `GET /users/73/cart` into a single transaction name `GET /users/*/cart`, hence reducing the transaction name cardinality.
@@ -183,7 +183,7 @@ When this setting is `true`, the agent also adds the header `elasticapm-tracepar
## `UsePathAsTransactionName` ([1.27.0]) [config-use-path-as-transaction-name]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
If set to `true`, transaction names of unsupported or partially-supported frameworks will be in the form of `$method $path` instead of just `$method unknown route`.
@@ -218,7 +218,7 @@ This is useful when using windows authentication on a proxy, that routes APM age
## `BaggageToAttach` ([1.24]) [config-baggage-to-attach]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
Controls which baggage values are automatically attached to the given event (transaction, span, error). Baggage values are derived from the `baggage` header defined in the [W3C Baggage specification](https://www.w3.org/TR/baggage/). You can programmatically write and read baggage values via the [Activity API](https://learn.microsoft.com/en-us/dotnet/api/system.diagnostics.activity?view=net-6.0). For more details, see [`our documentation on how to integrate with OpenTelemetry`](/reference/opentelemetry-bridge.md#baggage-api).
diff --git a/docs/reference/config-stacktrace.md b/docs/reference/config-stacktrace.md
index 2c9c8a9a6..bdaa6540a 100644
--- a/docs/reference/config-stacktrace.md
+++ b/docs/reference/config-stacktrace.md
@@ -39,7 +39,7 @@ Namespaces are checked with `string.StartsWith()`, so "System." matches all Syst
## `StackTraceLimit` (performance) [config-stack-trace-limit]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
Setting this to `0` disables stack trace collection. Any positive integer value will be used as the maximum number of frames to collect. Setting it to -1 means that all frames will be collected.
@@ -59,7 +59,7 @@ If you would like to disable stack trace capturing only for spans, but still cap
### `SpanStackTraceMinDuration` (performance) [config-span-stack-trace-min-duration]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
In its default settings, the APM agent collects a stack trace for every recorded span with duration longer than `5ms`. While this is very helpful to find the exact place in your code that causes the span, collecting this stack trace does have some overhead. When setting this option to zero (regardless of the time unit), like `0ms`, stack traces are collected for all spans. Setting it to a positive value, e.g. `5ms`, limits stack trace collection to spans with durations equal to or longer than the given value, e.g. 5 milliseconds.
diff --git a/docs/reference/config-supportability.md b/docs/reference/config-supportability.md
index e9c7aa11a..f26abc22b 100644
--- a/docs/reference/config-supportability.md
+++ b/docs/reference/config-supportability.md
@@ -8,7 +8,7 @@ mapped_pages:
## `LogLevel` [config-log-level]
-[ ](/reference/configuration.md#dynamic-configuration)
+[ ](/reference/configuration.md#dynamic-configuration)
Sets the logging level for the agent.
diff --git a/docs/reference/configuration.md b/docs/reference/configuration.md
index d9a0f9583..9bd50deb0 100644
--- a/docs/reference/configuration.md
+++ b/docs/reference/configuration.md
@@ -12,7 +12,7 @@ By default, the agent uses environment variables. Additionally, on ASP.NET Core,
## Dynamic configuration [dynamic-configuration]
-Configuration options that are marked with the  badge can be changed at runtime when set from a supported source.
+Configuration options that are marked with the  badge can be changed at runtime when set from a supported source.
The .NET Agent supports [Central configuration](docs-content://solutions/observability/apps/apm-agent-central-configuration.md), which allows you to fine-tune certain configurations via the APM app. This feature is enabled in the Agent by default, with [`CentralConfig` ([1.1])](/reference/config-core.md#config-central-config).
diff --git a/docs/images/azure-functions-configuration.png b/docs/reference/images/azure-functions-configuration.png
similarity index 100%
rename from docs/images/azure-functions-configuration.png
rename to docs/reference/images/azure-functions-configuration.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/unblock-profiler-dll.png b/docs/reference/images/unblock-profiler-dll.png
similarity index 100%
rename from docs/images/unblock-profiler-dll.png
rename to docs/reference/images/unblock-profiler-dll.png
diff --git a/docs/reference/logs.md b/docs/reference/logs.md
index 5e14cbe54..aef8faae6 100644
--- a/docs/reference/logs.md
+++ b/docs/reference/logs.md
@@ -24,7 +24,7 @@ If your favorite logging framework is not already supported, there are two other
* Open a feature request, or contribute code, for additional support, as described in [CONTRIBUTING.md](https://github.com/elastic/apm-agent-dotnet/blob/main/CONTRIBUTING.md).
* Manually inject trace IDs into log records, as described in [Manual log correlation](/reference/log-correlation-manual.md).
-Regardless of how you integrate APM with logging, you can use [Filebeat](beats://reference/filebeat/filebeat-overview.md) to send your logs to Elasticsearch, in order to correlate your traces and logs and link from APM to the [Logs app](docs-content://solutions/observability/logs/explore-logs.md).
+Regardless of how you integrate APM with logging, you can use [Filebeat](beats://reference/filebeat/index.md) to send your logs to Elasticsearch, in order to correlate your traces and logs and link from APM to the [Logs app](docs-content://solutions/observability/logs/explore-logs.md).
diff --git a/docs/reference/metrics.md b/docs/reference/metrics.md
index 9f5fca6e7..d66ad06c4 100644
--- a/docs/reference/metrics.md
+++ b/docs/reference/metrics.md
@@ -35,7 +35,7 @@ For applications running in IIS, [IIS application pool identities use *virtual*
::::
-For more system metrics, consider installing [metricbeat](beats://reference/metricbeat/metricbeat.md) on your hosts.
+For more system metrics, consider installing [metricbeat](beats://reference/metricbeat/index.md) on your hosts.
**`system.cpu.total.norm.pct`**
: type: scaled_float
diff --git a/docs/reference/setup-auto-instrumentation.md b/docs/reference/setup-auto-instrumentation.md
index 74631b0ad..15aa01d0c 100644
--- a/docs/reference/setup-auto-instrumentation.md
+++ b/docs/reference/setup-auto-instrumentation.md
@@ -423,6 +423,6 @@ To unblock a DLL file on Windows, you can do the following:
* In the General tab, look for the Security section at the bottom
* Select the Unblock check box and click OK
-:::{image} ../images/unblock-profiler-dll.png
+:::{image} images/unblock-profiler-dll.png
:alt: Unblock DLL in Windows file properties
:::
diff --git a/docs/reference/setup-azure-functions.md b/docs/reference/setup-azure-functions.md
index 26122a0ab..44b02f240 100644
--- a/docs/reference/setup-azure-functions.md
+++ b/docs/reference/setup-azure-functions.md
@@ -92,7 +92,7 @@ Open *Settings > Environment variables* for your Function App in the Azure Porta
For example:
-:::{image} ../images/azure-functions-configuration.png
+:::{image} images/azure-functions-configuration.png
:alt: Configuring the APM Agent in the Azure Portal
:::