Analizar peticiones PHP lentas con X-Ray

PHP X-Ray permite trazar peticiones PHP para localizar consultas SQL, funciones y llamadas externas que consumen tiempo. Su objetivo es relacionar una operación lenta con el trabajo que realiza la aplicación, no aplicar una corrección automática.

Preparar una muestra

Anota una URL u operación que puedas reproducir, la hora y si requiere sesión. Revisa antes si la cuenta está alcanzando límites de CPU o memoria: esa limitación puede alterar los tiempos observados.

Una página servida desde caché puede no ejecutar PHP y, por tanto, no generar la traza que esperas. Elige una operación representativa y comprueba qué capa atiende la petición.

Iniciar el análisis

1. En cPanel, abre X-Ray o X-Ray app y pulsa Start tracing.
2. Selecciona el dominio correcto.
3. En el patrón de URL o Specify mask, limita el alcance a la ruta problemática siguiendo la ayuda del campo. Un patrón con asterisco puede ampliar mucho la muestra.
4. Revisa en Advanced settings el máximo de peticiones y la duración. Empieza con pocas peticiones y un intervalo corto; no asumas un valor por defecto fijo.
5. Inicia con Run, reproduce la operación y detén el análisis cuando tengas muestras suficientes.

La documentación de CloudLinux para usuarios describe las funciones disponibles según la versión. Si la herramienta no aparece, consulta su disponibilidad para tu servicio.

Leer el informe

Ordena las peticiones por duración y abre una representativa. Revisa el tiempo total, URL, componentes, consultas y llamadas externas que el informe identifique.

Distingue una operación individual lenta de una operación rápida repetida cientos de veces. Que una función aparezca en la pila no demuestra que sea la causa: puede estar esperando a otra función o a un servidor externo.

Compara varias muestras. Si el análisis marca limitaciones de recursos, tenlas en cuenta antes de atribuir toda la demora al código.

Convertir el diagnóstico en una prueba

Identifica una hipótesis concreta, por ejemplo una consulta sin un índice adecuado, una llamada externa con demora o un plugin que repite trabajo. Prueba el cambio en una copia y compara la misma operación bajo condiciones similares.

Revisa también el comportamiento correcto: lecturas, escrituras, formularios y tareas programadas. Una mejora de tiempo no compensa datos incorrectos ni una pérdida de funcionalidad.

Finalizar y compartir

El trazado añade trabajo a las peticiones analizadas. No lo mantengas activo durante largos periodos sin necesidad y confirma que la tarea ha terminado.

Si exportas un informe, revisa antes consultas, URLs, parámetros y datos personales. Comparte solo la evidencia necesaria con quien deba resolver el problema. X-Ray no mide por sí solo todo el tiempo de renderizado y JavaScript del navegador; utiliza las herramientas del navegador para esa parte.