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: debug
El agente Ruby busca las siguientes variables de entorno, en este orden, para encontrar el entorno de la aplicación:
NEW_RELIC_ENV
RUBY_ENV
RAILS_ENV
APP_ENV
RACK_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 personalizados de eventos ActiveSupport para suscribirse e instrumento. Por ejemplo,
- one.custom.event
- another.event
- a.third.event
Tipo | Cadena |
---|---|
Por defecto |
|
Variable ambiental |
|
Tu New Relic . Requerido cuando se utiliza la API REST v2 de New Relic para registrar el despliegue usando el comando newrelic deployments
.
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 |
|
Habilita o deshabilita la captura de claves de Memcache de la traza 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 verifica los siguientes directorios (en orden):
config/newrelic.yml
newrelic.yml
$HOME/.newrelic/newrelic.yml
$HOME/newrelic.yml
Tipo | Booleano |
---|---|
Por defecto |
|
Variable ambiental |
|
Permite suprimir los encabezados distribuidos de newrelic rastreo en solicitudes salientes.
Tipo | Booleano |
---|---|
Por defecto |
|
Variable ambiental |
|
Se instala de forma forzada el controlador de salida que envía todos los datos almacenados en caché al recolector antes de apagarlo. Esto es cierto incluso cuando detecta escenarios en los que generalmente no debería estarlo. El caso de uso conocido para esta opción es cuando Sinatra se ejecuta como un servicio integrado dentro de otro framework. El agente detecta la aplicación Sinatra y, como resultado, omite el controlador at_exit
. Sinatra clásicamente ejecuta toda la aplicación en un bloque at_exit
y, de lo contrario, funcionaría mal si el controlador at_exit
del agente también estuviera instalado en esas circunstancias. Nota: send_data_on_exit
también debe configurar en true
junto con esta configuración.
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 registro del agente, excluyendo el nombre del archivo.
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 | Cadena |
---|---|
Por defecto |
|
Variable ambiental |
|
Aplica la configuración de la política de seguridad del agente de idioma.
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 true
, el almacenamiento del estado del rastreador es local del hilo, de lo contrario, local de 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 end
Dado 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.notify
Ese 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 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 | 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 de códigos de estado separados por comas, que posiblemente incluya rangos. Los errores asociados con estos códigos de estado, cuando corresponda, 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 de códigos de estado separados por comas, que posiblemente incluya rangos. Se ignorarán los errores asociados con estos códigos de estado, cuando corresponda.
Tipo | Entero |
---|---|
Por defecto |
|
Variable ambiental |
|
Define el número máximo de cuadros en un seguimiento de errores. Los backtraces que superen esta cantidad se truncan a la mitad, preservando el inicio y el final del rastreo de la stack.
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 registro de eventos para reenviarse a New Relic.
Esto se basa en los valores enteros de las constantes Logger::Severity
de Ruby.
La intención es reenviar el log con el nivel dado a la configuración, así como cualquier log con un nivel de severidad mayor.
Por ejemplo, establecer este valor en "depurar" reenviará todo el registro de eventos a New Relic. Establecer este valor en "error" solo reenviará el registro de eventos con los niveles "error", "fatal" y "desconocido".
Valores válidos (ordenados de menor a mayor):
- "depurar"
- "información"
- "advertir"
- "error"
- "fatal"
- "desconocido"
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
, LLM instrumentación (OpenAI solo por ahora) no capturará contenido de entrada y salida en un evento LLM específico.
Los atributos excluidos incluyen:
content
del evento LlmChatCompletionMessageinput
del evento LlmEmbeddingEsta es una configuración de seguridad opcional para evitar que se registren datos confidenciales enviados y recibidos desde sus LLM.
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 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 la cuenta de AWS para la cuenta de AWS asociada 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\/
Rastreador multiaplicación
Tipo | Booleano |
---|---|
Por defecto |
|
Variable ambiental |
|
DEPRECATED Consulte: distributed_tracing.enabled.
Si es true
, habilita el seguimiento de múltiples aplicaciones cuando distributed_tracing.enabled
está establecido en false
.
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 el buffer en la memoria a la vez.
- Al configurar el agente para el monitoreo de IA, configúrelo en el valor máximo
100000
. Esto garantiza que el agente capture la máxima cantidad de eventos 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 o ralentizará la traza SQL.
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
, 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 true
, desactiva 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 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 es true
, deshabilita el middleware del agente para Sinatra. Este middleware es responsable del soporte de características avanzadas como el seguimiento de múltiples aplicaciones, el tiempo de carga de la página y la recopilación de errores.
Importante
El rastreo de multiaplicación está en desuso en favor del rastreo distribuido. rastreo distribuido está activado de forma predeterminada para las versiones 8.0.0 y superiores del agente Ruby. No se requieren middlewares para admitir el rastreo distribuido.
Para continuar usando el seguimiento de múltiples aplicaciones, actualice las siguientes opciones en su archivo de configuración newrelic.yml
:
cross_application_tracer: enabled: true distributed_tracing: enabled: false
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.
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 de la ejemplificación de transacciones cuando se muestrea un padre remoto y el indicador traza se establece en traceparent. Los valores disponibles son default
, always_on
y always_off
.
Tipo | Cadena |
---|---|
Por defecto |
|
Variable ambiental |
|
Esta configuración controla el comportamiento de la ejemplificación de transacciones cuando no se muestrea un padre remoto y el indicador traza no está configurado en traceparent. Los valores disponibles son default
, always_on
y always_off
.
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 | 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 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 |
|
Especifica una lista de patrones de nombre de host separados por comas que coincidirán con el nombre de host de gRPC para el cual New Relic ignorará el tráfico. La instrumentación del cliente gRPC de New Relic ignorará el tráfico transmitido a un host que coincida con cualquiera de estos patrones, y la instrumentación del servidor gRPC de New Relic ignorará el tráfico de un servidor que se ejecuta en un host cuyo nombre de host coincida con cualquiera de estos patrones. De forma predeterminada, no se ignora ningún tráfico cuando la instrumentación gRPC está habilitada. Por ejemplo, "private.com$,exception.*"
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 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 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.
Anfitrión del proceso
Tipo | Cadena |
---|---|
Por defecto |
|
Variable ambiental |
|
Especifique un nombre de host personalizado para mostrar en la UI de New Relic.
Rastrillo
Tipo | Matriz |
---|---|
Por defecto |
|
Variable ambiental |
|
Especifique una matriz de tareas de Rake para instrumento automáticamente. Esta opción de configuración convierte la matriz en una lista RegEx. Si desea permitir todas las tareas de forma predeterminada, utilice rake.tasks: [.+]
. No se instrumentarán tareas de rake a menos que se agreguen a esta lista. Para obtener más información, visite los documentos de instrumentación de New Relic Rake.
Tipo | Entero |
---|---|
Por defecto |
|
Variable ambiental |
|
Tiempo de espera para esperar a que se complete la conexión antes de una tarea de rake
Normas
Tipo | Matriz |
---|---|
Por defecto |
|
Variable ambiental |
|
Defina la transacción que desea que el agente ignore, especificando una lista de patrones que coincidan con el URI que desea ignorar. Para obtener más detalles, consulte los documentos sobre cómo ignorar transacciones específicas.
Seguridad
Tipo | Booleano |
---|---|
Por defecto |
|
Variable ambiental |
|
Si true
, se carga el agente de seguridad (se realiza un 'require' de Ruby)
Tipo | Booleano |
---|---|
Por defecto |
|
Variable ambiental |
|
Si 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 de 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
, se deshabilita la detección de configuraciones inseguras de baja gravedad. Por ejemplo, hash, criptografía, cookie, generadores aleatorios, límite 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 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 true
, deshabilita la detección de inyección de Javascript en los escaneos 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 true
, deshabilita la detección de inyección XPATH en los escaneos IAST.
Tipo | Booleano |
---|---|
Por defecto |
|
Variable ambiental |
|
Si true
, deshabilita la detección de falsificación de solicitud del lado del servidor (SSRF) en los escaneos 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 |
|
Indica la duración (en minutos) durante la cual se realizará la exploración 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 la cantidad máxima de requests HTTP permitidas para el escaneo IAST por minuto. Cualquier número entero entre 12 y 3600 es válido. El valor predeterminado es 3600.
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 cuando se ejecuta IAST en un entorno CI/CD para diferenciar entre diferentes ejecuciones de pruebas. 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án colectivamente como una lista de permitidos para filtrar qué argumentos de trabajo de Sidekiq se informan a New Relic. Para capturar cualquier argumento de Sidekiq, 'job.sidekiq.args.*' debe agregarse a la opción de configuración :'attributes.include'
separada. Cada cadena de esta matriz se convertirá en una expresión regular mediante Regexp.new
para permitir una coincidencia avanzada. Para los hash de argumentos de trabajo, si una clave o un valor coinciden, se incluirá el par. Se incluirán todos los elementos de la matriz de argumentos del trabajo y los escalares de argumentos del trabajo que coincidan.
Tipo | Matriz |
---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de cadenas que servirán colectivamente como una lista de denegados para filtrar qué argumentos de trabajo de Sidekiq se informan a New Relic. Para capturar cualquier argumento de Sidekiq, 'job.sidekiq.args.*' debe agregarse a la opción de configuración :'attributes.include'
separada. Cada cadena de esta matriz se convertirá en una expresión regular mediante Regexp.new
para permitir una coincidencia avanzada. Para los hash de argumentos de trabajo, si una clave o un valor coinciden, el par se excluirá. Se excluirán todos los elementos de la matriz de argumentos del trabajo y los escalares de argumentos del trabajo que coincidan.
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 |
|
Genere un sql_id
más largo para traza SQL lenta. sql_id
se utiliza para agregar 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 lapso informados desde una sola cosecha. Cualquier entero entre
1
y10000
es válido. - Al configurar el agente para monitoreo de IA, configúrelo 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 verdadero, el agente elimina los mensajes de todas las excepciones excepto aquellos en la lista de clases permitidas. Habilitado automáticamente en modo de alta seguridad.
Tipo | Cadena |
---|---|
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 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.