El agente PHP de New Relic proporciona una API para personalizar el comportamiento del agente. El agente instrumentó automáticamente muchos marcos PHP populares, pero puede usar la API de PHP para instrumentar actividades que el agente aún no instrumenta de forma predeterminada.
Esta guía describe la API de llamada PHP para varias tareas comunes; Por ejemplo:
- Observe o ignore errores específicos.
- Nombra una transacción.
- Cambie el nombre de la aplicación que informa los datos.
Sugerencia
También puede configurar muchas de estas opciones por directorio o en newrelic.ini. Si se configura a través de API, la API tiene prioridad sobre los otros métodos.
Aviso o error omitido
Normalmente, el agente detecta errores automáticamente. Sin embargo, puede marcar manualmente un error con el agente.
Si quieres... | Hacer esto... |
|---|---|
Informar un error que el agente no informa automáticamente | |
Ignorar un error | Edite |
Mejorar los metadatos de una transacción
A veces, el código al que apuntas es visible en New Relic, pero algunos detalles del método no son útiles. Por ejemplo:
- El nombre predeterminado no es útil o está provocando un problema de agrupación métrica.
- Desea agregar un atributo personalizado a su transacción o tramos para poder filtrarlos con NRQL consulta.
Utilice estos métodos cuando desee cambiar la forma en que New Relic instrumentó una transacción que ya está visible en New Relic:
Si quieres... | Hacer esto... |
|---|---|
Cambiar el nombre de una transacción | |
Agregue metadatos (como el nombre de la cuenta de sus clientes o el nivel de suscripción) a sus transacciones o tramos | Utilice un atributo personalizado. Para conocer el atributo personalizado que se agregará a la transacción y a los intervalos (si está habilitado), consulte Para conocer el atributo personalizado que se agregará solo a los tramos, consulte |
Marcar una transacción como trabajo en segundo plano | |
Evite que una transacción afecte su puntuación Apdex |
Ver registro relacionado
Para ver el registro directamente dentro del contexto de los errores y la traza de su aplicación, use estas llamadas API para anotar su registro:
Para obtener más información sobre cómo correlacionar los datos log con otros telemetry data, consulte nuestra documentación de contexto de registro .
Aplicación de informes de nombres
La UI de New Relic organiza los datos según el nombre que le dé a su aplicación. Cada nombre aparece como una aplicación diferente. Puedes cambiar el nombre de la aplicación de informes para cualquier parte de tu código para ayudarte mejor:
Organice y analice sus datos en las páginas UI de New Relic (por ejemplo, la página
de APM, la página
, la página
consulta tus datos.
Crear política de alertas.
Esto es especialmente útil si tiene una aplicación de múltiples sitios o conjuntos distintos de código de aplicación que utilizan la misma instalación de PHP.
Alternativamente, puede configurar el nombre de la aplicación en un nivel superior a través del valor de configuración newrelic.appname , a través de Apache o a través de PHP-FPM.
Si quieres... | Hacer esto... |
|---|---|
Cambie el nombre de la aplicación de informes para una parte específica de su código | Establece el nombre de la aplicación. Ver |
Instrumento faltan secciones de tu código con transacción.
Para instrumentar su aplicación, New Relic separa cada ruta a través de su código en su propia transacción. New Relic mide (o "instrumentado") el método principal en estas transacciones para medir el rendimiento general de su aplicación y recopila la traza de la transacción de transacciones de larga duración para obtener detalles adicionales. Para obtener más información sobre transacción, consulte transacción y traza de la transacción.
Utilice estos métodos cuando New Relic no esté instrumentada en absoluto en una parte particular de su código:
Si quieres... | Hacer esto... |
|---|---|
Comenzar a cronometrar un método New Relic no se instrumenta automáticamente | Iniciar una transacción. Ver |
Dejar de cronometrar un método una vez completado su trabajo | Detener una transacción. Ver |
Evitar que una transacción se informe a New Relic | Ignora la transacción. Ver |
Métodos específicos de tiempo que utilizan segmentos
Si una transacción ya es visible en la UI de New Relic, pero no tiene suficientes datos sobre un método en particular que se llamó durante esa transacción, puede crear segmentos para cronometrar esos métodos individuales con mayor detalle. Por ejemplo, es posible que desee cronometrar un método particularmente crítico con lógica compleja.
Utilice estos métodos cuando desee instrumentar un método dentro de una transacción existente:
Si quieres... | Hacer esto... |
|---|---|
Cronometrar un método particular |
Trabajo asincrónico del instrumento.
El único trabajo asíncrono instrumentado por el agente PHP es Guzzle, que está instrumentado de forma predeterminada.
Envía datos de eventos personalizados y métricos desde tu app
New Relic incluye varias formas de registrar datos personalizados arbitrarios. Para obtener una explicación de los tipos de datos de New Relic, consulte Recopilación de datos.
Si quieres... | Hacer esto... |
|---|---|
Envía datos sobre un evento para que puedas analizarlo en New Relic | Crea un evento personalizado. Ver Insertar evento personalizado vía agente APM (PHP). |
Etiqueta tu evento con metadatos para filtrarlos y facetarlos | Agregue un atributo personalizado. Ver |
Informar datos de rendimiento personalizados | Cree una métrica personalizada. Ver |
Llamadas de instrumentos a servicios externos.
Utilice estos métodos para recopilar datos sobre las conexiones de su aplicación a otras aplicaciones o almacenes de datos:
Si quieres... | Hacer esto... |
|---|---|
Cronometrar una llamada a un almacenamiento de datos no instrumentado por defecto | |
Vea el camino que sigue una solicitud a medida que viaja a través de un sistema distribuido | Para versiones del agente PHP inferiores a 9.8, consulte estas API de llamada:
|
Monitor páginas específicas browser
Puede instalar el agente del navegador agregándolo automáticamente a sus páginas o implementándolo en páginas específicas copiando y pegando nuestro fragmento de JavaScript. También puede controlar el agente mediante llamadas a la API del agente . Para obtener más información, consulte monitoreo del navegador y el agente PHP.