Puede configurar el agente New Relic Ruby con configuraciones en un archivo de configuración, variables de entorno o mediante programación con configuración del lado del servidor. Este documento resume las opciones de configuración disponibles para el agente Ruby.
Si el valor predeterminado para una opción de configuración es (Dynamic), esto significa que el agente Ruby calcula el valor predeterminado en tiempo de ejecución. El valor de la configuración es el valor predeterminado de otra configuración, según corresponda.
Métodos de configuración y precedencia.
El método principal (predeterminado) para configurar el agente Ruby es a través del archivo de configuración (newrelic.yml) en el subdirectorio config . Para establecer valores de configuración utilizando variables de entorno:
- Agregue el prefijo
NEW_RELIC_al nombre de la configuración. - Reemplace los puntos
.con guiones bajos_.
También puede configurar algunos valores en la UI mediante la configuración del lado del servidor.
El agente Ruby sigue este orden de precedencia para la configuración:
- Variables de entorno
- Configuración del lado del servidor
- Archivo de configuración (
newrelic.yml) - Ajustes de configuración predeterminados
En otras palabras, las variables de entorno anulan todas las demás configuraciones e información de configuración, la configuración del lado del servidor anula el archivo de configuración y las configuraciones predeterminadas, y así sucesivamente.
Ver y editar opciones de archivos de configuración
El newrelic.yml del agente Ruby es un archivo de configuración YAML estándar. Generalmente incluye una sección Defaults en la parte superior, además de secciones debajo para cada entorno de aplicación (Development, Test, Staging y Production).
El agente Ruby determina qué sección del archivo de configuración newrelic.yml leer observando ciertas variables de entorno para derivar el entorno de la aplicación. Esto puede ser útil cuando desea emplear info para la configuración log_level en su entorno de producción y desea configuraciones log_level más detalladas (como debug) en su entorno de desarrollo.
A continuación se muestra un archivo de configuración newrelic.yml de ejemplo:
common: &default_settings license_key: 'YOUR_LICENSE_KEY' app_name: 'My Application Name'production: <<: *default_settings log_level: infodevelopment: <<: *default_settings log_level: debugEl agente Ruby busca las siguientes variables de entorno, en este orden, para encontrar el entorno de la aplicación:
NEW_RELIC_ENVRUBY_ENVRAILS_ENVAPP_ENVRACK_ENV
Si el agente Ruby no detecta valores para ninguna de esas variables de entorno, establecerá el entorno de la aplicación en development de manera predeterminada y leerá desde la sección development del archivo de configuración newrelic.yml .
Al ejecutar el agente Ruby en una aplicación Rails, el agente primero busca la variable de entorno NEW_RELIC_ENV para encontrar el entorno de la aplicación y qué sección de newrelic.yml emplear. Si NEW_RELIC_ENV no está presente, el agente emplea el entorno Rails (RAILS_ENV).
Cuando edite el archivo de configuración, asegúrese de:
- Sangría sólo con dos espacios.
- Sangrar sólo cuando sea relevante, en secciones como
error_collector.
Si no aplica la sangría correctamente, el agente puede generar un error Unable to parse configuration file al iniciar.
Para ver la lista más actualizada de opciones de configuración del agente Ruby disponibles, utilice el comando rake newrelic:config:docs . Este documento describe las opciones más comunes.
Actualizar el archivo de configuración
Esta documentación se aplica a la última versión del agente Ruby. Para obtener detalles sobre versiones anteriores, consulte los comentarios en el propio newrelic.yml .
Para actualizar el archivo newrelic.yml después de una nueva versión, utilice la plantilla en el directorio base de la gema del agente. Cuando actualice a nuevas versiones de gemas, examine o diferencie config/newrelic.yml y newrelic.yml en el directorio de instalación para aprovechar las nuevas opciones de configuración.
Importante
La actualización de la gema no actualiza automáticamente config/newrelic.yml.
General
Estas configuraciones están disponibles para la configuración del agente. Algunas configuraciones dependen de su nivel de suscripción a New Relic.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, permite que se ejecute el agente Ruby.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifique el nombre de la aplicación utilizada para agregar datos en la UI de New Relic. Para informar datos a varias aplicaciones al mismo tiempo, especifique una lista de nombres separados por un punto y coma ;. Por ejemplo, MyApp o MyStagingApp;Instance1.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Tu New Relic .
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Establece el nivel de detalle del mensaje de log. Los posibles niveles de logs, con mayor detalle, son: error, warn, info o debug.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de nombres de eventos personalizados de ActiveSupport a los que suscribirse e instrumentar. Por ejemplo: [one.custom.event, another.event, a.third.event]
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente usará el nombre de la tabla del modelo de ActiveRecord en lugar del nombre de la clase al nombrar las métricas, los spans y los segmentos de la traza de la transacción de ActiveRecord. Esto puede reducir la cardinalidad cuando varios modelos comparten una tabla de base de datos. Por defecto es false.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Respalda la búsqueda de conexiones ActiveRecord más rápida introducida en Rails 6, lo que mejora el rendimiento del agente cuando se instrumenta ActiveRecord. Tenga en cuenta que esta configuración puede no ser compatible con otras gemas que parchean ActiveRecord.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Anulación manual de la ruta a su paquete de CA local. Este paquete de CA valida el certificado SSL presentado por el servicio de recopilación de datos de New Relic.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente captura las claves de memcache en las trazas de la transacción.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Cuando true, el agente captura el parámetro de solicitud HTTP y los adjunta a la traza de la transacción, los errores de traza y TransactionError evento.
Advertencia
Al emplear la configuración capture_params , el agente Ruby no intentará filtrar información secreta. Recommendation: Para filtrar la información secreta del parámetro de solicitud, emplee la configuraciónattributes.include en su lugar. Para obtener más información, consulte los ejemplos de atributosRuby .
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente borrará Tracer::State en Agent.drop_buffered_data.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Ruta a newrelic.yml. Si no está definido, el agente comprueba los siguientes directorios (en orden): config/newrelic.yml -> newrelic.yml -> $HOME/.newrelic/newrelic.yml -> $HOME/newrelic.yml
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, suprime el encabezado de rastreo distribuido newrelic en las requests salientes.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, fuerza al agente a instalar su manejador de salida (que envía todos los datos en caché al recolector antes de apagarse), incluso en los casos en que el agente normalmente lo omitiría, como cuando detecta que Sinatra se ejecuta como un servicio integrado dentro de otro framework. Sinatra ejecuta toda la aplicación dentro de su propio bloque at_exit, por lo que el agente omite su propio manejador at_exit de forma predeterminada para evitar conflictos. Esta configuración anula eso. Nota: send_data_on_exit también debe ser true para que esta configuración surta efecto.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, habilita el modo de alta seguridad. Asegúrese de comprender las implicaciones del modo de alta seguridad antes de habilitar esta configuración.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Un diccionario de nombres y valores de etiquetas que se aplicarán a los datos enviados desde este agente. También se puede expresar como una cadena ; delimitada por punto y coma de pares : separados por dos puntos. Por ejemplo, Server:One;Data Center:Primary.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define un nombre para el archivo de registro.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define una ruta al archivo de log del agente, excluyendo el nombre del archivo. Si desea enviar los logs del agente a la salida estándar, establezca esto en STDOUT.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifica un señalizador para transmitir datos al recolector New Relic. Actualmente json es el único valor válido para esta configuración.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Cuando true, el agente transmite datos sobre su aplicación al recolector de New Relic.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, utiliza Module#prepend en lugar de alias_method para la instrumentación de ActiveRecord.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define un host para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define una contraseña para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define un puerto para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define un usuario para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita el controlador de salida que envía datos al recolector New Relic antes de apagarse.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Cuando se establece en true, fuerza una conexión sincrónica con el recolector New Relic durante el inicio de la aplicación. Para procesos de muy corta duración, esto ayuda a garantizar que el agente de New Relic tenga tiempo para informar.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el almacenamiento de estado del rastreador es local para el subproceso; de lo contrario, es local para la fibra.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define el número máximo de segundos que el agente debe dedicar a intentar conectarse al recolector.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita la captura de todos los encabezados de solicitud HTTP para todos los destinos.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de cadenas CLASS#METHOD (para métodos de instancia) y/o CLASS.METHOD (para métodos de clase) que representan métodos de Ruby a los que el agente puede agregar automáticamente instrumentación personalizada. Esto no requiere ninguna modificación del código fuente que define los métodos.
Emplee nombres de clase completamente calificados (empleando el delimitador :: ) que incluyan cualquier espacio de nombres de módulo o clase.
Aquí hay un código fuente Ruby que define un método de instancia render_png para una clase Image y un método de clase notify para una clase User , ambos dentro de un namespace módulo MyCompany :
module MyCompany class Image def render_png # code to render a PNG end end
class User def self.notify # code to notify users end end endDado ese código fuente, el archivo de configuración newrelic.yml podría aplicar instrumentación para ambos métodos de la siguiente manera:
automatic_custom_instrumentation_method_list: - MyCompany::Image#render_png - MyCompany::User.notifyEse ejemplo de configuración emplea la sintaxis de matriz YAML para especificar ambos métodos. Alternativamente, puede emplear una cadena delimitada por comas:
automatic_custom_instrumentation_method_list: 'MyCompany::Image#render_png, MyCompany::User.notify'Los espacios en blanco alrededor de las comas en la lista son opcionales. Al configurar el agente con una lista de métodos a través de la variable de entorno NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST , emplee este formato de cadena delimitada por comas:
$export NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST='MyCompany::Image#render_png, MyCompany::User.notify'Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, las métricas para las llamadas de transmisión de Action Cable no incluirán el valor broadcasting para una transmisión dada. Por defecto es false. El valor predeterminado puede cambiar en una futura versión mayor.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una lista de nombres de clases o módulos de middleware que el agente debe ignorar. Ejemplo: ["Rack::Cors", "ActionDispatch::Reloader"]
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, cuando el agente esté en una aplicación que utilice Ruby on Rails, se iniciará después de ejecutar config/initializers .
Advertencia
Esta opción solo puede establecerse mediante una variable de entorno.
Rastreador de transacciones
La traza de la transacción característica recopila información detallada de una selección de transacciones, incluido un resumen de la secuencia de llamadas, un desglose del tiempo invertido y una lista de consultas SQL y sus planes de consulta (en MySQL y postgresql). La característica disponible depende de su nivel de suscripción a New Relic.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita la recopilación de la traza de la transacción.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita la recopilación de planos explicativos en la traza de la transacción. Esta configuración también se aplicará para explicar los planes en trazas SQL lentas si slow_sql.explain_enabled no se configura por separado.
Tipo | Flotante |
|---|---|
Por defecto |
|
Variable ambiental |
|
Umbral (en segundos) por encima del cual el agente recopilará planes explicativos. Relevante solo cuando explain_enabled es verdadero.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Número máximo de nodos de traza de la transacción a registrar en una única traza de la transacción.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente registra los argumentos del comando Redis en la traza de la transacción.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Nivel de ofuscación para consulta SQL reportado en los nodos de traza de la transacción. De manera predeterminada, esto se establece en obfuscated, lo que elimina los literales numéricos y de cadena.
- Si no desea que el agente capture información de la consulta, configúrelo en
none. - Si desea que el agente capture toda la información de la consulta en su formato original, configúrelo en
raw. - Cuando habilita el modo de alta seguridad, se establece automáticamente en
obfuscated.
Tipo | Flotante |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifique un umbral en segundos. El agente incluye el rastreo del stack en los nodos de traza de la transacción cuando la duración del rastreo del stack excede este umbral.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, una vez que se alcanza transaction_tracer.limit_segments, el agente también dejará de registrar el tiempo exclusivo para cualquier segmento creado posteriormente en esa transacción. Esto puede reducir el uso de memoria para transacciones de muy larga duración con muchos segmentos, a costa de datos de tiempo menos precisos para los segmentos en la transacción si se alcanza el límite de segmentos.
Tipo | Flotante |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifique un umbral en segundos. Las transacciones con una duración superior a este umbral son elegibles para la traza de la transacción. Especifique un valor flotante o la cadena apdex_f.
Recolector de errores
El agente recopila e informa todas las excepciones no detectadas de forma predeterminada. Estas opciones de configuración le permiten personalizar la recopilación de errores.
Para obtener información sobre errores ignorados y esperados, consulte esta página sobre Análisis de errores en APM. Para establecer el error esperado a través del NewRelic::Agent.notice_error Ruby método, consulte la Ruby API del agente.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente recopila TransactionError evento.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente captura los errores de traza y el recuento de errores métrico.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una lista de clases de errores que el agente debe tratar como se esperaba.
Advertencia
Esta opción no se puede configurar mediante una variable de entorno.
Tipo | Hash |
|---|---|
Por defecto |
|
Variable ambiental |
|
Un mapa de clases de error a una lista de mensajes. Cuando ocurre un error de una de las clases especificadas aquí, si su mensaje de error contiene una de las cadenas correspondientes aquí, ese error se tratará como se esperaba.
Advertencia
Esta opción no se puede configurar mediante una variable de entorno.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una lista separada por comas de códigos de estado HTTP y/o rangos de códigos de estado (por ejemplo, 404, 429, 500-599). Los errores asociados con un código de estado coincidente, si el error tiene uno, se tratarán como se espera.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una lista de clases de error que el agente debe ignorar.
Advertencia
Esta opción no se puede configurar mediante una variable de entorno.
Tipo | Hash |
|---|---|
Por defecto |
|
Variable ambiental |
|
Un mapa de clases de error a una lista de mensajes. Cuando ocurre un error de una de las clases especificadas aquí, si su mensaje de error contiene una de las cadenas correspondientes aquí, ese error será ignorado.
Advertencia
Esta opción no se puede configurar mediante una variable de entorno.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una lista separada por comas de códigos de estado HTTP y/o rangos de códigos de estado (por ejemplo, 404, 429, 500-599). Los errores asociados con un código de estado coincidente, si el error tiene uno, se ignorarán.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define el número máximo de marcos en un rastreo inverso de errores. Los rastreos inversos que superan esta cantidad se truncan en el medio de forma predeterminada, preservando el principio y el final del rastreo del stack. Consulte error_collector.backtrace_truncate_location para personalizar la ubicación de truncamiento.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifica dónde truncar el rastreo inverso cuando el número de marcos supera error_collector.max_backtrace_frames. Las opciones son top (eliminar marcos del inicio), middle (eliminar marcos del medio, conservando el inicio y el final) o end (eliminar marcos del final).
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define el número máximo de TransactionError eventos informados por ciclo de recolección.
Monitoreo del navegador
La característicade tiempo de carga de la página (a veces denominada monitoreo de usuarios reales o RUM) le brinda información valiosa sobre el rendimiento que los usuarios reales están experimentando con su sitio web. Esto se logra midiendo el tiempo que le toma al navegador de su usuario descargar y representar sus páginas web inyectando una pequeña cantidad de código JavaScript en el encabezado y pie de página de cada página.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita la inyección automática del encabezado de JavaScript para el tiempo de carga de la página (a veces denominado monitoreo de usuarios reales o RUM).
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita la auto-inyección de la Política de seguridad de contenido Nonce en los scripts de monitoreo de browser. Por ahora la autoinyección solo funciona con Rails 5.2+.
Evento de transacción
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita el muestreo de eventos de transacción.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define el número máximo de eventos de transacción reportados de una sola cosecha.
Registro de aplicaciones
El agente Ruby admite el logs en el contexto de APM. Para obtener algunos consejos sobre cómo configurar el registro para el agente Ruby, consulte Configurar el logs en el contexto de Ruby.
Las opciones de configuración disponibles relacionadas con el registro incluyen:
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita la decoración log y la recopilación de logs de evento y métrica.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente captura los log emitidos por su aplicación.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Establece el nivel mínimo que debe tener un log de evento para ser reenviado a New Relic. Los logs en el nivel configurado y cualquier gravedad mayor se reenvían, por ejemplo, debug reenvía todos los logs de eventos, mientras que error reenvía solo los eventos error, fatal y unknown. Valores válidos, de menor a mayor gravedad: debug, info, warn, error, fatal, unknown (distingue entre mayúsculas y minúsculas; también se aceptan formas en mayúsculas).
Este orden se basa en los valores enteros de las constantes Logger::Severity de Ruby (consulte https://github.com/ruby/logger/blob/113b82a06b3076b93a71cd467e1605b23afb3088/lib/logger/severity.rb).
Tipo | Hash |
|---|---|
Por defecto |
|
Variable ambiental |
|
Un hash con pares principales de valor para agregar como atributo personalizado a todos los logs de eventos reenviados a New Relic. Si se envía utilizando una variable de entorno, el valor debe tener el formato siguiente: "clave1=valor1,clave2=valor2"
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente adjunta etiquetas a los registros de log.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz que no distingue entre mayúsculas y minúsculas o una cadena delimitada por comas que contiene las etiquetas que se excluirán de los registros de log.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define el número máximo de log que se almacenarán en el buffer en la memoria a la vez.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente decora el registro con metadatos para vincularlo a entidad, hosts, traza y spans.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente captura métricas relacionadas con el registro de su aplicación.
Monitoreo de IA
Esta sección incluye la configuración del agente Ruby para configurar el monitoreo de IA.
Importante
Debe habilitar rastreo distribuido para capturar datos de traza y retroalimentación. Está activado de forma predeterminada en Ruby agente 8.0.0 y superiores.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si false, toda la instrumentación LLM (OpenAI solo por ahora) se deshabilitará y no se enviará ninguna métrica, evento o span. El monitoreo de IA se desactiva automáticamente si el modo high_security está activado.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es false, la instrumentación de LLM (OpenAI solo por ahora) no capturará el atributo content en los eventos LlmChatCompletionMessage ni el atributo input en los eventos LlmEmbedding. Esta es una configuración de seguridad opcional para evitar el registro de datos confidenciales enviados a los LLM y recibidos de estos.
Atributo
Los atributos son pares de valores principales que contienen información que determina las propiedades de un evento o transacción. Estos pares de valores principales se pueden ver dentro de la traza de la transacción en APM, errores de traza en APM, evento de transacción en el tablero y vistas de página en el tablero. Puedes personalizar exactamente qué atributo se enviará a cada uno de estos destinos.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita la captura del atributo para todos los destinos.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a excluir de todos los destinos. Permite * como comodín al final.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a incluir en todos los destinos. Permite * como comodín al final.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente captura un atributo del monitoreo del navegador.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a excluir del monitoreo del navegador. Permite * como comodín al final.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a incluir en el monitoreo del navegador. Permite * como comodín al final.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente captura el atributo de la colección de errores.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo del atributo a excluir de la colección de errores. Permite * como comodín al final.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo del atributo a incluir en la colección de errores. Permite * como comodín al final.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente captura el atributo en el evento span.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a excluir del evento span. Permite * como comodín al final.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a incluir en el evento span. Permite * como comodín al final.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente captura el atributo del evento de transacción.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a excluir del evento de transacción. Permite * como comodín al final.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a incluir en evento de transacción. Permite * como comodín al final.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente captura el atributo en los segmentos de transacción.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a excluir de segmentos de transacción. Permite * como comodín al final.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a incluir en segmentos de transacción. Permite * como comodín al final.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente captura atributo de la traza de la transacción.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a excluir de la traza de la transacción. Permite * como comodín al final.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Prefijo de atributo a incluir en la traza de la transacción. Permite * como comodín al final.
Log de auditoría
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, habilita un log de auditoría que registra las comunicaciones con el recolector New Relic.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Lista de extremos permitidos para incluir en el log de auditoría.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifica una ruta al archivo de registro de auditoría (incluido el nombre del archivo).
Autoencendido
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifique una lista de constantes que deberían impedir que el agente se inicie automáticamente. Separe las constantes individuales con una coma ,. Por ejemplo, "Rails::Console,UninstrumentedBackgroundJob".
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define una lista delimitada por comas de ejecutables que el agente no debe utilizar. Por ejemplo, "rake,my_ruby_script.rb".
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define una lista delimitada por comas de tareas de Rake que el agente no debe realizar. Por ejemplo, "assets:precompile,db:migrate".
Nube
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
El ID de cuenta de AWS asociado con esta aplicación.
Un nivel de código métrico
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente reportará código fuente nivel métrico para métodos de traza. Consulte: https:\/\/docs.newrelic.com\/docs\/apm\/agents\/ruby-agent\/features\/ruby-codestream-integration\/
Atributo personalizado
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si false, el atributo personalizado no se enviará en el evento.
Evento personalizado
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente captura el evento personalizado.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifique un número máximo de eventos personalizados para almacenar en la memoria a la vez. Al configurar el agente para el monitoreo de IA, establézcalo en el valor máximo 100000. Esto garantiza que el agente capture la cantidad máxima de eventos de LLM.
Almacenamiento de datos rastreador
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es false, el agente no agregará el parámetro database_name a la transacción ni a las trazas de SQL lentas.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es false, el agente no reportará almacenamiento de datos de instancia métrica, ni agregará host o port_path_or_id parámetro a la transacción o traza SQL lenta.
Deshabilitar
Utilice esta configuración para alternar tipos de instrumentación durante el inicio del agente.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la instrumentación de Action Cable.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la instrumentación del Controlador de acciones.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita la instrumentación del buzón de acciones.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la instrumentación de Action Mailer.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la instrumentación del trabajo activo.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, los nombres de los pasos de Rails Active Job Continuations no se incluirán en los nombres de las métricas. Esto reduce la cardinalidad de la métrica, pero también reduce la visibilidad del rendimiento de cada paso individual. Solo establezca esto en true si experimenta problemas de cardinalidad de métricas debido a trabajos con muchos pasos o pasos con nombres dinámicos.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la instrumentación de Active Storage.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la instrumentación de soporte activo.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la instrumentación de Active Record.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita la instrumentación para Active Record 4+.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente no probará el uso de CPU del proceso del host.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente no medirá la profundidad de las colas de trabajos retrasados.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita el uso de GC::Profiler para medir el tiempo dedicado a la recolección de basura.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente no probará el uso de memoria del proceso del host.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente no incluirá middlewares de terceros en la instrumentación (independientemente de si están instalados a través de Rack::Builder o Rails).
Importante
Cuando la instrumentación de middleware está deshabilitada, si una aplicación utiliza middleware que podría alterar el código de respuesta, es posible que el código de estado HTTP informado en la transacción no refleje el valor modificado.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la recolección de muestra métrica. Las métricas de sampler son métricas que no se basan en eventos (como el tiempo de CPU o el uso de memoria).
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita la instrumentación de Sequel.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita la instrumentación de Sidekiq.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita el middleware del agente para Roda. Este middleware es responsable del soporte de características avanzadas, como el tiempo de carga de la página y la recopilación de errores.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita el middleware del agente para Sinatra. Este middleware es responsable de la compatibilidad con funciones avanzadas como rastreo distribuido, medición del tiempo de carga de la página y recopilación de errores.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la instrumentación de visualización.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente no tomará muestras de las mediciones de rendimiento de la máquina virtual (VM) de Ruby.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita la instrumentación de estadísticas del servidor Puma que toma muestras de Ruby/Puma/* métricas del proceso maestro de Puma. Esta instrumentación está deshabilitada de forma predeterminada. Cuando está habilitado, el agente inicia un hilo de informes en el proceso maestro de Puma para entregar estas métricas.
Rastreo distribuido
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Rastreo distribuido te permite ver el recorrido que sigue una solicitud a través de tus sistemas distribuidos. Habilitar rastreo distribuido cambia el comportamiento de algunas características de New Relic, así que consulte atentamente la guía de transición antes de habilitar esta característica.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Esta configuración controla el comportamiento del muestreo de transacciones para transacciones sin un elemento principal remoto (trazas que se originan dentro de esta instancia del agente de New Relic). Los valores disponibles son adaptive (el valor predeterminado), always_on, always_off y trace_id_ratio_based.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Esta configuración controla el comportamiento del muestreo de transacciones cuando se muestrea un padre remoto. Los valores disponibles son adaptive (el valor predeterminado), always_on, always_off y trace_id_ratio_based.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Esta configuración controla el comportamiento del muestreo de transacciones cuando un padre remoto no se muestrea. Los valores disponibles son adaptive (el valor predeterminado), always_on, always_off y trace_id_ratio_based.
Elasticsearch
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente captura el nombre del clúster Elasticsearch en la traza de la transacción.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente captura la consulta de Elasticsearch en la traza de la transacción.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente confunde la consulta de Elasticsearch en la traza de la transacción.
Heroku
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente utiliza nombres de dinamómetro Heroku como nombre de host.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Normalmente, el agente informa los nombres de los dinamómetros con un punto final y un ID de proceso (por ejemplo, worker.3). Puede eliminar estos datos finales especificando los prefijos que desea informar sin datos finales (por ejemplo, worker).
Rastreo infinito
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Configura el nombre de host para el host del observador de traza. Cuando se configura, permite la muestreo tail-based enviando todos los intervalos registrados a un observador de traza para tomar decisiones de muestreo adicionales, independientemente de cualquier decisión de muestreo habitual del agente.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Configura el puerto TCP/IP para el Host de traza observer
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true (el valor predeterminado), los datos enviados al observador de traza se agrupan en lugar de enviar cada tramo individualmente.
Tipo | Símbolo |
|---|---|
Por defecto |
|
Variable ambiental |
|
Configure el nivel de compresión para los datos enviados al observador traza. Puede ser uno de: :none, :low, :medium, :high. Establezca el nivel en :none para deshabilitar la compresión.
Instrumentación
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una lista de permitidos de nombres de eventos de notificación de ActiveSupport (principalmente eventos de almacenamiento en caché y eventos de serializador de mensajes) a los que se suscribe el agente. Se ignora cualquier nombre de evento que no esté incluido aquí. Proporcione solo nombres de eventos completos, como cache_fetch_hit.active_support. No proporcione asteriscos ni patrones de expresiones regulares, y no escape ningún carácter con barras invertidas.
Para obtener la lista completa de posibles nombres de eventos, consulte la lista de nombres de almacenamiento en caché y nombres de mensajes de la documentación de Rails.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de ActiveSupport::BroadcastLogger al inicio. Puede ser uno de: auto, prepend, chain, disabled. Utilizado en versiones de Rails >= 7.1.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de ActiveSupport::Logger al inicio. Puede ser uno de: auto, prepend, chain, disabled. Utilizado en versiones de Rails inferiores a 7.1.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Async::HTTP al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controles de instrumentación automática de conejito en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca semantic_logger al inicio. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la autoinstrumentación de la biblioteca paralela al inicio. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca AWS-sdk-firehose en el inicio. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca aws_sdk_lambda al inicio. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca AWS-sdk-kinesis en el inicio. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca ruby-kafka al inicio. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca opensearch-ruby al inicio. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca rdkafka al inicio. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca AWS-sdk-sqs en el inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca AWS-sdk-dynamodb en el inicio. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la clase Fibra en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca concurrente-ruby al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Curb en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática del trabajo retrasado al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca elasticsearch al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de ethon en el arranque. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Excon al inicio. Puede ser uno de: enabled, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Grape en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de los clientes gRPC al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una lista separada por comas de patrones de expresiones regulares que coinciden con los nombres de host de gRPC cuyo tráfico New Relic debe ignorar. La instrumentación del cliente gRPC de New Relic omite el rastreo de las llamadas realizadas a un host que coincide con cualquiera de estos patrones, y su instrumentación del servidor gRPC omite el rastreo de las requests recibidas por un servidor que se ejecuta en un host coincidente. Por ejemplo, "private.com$,exception.*" Empty by default, meaning no traffic is ignored..
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de los servidores gRPC al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de HTTPClient al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la gema http.rb al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de httpx al inicio. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática del logger de la biblioteca estándar de Ruby al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la autoinstrumentación de la biblioteca de logging al inicio. Puede ser uno de auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca LogStasher al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación de Rails.event como logs estructurados. Puede ser uno de: enabled, disabled.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de nombres de Rails.event para capturar como log de evento estructurado. Por ejemplo: [usuario.signup, payment.processed, order.created]. Deje en blanco para capturar toda notificación de Rails.event. Cada evento se registra con el nivel UNKNOWN (lo que garantiza que nunca se filtre) a menos que se anule mediante una clave :level en la carga del evento.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de dalli gem para Memcache al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la gema Memcache para Memcache al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la gema memcache-client para Memcache al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Mongo en el arranque. Puede ser uno de: enabled, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Net::HTTP al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la gema ruby-openai al inicio. Puede ser uno de: auto, prepend, chain, disabled. El valor predeterminado es disabled en modo de alta seguridad.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Puma::Rack. Cuando está habilitado, el agente se conecta al método to_app en Puma::Rack::Builder para buscar gemas para el instrumento durante el inicio de la aplicación. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Puma::Rack::URLMap al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controles de instrumentación automática de Rack. Cuando está habilitado, el agente se conecta al método to_app en Rack::Builder para buscar gemas para el instrumento durante el inicio de la aplicación. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Rack::URLMap al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controles de instrumentación automática de rastrillo en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Redis al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de resque en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Roda en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Sinatra en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Stripe al inicio. Puede ser uno de: enabled, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de ViewComponent al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la clase Thread al inicio para permitir que el agente anide correctamente los intervalos dentro de una transacción asincrónica. Esto no permite al agente trazar automáticamente todos los hilos creados (ver instrumentation.thread.tracing). Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la clase Thread al inicio para agregar automáticamente seguimiento a todos los Threads creados en la aplicación.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de la biblioteca de renderizado de plantillas Tilt al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Controla la instrumentación automática de Typhoeus en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Rastreador de mensajes
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente recopilará metadatos sobre los mensajes y los adjuntará como parámetro de segmento.
Mongo
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente captura Mongo consulta en la traza de la transacción.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente confunde a Mongo consulta en la traza de la transacción.
Búsqueda abierta
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente captura OpenSearch consulta en la traza de la transacción.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente confunde OpenSearch consulta en la traza de la transacción.
OpenTelemetry
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una opción de configuración global para deshabilitar todas las señales de OpenTelemetry enviadas a través de New Relic. Si es false, no se enviarán señales de OpenTelemetry a New Relic. Si es true, la opción de configuración habilitada específica de la señal (p. ej. opentelemetry.traces.enabled) determina si la telemetría de ese tipo de señal se reportará a New Relic.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Permite la creación de segmentos de Transaction Trace y métricas de timeslice a partir de Spans de OpenTelemetry. Esto ayudará a impulsar la experiencia de la interfaz de usuario de New Relic para los spans de OpenTelemetry.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una lista de rastreadores de OpenTelemetry delimitada por comas, representada como una cadena (p. ej. "AppTracer1,OpenTelemetry::Instrumentation::Bunny::Instrumentation"), que tendrán sus trazas enviadas a New Relic.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una lista de rastreadores de OpenTelemetry delimitada por comas, representada como una cadena (p. ej. "AppTracer1,OpenTelemetry::Instrumentation::Bunny::Instrumentation"), cuyas trazas no se enviarán a New Relic.
Anfitrión del proceso
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifique un nombre de host personalizado para mostrar en la UI de New Relic.
Puma
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Número de segundos entre muestras de estadísticas del servidor Puma tomadas en el proceso maestro de Puma.
Rastrillo
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifique una matriz de tareas de Rake para instrumentar automáticamente. Esta opción de configuración convierte la matriz en una lista de expresiones regulares. No se instrumentará ninguna tarea de rake a menos que se agregue a esta lista. Si desea permitir todas las tareas de forma predeterminada, use rake.tasks: [.+]. Para obtener más información, visite la documentación de instrumentación de Rake de New Relic.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define el número de segundos que se debe esperar para que se complete una conexión antes de ejecutar una tarea de Rake.
Normas
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Defina las transacciones que desea que el agente ignore especificando una lista de patrones que coincidan con los URI a excluir. Para obtener más detalles, consulte la documentación sobre cómo ignorar transacciones específicas.
Seguridad
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, se carga el agente de seguridad (se realiza un “require” de Ruby).
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, se inicia el agente de seguridad (el agente se ejecuta en su bucle de eventos).
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define el modo en el que operará el agente de seguridad. Actualmente, solo se admite IAST.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define la URL del extremo para publicar datos relacionados con la seguridad.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
El puerto en el que está escuchando la aplicación. Esta configuración es obligatoria para los servidores de Pasajeros. El agente detecta otros servidores de forma predeterminada.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define las rutas de API que el agente de seguridad debe ignorar en los escaneos IAST. Acepta una matriz de patrones de expresiones regulares que coinciden con la URI a ignorar. El patrón regex debería encontrar una coincidencia completa para la URL sin el extremo. Por ejemplo, [".*account.*"], [".*/\api\/v1\/.*?\/login"]
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de encabezados de solicitud HTTP que el agente de seguridad debe ignorar en los escaneos IAST. La matriz debe especificar una lista de patrones que coincidan con los encabezados que se deben ignorar.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de consulta de solicitudes HTTP que el agente de seguridad debe ignorar en los escaneos IAST . La matriz debe especificar una lista de patrones que coincidan con el parámetro de consulta de la solicitud HTTP que se desea ignorar.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de claves del cuerpo de solicitud HTTP que el agente de seguridad debe ignorar en los escaneos IAST.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita la detección de configuraciones inseguras de baja gravedad. Por ejemplo, hash, criptografía, cookies, generadores aleatorios y límites de confianza.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita las detecciones IAST relacionadas con la operación de archivos (acceso a archivos e integridad de la aplicación dañada)
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la detección de inyección SQL en los escaneos IAST.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita la detección de inyección NoSQL en los escaneos IAST.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la detección de inyección LDAP en los escaneos IAST.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita la detección de inyección de JavaScript en los escaneos de IAST.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, se deshabilita la detección de inyección de comandos del sistema en los análisis IAST.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita la detección de inyección de XPath en los escaneos de IAST.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, deshabilita la detección de falsificación de solicitudes del lado del servidor (SSRF) en los escaneos de IAST.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, deshabilita la detección de secuencias de comandos entre sitios reflejadas (RXSS) en los análisis IAST .
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifica el tiempo de retraso (en minutos) antes de que comience el escaneo IAST después de que se inicia la aplicación.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifica la duración (en minutos) durante la cual se realiza el escaneo de IAST.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifica una expresión cron que establece cuándo debe ejecutar el escaneo IAST.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, permite que IAST recopile datos de seguimiento de forma continua en segundo plano. El agente de seguridad emplea los datos recopilados para realizar un escaneo IAST a la hora programada.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Establece el número máximo de requests HTTP permitidas por minuto para el escaneo de IAST. Debe ser un número entero entre 12 y 3600 (por defecto).
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
El número de instancias de aplicación para que una entidad específica realice el análisis IAST .
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita el envío de cuerpos de respuestas HTTP. Al deshabilitar esta opción también se deshabilita la detección de vulnerabilidades de secuencias de comandos entre sitios reflejadas (RXSS).
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Un identificador de prueba único al ejecutar IAST en un entorno de CI/CD para diferenciar entre diferentes ejecuciones de prueba. Por ejemplo, un número de compilación.
Modo Serverless
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente operará en un modo optimizado, adecuado para su uso con funciones sin servidor de corta duración. NOTA:AWS Actualmente, solo se admiten las funciones Lambda y esta opción no está diseñada para usar sin la oferta de New Relic Ruby Lambda capa de .
Sidekiq
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de cadenas que servirá colectivamente como una lista de permitidos para filtrar qué argumentos de trabajos de Sidekiq se informan a New Relic. Para capturar cualquier argumento de Sidekiq, job.sidekiq.args.* también debe agregarse a la opción de configuración attributes.include separada. Cada cadena en esta matriz se convertirá en una expresión regular a través de Regexp.new para permitir coincidencias avanzadas. Para los hashes de argumentos de trabajos, si coincide una clave o un valor, se incluirá el par. Se incluirán todos los elementos de la matriz de argumentos de trabajos y los escalares de argumentos de trabajos coincidentes.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de cadenas que servirá colectivamente como una lista de denegación para filtrar qué argumentos de trabajo de Sidekiq se reportan a New Relic. Para capturar cualquier argumento de Sidekiq, job.sidekiq.args.* también debe agregarse a la opción de configuración attributes.include separada. Cada cadena en esta matriz se convertirá en una expresión regular a través de Regexp.new para permitir coincidencias avanzadas. Para los hashes de argumentos de trabajo, si una clave o un valor coincide, el par se excluirá. Todos los elementos de la matriz de argumentos de trabajo y los escalares de argumentos de trabajo coincidentes se excluirán.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente ignorará las excepciones generadas durante los intentos de reintento de Sidekiq y solo informará del error si el trabajo falla permanentemente.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente inicia una nueva transacción cuando se ejecuta un trabajo de Sidekiq durante una transacción web. Esto evita que el tiempo de ejecución del trabajo de Sidekiq se incluya en las métricas de transacciones web.
SQL lento
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente recopila una consulta SQL lenta.
Tipo | Flotante |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifique un umbral en segundos. El agente recopila consultas SQL lentas y explica los planes que superan este umbral.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente recopila planes explicativos en una consulta SQL lenta. Si se omite esta configuración, la configuración transaction_tracer.explain_enabled también se aplicará como configuración predeterminada para los planes de explicación en SQL lento.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define un nivel de ofuscación para consultas SQL lentas. Las opciones válidas son obfuscated, raw o none.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente genera un sql_id más largo para trazas de SQL lentas. sql_id se usa para la agregación de consultas similares.
Evento de alcance
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita el muestreo de eventos de intervalo.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Establece el número máximo de eventos de intervalo que se almacenarán en el búfer cuando se transmite al observador de traza.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define el número máximo de eventos de span reportados desde una sola recolección. Cualquier número entero entre 1 y 10000 es válido. Al configurar el agente para el monitoreo de IA, establézcalo en el valor máximo 10000. Esto garantiza que el agente capture la cantidad máxima de rastreo distribuido.
Eliminar mensajes de excepción
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente elimina los mensajes de todas las excepciones, excepto las de la lista de clases permitidas. Habilitado automáticamente en el modo de alta seguridad.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifique una lista de excepciones que no desea que el agente elimine cuando strip_exception_messages sea true. Separe las excepciones con una coma. Por ejemplo, "ImportantException,PreserveMessageException".
Raya
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de cadenas para especificar qué claves dentro del hash user_data de un evento de Stripe deben informar a New Relic. Cada cadena de esta matriz se convertirá en una expresión regular a través de Regexp.new para permitir una coincidencia avanzada. Si se establece el valor en ["."] se informarán todos user_data.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de cadenas para especificar qué claves y/o valores dentro del hash user_data de un evento de Stripe no deben informar a New Relic. Cada cadena de esta matriz se convertirá en una expresión regular a través de Regexp.new para permitir una coincidencia avanzada. Para cada par hash, si la clave o el valor coinciden, el par no se informa. De forma predeterminada, no se informa user_data . Emplee esta opción sólo si también se emplea la opción stripe.user_data.include .
Hilo generador de perfiles
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, habilita el uso del generador de perfiles de subprocesos.
Utilización
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente detecta automáticamente que se está ejecutando en un entorno de AWS.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente detecta automáticamente que se está ejecutando en un entorno de Azure.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente detecta automáticamente que se está ejecutando en Docker.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente detecta automáticamente que se está ejecutando en un entorno de Google Cloud Platform.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente informa el ID de la instancia de GCP como el nombre de host cuando se ejecuta en Google Cloud Run.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente antepone el valor K_REVISION al ID de la instancia de GCP para formar el nombre de host ({K_REVISION}-{instance id}) en Google Cloud Run. No tiene efecto a menos que utilization.gcp_cloud_run.use_instance_as_host también sea true.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente detecta automáticamente que se está ejecutando en Kubernetes.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente detecta automáticamente que se está ejecutando en un entorno de Pivotal Cloud Foundry.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, el agente realizará la detección del entorno en paralelo para acelerar el tiempo de inicio del agente.