Configuración del agente PHP

Esta opción de configuración establece el nombre de la aplicación bajo la cual se informan los datos en APM. Le recomendamos encarecidamente que reemplace el nombre predeterminado con un nombre descriptivo para evitar confusión y agregación involuntaria de datos. Los datos de todas las aplicaciones con el mismo nombre se fusionarán en New Relic, así que configúrelo con cuidado.

Para conocer todas las opciones de nomenclatura de aplicaciones, incluida la configuración por directorio, consulte Asigne un nombre a su aplicación PHP.

El valor de la configuración es una lista separada por punto y coma de hasta tres nombres de aplicaciones. El primer nombre de la lista es el nombre de la aplicación primary . Debe ser único para cada cuenta. El nombre de la aplicación se utiliza como clave en un caché. Cuando se utilizan varios nombres para una aplicación, New Relic solo utiliza el primer nombre para el almacenamiento en caché. Por lo tanto, el nombre de cada aplicación solo puede aparecer como el primer elemento once.

Si necesita nombres de aplicaciones superpuestos, establezca el nombre de la aplicación común en la segunda o tercera posición. Por ejemplo: newrelic.appname="App2;App1" y newrelic.appname="App3;App1". Esto es útil, por ejemplo, cuando desea realizar un seguimiento de un superconjunto de aplicaciones.

Para establecer este valor mediante programación, utilice la función API newrelic_capture_params() .

Si pasa información confidencial directamente en la URL, manténgala desactivada.

Si se establece en true, esto permitirá el registro del parámetro pasado a un script PHP a través de la URL (todo lo que sigue al ? en la URL) en la traza de la transacción. Estos aparecerán debajo del menú desplegable Parameters cuando se muestre la traza de la transacción.

El agente PHP de New Relic detecta automáticamente el marco que admite, pero pueden surgir problemas si está utilizando nuevas versiones experimentales o si ha personalizado el framework. Esta configuración deshabilita la detección automática framework , en lugar de indicarle al agente que intente nombrar la transacción de acuerdo con el framework especificado.

Al especificar "no_framework", se desactivarán por completo los nombres de transacciones relacionadas con framework .

Utilice cualquiera de los siguientes valores, según corresponda:

• "cakephp"

• "codeigniter"

• "drupal" (para Drupal 6 y 7)

• "drupal8" (para Drupal 8 y 9)

• "joomla"

• "laravel"

• "magento"

• "magento2"

• "mediawiki"

• "slim"

• "symfony2" (para Symfony 3: Symfony 2.x no es compatible)

• "symfony4" (para Symfony 4 y 5)

• "wordpress"

• "yii"

• "zend"

• "zend2" (para Zend framework 2 y 3)

• "no_framework" (para no forzar ningún framework incluso si se detectara uno)

  Si falla la detección automática framework , este comando también fallará.

  Sugerencia

  Consulte la página de compatibilidad de PHP para obtener la información más reciente sobre los marcos compatibles.

Utilice la configuración newrelic.ignored_params para especificar una lista de nombres de parámetros separados por comas que se excluirán de la lista de parámetros enviados a los servidores de New Relic. Encierre los valores de cadena entre comillas.

Si habilita la captura de parámetros con newrelic.capture_params, puede haber parámetros con datos de usuario confidenciales que no desea que New Relic capture o que sean visibles en la traza de la transacción. Utilice esto para bloquear el registro de estos datos.

Establece la New Relic clave de licenciaque se utilizará. En un sistema multiinquilino, esto se puede configurar por directorio.

Establece el nivel de detalle de los mensajes enviados al archivo de registro. Los valores posibles, en orden creciente de detalle, incluyen:

• error

• warning

• info

• verbose

• debug

• verbosedebug

  Al informar cualquier problema de agente al soporte técnico de New Relic, verbosedebug es la configuración más útil. Sin embargo, esto puede generar mucha información muy rápidamente, así que evite mantener el agente en el nivel verbosedebug durante más tiempo del necesario para reproducir el problema que está experimentando.

  Al informar cualquier problema con el agente al soporte técnico de New Relic, es posible que se le solicite que lo configure en un nivel personalizado, habilitando la depuración solo para ciertos subsistemas. Los niveles personalizados están más allá del alcance de este documento.

Establece el nivel de detalle en una traza de la transacción:

• Cuando se establece en 1, todas las llamadas al servidor son traza.

• Cuando se establece en 0, traza solo incluye llamadas instrumentadas internamente por New Relic y aquellas definidas por el usuario usando newrelic.transaction_tracer.custom.

  El nivel predeterminado de 1 tiene un impacto en el rendimiento. Si necesita mejorar el rendimiento, intente establecer el nivel de detalle en 0.

  Cuando no se rastrean todas las llamadas al servidor, los bloques de tiempo en la traza de la transacción se etiquetarán como uninstrumented time y solo se instrumentarán ciertas funciones (definidas internamente por el agente). Incluso al reportar todas las llamadas, puede haber tiempo no instrumentado en la traza.

Permite alta seguridad para todas las aplicaciones. Cuando la seguridad alta se establece en true, se aplican los siguientes comportamientos:

• Los datos no se enviarán a New Relic a menos quedaemon esté utilizando una conexión segura (HTTPS). Si el proceso PHP genera un newrelic-daemon, se configurará para usar HTTPS independientemente del valor de newrelic.daemon.ssl.

• Nunca se recopilarán cadenas de consulta sin procesar, independientemente del valor de newrelic.transaction_tracer.record_sql.

• El atributo de solicitud nunca se capturará, independientemente de los ajustes de configuración newrelic.attributes .

• Las funciones API newrelic_add_custom_parameter y newrelic_set_user_attributes no tendrán ningún efecto y devolverán false.

• La función API newrelic_record_custom_event no enviará ningún evento a New Relic.

• El agente elimina los mensajes de excepción de los errores.

  Advertencia

  Si cambia la configuración newrelic.high_security , debe also cambiar la configuración de seguridad en la interfaz de usuario de APM. Si las dos configuraciones no coinciden, no se recopilarán datos. Para obtener más información, consulte Alta seguridad.

Agrega etiqueta.

Example tags

"Server:One;Data Center:Primary"

Establece el nombre de host que se mostrará en la UIde APM. Si se establece, esto anula el nombre de host predeterminado que el agente captura automáticamente.

Establece el tiempo transcurrido después del cual una aplicación se considerará inactiva. Las aplicaciones inactivas no cuentan contra el límite máximo de 250 aplicaciones. Las unidades permitidas son "ns", "us", "ms", "s", "m" y "h".

Un valor de 0 se interpretará como "sin tiempo de espera". Esto dará como resultado que las nuevas aplicaciones siempre cuenten para el límite de 250 aplicaciones, además de que el daemon no podrá liberar una pequeña cantidad de memoria por aplicación al sistema operativo.

Recommendation: No utilice este valor a menos que el soporte de New Relic lo solicite. En su lugar, para transacciones en segundo plano ocasionales, utilice un valor del doble del intervalo. Por ejemplo, para un trabajo en segundo plano por horas, establezca el tiempo de espera en 2 horas.

Establece el tiempo máximo que el agente debe esperar a que el daemon conecte una aplicación. Un valor de "0" hace que el agente solo haga un intento de conectarse al daemon. Las unidades permitidas son "ns", "us", "ms", "s", "m" y "h".

Con este tiempo de espera establecido, el agente no cancelará inmediatamente una transacción cuando el daemon aún no se haya conectado al backend, sino que le otorgará tiempo al daemon para establecer la conexión.

Recommendation: Si configura un tiempo de espera, el valor recomendado es "15s". Establezca este tiempo de espera solo cuando instrumente tareas en segundo plano de larga duración, ya que en caso de problemas de conexión, el agente se bloqueará durante el tiempo de espera determinado en cada inicio de transacción.

La configuración especifica el nombre de un log de auditoría, que contendrá todos los datos enviados desde el daemon a los servidores de New Relic, incluida la URL completa, la fecha, la hora y los datos sin comprimir y codificar para cada solicitud.

Este archivo no puede ser el mismo archivo que el daemon log.

Establece el nombre y el puerto opcional del host recolector con el que el daemon se comunicará para verificar su clave de licenciay enviar datos del agente.

Este es solo el nombre del host o el nombre y número de puerto en el formato "hostname:port". Al especificar un número de puerto de 0 se utilizará el puerto predeterminado, que es 80.

Si prefiere que el daemon se lance externamente antes de que se inicie el agente, este valor determina cuándo el agente puede iniciar el daemon:

• 0: No se imponen restricciones al inicio daemon y el agente puede iniciar el daemon en cualquier momento.

• 1: El agente que no es de línea de comando (como Apache o php-fpm) puede iniciar el daemon.

• 2: Sólo el agente de línea de comando puede iniciar el daemon.

• 3: El agente nunca iniciará el daemon. Utilice esta configuración si está configurando el daemon a través de newrelic.cfg y lo inicia fuera del agente.

  Importante

  Si /etc/newrelic/newrelic.cfg existe, el agente asume que el daemon debe iniciarse mediante su script de inicio, no a través del agente. Esta configuración no tiene significado y no aparece en newrelic.cfg.

Establece el nombre del daemon ejecutable en lanzamiento.

Esta variable identifica la ruta completa al archivo ejecutable daemon . Si el sistema New Relic se instaló utilizando los paquetes estándar, la ubicación predeterminada será la correcta. Si ha instalado en una ubicación personalizada utilizando la distribución tar (y no tiene permiso para escribir en /usr/bin), entonces el daemon puede residir en otra ubicación.

Esta configuración no aparece en el archivo newrelic.cfg ya que solo es relevante para PHP.

Establece el nombre del archivo de registro para registrar el mensaje de registro específico daemon . El daemon debe poder escribir en este archivo. El caso más común es que el usuario de Apache terminará iniciando el daemon cuando se inicie Apache, por lo que debe asegurarse de que cualquier usuario que ejecute el proceso de Apache pueda escribir en el archivo.

Establece el nivel de detalle de los mensajes grabados en el archivo de registro daemon de New Relic. Los valores posibles, en orden creciente de detalle, son:

• error

• warning

• info

• healthcheck

• debug

  Las configuraciones más detalladas pueden generar mucha información muy rápidamente. healthcheck registra el número exacto de aplicaciones conectadas. Cuando sea necesario, configure debug durante períodos cortos de tiempo para identificar problemas.

Establece el nombre del archivo en el que el daemon registrará su ID de proceso (pid).

Este archivo lo utiliza el script de inicio y apagado daemon para determinar si el daemon ya se está ejecutando o no.

Establece el extremo del socket para las comunicaciones entre el agente y daemon .

Esto se puede especificar de cuatro maneras.

• Para utilizar un archivo específico como socket de dominio UNIX (UDS), proporcione un nombre de ruta absolute como una cadena. Este es el valor predeterminado en sistemas que no son Linux.

• Para utilizar un puerto TCP estándar, especifique un número en el rango de 1 a 65534.

• Para utilizar un socket abstracto, utilice el valor @newrelic-daemon (disponible para la versión del agente 5.2.0.141 o superior). Este es el valor predeterminado en los sistemas Linux.

• Para conectarse a un daemon que se ejecuta en un host diferente (útil para entornos de contenedor), establezca este valor en host:port, donde host indica un nombre de host o una IP, y port indica un número de puerto válido. Se admiten tanto IPv4 como IPv6. Está disponible para la versión del agente 9.2.0.247 o superior.

  Advertencia

  Los datos transmitidos desde el agente al daemon no están cifrados. La única excepción a esto es la ofuscación de SQL que ocurre antes de enviar datos al daemon. Recomendamos utilizar únicamente una conexión de red privada entre el agente y daemon (esto solo se aplica cuando el agente y daemon se ejecutan en hosts diferentes).

  Si utiliza números de puerto, los sistemas Unix requieren que los puertos en el rango del 1 al 1023 requieran que el daemon se ejecute como superusuario. En caso de que el daemon utilice un puerto no estándar, esta variable también establece el número de puerto que utilizará el agente para comunicarse con el daemon.

  Importante

  Si está utilizando el mecanismo de inicio newrelic.cfg para el daemon, esta configuración y la configuración address en ese archivo deben coincidir.

Establece las credenciales de host y usuario para usar como proxy de salida.

Esto solo se usa si su sitio requiere un proxy para acceder a los servidores de recopilación de datos de New Relic. Puede adoptar cualquiera de las siguientes formas, según la configuración del proxy:

• hostname

• hostname:port

• user@hostname

• user@hostname:port

• user:password@hostname

• user:password@hostname:port

• proxytype://user:password@hostname:port

  Se supone un tipo de proxy HTTP a menos que se especifique otro tipo de proxy. En ese caso, el tipo de proxy puede ser http, calcetines4, calcetines4a o calcetines5.

Esta configuración se ignora en las versiones 8.0 y superiores del agente PHP, y siempre se utilizará HTTPS para comunicarse con New Relic.

En versiones del agente PHP inferiores a 8.0, controla si la comunicación con el recolector New Relic debe utilizar una conexión HTTP segura. El agente se comunica con New Relic a través de HTTPS de forma predeterminada, y New Relic requiere HTTPS para todo el tráfico hacia APM y la API REST de New Relic.

Establece la ubicación de un archivo que contiene certificados de CA en formato PEM. Cuando se configuran, los certificados de este archivo se utilizarán para autenticar el recolector New Relic. En la mayoría de los casos, no debería ser necesario configurar un paquete de CA. El agente PHP de New Relic viene incluido con los certificados CA necesarios.

Si también se establece newrelic.daemon.ssl_ca_path , se buscarán primero los certificados de este archivo, seguidos de los certificados contenidos en el directorio newrelic.daemon.ssl_ca_path .

Esta configuración no tiene ningún efecto cuando newrelic.daemon.ssl se establece en false.

Establece la ubicación de un directorio que contiene certificados de CA confiables en formato PEM. Cuando se configuran, los certificados en este directorio se utilizarán para autenticar el recolector New Relic. En la mayoría de los casos, no debería ser necesario configurar una ruta de CA. El agente PHP de New Relic viene incluido con los certificados CA necesarios.

Si también se establece newrelic.daemon.ssl_ca_bundle , se buscará primero seguido de los certificados contenidos en newrelic.daemon.ssl_ca_path.

Esta configuración no tiene ningún efecto cuando newrelic.daemon.ssl se establece en false.

Establece el tiempo máximo que el agente debe esperar para que se inicie el daemon después de que se activó el lanzamiento daemon . Un valor de "0" hace que el agente no espere. Las unidades permitidas son "ns", "us", "ms", "s", "m" y "h".

El valor de tiempo de espera especificado se pasará al daemon mediante el indicador --wait-for-port. Esto hace que el inicio daemon se bloquee hasta que se adquiera un socket o hasta que transcurra el tiempo de espera.

Recommendation: Si establece un tiempo de espera, el valor recomendado es de "2s" a "5s". Se recomienda establecer este tiempo de espera solo cuando se instrumentan tareas en segundo plano de larga duración, ya que en caso de problemas de inicio daemon , el agente se bloqueará durante el tiempo de espera determinado en cada inicio de transacción.

• Configúrelo en true para habilitar la característica principal de inicio de sesión en contexto. Cuando está habilitado, se habilita la instrumentación adicional framework de registro, ya sea que el registro se envíe o no a New Relic.

• Establezca en false para deshabilitar completamente esta característica, incluida la recopilación de log métricos y reenvío de registros.

• El contexto de inicio de sesión ahora está habilitado de forma predeterminada. Si deshabilitó esta característica, asegúrese de reiniciar su aplicación o sus cambios no surtirán efecto de inmediato.

  Un archivo de configuración de ejemplo:

  newrelic.application_logging.enabled = true
  newrelic.application_logging.metrics.enabled = true
  newrelic.application_logging.forwarding.enabled = true

  Copia

Habilita el envío de log de aplicación a New Relic.

• Establezca esto en true para que su registro se envíe a New Relic. Esto reenvía el registro directamente desde el agente PHP con metadatos de enlace que permiten que funcione nuestra característica de contexto de inicio de sesión. El agente PHP no escribe ningún metadato en la salida del registro de aplicación.

• Establezca esto en false si no desea que su registro se envíe a New Relic. Cuando enabled se establece en false, no se envían datos log a New Relic y la salida del registro de aplicación no se modifica.

  Archivo de configuración de ejemplo (newrelic.ini):

  newrelic.application_logging.enabled = true

  Copia

  Si ya tiene una solución de reenvío de registros y está actualizando su agente para usar el registro automático en contexto, asegúrese de disable your old log forwarder. De lo contrario, su aplicación enviará líneas log dobles. Dependiendo de su cuenta, esto podría resultar en una doble facturación. Para obtener más información, siga los procedimientos para desactivar su reenviador de registros específico.

  Importante

  El uso de la característica de reenvío de registros aumenta la ingesta de datos, lo que puede afectar su facturación. Para obtener más información, consulte nuestra documentación sobre el seguimiento de su ingesta de datos.

• Establezca el valor en un entero positivo para especificar el número máximo de líneas log por minuto para enviar.

• Establezca esto en 0 para deshabilitar efectivamente el envío de registros.

• Establezca esto en un valor más bajo para reducir la cantidad de líneas log enviadas. Esto puede provocar un muestreo log .

• Establezca esto en un valor más alto para enviar más líneas log .

  Cada log recibe la misma prioridad que su transacción asociada. Es posible que algunos registros no se incluyan porque están limitados por max_samples_stored. Por ejemplo, si el registro max_samples_stored se establece en 10 000 y una transacción 1 tiene 10 000 entradas log , solo se registrarán las entradas log de la transacción 1. Si la transacción 1 tiene menos de 10 000 registros, recibirá todos los registros de la transacción 1. Si todavía hay espacio, recibirás todo el registro de la transacción 2, y así sucesivamente. Las entradas log con prioridades más altas se mantienen sobre aquellas con prioridades más bajas.

  Sugerencia

  Esto se refiere a la cantidad de registros enviados por minuto. Establecer max_samples_stored en un valor inferior a 12 tendrá el efecto de no enviar ningún registro. Cualquier número entero no negativo es válido, pero actualmente el valor máximo admitido es 20.000.

  Archivo de configuración de ejemplo (newrelic.ini):

  newrelic.application_logging.forwarding.max_samples_stored = 10000

  Copia

Es posible controlar el nivel de logs de mensajes reenviados por el agente. El nivel de registros reconocidos sigue la especificación PSR-3 y es el siguiente (de mayor a menor gravedad):

• EMERGENCY

• ALERT

• CRITICAL

• ERROR

• WARNING

• NOTICE

• INFO

• DEBUG

  Cuando se especifica un nivel de registros para el agente, se informarán todos los mensajes de este nivel de registros y superiores. Por ejemplo, si establece su nivel de registros en ALERT, recibirá registros para la gravedad ALERT y EMERGENCY . El nivel de registros predeterminado es WARNING.

  Archivo de configuración de ejemplo (newrelic.ini):

  newrelic.application_logging.forwarding.log_level = "INFO"

  Copia

• Establezca esto en true para agregar datos de contexto como atributo de registro.
• Establezca esto en false si no desea que se agreguen datos de contexto como atributo a su registro.

Cuando aplica reglas de atributo al atributo de contexto log , la regla include descarta todos los atributos no definidos en el conjunto de reglas. Este es un comportamiento diferente al de otros tipos de atributos de agente.

• Si el atributo de contexto log no aparece como se esperaba, entonces debe revisar el conjunto de reglas newrelic.attributes.include para confirmar que el atributo que falta es parte de la exclusión. Le recomendamos que configure newrelic.loglevel=verbosedebug para habilitar también los mensajes de registro detallados del agente. Una vez actualizado, busque mensajes del agente sobre el atributo excluido. Esto puede darle pistas sobre cómo ajustar las reglas de inclusión/exclusión.
• Si context_data está habilitado para el reenvío de registros, todas las claves de atributos que se encuentran en esta lista aparecerán en log . Una lista vacía enviará todas las claves de atributos de forma predeterminada.
• Si todas las listas include están vacías, se reenvían todos los atributos de contexto log .

• Si context_data está habilitado para el reenvío de registros, todas las claves de atributos que se encuentran en esta lista se excluyen de log .
• Dejar este campo vacío da como resultado el comportamiento predeterminado. El atributo aún puede excluirse si existe una reglainclude .
• La lista include y exclude sigue las reglas definidas en Habilitación y deshabilitación del atributo.

Esto permite agregar metadatos de enlace a log de Monolog. Establezca esto en true para habilitar esta característica. Deje esto configurado en false si usa la característica de reenvío de registros de APM para reenviar su registro a New Relic.

Permite capturar información métrica sobre su registro y nivel de registros, que se muestra en un gráfico en la página APM Summary .

Deje esto configurado en verdadero para permitir que el agente capture información métrica sobre su registro.

Establezca esto en false para desactivar esta característica.

Establezca esto en una lista separada por comas de funciones o métodos definidos por el usuario para instrumento:

"myfunction,myclass::method,otherfunction"

Las funciones internas de PHP no pueden tener seguimiento personalizado.

Puede agregar a la lista de funciones personalizadas con cada archivo PERDIR, pero no puede eliminar una función o método que ya se haya agregado. Si desea agregar funciones o métodos mediante programación para instrumentarlos, utilice la llamada de función API newrelic_add_custom_tracer() .

Habilita o deshabilita el rastreador de transacciones.

El rastreador crea una traza detallada de la transacción para las transacciones que toman más tiempo que el umbral, según lo establecido por el valor newrelic.transaction_tracer.threshold . Solo se almacena una traza de la transacción por aplicación por ciclo de cosecha y siempre es la transacción más lenta durante ese ciclo.

La traza de la transacción es útil para diagnosticar por qué una transacción en particular fue lenta. A menos que la memoria y el rendimiento sean críticos, casi nunca deberían desactivarse. Habilitar esto tiene un impacto muy leve en el rendimiento y utiliza más memoria.

Para obtener más información, consulte newrelic.transaction_tracer.detail.

Habilita o deshabilita la solicitud de planes explicativos de MySQLi y PDO MySQL biblioteca para llamadas de consulta lenta. Los planes explicativos solo estarán disponibles cuando newrelic.transaction_tracer.slow_sql esté configurado en true y newrelic.transaction_tracer.record_sql no esté configurado en "off".

Establece el umbral más allá del cual las consultas se consideran "lentas" y, por lo tanto, candidatas para la página Slow Queries . Especifique la duración como un valor absoluto con unidades. La unidad predeterminada es milisegundos si no se especifica ninguna.

Example durations

• "200ms"
• "1s250ms"
• "1h30m"
• "750us"

Habilita o deshabilita el soporte para el seguimiento de funciones internas (es decir, funciones escritas en C y proporcionadas a través de la biblioteca estándar PHP o extensiones PECL). Cuando está habilitada, las funciones internas aparecen en la traza de la transacción como funciones escritas en PHP.

Habilitar esta opción puede hacer que la transacción sea más lenta, especialmente cuando se recopilan muchas trazas de PHP 5.x. Solo se recomienda habilitar esta opción cuando se depuran específicamente problemas de rendimiento en los que se sospecha que una función interna es lenta.

Establece cómo se registran las consultas (si es que se registran).

Al registrar internamente la traza de la transacción, se registra la consulta completa de llamadas de consulta lenta. Enviar esta consulta a New Relic puede tener graves implicaciones de seguridad, por lo que, de forma predeterminada, todas las declaraciones de la base de datos se ofuscan antes de enviarse a New Relic. La ofuscación no es reversible, ya que reemplaza cadenas y números en cualquier consulta con signos de interrogación. Lo único que sobrevive intacto son los nombres de los campos, no ninguno de sus valores.

• Si está realizando pruebas con datos que no son confidenciales y necesita ver la consulta sin procesar en la traza de la transacción, configúrelo en "raw".

• Si no desea que la consulta se grabe en absoluto, configúrelo en "off".

  Importante

  Vuelva a establecerlo siempre en "obfuscated" o "off" en cualquier entorno de producción.

Utilice esta configuración para habilitar o deshabilitar la característica de consulta lenta. Cuando esté habilitado,:

• Registre las 10 consultas de la base de datos más lentas por aplicación por minuto.

• Cree un rastreo del stack que conduzca a la consulta.

  Si esta variable se establece en false o la grabación SQL está deshabilitada, el agente New Relic no recopila ningún dato de consulta lenta.

Esto establece el umbral por encima del cual el agente registrará la stack PHP completa para la traza de la transacción para la cual se está registrando la consulta.

Especifique la duración como un valor absoluto con unidades. La unidad predeterminada es milisegundos si no se especifica ninguna.

Example durations

• "200ms"

• "1s250ms"

• "1h30m"

• "750us"

  Rastreo del stack puede consumir memoria, así que tenga cuidado de no establecer este valor demasiado bajo. Esta variable no tiene significado si newrelic.transaction_tracer.record_sql se establece en "off".

Utilice esta variable para establecer el umbral más allá del cual las transacciones son elegibles para ser traza. Los valores disponibles incluyen:

• Utilice "apdex_f" para establecer el umbral en 4 veces el valor apdex_t de la aplicación. Para obtener más información, consulte Apdex: Medición de la satisfacción del usuario.

• Utilice cualquier otra cadena de duración para establecer un umbral de tiempo específico. Especifique la duración como valor absoluto y la unidad de medida. Si no se especifica ninguno, la unidad por defecto es milisegundo.

  Example durations

• "200ms"

• "1s250ms"

• "1h30m"

• "750us"

Utilice esta configuración para habilitar o deshabilitar la recopilación de consulta de entrada DQL con consulta lenta y traza de la transacción. Cuando estén habilitados, aparecerán junto con consulta lenta y traza de la transacción.

Especifica el número máximo de segmentos que el agente PHP registrará para la transacción web. Una vez que se alcance ese máximo, se realizará el muestreo.

El agente PHP informa la traza de la transacción y el rastreo distribuido como una colección de segmentos. Cada segmento representa un método o una llamada a función en una traza de la transacción. El valor predeterminado para esta configuración es 0, lo que indica que el agente PHP capturará todos los segmentos durante una transacción web. Al final de una transacción, reúne los segmentos de mayor prioridad para informar en una traza de la transacción.

Para procesos PHP de larga duración con cientos de miles o millones de llamadas a funciones, establecer esto en un valor mayor que 1 evita que el agente PHP agote la memoria del sistema al grabar segmentos.

El tamaño del segmento puede variar según la longitud del nombre del método correspondiente, la longitud de su nombre de clase y la cantidad de llamadas posteriores realizadas por el método. Dicho esto, una estimación conservadora es 400 bytes por segmento. Para limitar el agente PHP a 40 MB para la captura de segmentos, establezca este valor en 100000. Si este valor se establece por debajo de 2000, limita aún más el número total de segmentos reportados para la traza de la transacción.

Esta configuración es sólo para procesos web PHP; no afectará los procesos PHP CLI. Para establecer un límite para los procesos CLI, utilice newrelic.transaction_tracer.max_segments_cli.

Especifica el número máximo de segmentos que el agente PHP registrará para la transacción CLI. Una vez que se alcance ese máximo, se realizará el muestreo.

El agente PHP informa la traza de la transacción y el rastreo distribuido como una colección de segmentos. Cada segmento representa un método o una llamada a función en una traza de la transacción. El valor predeterminado para esta configuración es 100000, lo que indica que el agente PHP capturará todos los segmentos durante una transacción web. Al final de una transacción, reúne los segmentos de mayor prioridad para informar en una traza de la transacción.

Para procesos PHP de larga duración con cientos de miles o millones de llamadas a funciones, establecer esto en un valor mayor que 1 evita que el agente PHP agote la memoria del sistema al grabar segmentos.

El tamaño del segmento puede variar según la longitud del nombre del método correspondiente, la longitud de su nombre de clase y la cantidad de llamadas posteriores realizadas por el método. Dicho esto, una estimación conservadora es 400 bytes por segmento. Para limitar el agente PHP a 40 MB para la captura de segmentos, establezca este valor en 100000. Si este valor se establece por debajo de 2000, limita aún más el número total de segmentos reportados para la traza de la transacción.

Esta configuración es solo para procesos PHP CLI; no afectará los procesos web PHP. Para establecer un límite para los procesos web, utilice newrelic.transaction_tracer.max_segments_web.

Activa o desactiva el rastreador multiaplicación. El rastreador de aplicaciones múltiples inserta encabezados HTTP en las solicitudes salientes y en la respuesta para vincular la transacción web métrica y la traza de la transacción entre aplicaciones.

El rastreo distribuido y el rastreo multiaplicación no se pueden utilizar simultáneamente. La configuración predeterminada del agente PHP habilita el rastreo distribuido y deshabilita el rastreo multiaplicación.

Activa o desactiva el rastreo distribuido. Está activado de forma predeterminada en agente PHP 9.21.0 y superior. Cuando el rastreador de transacciones del agente y la característica de rastreo distribuido están habilitados, el agente insertará encabezados en las solicitudes salientes y escaneará las solicitudes entrantes en busca de encabezados de rastreo distribuido.

newrelic.transaction_tracer.enabled = true
newrelic.distributed_tracing_enabled = true

Para más información, consulta rastreo distribuido para tus servicios PHP.

Establezca esto en verdadero para excluir el encabezado de rastreo distribuido de New Relic que se adjunta a las solicitudes salientes y, en su lugar, confiar únicamente en los encabezados W3C Trace Context para rastreo distribuido. Si esto es falso, ambos tipos de encabezados se adjuntan a las solicitudes salientes.

El encabezado rastreo distribuido de New Relic permite la interoperabilidad con agentes más antiguos que no admiten encabezados W3C Trace Context . Las versiones del agente que admiten encabezados W3C Trace Context los priorizarán sobre los encabezados New Relic para rastreo distribuido.

Span evento son reportados para rastreo distribuido. Los informes de eventos de span requieren que rastreo distribuido esté habilitado. Esta opción habilita/deshabilita el informe del evento de intervalo.

Span evento son reportados para rastreo distribuido. Este valor establece el número máximo de eventos de intervalo enviados al recolector por ciclo de recolección. Un valor de 0 utilizará el agente predeterminado de 2000. La configuración máxima es 10000.

Configura la traza Observer utilizada para Infinite Tracing. Si está vacío, se desactivará la compatibilidad con Infinite Tracing. Esto requiere que rastreo distribuido y span evento estén habilitados.

Configura el puerto TCP/IP utilizado para comunicarse con el Infinite Tracing traza Observer. Esta configuración se ignora si newrelic.infinite_tracing.trace_observer.host está vacío. Por lo general, no será necesario cambiar esta configuración.

Establece el número de eventos de intervalo que se pueden poner en cola para su transmisión al Infinite Tracing traza Observer. El agente gestiona internamente el evento de intervalo para Infinite Tracing en lotes de intervalo. Esos lotes de tramos pueden contener un máximo de 1000 tramos. Por lo tanto, el tamaño de la cola de eventos de intervalo no puede ser inferior a 1000, de lo contrario ni siquiera se podrá poner en cola un solo lote de intervalo. Si se especifica un tamaño de cola inferior a 1000, se utiliza el tamaño mínimo de 1000 .

Habilite o deshabilite el selector de errores. Cuando está habilitado, el agente recopila e informa errores de PHP a la UI de New Relic.

El agente registra solo el error más grave de cada transacción y hasta 20 errores por ciclo de recolección.

Cuando está habilitado, el agente recopila los errores devueltos por las funciones de MySQL como si fueran errores de PHP.

Establezca esto en true para asignar la prioridad más alta a los errores identificados a través de la función API newrelic_notice_error() .

Una lista separada por comas de nombres de clases de excepción completos que el agente debe ignorar. Cuando se produce una excepción no controlada, el agente realizará el equivalente a $exception instanceof Class para cada una de las clases enumeradas. Si alguna de esas comprobaciones resulta verdadera, el agente no registrará una excepción.

Según la versión de PHP admitida, estos valores equivalen a disabling informe de excepciones:

• Versiones PHP 5 compatibles: newrelic.error_collector.ignore_exceptions = Exceptions
• Versiones de PHP 7 compatibles: newrelic.error_collector.ignore_exceptions = Throwable

Establece los niveles de error para el agente PHP en ignore. El valor de esta configuración utiliza una sintaxis similar a la opción error_reporting de PHP. Por ejemplo, para configurar el agente PHP para ignorar los errores de nivel E_WARNING y E_ERROR , utilice:

newrelic.error_collector.ignore_errors = E_WARNING | E_ERROR

o

newrelic.error_collector.ignore_errors = 3

Para configurar el agente PHP para que ignore todo excepto E_WARNING, use:

newrelic.error_collector.ignore_errors = E_ALL & ~E_WARNING

Para habilitar el seguimiento del módulo Drupal, configúrelo en true. Esta opción tiene el mismo impacto en el rendimiento que newrelic.transaction_tracer.detail. Permitirá el registro de las funciones del módulo Drupal y el recuento de llamadas, y se mostrarán en la pestaña Modules , al igual que las transacciones web.

Para habilitar el seguimiento de enlaces de WordPress, configúrelo en true. Permitirá la grabación de ganchos, complementos y temas de WordPress, y se mostrarán en la pestaña WordPress en la UI de New Relic.

Establece las opciones sobre cómo se instrumentan los ganchos de WordPress. El agente New Relic puede proporcionar diferentes niveles de información valiosa en los enlaces de WordPress. De forma predeterminada, todas las funciones de devolución de llamadas están instrumentadas ("all_callbacks"). Para reducir los gastos generales del agente, es posible limitar la instrumentación a solo el complemento/tema de devolución de llamada ("complemento"). La tercera opción es monitor los ganchos sin devolución de llamada instrumentada ("umbral"). Esta opción no proporciona información valiosa sobre complementos/temas. Lea más sobre la instrumentación específica de WordPress aquí.

Establece el umbral por encima del cual el agente New Relic registrará la ejecución del enlace de WordPress. Se utiliza cuando newrelic.framework.wordpress.hooks.options está configurado en "threshold".

Es lo mismo que newrelic.webtransaction.name.functions, excepto que utiliza nombres de archivos para nombrar la transacción web. Los nombres de los archivos pueden ser expresiones regulares POSIX estándar para usarse con PCRE; por ejemplo, "controllers/actions/.*".

A menos que el agente New Relic detecte un framework específico, como Drupal o Wordpress, las transacciones web llevan el nombre del archivo PHP inicial; por ejemplo, article.php.

Cuando el archivo inicial es un despachador, este esquema de nombres produce datos poco útiles. Utilice esta variable para especificar una lista de funciones que son las "acciones" generadas por el despachador. El nombre de la transacción web será la primera función de acción ejecutada.

Example dispatch function naming

Si index.php se envía a funciones denominadas:

• login,

• logout,

• admin,

• show, y

• edit

  Establecería este valor en "login,logout,admin,show,edit".

  La web de transacción se llamará login, logout, etc. en lugar de /index.php (el nombre del archivo inicial).

Cuando está habilitado, esto elimina cualquier contenido en el URI de solicitud después del nombre del script. Por ejemplo, esto eliminaría el /xyz/zy final de /path/to/foo.php/xyz/zy.

Si es false, el agente no reportará almacenamiento de datos instancia métrica, ni agregará host o port_path_or_id parámetro a la transacción o traza sql lenta.

Si es false, el agente no agregará el parámetro database_name a la transacción o ralentizará la traza SQL.

Habilita o deshabilita la colección de atributos generados por el agente PHP o generados por el usuario a través de newrelic_add_custom_parameter(). Esta configuración tendrá prioridad sobre todas las demás configuraciones de atributos.

Para obtener más información, consulte Habilitación y deshabilitación de atributos.

Controla qué destinos reciben atributo. Estos ajustes de configuración anularán los ajustes .include y .exclude .

Para obtener más información sobre los destinos disponibles, consulte Habilitación y deshabilitación del atributo.

Esta es una familia de opciones de configuración que permiten un control preciso sobre los destinos del atributo. Para obtener más información, consulte Habilitación y deshabilitación de atributos.

Habilite o deshabilite la colección de eventos generados por el usuario a través de newrelic_record_custom_event(). Esta configuración tendrá prioridad sobre todas las demás configuraciones de atributos.

Para obtener más información, consulte Informe de evento personalizado y atributo.

Un entero positivo que especifica el número máximo de eventos personalizados por minuto para enviar.

Establecer esto en 0 deshabilitará efectivamente el envío de eventos personalizados. Configurar newrelic.custom_insights_events.enabled es la forma preferida de habilitar o deshabilitar la generación de eventos personalizados.

Establezca esto en un valor más bajo para reducir la cantidad de eventos personalizados enviados (puede causar muestreo de eventos personalizados). Establezca esto en un valor más alto para enviar más líneas de eventos personalizados.

Activa o desactiva la recopilación de métricas a nivel de código.

El compromiso sha. Se puede utilizar el sha completo o sólo los primeros siete caracteres (por ejemplo, 734713b).

Una etiqueta de lanzamiento (como v0.1.209 o release-209).

Habilite o deshabilite el agente New Relic. De forma predeterminada, el agente PHP New Relic está habilitado para todos los directorios.

Si tiene varios sitios en su servidor web pero solo desea que el agente PHP monitor sitios específicos:

1. Asegúrese de que newrelic.enabled esté configurado en true en el nivel global (SISTEMA) en su archivo newrelic.ini .

2. Establezca newrelic.enabled en false para uno o más sitios específicos por directorio (PERDIR).

   Si necesita deshabilitar el agente globalmente, establezca el valor newrelic.enabled en false en el archivo newrelic.ini .

   Cuando el agente está globalmente deshabilitado, no se inicializa por completo. Se supone que lo está deshabilitando globalmente por una razón crítica, y el agente intentará tener un impacto lo más cercano posible a cero en PHP.

   Importante

   No puede deshabilitar globalmente el agente y luego habilitarlo selectivamente por directorio usando .htaccess.

Esto identifica el nombre del archivo para registrar mensajes. Esto es útil para depurar cualquier problema con el agente. Independientemente de lo que establezca, asegúrese de que:

• Los permisos para el directorio que lo contiene y el archivo en sí son correctos.
• El usuario que ejecuta PHP puede escribir en el archivo. Normalmente se trata del mismo usuario que el servidor web.

Cuando se establece en true, el agente recopilará e informará datos de eventos analíticos. Los datos del evento permiten que la UI de New Relic muestre información adicional como histograma y percentil.

Cuando se establece en true, el agente recopilará e informará datos del evento de error. Los datos del evento permiten que la UI de New Relic muestre análisis de errores.

Esta configuración habilita características nuevas y experimentales dentro del agente PHP. Estos indicadores se utilizan para habilitar selectivamente características que deben habilitarse de forma predeterminada en versiones posteriores del agente PHP.

Esto permite la inserción automática de fragmentos de JavaScript para monitoreo de browser. Cuando está habilitado, el agente insertará un encabezado y un pie de página en la salida HTML que generará métricas en el tiempo de carga de la página para la experiencia del usuario final. Para obtener más información, consulte Tiempo de carga de la página en PHP.

Activa o desactiva la compatibilidad con la biblioteca Guzzle cuando se utiliza con New Relic.

• Agente PHP versión 6.4 o superior: esta configuración está establecida en true de forma predeterminada.

Habilita la detección de framework y biblioteca cuando la precarga está habilitada. La precarga se introdujo en la versión PHP 7.4. newrelic.preload_framework_library_detection solo tendrá efecto cuando opcache.preload esté configurado en el archivo php.ini .

Cuando se establece en true, el agente enviará información de detección de paquetes que se puede ver en la página del entorno.