• EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

Te ofrecemos esta traducción automática para facilitar la lectura.

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Guía para usar la API del agente PHP

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:

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

Ver newrelic_notice_error().

Ignorar un error

Edite error_collector.ignore_exceptions o error_collector.ignore_errors en el archivonewrelic.ini .

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:

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

Ver newrelic_name_transaction().

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 newrelic_add_custom_parameter().

Para conocer el atributo personalizado que se agregará solo a los tramos, consulte newrelic_add_custom_span_parameter().

Marcar una transacción como trabajo en segundo plano

Ver newrelic_background_job().

Evite que una transacción afecte su puntuación Apdex

Ver newrelic_ignore_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:

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 newrelic_set_appname().

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 newrelic_start_transaction().

Dejar de cronometrar un método una vez completado su trabajo

Detener una transacción. Ver newrelic_end_transaction().

Evitar que una transacción se informe a New Relic

Ignora la transacción. Ver newrelic_ignore_transaction().

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

Ver newrelic_add_custom_tracer().

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 newrelic_add_custom_parameter().

Informar datos de rendimiento personalizados

Cree una métrica personalizada. Ver newrelic_custom_metric().

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

Ver newrelic_record_datastore_segment().

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.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.