Esta documentación es para el rastreador de PHP v1.x. Si buscas la documentación del rastreador de PHP v0.x, consulta la documentación de Requisitos de compatibilidad de PHP heredada.

Política de soporte técnico de tiempo de ejecución de PHP APM

La biblioteca de PHP Datadog Trace es de código abierto - consulta el repositorio GitHub para obtener más información.

Datadog APM para PHP se basa en dependencias definidas en versiones específicas del sistema operativo host, tiempo de ejecución de PHP, determinadas bibliotecas de PHP y el Datadog Agent o API. Cuando estas versiones dejan de tener soporte técnico de los responsables de mantenimiento, Datadog APM para PHP también limita su soporte técnico a estas.

Niveles de soporte técnico

NivelAsistencia prestada
Sin soporte técnicoSin implementación. Ponte en contacto con nuestro equipo de atención al cliente para solicitudes especiales.
BetaImplementación inicial. Puede que aún no contenga todas las funciones. El soporte técnico para nuevas funciones, errores y correcciones de seguridad se proporciona en el mejor de los casos.
Disponibilidad general (GA)Implementación completa de todas las funciones. Soporte completo para nuevas funciones, correcciones de errores y de seguridad.
MantenimientoImplementación completa de las funciones existentes. No recibe nuevas funciones. Soporte técnico solo para correcciones de errores y seguridad.
HeredadoImplementación heredada. Puede tener función limitada, pero no se proporciona mantenimiento. Ponte en contacto con el equipo de asistencia para solicitudes especiales.
Final del servicio (EOL)Sin soporte. La versión todavía se puede utilizar, pero no se proporcionan correcciones de errores.

PHP APM admite las siguientes versiones de PHP (ZTS y NTS):

Nota: PHP versión 5.x no es compatible a partir de la versión 1.0.0. Si utilizas PHP 5, puedes seguir utilizando el rastreador de PHP hasta la versión 0.99.
Si estás utilizando la versión PHP 5.x en tu aplicación y tienes una solicitud de función que es crítica para tus necesidades de negocio, ponte en contacto con el servicio de soporte técnico de Datadog .
Se recomienda utilizar versiones con soporte técnico oficial de PHP, especialmente 8.0+.
PHP VersiónNivel de soporte técnicoPaquete versión
8.3.xDisponibilidad general> 0.93.0+
8.2.xDisponibilidad general> 0.82.0+
8.1.xDisponibilidad general> 0.66.0+
8.0.xDisponibilidad general> 0.52.0+
7.4.xDisponibilidad generalTodas
7.3.xDisponibilidad generalTodas
7.2.xDisponibilidad generalTodas
7.1.xDisponibilidad generalTodas
7.0.xDisponibilidad generalTodas
5.6.xEOL< 1.0.0
5.5.xEOL< 1.0.0
5.4.xEOL< 1.0.0

PHP APM admite los siguientes SAPI:

SAPITipo de soporte técnico
apache2handlerTodas las versiones compatibles de PHP
cliTodas las versiones compatibles de PHP
fpm-fcgiTodas las versiones compatibles de PHP
cgi-fcgiTodas las versiones compatibles de PHP
FrankenPHPTodas las versiones compatibles de PHP

Arquitecturas de procesador compatibles

PHP APM es compatible con las siguientes arquitecturas:

Arquitecturas de procesadoresNivel de soporte técnicopaquete versiónTipo de soporte técnico
Linux GNU amd64 (x86-64-linux-gnu)GATodasTodas las versiones compatibles de PHP
Linux MUSL amd64 (x86-64-linux-musl)GATodasTodas las versiones compatibles de PHP
Linux GNU arm64 (aarch64-linux-gnu)GA> 0.78.0Todas las versiones compatibles de PHP
Linux MUSL arm64 (aarch64-linux-musl)GA> 0.78.0Todas las versiones compatibles de PHP
Windows amd64 (x86_64-windows)GA> 0.98.0PHP 7.2+

Integraciones

Compatibilidad con marcos web

Por defecto, Datadog es compatible con todos los marcos web de PHP desde el primer momento, ya sea con instrumentación a nivel del marco o rastreo web genérico.

La instrumentación al nivel del marco incluye el rastreo de métodos internos y el etiquetado específico del marco.

El rastreo web genérico incluye un tramo (span) deweb.request para rastrear la latencia y los errores que se originan en la llamada, además de tramos para las bibliotecas compatibles - por ejemplo: base de datos y clientes HTTP.

En la siguiente tabla se enumeran algunos de los marcos y versiones que Datadog rastrea con éxito.

Marcos web:

MóduloVersionesTipo de soporte técnicoNivel de instrumentación
CakePHP2.xTodas las versiones compatibles de PHPInstrumentación al nivel del marco
CodeIgniter2.xTodas las versiones compatibles de PHPInstrumentación al nivel del marco
CodeIgniter3.xTodas las versiones compatibles de PHPRastreo web genérico
DrupalTodas las versiones compatibles de PHPInstrumentación al nivel del marco
FuelPHP1.1Todas las versiones compatibles de PHPRastreo web genérico
LaminasTodas las versiones compatibles de PHPInstrumentación a nivel del marco
Laravel4.2, 5.x, 6.xTodas las versiones compatibles de PHPInstrumentación a nivel del marco
Laravel 8+8.x, 9.x, 10.x, 11.x (rastreador 0.52.0+)Todas las versiones compatibles de PHPInstrumentación a nivel del marco
Lumen5.2+Todas las versiones compatibles de PHPInstrumentación a nivel del marco
Magento1Todas las versiones compatibles de PHPRastreo web genérico
Magento2Todas las versiones compatibles de PHPInstrumentación a nivel del marco
Neos Flow1.1Todas las versiones compatibles de PHPRastreo web genérico
Phalcon1.3, 3.4Todas las versiones compatibles de PHPRastreo web genérico
RoadRunner2.xTodas las versiones compatibles de PHPInstrumentación a nivel del marco
Slim2.x, 3.x, 4.xTodas las versiones compatibles de PHPInstrumentación a nivel del marco
Symfony2.x, 3.3, 3.4, 4.x, 5.x, 6.x, 7.xTodas las versiones compatibles de PHPInstrumentación a nivel del marco
WordPress4.x, 5.x, 6.xTodas las versiones compatibles de PHPInstrumentación a nivel del marco
Yii1.1, 2.0Todas las versiones compatibles de PHPInstrumentación a nivel del marco
Zend Framework1.12, 1.21Todas las versiones compatibles de PHPInstrumentación a nivel del marco
Zend Framework2.xTodas las versiones compatibles de PHPRastreo web genérico

Ten en cuenta que aunque no veas tu marco web en este lista, es compatible con la última versión del rastreador.

Datadog está añadiendo continuamente más soporte para el rastreo en profundidad para marcos web de PHP. Para solicitar soporte para metadatos de tramos adicionales e información interna del marco, ponte en contacto con nuestro impresionante equipo de soporte técnico.

Compatibilidad con la biblioteca CLI

El rastreo desde CLI SAPI está desactivado por defecto. Para habilitar el rastreo de los scripts CLI de PHP, configure DD_TRACE_CLI_ENABLED=true.

MóduloVersionesTipo de soporte técnico
Consola CakePHP2.xTodas las versiones compatibles de PHP
Laravel Artisan5.x, 8.x, 9.x, 10.xTodas las versiones compatibles de PHP
Symfony CLI4.x, 5.x, 6.xTodas las versiones compatibles de PHP

Para solicitar soporte para bibliotecas CLI adicionales, ponte en contacto con nuestro magnífico equipo de soporte técnico.

Compatibilidad de almacenes de datos

MóduloVersionesTipo de soporte técnico
Amazon RDS (utilizando PDO o MySQLi)(Cualquier PHP compatible)Todas las versiones compatibles de PHP
Elasticsearch1+Todas las versiones compatibles de PHP
EloquentVersiones de Laravel compatiblesTodas las versiones compatibles de PHP
Colas de LaravelVersiones de Laravel compatiblesTodas las versiones compatibles de PHP
Memcache(Cualquier PHP compatible)Todas las versiones compatibles de PHP
Memcached(Cualquier PHP compatible)Todas las versiones compatibles de PHP
MongoDB - a través de la extensión mongo1.4.xTodas las versiones compatibles de PHP
MySQLi(Cualquier PHP compatible)Todas las versiones compatibles de PHP
PDO(Cualquier PHP compatible)Todas las versiones compatibles de PHP
PhpRedis3, 4, 5Todas las versiones compatibles de PHP
Predis1.1Todas las versiones compatibles de PHP
SQLSRV(Cualquier PHP compatible)Todas las versiones compatibles de PHP

Para solicitar asistencia para otros almacenes de datos, ponte en contacto con nuestro impresionante equipo de asistencia.

Compatibilidad de bibliotecas

MóduloVersionesTipo de soporte técnico
php-amqplib2.x, 3.xPHP 7.1+
Curl(Cualquier PHP compatible)Todas las versiones compatibles de PHP
Guzzle5.x, 6.x, 7.xTodas las versiones compatibles de PHP
Cola de LaravelVersiones de Laravel compatiblesTodas las versiones compatibles de PHP

Para solicitar asistencia para bibliotecas adicionales, ponte en contacto con nuestro magnífico equipo de asistencia.

Stacks tecnológicos de llamadas en profundidad en PHP 5

El stack tecnológico de llamadas está limitada en PHP 5. Consulta la página para solucionar problemas de stacks tecnológicos de llamadas en profundidad para obtener más información.

Generadores

La instrumentación generadores no es compatible con PHP 5 y PHP 7.

PCNTL

Datadog es compatible con el rastreo de procesos de bifurcaciones utilizando pcntl. Cuando se detecta una llamada a pcntl_fork, se crea un tramo dedicado y se instrumenta el proceso de bifurcación. Esto puede desactivarse con DD_TRACE_FORKED_PROCESS. Consulta la página de configuración de bibliotecas para obtener más información.

Si la aplicación invoca pcntl_unshare(CLONE_NEWUSER); y el rastreador está instalado, la aplicación se bloquea fatalmente. Esto ocurre porque unshare con CLONE_NEWUSER requiere que el proceso no sea encadenado, mientras que el rastreador de PHP utiliza un subproceso separado para enviar trazas (traces) al Datadog Agent sin bloquear el proceso principal.

Leer más

Additional helpful documentation, links, and articles: