Te ofrecemos esta traducción automática para facilitar la lectura.
En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.
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.
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. Por lo general, incluye una sección Defaults en la parte superior, además de secciones a continuación para cada entorno de aplicación; por ejemplo, Development, Testing y Production.
El agente Ruby determina desde 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, por ejemplo, cuando desea utilizar info para la configuración log_level en su entorno de producción y desea configuraciones de configuración 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: info
development:
<<:*default_settings
log_level: debug
Para aplicaciones que no son Rails, el agente Ruby busca las siguientes variables de entorno, en este orden, para determinar 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á de forma predeterminada el entorno de la aplicación en development 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 determinar el entorno de la aplicación y qué sección de newrelic.yml usar. Si NEW_RELIC_ENV no está presente, el agente utiliza el entorno Rails (RAILS_ENV o RAILS.env, según la versión de Rails).
Cuando edite el archivo de configuración, asegúrese de:
Sangría sólo con dos espacios.
Sangra solo 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
true
Variable ambiental
NEW_RELIC_AGENT_ENABLED
Si true, permite que se ejecute el agente Ruby.
Tipo
Cadena
Por defecto
(Dynamic)
Variable ambiental
NEW_RELIC_APP_NAME
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
NEW_RELIC_LICENSE_KEY
Tu New Relic .
Tipo
Cadena
Por defecto
"info"
Variable ambiental
NEW_RELIC_LOG_LEVEL
Establece el nivel de detalle del mensaje de log. Los posibles niveles de registros, con mayor detalle, son: error, warn, info o debug.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_ACTIVE_SUPPORT_CUSTOM_EVENTS_NAMES
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
NEW_RELIC_API_KEY
Tu New Relic . Requerido cuando se utiliza la API REST v2 de New Relic para registrar el despliegue usando el comando newrelic deployments .
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
nil
Variable ambiental
NEW_RELIC_CA_BUNDLE_PATH
Anulación manual de la ruta a su paquete de CA local. Este paquete de CA se utilizará para validar el certificado SSL presentado por el servicio de recopilación de datos de New Relic.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_CAPTURE_MEMCACHE_KEYS
Habilita o deshabilita la captura de claves de Memcache de la traza de la transacción.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_CAPTURE_PARAMS
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
Cuando se utiliza la configuración capture_params , el agente Ruby no intentará filtrar información secreta. Recommendation: Para filtrar información secreta del parámetro de solicitud, utilice la configuraciónattributes.includeen su lugar. Para obtener más información, consulte los ejemplos de atributos de Ruby.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_CLEAR_TRANSACTION_STATE_AFTER_FORK
Si es true, el agente borrará Tracer::State en Agent.drop_buffered_data.
Tipo
Cadena
Por defecto
(Dynamic)
Variable ambiental
NEW_RELIC_CONFIG_PATH
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
false
Variable ambiental
NEW_RELIC_EXCLUDE_NEWRELIC_HEADER
Permite suprimir los encabezados distribuidos de newrelic rastreo en solicitudes salientes.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_FORCE_INSTALL_EXIT_HANDLER
Obliga a que se instale el controlador de salida que envía todos los datos almacenados en caché al recolector antes de apagarse, independientemente de detectar escenarios en los que generalmente no debería estarlo. El caso de uso conocido de esta opción es cuando Sinatra se ejecuta como un servicio integrado dentro de otro framework y 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, se comportaría mal si el controlador at_exit del agente también se instalara en esas circunstancias. Nota: send_data_on_exit también debe establecerse en true junto con esta configuración.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_HIGH_SECURITY
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
NEW_RELIC_LABELS
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
"newrelic_agent.log"
Variable ambiental
NEW_RELIC_LOG_FILE_NAME
Define un nombre para el archivo de registro.
Tipo
Cadena
Por defecto
"log/"
Variable ambiental
NEW_RELIC_LOG_FILE_PATH
Define una ruta al archivo de registro del agente, excluyendo el nombre del archivo.
Tipo
Cadena
Por defecto
"json"
Variable ambiental
NEW_RELIC_MARSHALLER
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
true
Variable ambiental
NEW_RELIC_MONITOR_MODE
Cuando true, el agente transmite datos sobre su aplicación al recolector de New Relic.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_PREPEND_ACTIVE_RECORD_INSTRUMENTATION
Si true, utiliza Module#prepend en lugar de alias_method para la instrumentación de ActiveRecord.
Tipo
Cadena
Por defecto
nil
Variable ambiental
NEW_RELIC_PROXY_HOST
Define un host para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo
Cadena
Por defecto
nil
Variable ambiental
NEW_RELIC_PROXY_PASS
Define una contraseña para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo
Entero
Por defecto
8080
Variable ambiental
NEW_RELIC_PROXY_PORT
Define un puerto para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo
Cadena
Por defecto
nil
Variable ambiental
NEW_RELIC_PROXY_USER
Define un usuario para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo
Cadena
Por defecto
""
Variable ambiental
NEW_RELIC_SECURITY_POLICIES_TOKEN
Aplica la configuración de la política de seguridad del agente de idioma.
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_SEND_DATA_ON_EXIT
Si true, habilita el controlador de salida que envía datos al recolector New Relic antes de apagarse.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_SYNC_STARTUP
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
Entero
Por defecto
120
Variable ambiental
NEW_RELIC_TIMEOUT
Define el número máximo de segundos que el agente debe dedicar a intentar conectarse al recolector.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_ALLOW_ALL_HEADERS
Si true, habilita la captura de todos los encabezados de solicitud HTTP para todos los destinos.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DEFER_RAILS_INITIALIZATION
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.
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 planes en traza SQL lenta si slow_sql.explain_enabled no se configura por separado.
Tipo
Flotante
Por defecto
0.5
Variable ambiental
NEW_RELIC_TRANSACTION_TRACER_EXPLAIN_THRESHOLD
Umbral (en segundos) por encima del cual el agente recopilará planes explicativos. Relevante solo cuando explain_enabled es verdadero.
Tipo
Entero
Por defecto
4000
Variable ambiental
NEW_RELIC_TRANSACTION_TRACER_LIMIT_SEGMENTS
Número máximo de nodos de traza de la transacción a registrar en una única traza de la transacción.
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.
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.
Si true, el agente captura los errores de traza y el recuento de errores métrico.
Tipo
Matriz
Por defecto
[]
Variable ambiental
None
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
None
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
NEW_RELIC_ERROR_COLLECTOR_EXPECTED_STATUS_CODES
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
Hash
Por defecto
{}
Variable ambiental
None
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
NEW_RELIC_ERROR_COLLECTOR_IGNORE_STATUS_CODES
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
50
Variable ambiental
NEW_RELIC_ERROR_COLLECTOR_MAX_BACKTRACE_FRAMES
Define el número máximo de fotogramas en un seguimiento de error. Los retrocesos que superan esta cantidad se truncan al principio y al final.
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.
Si se establece en false, el agente omite el contenido de entrada y salida (como cadenas de texto de símbolo y respuestas) capturado en el evento LLM.
Elimina content atributo de LlmChatCompletionMessage evento
Suelta input atributo from LlmEmbedding evento
Esta es una configuración de seguridad opcional si no desea registrar datos confidenciales enviados y recibidos de sus LLM.
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
true
Variable ambiental
NEW_RELIC_BROWSER_MONITORING_AUTO_INSTRUMENT
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).
Evento de transacción
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_TRANSACTION_EVENTS_ENABLED
Si true, habilita el muestreo de eventos de transacción.
Tipo
Entero
Por defecto
1200
Variable ambiental
NEW_RELIC_TRANSACTION_EVENTS_MAX_SAMPLES_STORED
Define el número máximo de eventos de transacción reportados de una sola cosecha.
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".
Un hash con pares principales de valor para agregar como atributo personalizado a todos los registros 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"
Si es true, el agente decora el registro con metadatos para vincularlo a entidad, hosts, traza y spans.
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_APPLICATION_LOGGING_METRICS_ENABLED
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. rastreo distribuido debe estar habilitado 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
false
Variable ambiental
NEW_RELIC_AI_MONITORING_ENABLED
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
true
Variable ambiental
NEW_RELIC_AI_MONITORING_RECORD_CONTENT_ENABLED
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 LlmChatCompletionMessage
input del evento LlmEmbedding
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
true
Variable ambiental
NEW_RELIC_ATTRIBUTES_ENABLED
Si true, habilita la captura del atributo para todos los destinos.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_ATTRIBUTES_EXCLUDE
Prefijo de atributo a excluir de todos los destinos. Permite * como comodín al final.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_ATTRIBUTES_INCLUDE
Prefijo de atributo a incluir en todos los destinos. Permite * como comodín al final.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_ENABLED
Si true, el agente captura un atributo del monitoreo del navegador.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_EXCLUDE
Prefijo de atributo a excluir del monitoreo del navegador. Permite * como comodín al final.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_INCLUDE
Prefijo de atributo a incluir en el monitoreo del navegador. Permite * como comodín al final.
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_ENABLED
Si es true, el agente captura el atributo de la colección de errores.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_EXCLUDE
Prefijo del atributo a excluir de la colección de errores. Permite * como comodín al final.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_INCLUDE
Prefijo del atributo a incluir en la colección de errores. Permite * como comodín al final.
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_ENABLED
Si true, el agente captura el atributo en el evento span.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_EXCLUDE
Prefijo de atributo a excluir del evento span. Permite * como comodín al final.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_INCLUDE
Prefijo de atributo a incluir en el evento span. Permite * como comodín al final.
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_ENABLED
Si true, el agente captura el atributo del evento de transacción.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_EXCLUDE
Prefijo de atributo a excluir del evento de transacción. Permite * como comodín al final.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_INCLUDE
Prefijo de atributo a incluir en evento de transacción. Permite * como comodín al final.
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_ENABLED
Si true, el agente captura el atributo en los segmentos de transacción.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_EXCLUDE
Prefijo de atributo a excluir de segmentos de transacción. Permite * como comodín al final.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_INCLUDE
Prefijo de atributo a incluir en segmentos de transacción. Permite * como comodín al final.
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_ENABLED
Si true, el agente captura atributo de la traza de la transacción.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_EXCLUDE
Prefijo de atributo a excluir de la traza de la transacción. Permite * como comodín al final.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_INCLUDE
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
false
Variable ambiental
NEW_RELIC_AUDIT_LOG_ENABLED
Si es true, habilita un log de auditoría que registra las comunicaciones con el recolector New Relic.
Tipo
Matriz
Por defecto
[".*"]
Variable ambiental
NEW_RELIC_AUDIT_LOG_ENDPOINTS
Lista de extremos permitidos para incluir en log de auditoría.
Tipo
Cadena
Por defecto
log/newrelic_audit.log
Variable ambiental
NEW_RELIC_AUDIT_LOG_PATH
Especifica una ruta al archivo de registro de auditoría (incluido el nombre del archivo).
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
"irb,rspec"
Variable ambiental
NEW_RELIC_AUTOSTART_DENYLISTED_EXECUTABLES
Define una lista delimitada por comas de ejecutables que el agente no debe utilizar. Por ejemplo, "rake,my_ruby_script.rb".
Configurar una de las siguientes etiquetas le ayudará a identificar qué versiones de su software están produciendo los errores.
NEW_RELIC_METADATA_SERVICE_VERSION creará tags.service.version en los datos del evento que contienen la versión de su código que se desplegará, en muchos casos una versión semántica como 1.2.3, pero no siempre.
NEW_RELIC_METADATA_RELEASE_TAG creará tags.releaseTag en los datos del evento que contienen la etiqueta de lanzamiento (como v0.1.209 o release-209).
NEW_RELIC_METADATA_COMMIT creará tags.commit on event data containing the commit sha. Se puede utilizar el sha completo o sólo los primeros siete caracteres (por ejemplo, 734713b).
Una próxima versión de Errors Inbox rastreará automáticamente qué versiones de su software están produciendo errores. Todos los datos de la versión también se mostrarán en CodeStream.
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. Garantiza que el agente capture la cantidad máxima de eventos LLM.
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
false
Variable ambiental
NEW_RELIC_DISABLE_ACTION_CABLE_INSTRUMENTATION
Si true, deshabilita la instrumentación de Action Cable.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_ACTION_CONTROLLER
Si true, deshabilita la instrumentación del Controlador de acciones.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_ACTION_MAILBOX
Si es true, deshabilita la instrumentación del buzón de acciones.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_ACTION_MAILER
Si true, deshabilita la instrumentación de Action Mailer.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_ACTIVEJOB
Si true, deshabilita la instrumentación del trabajo activo.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_ACTIVE_STORAGE
Si true, deshabilita la instrumentación de Active Storage.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_ACTIVE_SUPPORT
Si true, deshabilita la instrumentación de soporte activo.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_ACTIVE_RECORD_INSTRUMENTATION
Si true, deshabilita la instrumentación de Active Record.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_ACTIVE_RECORD_NOTIFICATIONS
Si true, desactiva la instrumentación para Active Record 4+
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_CPU_SAMPLER
Si es true, el agente no probará el uso de CPU del proceso del host.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_DELAYED_JOB_SAMPLER
Si es true, el agente no medirá la profundidad de las colas de trabajos retrasados.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_GC_PROFILER
Si true, deshabilita el uso de GC::Profiler para medir el tiempo dedicado a la recolección de basura
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_MEMORY_SAMPLER
Si es true, el agente no probará el uso de memoria del proceso del host.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_MIDDLEWARE_INSTRUMENTATION
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
false
Variable ambiental
NEW_RELIC_DISABLE_SAMPLERS
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).
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 :
# newrelic.yml
cross_application_tracer:
enabled:true
distributed_tracing:
enabled:false
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_DISABLE_VIEW_INSTRUMENTATION
Si true, deshabilita la instrumentación de visualización.
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.
Elasticsearch
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_ELASTICSEARCH_CAPTURE_QUERIES
Si true, el agente captura la consulta de Elasticsearch en la traza de la transacción.
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_ELASTICSEARCH_OBFUSCATE_QUERIES
Si true, el agente confunde la consulta de Elasticsearch en la traza de la transacción.
Heroku
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_HEROKU_USE_DYNO_NAMES
Si es true, el agente utiliza nombres de dinamómetro Heroku como nombre de host.
Tipo
Matriz
Por defecto
["scheduler", "run"]
Variable ambiental
NEW_RELIC_HEROKU_DYNO_NAME_PREFIXES_TO_SHORTEN
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
NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_HOST
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
443
Variable ambiental
NEW_RELIC_INFINITE_TRACING_TRACE_OBSERVER_PORT
Configura el puerto TCP/IP para el Host de traza observer
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_INFINITE_TRACING_BATCHING
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
:high
Variable ambiental
NEW_RELIC_INFINITE_TRACING_COMPRESSION_LEVEL
Configure el nivel de compresión de los datos enviados al observador de traza.
Puede ser uno de: :none, :low, :medium, :high.
Establezca el nivel en :none para desactivar la compresión.
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
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_ACTIVE_SUPPORT_LOGGER
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
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_ASYNC_HTTP
Controla la instrumentación automática de Async::HTTP al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_BUNNY
Controles de instrumentación automática de conejito en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_FIBER
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
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_CONCURRENT_RUBY
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
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_CURB
Controla la instrumentación automática de Curb en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_DELAYED_JOB
Controla la instrumentación automática del trabajo retrasado al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_ELASTICSEARCH
Controla la instrumentación automática de la biblioteca elasticsearch al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_ETHON
Controla la instrumentación automática de ethon en el arranque. Puede ser uno de [auto|prepend|chain|disabled]
Tipo
Cadena
Por defecto
enabled
Variable ambiental
NEW_RELIC_INSTRUMENTATION_EXCON
Controla la instrumentación automática de Excon al inicio. Puede ser uno de: enabled, disabled.
Tipo
Cadena
Por defecto
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_GRAPE
Controla la instrumentación automática de Grape en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_GRPC_CLIENT
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
NEW_RELIC_INSTRUMENTATION_GRPC_HOST_DENYLIST
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
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_GRPC_SERVER
Controla la instrumentación automática de los servidores gRPC al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_HTTPCLIENT
Controla la instrumentación automática de HTTPClient al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_HTTPRB
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
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_HTTPX
Controla la instrumentación automática de httpx al inicio. Puede ser uno de [auto|prepend|chain|disabled]
Tipo
Cadena
Por defecto
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_LOGGER
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
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_MEMCACHE
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
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_MEMCACHED
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
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_MEMCACHE_CLIENT
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
enabled
Variable ambiental
NEW_RELIC_INSTRUMENTATION_MONGO
Controla la instrumentación automática de Mongo en el arranque. Puede ser uno de: enabled, disabled.
Tipo
Cadena
Por defecto
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_NET_HTTP
Controla la instrumentación automática de Net::HTTP al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_RUBY_OPENAI
Controla la instrumentación automática de la gema ruby-openai al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_PUMA_RACK
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
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_PUMA_RACK_URLMAP
Controla la instrumentación automática de Puma::Rack::URLMap al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_RACK
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
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_RACK_URLMAP
Controla la instrumentación automática de Rack::URLMap al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_RAKE
Controles de instrumentación automática de rastrillo en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_REDIS
Controla la instrumentación automática de Redis al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_RESQUE
Controla la instrumentación automática de resque en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_RODA
Controla la instrumentación automática de Roda en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_SINATRA
Controla la instrumentación automática de Sinatra en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
"enabled"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_STRIPE
Controla la instrumentación automática de Stripe al inicio. Puede ser uno de: enabled, disabled.
Tipo
Cadena
Por defecto
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_VIEW_COMPONENT
Controla la instrumentación automática de ViewComponent al inicio. Puede ser uno de: auto, prepend, chain, disabled.
Tipo
Cadena
Por defecto
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_THREAD
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
true
Variable ambiental
NEW_RELIC_INSTRUMENTATION_THREAD_TRACING
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
"auto"
Variable ambiental
NEW_RELIC_INSTRUMENTATION_TILT
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
auto
Variable ambiental
NEW_RELIC_INSTRUMENTATION_TYPHOEUS
Controla la instrumentación automática de Typhoeus en el arranque. Puede ser uno de: auto, prepend, chain, disabled.
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
10
Variable ambiental
NEW_RELIC_RAKE_CONNECT_TIMEOUT
Tiempo de espera para esperar a que se complete la conexión antes de una tarea de rake
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
NEW_RELIC_SIDEKIQ_ARGS_EXCLUDE
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.
Especifique un umbral en segundos. El agente recopila consultas SQL lentas y explica los planes que superan este umbral.
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_SLOW_SQL_EXPLAIN_ENABLED
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
obfuscated
Variable ambiental
NEW_RELIC_SLOW_SQL_RECORD_SQL
Define un nivel de ofuscación para consultas SQL lentas. Las opciones válidas son obfuscated, raw o none.
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_SLOW_SQL_USE_LONGER_SQL_ID
Genere un sql_id más largo para traza SQL lenta. sql_id se utiliza para agregar consultas similares.
Evento de duración
Tipo
Booleano
Por defecto
true
Variable ambiental
NEW_RELIC_SPAN_EVENTS_ENABLED
Si true, habilita el muestreo de eventos de intervalo.
Tipo
Entero
Por defecto
10000
Variable ambiental
NEW_RELIC_SPAN_EVENTS_QUEUE_SIZE
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
2000
Variable ambiental
NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED
Define el número máximo de eventos de intervalo reportados de una sola cosecha. Cualquier número entero entre 1 y 10000 es válido.
Al configurar el agente para el monitoreo de IA, configúrelo en el valor máximo 10000. Garantiza que el agente capture la máxima cantidad de rastreo distribuido.
Eliminar mensajes de excepción
Tipo
Booleano
Por defecto
false
Variable ambiental
NEW_RELIC_STRIP_EXCEPTION_MESSAGES_ENABLED
Si es verdadero, el agente elimina los mensajes de todas las excepciones excepto aquellos en la lista de permitidos. Habilitado automáticamente en modo de alta seguridad.
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
NEW_RELIC_STRIPE_USER_DATA_INCLUDE
Una matriz de cadenas para especificar qué claves dentro del hash user_data de un evento Stripe deben informarse a New Relic. Cada cadena de esta matriz se convertirá en una expresión regular mediante Regexp.new para permitir una coincidencia avanzada. Establecer el valor en ["."] informará todos user_data.
Tipo
Matriz
Por defecto
[]
Variable ambiental
NEW_RELIC_STRIPE_USER_DATA_EXCLUDE
Una matriz de cadenas para especificar qué claves y/o valores dentro del hash user_data de un evento Stripe no deben informarse a New Relic. Cada cadena de esta matriz se convertirá en una expresión regular mediante Regexp.new para permitir una coincidencia avanzada. Para cada par hash, si la clave o el valor coinciden, no se informará el par. De forma predeterminada, no se informa ningún user_data , por lo que esta opción solo debe usarse si se usa la opción stripe.user_data.include .