replace apm-agent-php asciidocalypse links

colleenmcginnis · colleenmcginnis · commit 55b5400cf299 · 2025-03-19T12:53:17.000-05:00
diff --git a/docset.yml b/docset.yml
@@ -13,6 +13,7 @@ cross_links:
   - apm-agent-ios
   - apm-agent-java
   - apm-agent-nodejs
+  - apm-agent-php
   - apm-agent-python
   - apm-agent-rum-js
   - apm-aws-lambda
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
@@ -247,7 +247,7 @@ 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-php/docs/reference/supported-technologies.md)
+        * [Supported technologies](apm-agent-php://reference/supported-technologies.md)
         * [Configuration](apm-agent-python://reference/configuration.md)
 
           </div>
diff --git a/solutions/observability/apps/api-keys.md b/solutions/observability/apps/api-keys.md
@@ -112,7 +112,7 @@ You can now apply your newly created API keys in the configuration of each of yo
 * **iOS**: [`withApiKey`](apm-agent-ios://reference/configuration.md#withapikey)
 * **Java agent**: [`api_key`](apm-agent-java://reference/config-reporter.md#config-api-key)
 * **Node.js agent**: [`apiKey`](apm-agent-nodejs://reference/configuration.md#api-key)
-* **PHP agent**: [`api_key`](asciidocalypse://docs/apm-agent-php/docs/reference/configuration-reference.md#config-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)
 
diff --git a/solutions/observability/apps/apm-agent-central-configuration.md b/solutions/observability/apps/apm-agent-central-configuration.md
@@ -50,7 +50,7 @@ Node.js agent
 :   [Configuration reference](apm-agent-nodejs://reference/configuration.md)
 
 PHP agent
-:   [Configuration reference](asciidocalypse://docs/apm-agent-php/docs/reference/configuration.md)
+:   [Configuration reference](apm-agent-php://reference/configuration.md)
 
 Python agent
 :   [Configuration reference](apm-agent-python://reference/configuration.md)
diff --git a/solutions/observability/apps/apm-agent-tls-communication.md b/solutions/observability/apps/apm-agent-tls-communication.md
@@ -67,7 +67,7 @@ We do not recommend disabling {{apm-agent}} verification of the server’s certi
 * **Go agent**: [`ELASTIC_APM_VERIFY_SERVER_CERT`](apm-agent-go://reference/configuration.md#config-verify-server-cert)
 * **.NET agent**: [`VerifyServerCert`](apm-agent-dotnet://reference/config-reporter.md#config-verify-server-cert)
 * **Java agent**: [`verify_server_cert`](apm-agent-java://reference/config-reporter.md#config-verify-server-cert)
-* **PHP agent**: [`verify_server_cert`](asciidocalypse://docs/apm-agent-php/docs/reference/configuration-reference.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)
 * **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
@@ -516,8 +516,8 @@ elastic_apm.bootstrap_php_part_file=<repo root>/agent/php/bootstrap_php_part.php
 
 **Learn more in the agent reference**
 
-* [Supported technologies](asciidocalypse://docs/apm-agent-php/docs/reference/supported-technologies.md)
-* [Configuration](asciidocalypse://docs/apm-agent-php/docs/reference/configuration.md)
+* [Supported technologies](apm-agent-php://reference/supported-technologies.md)
+* [Configuration](apm-agent-php://reference/configuration.md)
 ::::::
 
 ::::::{tab-item} Python
diff --git a/solutions/observability/apps/elastic-apm-agents.md b/solutions/observability/apps/elastic-apm-agents.md
@@ -193,12 +193,12 @@ The Elastic APM PHP agent measures application performance and tracks errors. Th
 
 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 [PHP agent reference](asciidocalypse://docs/apm-agent-php/docs/reference/index.md)  for full documentation, including:
+See the [PHP agent reference](apm-agent-php://reference/index.md)  for full documentation, including:
 
-* [Supported technologies](asciidocalypse://docs/apm-agent-php/docs/reference/supported-technologies.md)
-* [Set up](asciidocalypse://docs/apm-agent-php/docs/reference/set-up-apm-php-agent.md)
-* [Configuration reference](asciidocalypse://docs/apm-agent-php/docs/reference/configuration.md)
-* [API reference](asciidocalypse://docs/apm-agent-php/docs/reference/public-api.md)
+* [Supported technologies](apm-agent-php://reference/supported-technologies.md)
+* [Set up](apm-agent-php://reference/set-up-apm-php-agent.md)
+* [Configuration reference](apm-agent-php://reference/configuration.md)
+* [API reference](apm-agent-php://reference/public-api.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
@@ -39,7 +39,7 @@ Service environments are defined when configuring your APM agents. It’s vital
 * **Java:** [`environment`](apm-agent-java://reference/config-core.md#config-environment)
 * **.NET:** [`Environment`](apm-agent-dotnet://reference/config-core.md#config-environment)
 * **Node.js:** [`environment`](apm-agent-nodejs://reference/configuration.md#environment)
-* **PHP:** [`environment`](asciidocalypse://docs/apm-agent-php/docs/reference/ingestion-tools/apm-agent-php/configuration-reference.md#config-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)
 * **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
@@ -561,8 +561,8 @@ elastic_apm.bootstrap_php_part_file=<repo root>/agent/php/bootstrap_php_part.php
 
 **Learn more in the agent reference**
 
-* [Supported technologies](asciidocalypse://docs/apm-agent-php/docs/reference/supported-technologies.md)
-* [Configuration](asciidocalypse://docs/apm-agent-php/docs/reference/configuration.md)
+* [Supported technologies](apm-agent-php://reference/supported-technologies.md)
+* [Configuration](apm-agent-php://reference/configuration.md)
 ::::::
 
 ::::::{tab-item} Python
diff --git a/solutions/observability/apps/metadata.md b/solutions/observability/apps/metadata.md
@@ -31,7 +31,7 @@ Avoid defining too many user-specified labels. Defining too many unique fields i
 * Java: [`setLabel`](apm-agent-java://reference/public-api.md#api-transaction-add-tag)
 * .NET: [`SetLabel`](apm-agent-dotnet://reference/public-api.md#api-transaction-set-label)
 * Node.js: [`setLabel`](apm-agent-nodejs://reference/agent-api.md#apm-add-labels)
-* PHP: [`Transaction` `setLabel`](asciidocalypse://docs/apm-agent-php/docs/reference/public-api.md#api-transaction-interface-set-label) | [`Span` `setLabel`](asciidocalypse://docs/apm-agent-php/docs/reference/public-api.md#api-span-interface-set-label)
+* 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)
 * Rum: [`addLabels`](apm-agent-rum-js://reference/agent-api.md#apm-add-labels)
diff --git a/solutions/observability/apps/secret-token.md b/solutions/observability/apps/secret-token.md
@@ -65,7 +65,7 @@ Each Elastic {{apm-agent}} has a configuration option to set the value of the se
 * **Java agent**: [`secret_token`](apm-agent-java://reference/config-reporter.md#config-secret-token)
 * **.NET agent**: [`ELASTIC_APM_SECRET_TOKEN`](apm-agent-dotnet://reference/config-reporter.md#config-secret-token)
 * **Node.js agent**: [`Secret Token`](apm-agent-nodejs://reference/configuration.md#secret-token)
-* **PHP agent**: [`secret_token`](asciidocalypse://docs/apm-agent-php/docs/reference/configuration-reference.md#config-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)
 
@@ -75,6 +75,6 @@ In addition to setting the secret token, ensure the configured server URL uses `
 * **Java agent**: [`server_urls`](apm-agent-java://reference/config-reporter.md#config-server-urls)
 * **.NET agent**: [`ServerUrl`](apm-agent-dotnet://reference/config-reporter.md#config-server-url)
 * **Node.js agent**: [`serverUrl`](apm-agent-nodejs://reference/configuration.md#server-url)
-* **PHP agent**: [`server_url`](asciidocalypse://docs/apm-agent-php/docs/reference/configuration-reference.md#config-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)
diff --git a/solutions/observability/apps/spans.md b/solutions/observability/apps/spans.md
@@ -38,7 +38,7 @@ To configure the number of spans recorded per transaction, see the relevant Agen
 * Java: [`transaction_max_spans`](apm-agent-java://reference/config-core.md#config-transaction-max-spans)
 * .NET: [`TransactionMaxSpans`](apm-agent-dotnet://reference/config-core.md#config-transaction-max-spans)
 * Node.js: [`transactionMaxSpans`](apm-agent-nodejs://reference/configuration.md#transaction-max-spans)
-* PHP: [`transaction_max_spans`](asciidocalypse://docs/apm-agent-php/docs/reference/configuration-reference.md#config-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)
 
diff --git a/solutions/observability/apps/traces.md b/solutions/observability/apps/traces.md
@@ -360,7 +360,7 @@ agent.startTransaction('my-service-b-transaction', { childOf: traceparent }) <2>
 
 ::::::{tab-item} PHP
 1. Receive the distributed tracing data on the server side.
-2. Begin a new transaction using the agent’s public API. For example, use [`ElasticApm::beginCurrentTransaction`](asciidocalypse://docs/apm-agent-php/docs/reference/public-api.md#api-elasticapm-class-begin-current-transaction) and pass the received distributed tracing data (serialized as string) as a parameter. This will create a new transaction as a child of the incoming trace context.
+2. Begin a new transaction using the agent’s public API. For example, use [`ElasticApm::beginCurrentTransaction`](apm-agent-php://reference/public-api.md#api-elasticapm-class-begin-current-transaction) and pass the received distributed tracing data (serialized as string) as a parameter. This will create a new transaction as a child of the incoming trace context.
 3. Don’t forget to eventually end the transaction on the server side.
 
 Example:
diff --git a/solutions/observability/apps/transaction-sampling.md b/solutions/observability/apps/transaction-sampling.md
@@ -234,7 +234,7 @@ Each agent provides a configuration value used to set the transaction sample rat
 * Java: [`transaction_sample_rate`](apm-agent-java://reference/config-core.md#config-transaction-sample-rate)
 * .NET: [`TransactionSampleRate`](apm-agent-dotnet://reference/config-core.md#config-transaction-sample-rate)
 * Node.js: [`transactionSampleRate`](apm-agent-nodejs://reference/configuration.md#transaction-sample-rate)
-* PHP: [`transaction_sample_rate`](asciidocalypse://docs/apm-agent-php/docs/reference/configuration-reference.md#config-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)
 
diff --git a/solutions/observability/infra-and-hosts/tutorial-observe-kubernetes-deployments.md b/solutions/observability/infra-and-hosts/tutorial-observe-kubernetes-deployments.md
@@ -880,7 +880,7 @@ To use the APK package (Alpine):
 apk add --allow-untrusted <package-file>.apk
 ```
 
-If you can’t find your distribution, you can install the agent by [building it from the source](asciidocalypse://docs/apm-agent-php/docs/reference/set-up-apm-php-agent.md).
+If you can’t find your distribution, you can install the agent by [building it from the source](apm-agent-php://reference/set-up-apm-php-agent.md).
 
 **Configure the agent**
 
@@ -906,8 +906,8 @@ Configure the agent using environment variables:
 
 **Learn more in the agent reference**
 
-* [Supported technologies](asciidocalypse://docs/apm-agent-php/docs/reference/supported-technologies.md)
-* [Configuration](asciidocalypse://docs/apm-agent-php/docs/reference/configuration.md)
+* [Supported technologies](apm-agent-php://reference/supported-technologies.md)
+* [Configuration](apm-agent-php://reference/configuration.md)
 ::::::
 
 ::::::{tab-item} Python
diff --git a/troubleshoot/observability/apm-agent-php/apm-php-agent.md b/troubleshoot/observability/apm-agent-php/apm-php-agent.md
@@ -10,29 +10,29 @@ applies_to:
 
 # Troubleshoot APM PHP Agent [troubleshooting]
 
-Is something not working as expected? Don’t worry if you can’t figure out what the problem is; we’re here to help! As a first step, ensure your app is compatible with the agent’s [supported technologies](asciidocalypse://docs/apm-agent-php/docs/reference/supported-technologies.md).
+Is something not working as expected? Don’t worry if you can’t figure out what the problem is; we’re here to help! As a first step, ensure your app is compatible with the agent’s [supported technologies](apm-agent-php://reference/supported-technologies.md).
 
 If you’re an existing Elastic customer with a support contract, please create a ticket in the [Elastic Support portal](https://support.elastic.co/customers/s/login/). Other users can post in the [APM discuss forum](https://discuss.elastic.co/c/apm).
 
-::::{important} 
+::::{important}
 **Please upload your complete debug logs** to a service like [GitHub Gist](https://gist.github.com) so that we can analyze the problem. Logs should include everything from when the application starts up until the first request executes.
 ::::
 
 
 
-## Disable the Agent [disable-agent] 
+## Disable the Agent [disable-agent]
 
 In the unlikely event the agent causes disruptions to a production application, you can disable the agent while you troubleshoot.
 
-Disable the agent by setting [`enabled`](asciidocalypse://docs/apm-agent-php/docs/reference/configuration-reference.md#config-enabled) to `false`. You’ll need to restart your application for the changes to apply.
+Disable the agent by setting [`enabled`](apm-agent-php://reference/configuration-reference.md#config-enabled) to `false`. You’ll need to restart your application for the changes to apply.
 
 
-## Disclaimer for `dev_internal_*` configuration options [dev-internal-config-disclaimer] 
+## Disclaimer for `dev_internal_*` configuration options [dev-internal-config-disclaimer]
 
 Configuration options starting with `dev_internal_` should be used only for supportability. It’s recommended to have these options in the configuration for the short periods of time while resolving an issue with the agent. There is no backward compatability guarantee for these options so any one can be changed and/or removed even in a minor or patch release.
 
 
-## Enable verbose log for backend communication [enable-verbose-log-backend-comm] 
+## Enable verbose log for backend communication [enable-verbose-log-backend-comm]
 
 Configuration option `dev_internal_backend_comm_log_verbose` can be used to enable verbose log for the agent’s communication with Elastic APM Server.
 
@@ -44,7 +44,7 @@ Configuration option `dev_internal_backend_comm_log_verbose` can be used to enab
 | --- | --- |
 | `false` | Boolean |
 
-The log is written under `INFO` level - see [Logging](asciidocalypse://docs/apm-agent-php/docs/reference/configuration.md#configure-logging).
+The log is written under `INFO` level - see [Logging](apm-agent-php://reference/configuration.md#configure-logging).
 
 Also see [Disclaimer for `dev_internal_*` configuration options](#dev-internal-config-disclaimer).
 
diff --git a/troubleshoot/observability/apm/_agent_is_not_instrumenting_code.md b/troubleshoot/observability/apm/_agent_is_not_instrumenting_code.md
@@ -11,7 +11,7 @@ applies_to:
 
 ## `open_basedir` PHP configuration option [_open_basedir_php_configuration_option]
 
-If you see a similar entry in the agent log, this indicates an incorrect open_basedir configuration. For more details please see [the corresponding Limitations sub-section](asciidocalypse://docs/apm-agent-php/docs/reference/set-up-apm-php-agent.md#limitation-open_basedir).
+If you see a similar entry in the agent log, this indicates an incorrect open_basedir configuration. For more details please see [the corresponding Limitations sub-section](apm-agent-php://reference/set-up-apm-php-agent.md#limitation-open_basedir).
 
 ```
 [Elastic APM PHP Tracer] 2023-08-23 14:38:12.223397+02:00 [PID: 268995] [TID: 268995] [WARNING]  [Lifecycle] [lifecycle.cpp:558] [elasticApmModuleInit] Elastic Agent bootstrap file (/home/paplo/sources/apm-agent-php/agent/php/bootstrap_php_part.php) is located outside of paths allowed by open_basedir ini setting. Read more details here https://www.elastic.co/guide/en/apm/agent/php/current/setup.html
