Configure los ajustes principales del agente de Ruby, incluidos el nombre de la aplicación, la clave de licencia, el proxy, el logging y el comportamiento general del agente.
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: fatal, error, warn, info o debug.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de nombres de eventos personalizados de ActiveSupport a los que suscribirse e instrumentar. Por ejemplo: [one.custom.event, another.event, a.third.event]
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente usará el nombre de la tabla del modelo de ActiveRecord en lugar del nombre de la clase al nombrar las métricas, los spans y los segmentos de la traza de la transacción de ActiveRecord. Esto puede reducir la cardinalidad cuando varios modelos comparten una tabla de base de datos. Por defecto es false.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Respalda la búsqueda de conexiones ActiveRecord más rápida introducida en Rails 6, lo que mejora el rendimiento del agente cuando se instrumenta ActiveRecord. Tenga en cuenta que esta configuración puede no ser compatible con otras gemas que parchean ActiveRecord.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Anulación manual de la ruta a su paquete de CA local. Este paquete de CA valida el certificado SSL presentado por el servicio de recopilación de datos de New Relic.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente captura las claves de memcache en las trazas de la transacción.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Cuando true, el agente captura el parámetro de solicitud HTTP y los adjunta a la traza de la transacción, los errores de traza y TransactionError evento.
Advertencia
Al emplear la configuración capture_params , el agente Ruby no intentará filtrar información secreta. Recommendation: Para filtrar la información secreta del parámetro de solicitud, emplee la configuraciónattributes.include en su lugar. Para obtener más información, consulte los ejemplos de atributosRuby .
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el agente borrará Tracer::State en Agent.drop_buffered_data.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Ruta a newrelic.yml. Si no está definido, el agente comprueba los siguientes directorios (en orden): config/newrelic.yml -> newrelic.yml -> $HOME/.newrelic/newrelic.yml -> $HOME/newrelic.yml
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, suprime el encabezado de rastreo distribuido newrelic en las requests salientes.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, fuerza al agente a instalar su manejador de salida (que envía todos los datos en caché al recolector antes de apagarse), incluso en los casos en que el agente normalmente lo omitiría, como cuando detecta que Sinatra se ejecuta como un servicio integrado dentro de otro framework. Sinatra ejecuta toda la aplicación dentro de su propio bloque at_exit, por lo que el agente omite su propio manejador at_exit de forma predeterminada para evitar conflictos. Esta configuración anula eso. Nota: send_data_on_exit también debe ser true para que esta configuración surta efecto.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, habilita el modo de alta seguridad. Asegúrese de comprender las implicaciones del modo de alta seguridad antes de habilitar esta configuración.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Un diccionario de nombres y valores de etiquetas que se aplicarán a los datos enviados desde este agente. También se puede expresar como una cadena ; delimitada por punto y coma de pares : separados por dos puntos. Por ejemplo, Server:One;Data Center:Primary.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define un nombre para el archivo de registro.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define una ruta al archivo de log del agente, excluyendo el nombre del archivo. Si desea enviar los logs del agente a la salida estándar, establezca esto en STDOUT.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Especifica un señalizador para transmitir datos al recolector New Relic. Actualmente json es el único valor válido para esta configuración.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Cuando true, el agente transmite datos sobre su aplicación al recolector de New Relic.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, utiliza Module#prepend en lugar de alias_method para la instrumentación de ActiveRecord.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define un host para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define una contraseña para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define un puerto para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo | Cadena |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define un usuario para comunicarse con el recolector New Relic a través de un servidor proxy.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita el controlador de salida que envía datos al recolector New Relic antes de apagarse.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Cuando se establece en true, fuerza una conexión sincrónica con el recolector New Relic durante el inicio de la aplicación. Para procesos de muy corta duración, esto ayuda a garantizar que el agente de New Relic tenga tiempo para informar.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, el almacenamiento de estado del rastreador es local para el subproceso; de lo contrario, es local para la fibra.
Tipo | Entero |
|---|---|
Por defecto |
|
Variable ambiental |
|
Define el número máximo de segundos que el agente debe dedicar a intentar conectarse al recolector.
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, habilita la captura de todos los encabezados de solicitud HTTP para todos los destinos.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una matriz de cadenas CLASS#METHOD (para métodos de instancia) y/o CLASS.METHOD (para métodos de clase) que representan métodos de Ruby a los que el agente puede agregar automáticamente instrumentación personalizada. Esto no requiere ninguna modificación del código fuente que define los métodos.
Emplee nombres de clase completamente calificados (empleando el delimitador :: ) que incluyan cualquier espacio de nombres de módulo o clase.
Aquí hay un código fuente Ruby que define un método de instancia render_png para una clase Image y un método de clase notify para una clase User , ambos dentro de un namespace módulo MyCompany :
module MyCompany class Image def render_png # code to render a PNG end end
class User def self.notify # code to notify users end end endDado ese código fuente, el archivo de configuración newrelic.yml podría aplicar instrumentación para ambos métodos de la siguiente manera:
automatic_custom_instrumentation_method_list: - MyCompany::Image#render_png - MyCompany::User.notifyEse ejemplo de configuración emplea la sintaxis de matriz YAML para especificar ambos métodos. Alternativamente, puede emplear una cadena delimitada por comas:
automatic_custom_instrumentation_method_list: 'MyCompany::Image#render_png, MyCompany::User.notify'Los espacios en blanco alrededor de las comas en la lista son opcionales. Al configurar el agente con una lista de métodos a través de la variable de entorno NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST , emplee este formato de cadena delimitada por comas:
$export NEW_RELIC_AUTOMATIC_CUSTOM_INSTRUMENTATION_METHOD_LIST='MyCompany::Image#render_png, MyCompany::User.notify'Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si true, las métricas para las llamadas de transmisión de Action Cable no incluirán el valor broadcasting para una transmisión dada. Por defecto es false. El valor predeterminado puede cambiar en una futura versión mayor.
Tipo | Matriz |
|---|---|
Por defecto |
|
Variable ambiental |
|
Una lista de nombres de clases o módulos de middleware que el agente debe ignorar. Ejemplo: ["Rack::Cors", "ActionDispatch::Reloader"]
Tipo | Booleano |
|---|---|
Por defecto |
|
Variable ambiental |
|
Si es true, cuando el agente esté en una aplicación que utilice Ruby on Rails, se iniciará después de ejecutar config/initializers .
Advertencia
Esta opción solo puede establecerse mediante una variable de entorno.