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 |
|
An array of ActiveSupport custom event names to subscribe to and instrument. For example: [one.custom.event, another.event, a.third.event]
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
If true, the agent will use the ActiveRecord model's table name instead of the class name when naming ActiveRecord metrics, spans, and transaction trace segments. This can reduce cardinality when multiple models share a database table. Defaults to 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 |
|
If true, the agent captures memcache keys in transaction traces.
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 |
|
Path to newrelic.yml. If undefined, the agent checks the following directories (in order): config/newrelic.yml -> newrelic.yml -> $HOME/.newrelic/newrelic.yml -> $HOME/newrelic.yml
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
If true, suppresses the newrelic distributed tracing header on outbound requests.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
If true, forces the agent to install its exit handler (which sends all cached data to the collector before shutting down), even in cases where the agent would normally skip it, such as when it detects Sinatra running as an embedded service within another framework. Sinatra runs the entire application inside its own at_exit block, so the agent skips its own at_exit handler by default to avoid conflicts. This setting overrides that. Note: send_data_on_exit must also be true for this setting to have any effect.
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 |
|
Defines a path to the agent log file, excluding the filename. If you want to send your agent logs to standard out, set this to 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 |
|
If true, tracer state storage is thread-local, otherwise, fiber-local.
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 |
|
A comma-separated list of HTTP status codes and/or status code ranges (for example, 404, 429, 500-599). Errors associated with a matching status code, if the error has one, will be treated as expected.
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 |
|
A comma-separated list of HTTP status codes and/or status code ranges (for example, 404, 429, 500-599). Errors associated with a matching status code, if the error has one, will be ignored.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Defines the maximum number of frames in an error backtrace. Backtraces over this amount are truncated in the middle by default, preserving the beginning and the end of the stack trace. See error_collector.backtrace_truncate_location to customize the truncation location.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Specifies where in the backtrace to truncate when the number of frames exceeds error_collector.max_backtrace_frames. Options are top (remove frames from the beginning), middle (remove frames from the middle, preserving the beginning and end), or end (remove frames from the end).
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 |
|
Sets the minimum level a log event must have to be forwarded to New Relic. Logs at the configured level and any higher severity are forwarded, for example, debug forwards all log events, while error forwards only error, fatal, and unknown events. Valid values, lowest to highest severity: debug, info, warn, error, fatal, unknown (case-sensitive; uppercase forms are also accepted).
This ordering is based on the integer values of Ruby's Logger::Severity constants (see 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 |
|
If false, LLM instrumentation (OpenAI only for now) will not capture the content attribute on LlmChatCompletionMessage events or the input attribute on LlmEmbedding events. This is an optional security setting to prevent recording sensitive data sent to and received from your LLMs.
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 |
|
List of allowed endpoints to include in the audit log.
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 |
|
The AWS account ID associated with this application.
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 |
|
Specify a maximum number of custom events to buffer in memory at a time. When configuring the agent for AI monitoring, set to max value 100000. This ensures the agent captures the maximum amount of LLM events.
Almacenamiento de datos rastreador
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
If false, the agent will not add database_name parameter to transaction or slow SQL traces.
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 |
|
If true, disables instrumentation for 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 |
|
If true, disables the use of GC::Profiler to measure time spent in garbage collection.
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 |
|
This setting controls the behavior of transaction sampling for transactions without a remote parent (traces that originate within this instance of the New Relic agent). Available values are adaptive (the default), always_on, always_off, and 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 |
|
An allowlist of ActiveSupport notification event names (mostly caching events and message-serializer events) that the agent subscribes to. Any event name not included here is ignored. Provide complete event names only, such as cache_fetch_hit.active_support. Do not provide asterisks or regex patterns, and do not escape any characters with backslashes.
For the complete list of possible event names, see the Rails documentation's list of caching names and messages names.
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 |
|
Controls auto-instrumentation of ethon at start up. May be one of 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 |
|
A comma-separated list of regular expression patterns matching gRPC hostnames whose traffic New Relic should ignore. New Relic's gRPC client instrumentation skips tracing calls made to a host matching any of these patterns, and its gRPC server instrumentation skips tracing requests received by a server running on a matching host. For example, "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 |
|
Controls auto-instrumentation of httpx at start up. May be one of 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 |
|
An array of Rails.event names to capture as structured log events. For example: [user.signup, payment.processed, order.created]. Leave empty to capture all Rails.event notifications. Events are logged with level UNKNOWN (ensuring they're never filtered) unless overridden via a :level key in the event payload.
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 |
|
A global configuration option for disabling all OpenTelemetry signals sent through New Relic. If false, no OpenTelemetry signals will be sent to New Relic. If true, the signal-specific enabled config option (e.g. opentelemetry.traces.enabled) determines whether telemetry of that signal type will be reported to 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 |
|
Specify a custom hostname for display in the New Relic UI.
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 |
|
Specify an Array of Rake tasks to automatically instrument. This configuration option converts the Array to a RegEx list. No rake tasks will be instrumented unless they're added to this list. If you'd like to allow all tasks by default, use rake.tasks: [.+]. For more information, visit the New Relic Rake Instrumentation docs.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Defines the number of seconds to wait for a connection to complete before running a Rake task.
Normas
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define transactions you want the agent to ignore by specifying a list of patterns matching the URIs to exclude. For more detail, see the docs on ignoring specific transactions.
Seguridad
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
If true, the security agent is loaded (a Ruby 'require' is performed).
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
If true, the security agent is started (the agent runs in its event loop).
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Defines the mode for the security agent to operate in. Currently only IAST is supported.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Defines the endpoint URL for posting security-related data.
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 |
|
If true, disables the detection of low-severity insecure settings. For example, hash, crypto, cookie, random generators, and trust boundary.
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 |
|
If true, disables NoSQL injection detection in IAST scans.
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 |
|
If true, disables JavaScript injection detection in IAST scans.
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 |
|
If true, disables XPath injection detection in IAST scans.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
If true, disables Server-Side Request Forgery (SSRF) detection in IAST scans.
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 |
|
Specifies the duration (in minutes) for which the IAST scan is performed.
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 |
|
Sets the maximum number of HTTP requests allowed per minute for the IAST scan. Must be an integer between 12 and 3600 (default).
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 |
|
A unique test identifier when running IAST in a CI/CD environment to differentiate between different test runs. For example, a build number.
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 |
|
An array of strings that will collectively serve as an allowlist for filtering which Sidekiq job arguments get reported to New Relic. To capture any Sidekiq arguments, job.sidekiq.args.* must also be added to the separate attributes.include configuration option. Each string in this array will be turned into a regular expression via Regexp.new to permit advanced matching. For job argument hashes, if either a key or value matches, the pair will be included. All matching job argument array elements and job argument scalars will be included.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
An array of strings that will collectively serve as a denylist for filtering which Sidekiq job arguments get reported to New Relic. To capture any Sidekiq arguments, job.sidekiq.args.* must also be added to the separate attributes.include configuration option. Each string in this array will be turned into a regular expression via Regexp.new to permit advanced matching. For job argument hashes, if either a key or value matches, the pair will be excluded. All matching job argument array elements and job argument scalars will be excluded.
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 |
|
If true, the agent generates a longer sql_id for slow SQL traces. sql_id is used for aggregation of similar queries.
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 |
|
Defines the maximum number of span events reported from a single harvest. Any Integer between 1 and 10000 is valid. When configuring the agent for AI monitoring, set to max value 10000. This ensures the agent captures the maximum amount of distributed traces.
Eliminar mensajes de excepción
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
If true, the agent strips messages from all exceptions except those in the allowed classes list. Enabled automatically in high security mode.
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.