replace apm-agent-ruby asciidocalypse links

colleenmcginnis · colleenmcginnis · commit ce072eadff84 · 2025-03-19T12:54:45.000-05:00
diff --git a/docset.yml b/docset.yml
@@ -15,6 +15,7 @@ cross_links:
   - apm-agent-nodejs
   - apm-agent-php
   - apm-agent-python
+  - apm-agent-ruby
   - apm-agent-rum-js
   - apm-aws-lambda
   - apm-k8s-attacher
diff --git a/raw-migrated-files/docs-content/serverless/observability-apm-get-started.md b/raw-migrated-files/docs-content/serverless/observability-apm-get-started.md
@@ -412,8 +412,8 @@ To send APM data to Elastic, you must install an APM agent and configure it to s
 
         **Learn more in the {{apm-agent}} reference**
 
-        * [Supported technologies](asciidocalypse://docs/apm-agent-ruby/docs/reference/supported-technologies.md)
-        * [Advanced configuration](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md)
+        * [Supported technologies](apm-agent-ruby://reference/supported-technologies.md)
+        * [Advanced configuration](apm-agent-ruby://reference/configuration.md)
 
           </div>
           <div tabindex="0" role="tabpanel" id="apm-apm-get-started-opentelemetry-panel" aria-labelledby="apm-apm-get-started-opentelemetry-button" hidden="">
diff --git a/raw-migrated-files/docs-content/serverless/observability-ecs-application-logs.md b/raw-migrated-files/docs-content/serverless/observability-ecs-application-logs.md
@@ -42,7 +42,7 @@ To set up log ECS reformatting:
 Log ECS reformatting is controlled by the `log_ecs_reformatting` configuration option, and is disabled by default. Refer to the guide for your framework for information on enabling:
 
 * [Java](apm-agent-java://reference/config-logging.md#config-log-ecs-reformatting)
-* [Ruby](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-log-ecs-formatting)
+* [Ruby](apm-agent-ruby://reference/configuration.md#config-log-ecs-formatting)
 * [Python](apm-agent-python://reference/configuration.md#config-log_ecs_reformatting)
 
 
diff --git a/raw-migrated-files/docs-content/serverless/observability-plaintext-application-logs.md b/raw-migrated-files/docs-content/serverless/observability-plaintext-application-logs.md
@@ -390,7 +390,7 @@ Learn about correlating plaintext logs in the agent-specific ingestion guides:
 * [.NET](apm-agent-dotnet://reference/logs.md)
 * [Node.js](apm-agent-nodejs://reference/logs.md)
 * [Python](apm-agent-python://reference/logs.md#log-correlation-ids)
-* [Ruby](asciidocalypse://docs/apm-agent-ruby/docs/reference/logs.md)
+* [Ruby](apm-agent-ruby://reference/logs.md)
 
 
 ## View logs [observability-plaintext-application-logs-view-logs]
diff --git a/solutions/observability/apps/api-keys.md b/solutions/observability/apps/api-keys.md
@@ -114,7 +114,7 @@ You can now apply your newly created API keys in the configuration of each of yo
 * **Node.js agent**: [`apiKey`](apm-agent-nodejs://reference/configuration.md#api-key)
 * **PHP agent**: [`api_key`](apm-agent-php://reference/configuration-reference.md#config-api-key)
 * **Python agent**: [`api_key`](apm-agent-python://reference/configuration.md#config-api-key)
-* **Ruby agent**: [`api_key`](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-api-key)
+* **Ruby agent**: [`api_key`](apm-agent-ruby://reference/configuration.md#config-api-key)
 
 
 ## Alternate API key creation methods [apm-configure-api-key-alternative]
diff --git a/solutions/observability/apps/apm-agent-central-configuration.md b/solutions/observability/apps/apm-agent-central-configuration.md
@@ -56,7 +56,7 @@ Python agent
 :   [Configuration reference](apm-agent-python://reference/configuration.md)
 
 Ruby agent
-:   [Configuration reference](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md)
+:   [Configuration reference](apm-agent-ruby://reference/configuration.md)
 
 Real User Monitoring (RUM) agent
 :   [Configuration reference](apm-agent-rum-js://reference/configuration.md)
diff --git a/solutions/observability/apps/apm-agent-tls-communication.md b/solutions/observability/apps/apm-agent-tls-communication.md
@@ -57,7 +57,7 @@ When the APM server uses a certificate that is not chained to a publicly-trusted
 
 * **Go agent**: certificate pinning through [`ELASTIC_APM_SERVER_CERT`](apm-agent-go://reference/configuration.md#config-server-cert)
 * **Python agent**: certificate pinning through [`server_cert`](apm-agent-python://reference/configuration.md#config-server-cert)
-* **Ruby agent**: certificate pinning through [`server_ca_cert`](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-ssl-ca-cert)
+* **Ruby agent**: certificate pinning through [`server_ca_cert`](apm-agent-ruby://reference/configuration.md#config-ssl-ca-cert)
 * **.NET agent**: [`ServerCert`](apm-agent-dotnet://reference/config-reporter.md#config-server-cert)
 * **Node.js agent**: custom CA setting through [`serverCaCertFile`](apm-agent-nodejs://reference/configuration.md#server-ca-cert-file)
 * **Java agent**: adding the certificate to the JVM `trustStore`. See [APM Server authentication](apm-agent-java://reference/ssl-configuration.md#ssl-server-authentication) for more details.
@@ -69,7 +69,7 @@ We do not recommend disabling {{apm-agent}} verification of the server’s certi
 * **Java agent**: [`verify_server_cert`](apm-agent-java://reference/config-reporter.md#config-verify-server-cert)
 * **PHP agent**: [`verify_server_cert`](apm-agent-php://reference/configuration-reference.md#config-verify-server-cert)
 * **Python agent**: [`verify_server_cert`](apm-agent-python://reference/configuration.md#config-verify-server-cert)
-* **Ruby agent**: [`verify_server_cert`](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-verify-server-cert)
+* **Ruby agent**: [`verify_server_cert`](apm-agent-ruby://reference/configuration.md#config-verify-server-cert)
 * **Node.js agent**: [`verifyServerCert`](apm-agent-nodejs://reference/configuration.md#validate-server-cert)
 
 
diff --git a/solutions/observability/apps/apm-server-binary.md b/solutions/observability/apps/apm-server-binary.md
@@ -677,8 +677,8 @@ server_url: 'http://localhost:8200'
 
 **Learn more in the agent reference**
 
-* [Supported technologies](asciidocalypse://docs/apm-agent-ruby/docs/reference/supported-technologies.md)
-* [Advanced configuration](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md)
+* [Supported technologies](apm-agent-ruby://reference/supported-technologies.md)
+* [Advanced configuration](apm-agent-ruby://reference/configuration.md)
 ::::::
 
 ::::::{tab-item} RUM
diff --git a/solutions/observability/apps/built-in-data-filters.md b/solutions/observability/apps/built-in-data-filters.md
@@ -29,7 +29,7 @@ This setting supports [Central configuration](apm-agent-central-configuration.md
 * .NET: [`sanitizeFieldNames`](apm-agent-dotnet://reference/config-core.md#config-sanitize-field-names)
 * Node.js: [`sanitizeFieldNames`](apm-agent-nodejs://reference/configuration.md#sanitize-field-names)
 * Python: [`sanitize_field_names`](apm-agent-python://reference/configuration.md#config-sanitize-field-names)
-* Ruby: [`sanitize_field_names`](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-sanitize-field-names)
+* Ruby: [`sanitize_field_names`](apm-agent-ruby://reference/configuration.md#config-sanitize-field-names)
 
 Alternatively, you can completely disable the capturing of HTTP headers. This setting also supports [Central configuration](apm-agent-central-configuration.md):
 
@@ -38,7 +38,7 @@ Alternatively, you can completely disable the capturing of HTTP headers. This se
 * .NET: [`CaptureHeaders`](apm-agent-dotnet://reference/config-http.md#config-capture-headers)
 * Node.js: [`captureHeaders`](apm-agent-nodejs://reference/configuration.md#capture-headers)
 * Python: [`capture_headers`](apm-agent-python://reference/configuration.md#config-capture-headers)
-* Ruby: [`capture_headers`](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-capture-headers)
+* Ruby: [`capture_headers`](apm-agent-ruby://reference/configuration.md#config-capture-headers)
 
 
 ## HTTP bodies [apm-filters-http-body]
@@ -52,7 +52,7 @@ This setting supports [Central configuration](apm-agent-central-configuration.md
 * .NET: [`CaptureBody`](apm-agent-dotnet://reference/config-http.md#config-capture-body)
 * Node.js: [`captureBody`](apm-agent-nodejs://reference/configuration.md#capture-body)
 * Python: [`capture_body`](apm-agent-python://reference/configuration.md#config-capture-body)
-* Ruby: [`capture_body`](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-capture-body)
+* Ruby: [`capture_body`](apm-agent-ruby://reference/configuration.md#config-capture-body)
 
 
 ## Personal data [apm-filters-personal-data]
diff --git a/solutions/observability/apps/custom-filters.md b/solutions/observability/apps/custom-filters.md
@@ -37,7 +37,7 @@ Refer to the relevant agent’s documentation for more information and examples:
 * .NET: [Filter API](apm-agent-dotnet://reference/public-api.md#filter-api).
 * Node.js: [`addFilter()`](apm-agent-nodejs://reference/agent-api.md#apm-add-filter).
 * Python: [custom processors](apm-agent-python://reference/sanitizing-data.md).
-* Ruby: [`add_filter()`](asciidocalypse://docs/apm-agent-ruby/docs/reference/api-reference.md#api-agent-add-filter).
+* Ruby: [`add_filter()`](apm-agent-ruby://reference/api-reference.md#api-agent-add-filter).
 
 
 ## Tutorial: Use an ingest pipeline to redact sensitive information [apm-filters-ingest-pipeline-tutorial]
diff --git a/solutions/observability/apps/elastic-apm-agents.md b/solutions/observability/apps/elastic-apm-agents.md
@@ -115,12 +115,12 @@ These events, called Transactions and Spans, are sent to Elastic, where they're
 
 If you're ready to give Elastic APM a try, see [Get started with traces and APM](../../../solutions/observability/apps/get-started-with-apm.md).
 
-See the [Ruby agent reference](asciidocalypse://docs/apm-agent-ruby/docs/reference/index.md) for full documentation, including:
+See the [Ruby agent reference](apm-agent-ruby://reference/index.md) for full documentation, including:
 
-* [Supported technologies](asciidocalypse://docs/apm-agent-ruby/docs/reference/supported-technologies.md)
-* [Set up](asciidocalypse://docs/apm-agent-ruby/docs/reference/set-up-apm-ruby-agent.md)
-* [Configuration reference](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md)
-* [API reference](asciidocalypse://docs/apm-agent-ruby/docs/reference/api-reference.md)
+* [Supported technologies](apm-agent-ruby://reference/supported-technologies.md)
+* [Set up](apm-agent-ruby://reference/set-up-apm-ruby-agent.md)
+* [Configuration reference](apm-agent-ruby://reference/configuration.md)
+* [API reference](apm-agent-ruby://reference/api-reference.md)
 
 ::::{important}
 Not all APM agent configuration options are compatible with Elastic Cloud serverless.
diff --git a/solutions/observability/apps/filter-application-data.md b/solutions/observability/apps/filter-application-data.md
@@ -41,5 +41,5 @@ Service environments are defined when configuring your APM agents. It’s vital
 * **Node.js:** [`environment`](apm-agent-nodejs://reference/configuration.md#environment)
 * **PHP:** [`environment`](apm-agent-php://reference/configuration-reference.md#config-environment)
 * **Python:** [`environment`](apm-agent-python://reference/configuration.md#config-environment)
-* **Ruby:** [`environment`](asciidocalypse://docs/apm-agent-ruby/docs/reference/ingestion-tools/apm-agent-ruby/configuration.md#config-environment)
+* **Ruby:** [`environment`](apm-agent-ruby://reference/configuration.md#config-environment)
 * **Real User Monitoring (Elastic Stack only):** [`environment`](apm-agent-rum-js://reference/configuration.md#environment)
diff --git a/solutions/observability/apps/fleet-managed-apm-server.md b/solutions/observability/apps/fleet-managed-apm-server.md
@@ -722,8 +722,8 @@ server_url: 'http://localhost:8200'
 
 **Learn more in the agent reference**
 
-* [Supported technologies](asciidocalypse://docs/apm-agent-ruby/docs/reference/supported-technologies.md)
-* [Advanced configuration](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md)
+* [Supported technologies](apm-agent-ruby://reference/supported-technologies.md)
+* [Advanced configuration](apm-agent-ruby://reference/configuration.md)
 ::::::
 
 ::::::{tab-item} RUM
diff --git a/solutions/observability/apps/metadata.md b/solutions/observability/apps/metadata.md
@@ -33,7 +33,7 @@ Avoid defining too many user-specified labels. Defining too many unique fields i
 * Node.js: [`setLabel`](apm-agent-nodejs://reference/agent-api.md#apm-add-labels)
 * PHP: [`Transaction` `setLabel`](apm-agent-php://reference/public-api.md#api-transaction-interface-set-label) | [`Span` `setLabel`](apm-agent-php://reference/public-api.md#api-span-interface-set-label)
 * Python: [`elasticapm.label()`](apm-agent-python://reference/api-reference.md#api-label)
-* Ruby:  [`set_label`](asciidocalypse://docs/apm-agent-ruby/docs/reference/api-reference.md#api-agent-set-label)
+* Ruby:  [`set_label`](apm-agent-ruby://reference/api-reference.md#api-agent-set-label)
 * Rum: [`addLabels`](apm-agent-rum-js://reference/agent-api.md#apm-add-labels)
 
 
@@ -63,7 +63,7 @@ Setting a circular object, a large object, or a non JSON serializable object can
 * Node.js: [`setCustomContext`](apm-agent-nodejs://reference/agent-api.md#apm-set-custom-context)
 * PHP: *coming soon*
 * Python: [`set_custom_context`](apm-agent-python://reference/api-reference.md#api-set-custom-context)
-* Ruby: [`set_custom_context`](asciidocalypse://docs/apm-agent-ruby/docs/reference/api-reference.md#api-agent-set-custom-context)
+* Ruby: [`set_custom_context`](apm-agent-ruby://reference/api-reference.md#api-agent-set-custom-context)
 * Rum: [`setCustomContext`](apm-agent-rum-js://reference/agent-api.md#apm-set-custom-context)
 
 
@@ -86,6 +86,6 @@ User context adds **indexed** user information to transactions and errors. Index
 * Node.js: [`setUserContext`](apm-agent-nodejs://reference/agent-api.md#apm-set-user-context)
 * PHP: *coming soon*
 * Python: [`set_user_context`](apm-agent-python://reference/api-reference.md#api-set-user-context)
-* Ruby: [`set_user`](asciidocalypse://docs/apm-agent-ruby/docs/reference/api-reference.md#api-agent-set-user)
+* Ruby: [`set_user`](apm-agent-ruby://reference/api-reference.md#api-agent-set-user)
 * Rum: [`setUserContext`](apm-agent-rum-js://reference/agent-api.md#apm-set-user-context)
 
diff --git a/solutions/observability/apps/metrics.md b/solutions/observability/apps/metrics.md
@@ -30,7 +30,7 @@ For a full list of tracked metrics, see the relevant agent documentation:
 * [Java](apm-agent-java://reference/metrics.md)
 * [Node.js](apm-agent-nodejs://reference/metrics.md)
 * [Python](apm-agent-python://reference/metrics.md)
-* [Ruby](asciidocalypse://docs/apm-agent-ruby/docs/reference/metrics.md)
+* [Ruby](apm-agent-ruby://reference/metrics.md)
 
 
 ### Example system metric document [_example_system_metric_document]
diff --git a/solutions/observability/apps/secret-token.md b/solutions/observability/apps/secret-token.md
@@ -67,7 +67,7 @@ Each Elastic {{apm-agent}} has a configuration option to set the value of the se
 * **Node.js agent**: [`Secret Token`](apm-agent-nodejs://reference/configuration.md#secret-token)
 * **PHP agent**: [`secret_token`](apm-agent-php://reference/configuration-reference.md#config-secret-token)
 * **Python agent**: [`secret_token`](apm-agent-python://reference/configuration.md#config-secret-token)
-* **Ruby agent**: [`secret_token`](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-secret-token)
+* **Ruby agent**: [`secret_token`](apm-agent-ruby://reference/configuration.md#config-secret-token)
 
 In addition to setting the secret token, ensure the configured server URL uses `HTTPS` instead of `HTTP`:
 
@@ -77,4 +77,4 @@ In addition to setting the secret token, ensure the configured server URL uses `
 * **Node.js agent**: [`serverUrl`](apm-agent-nodejs://reference/configuration.md#server-url)
 * **PHP agent**: [`server_url`](apm-agent-php://reference/configuration-reference.md#config-server-url)
 * **Python agent**: [`server_url`](https://www.elastic.co/guide/en/apm/agent/python/current/)
-* **Ruby agent**: [`server_url`](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-server-url)
+* **Ruby agent**: [`server_url`](apm-agent-ruby://reference/configuration.md#config-server-url)
diff --git a/solutions/observability/apps/spans.md b/solutions/observability/apps/spans.md
@@ -40,7 +40,7 @@ To configure the number of spans recorded per transaction, see the relevant Agen
 * Node.js: [`transactionMaxSpans`](apm-agent-nodejs://reference/configuration.md#transaction-max-spans)
 * PHP: [`transaction_max_spans`](apm-agent-php://reference/configuration-reference.md#config-transaction-max-spans)
 * Python: [`transaction_max_spans`](apm-agent-python://reference/configuration.md#config-transaction-max-spans)
-* Ruby: [`transaction_max_spans`](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-transaction-max-spans)
+* Ruby: [`transaction_max_spans`](apm-agent-ruby://reference/configuration.md#config-transaction-max-spans)
 
 
 ## Missing spans [apm-data-model-missing-spans]
diff --git a/solutions/observability/apps/traces.md b/solutions/observability/apps/traces.md
@@ -246,7 +246,7 @@ elasticapm.get_trace_parent_header('new-transaction') <2>
 ::::::
 
 ::::::{tab-item} Ruby
-1. Start a span with [`with_span`](asciidocalypse://docs/apm-agent-ruby/docs/reference/api-reference.md#api-agent-with_span).
+1. Start a span with [`with_span`](apm-agent-ruby://reference/api-reference.md#api-agent-with_span).
 2. Get the active `TraceContext`.
 3. Send the `TraceContext` to the receiving service.
 
@@ -402,7 +402,7 @@ See the [`TraceParent` API](apm-agent-python://reference/api-reference.md#tracep
 ::::::
 
 ::::::{tab-item} Ruby
-Start a new transaction or span as a child of the incoming transaction or span with [`with_transaction`](asciidocalypse://docs/apm-agent-ruby/docs/reference/api-reference.md#api-agent-with_transaction) or [`with_span`](asciidocalypse://docs/apm-agent-ruby/docs/reference/api-reference.md#api-agent-with_span).
+Start a new transaction or span as a child of the incoming transaction or span with [`with_transaction`](apm-agent-ruby://reference/api-reference.md#api-agent-with_transaction) or [`with_span`](apm-agent-ruby://reference/api-reference.md#api-agent-with_span).
 
 Example:
 
diff --git a/solutions/observability/apps/transaction-sampling.md b/solutions/observability/apps/transaction-sampling.md
@@ -236,7 +236,7 @@ Each agent provides a configuration value used to set the transaction sample rat
 * Node.js: [`transactionSampleRate`](apm-agent-nodejs://reference/configuration.md#transaction-sample-rate)
 * PHP: [`transaction_sample_rate`](apm-agent-php://reference/configuration-reference.md#config-transaction-sample-rate)
 * Python: [`transaction_sample_rate`](apm-agent-python://reference/configuration.md#config-transaction-sample-rate)
-* Ruby: [`transaction_sample_rate`](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-transaction-sample-rate)
+* Ruby: [`transaction_sample_rate`](apm-agent-ruby://reference/configuration.md#config-transaction-sample-rate)
 
 
 ## Configure tail-based sampling [apm-configure-tail-based-sampling]
diff --git a/solutions/observability/apps/what-happens-when-apm-server-elasticsearch-is-down.md b/solutions/observability/apps/what-happens-when-apm-server-elasticsearch-is-down.md
@@ -18,6 +18,6 @@ Some agents have internal queues or buffers that will temporarily store data if
 * **Node.js agent** - No internal queue. Data is lost.
 * **PHP agent** - No internal queue. Data is lost.
 * **Python agent** - Internal [Transaction queue](apm-agent-python://reference/performance-tuning.md#tuning-queue) with configurable size and time between flushes.
-* **Ruby agent** - Internal queue with configurable size: [`api_buffer_size`](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-api-buffer-size).
+* **Ruby agent** - Internal queue with configurable size: [`api_buffer_size`](apm-agent-ruby://reference/configuration.md#config-api-buffer-size).
 * **RUM agent** - No internal queue. Data is lost.
 * **.NET agent** - No internal queue. Data is lost.
diff --git a/solutions/observability/infra-and-hosts/tutorial-observe-kubernetes-deployments.md b/solutions/observability/infra-and-hosts/tutorial-observe-kubernetes-deployments.md
@@ -1031,8 +1031,8 @@ Configure the agent using environment variables:
 
 **Learn more in the agent reference**
 
-* [Supported technologies](asciidocalypse://docs/apm-agent-ruby/docs/reference/supported-technologies.md)
-* [Advanced configuration](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md)
+* [Supported technologies](apm-agent-ruby://reference/supported-technologies.md)
+* [Advanced configuration](apm-agent-ruby://reference/configuration.md)
 ::::::
 
 :::::::
diff --git a/solutions/observability/logs/ecs-formatted-application-logs.md b/solutions/observability/logs/ecs-formatted-application-logs.md
@@ -51,7 +51,7 @@ To set up log ECS reformatting:
 Log ECS reformatting is controlled by the `log_ecs_reformatting` configuration option, and is disabled by default. Refer to the guide for your framework for information on enabling:
 
 * [Java](apm-agent-java://reference/config-logging.md#config-log-ecs-reformatting)
-* [Ruby](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-log-ecs-formatting)
+* [Ruby](apm-agent-ruby://reference/configuration.md#config-log-ecs-formatting)
 * [Python](apm-agent-python://reference/configuration.md#config-log_ecs_reformatting)
 
 
diff --git a/solutions/observability/logs/plaintext-application-logs.md b/solutions/observability/logs/plaintext-application-logs.md
@@ -346,7 +346,7 @@ Learn about correlating plaintext logs in the agent-specific ingestion guides:
 * [.NET](apm-agent-dotnet://reference/logs.md)
 * [Node.js](apm-agent-nodejs://reference/logs.md)
 * [Python](apm-agent-python://reference/logs.md#log-correlation-ids)
-* [Ruby](asciidocalypse://docs/apm-agent-ruby/docs/reference/logs.md)
+* [Ruby](apm-agent-ruby://reference/logs.md)
 
 
 ## View logs [view-plaintext-logs]
diff --git a/solutions/observability/logs/stream-application-logs.md b/solutions/observability/logs/stream-application-logs.md
@@ -69,7 +69,7 @@ Some Elastic {{apm-agent}}s can automatically reformat application logs to ECS f
 
 This feature is supported for the following {{apm-agent}}s:
 
-* [Ruby](asciidocalypse://docs/apm-agent-ruby/docs/reference/configuration.md#config-log-ecs-formatting)
+* [Ruby](apm-agent-ruby://reference/configuration.md#config-log-ecs-formatting)
 * [Python](apm-agent-python://reference/logs.md#log-reformatting)
 * [Java](apm-agent-java://reference/logs.md#log-reformatting)
 
@@ -100,4 +100,4 @@ Learn more about log correlation in the agent-specific ingestion guides:
 * [.NET](apm-agent-dotnet://reference/logs.md)
 * [Node.js](apm-agent-nodejs://reference/logs.md)
 * [Python](apm-agent-python://reference/logs.md#log-correlation-ids)
-* [Ruby](asciidocalypse://docs/apm-agent-ruby/docs/reference/logs.md)
+* [Ruby](apm-agent-ruby://reference/logs.md)
diff --git a/troubleshoot/observability/apm-agent-ruby/apm-ruby-agent.md b/troubleshoot/observability/apm-agent-ruby/apm-ruby-agent.md
diff --git a/troubleshoot/observability/apm/what-happens-when-apm-server-elasticsearch-is-down.md b/troubleshoot/observability/apm/what-happens-when-apm-server-elasticsearch-is-down.md
