• 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

Configuración del agente PHP

Nuestro agente PHP tiene una serie de configuraciones para ajustar los tipos y cantidades de datos reportados. Para la mayoría de los usuarios, los valores predeterminados producen la mejor combinación posible de gastos generales y utilidad. Sin embargo, puede cambiar la configuración según sus necesidades específicas.

Importante

Reinicie siempre su servidor web después de cambiar la configuración de INI. De lo contrario, es posible que no surtan efecto inmediatamente.

Orden de precedencia de configuración

A continuación se muestra una ilustración sencilla del orden de precedencia que sigue el agente PHP para la configuración. La configuración del lado del servidor no es aplicable. Los únicos valores que puede cambiar en la UI para aplicaciones que utilizan el agente PHP son el alias de la aplicación y su valor Apdex-T.

Con la configuración del agente PHP API de New Relic anula la configuración por directorio. La configuración por directorio anula la configuración del archivo php.ini . La configuración del lado del servidor no es aplicable.

Variables del archivo de configuración

Durante la instalación, el script newrelic-install proporciona información sobre los archivos de configuración que creó o una lista de los archivos que necesita editar. De forma predeterminada, intentará crear un archivo de configuración llamado newrelic.ini.

En algunos casos, es posible que se le indique que agregue opciones de configuración a su archivo php.ini . Haga esto sólo si es necesario. Exactamente qué archivo necesita editar depende de cómo se configuró su versión (o versiones) particular de PHP.

Las dos configuraciones más comunes son:

  • Utilice un único archivo newrelic.ini . Este suele ser el valor predeterminado si ha instalado o compilado PHP usted mismo sin opciones especiales.
  • Escanee un directorio determinado en busca de todos los archivos .ini .

Si no está seguro de qué archivo editar:

  • Desde la línea de comando, revise el resultado de php -i.

  • En un browser, revise el resultado de una página que contiene el script:

    <?php phpinfo(); ?>
  • Si aparece el archivo newrelic.ini , úselo.

Alcance variable

Cada variable de su archivo newrelic.ini tiene un alcance definido. El alcance controla dónde se puede establecer o modificar la configuración.

Los dos ámbitos admitidos para la configuración de New Relic son:

  • SYSTEM

    : Valores establecidos globalmente en el archivo global newrelic.ini .

  • PERDIR

    : Valores establecidos por directorio .

Cada uno también puede establecerse a un nivel más general. Las ubicaciones válidas para cada uno son:

Can be set for:

SISTEMA

PERDIR

Establecido en el archivo global newrelic.ini .

Establecido por directorio.

Importante

No puedes usar ini_set() para la configuración de New Relic.

Tipo de variable

Cada variable de su archivo newrelic.ini tiene un tipo definido. El tipo especifica la sintaxis del valor que utiliza.

Variable type

Formatting and contents

String

Los valores de cadena pueden contener cualquier carácter alfanumérico y puntuación. El valor está delimitado por comillas.

Boolean

Una configuración lógica de verdadero o falso. Los valores válidos son:

  • Para verdadero o habilitado: on, true, el número 1.
  • Para falso o deshabilitado: off, false, el número 0.

Number

Los valores numéricos solo pueden contener dígitos, más un punto para indicar flotante. A menos que se indique lo contrario, todos los números son enteros, no flotantes.

Duration

Un valor de cadena delimitado por comillas que representa una duración de tiempo. Utilice banderas de caracteres para delimitar los componentes del tiempo. Si no hay banderas, el tiempo está en milisegundos.

  • w\= semanas

  • d\= días

  • h\= horas

  • m\= minutos

  • s\= segundos

  • ms\= milisegundos

  • us\= microsegundos

    Duraciones de ejemplo:

  • "1w3d23h10m"\= 1 semana, 3 días, 23 horas y 10 minutos

  • "5h30m"\= 5 horas y 30 minutos

  • "500"\= 500 milisegundos

Ajustes de configuración generales

Estas configuraciones están disponibles en el archivo newrelic.ini .

Si está utilizando New Relic CodeStream para monitor el rendimiento de su IDE, es posible que también desee asociar el repositorio con sus servicios y asociar SHA de compilación o etiqueta de lanzamiento con errores.

Daemon .ini ajustes

Los valores de estas configuraciones controlan el inicio daemon . Cuando el agente detecta que es necesario iniciar el daemon , convertirá estas opciones en las opciones de línea de comando apropiadas para el daemon.

Todas estas configuraciones reflejan la configuración del archivo newrelic.cfg . Se repiten aquí para conservar todos los .ini. configuraciones en un solo lugar. Cada configuración en newrelic.cfg tiene su contraparte aquí, con newrelic.daemon. como prefijo. Por ejemplo, la configuración ssl en newrelic.cfg es newrelic.daemon.ssl en un .ini archivo.

Importante

Si el archivo /etc/newrelic/newrelic.cfg existe, el agente ignora esta configuración y no iniciará el daemon automáticamente.

Para obtener más información sobre las formas de iniciar el daemon y cuándo usar un archivo de configuración externo, consulte Modos de inicio daemon PHP.

Logs en contexto

Agente PHP versión 10.1.0 le permite reenviar su registro PHP con el registro APM en contexto. A partir de la versión 10.3.0, la característica logging métrica y agent reenvío de logs están habilitadas de forma predeterminada. El valor newrelic.application_logging.enabled controla si la característica de contexto de inicio de sesión está activa o inactiva.

Tenga en cuenta que cambiar la configuración en el archivo de configuración del agente local (newrelic.ini) requiere reiniciar el servidor web para que surta efecto. Si no lo hace, es posible que los cambios no surtan efecto inmediatamente.

Reenvío log

Si está utilizando un frameworkde registro compatible, puede indicarle al agente que reenvíe el registro de su aplicación a New Relic.

  • newrelic.application_logging.forward.enabled habilita o deshabilita el reenvío de registros
  • newrelic.application_logging.forwarding.max_samples_stored limita la cantidad de registros que su aplicación reenvía a New Relic
  • newrelic.application_logging.forwarding.log_level te permite elegir qué tipo de registro reenvía tu aplicación a New Relic

Log datos de contexto

El agente PHP captura datos de contexto para la biblioteca Monolog y agrega ese contexto como atributo a su registro reenviado. Puede controlar qué contexto agrega su agente a través de la configuración en la sección context_data , dentro de la sección forwarding .

  • newrelic.application_logging.forwarding.context_data.enabled agrega datos de contexto de Monolog a su atributo de registro
  • newrelic.application_logging.forwarding.context_data.include define qué claves de atributo se encuentran en su registro reenviado
  • newrelic.application_logging.forwarding.context_data.exclude define qué claves de atributos se excluyen en su registro reenviado

Importante

El agente PHP solo reenvía datos de contexto log que tienen una clave de cadena y un valor que es una cadena o un escalar (int, double, boolean).

Decoración log

El agente PHP puede recopilar y agregar metadatos de enlace a log de Monolog para permitir que el registro en contexto funcione con los datos log reenviados por un reenviador de registros de terceros. Para habilitar esta característica utilice la opción newrelic.application_logging.local_decorating.enable :

Log métrico

El agente PHP puede recopilar métricas relacionadas con el registro de eventos para el marco de registro compatible. La creación de estas métricas está controlada por la opción newrelic.application_logging.metrics.enable :

Importante

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 manual log forwarder. De lo contrario, su aplicación enviará el doble de datos log . 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.

Rastreador de transacciones .ini ajustes

Los valores de estas configuraciones se utilizan para controlar la traza de la transacción.

Otro rastreador .ini ajustes

Los valores de estas configuraciones se utilizan para controlar varias características del rastreador.

Configuración de atributos

Esta sección enumera las configuraciones que afectan la recopilación y los informes de atributos.

Evento personalizado

Esta sección enumera las configuraciones que afectan los informes de eventos personalizados.

Métrica a nivel de código

Esta sección enumera las configuraciones que afectan los informes de métricas a nivel de código.

Configuración Errors Inbox

Configurar una de las siguientes etiquetas le ayudará a identificar qué versiones de su software están produciendo los errores.

  • NEW_RELIC_METADATA_SERVICE_VERSION creará tags.service.version en los datos del evento que contienen la versión de su código que se desplegará, en muchos casos una versión semántica como 1.2.3, pero no siempre.
  • NEW_RELIC_METADATA_RELEASE_TAG creará tags.releaseTag en los datos del evento que contienen la etiqueta de lanzamiento (como v0.1.209 o release-209).
  • NEW_RELIC_METADATA_COMMIT creará tags.commit on event data containing the commit sha. Se puede utilizar el sha completo o sólo los primeros siete caracteres (por ejemplo, 734713b).

Una próxima versión de Errors Inbox rastreará automáticamente qué versiones de su software están produciendo errores. Todos los datos de la versión también se mostrarán en CodeStream.

Otro .ini ajustes

Esta sección enumera las configuraciones restantes de newrelic.ini.

Copyright © 2024 New Relic Inc.

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