Problema
El agente de Ruby no se inicia o no informa datos a New Relic.
Solución
Para resolver este problema:
Verifique la versión de su agente Ruby y actualícela si es necesario.
Cuando la gema newrelic_rpm Ruby sea requerida en su entorno de aplicación, intentará determinar si iniciar el monitoreo automáticamente y comenzar a transmitir métrica a New Relic, o permanecer deshabilitado.
Producción y prueba: el agente normalmente está configurado para monitor automáticamente en estos entornos.
Prueba y desarrollo: el agente normalmente permanece deshabilitado en estos entornos.
Para controlar esta lógica, establezca la clave de configuración
monitor_modeentrueofalseen cada sección de entorno denewrelic.yml.
Para anular la lógica de inicio automático del agente, el mecanismo más sencillo es establecer una variable de entorno NEW_RELIC_AGENT_ENABLED=true ; Por ejemplo:
$NEW_RELIC_AGENT_ENABLED=true rake assets:precompileSi está ejecutando la versión 3.6.1 o superior del agente Ruby, existen algunas razones por las que el agente se negará a iniciarse:
El agente detecta que está en una sesión interactiva; por ejemplo, una sesión
rails consoleoirb.El agente detecta que está en una de las tareas de rake integradas de Rails; por ejemplo,
assets:precompileodb:migrate.Puede utilizar variables de configuración en el archivo
newrelic.ymlde su agente Ruby para personalizar el comportamiento de inicio automático de constantes, nombres de script y tareas de rake.Variable
Description
Constantes
- Constantes de Ruby que deberían impedir que el agente se inicie. Acepta una lista separada por comas.
- El valor predeterminado es
Rails::Console,Rails::DBConsoley las constantes para los comandos de Rails, comoRails::Command::ConsoleCommand. Consulteautostart.denylisted_constantspara ver la lista completa. - Establezca el valor en
""para indicarle al agente que se inicie incluso cuando una de estas constantes esté definida.
Tareas de rastrillo
- Rastrillar tareas que no desea que el agente monitor; por ejemplo,
assets:precompile. Acepta una lista separada por comas. - No deshabilitamos el agente Ruby en todas las tareas de rake, porque tareas como
resque:workgeneralmente son monitoreadas.
Ejecutables
- Una lista de nombres script , como
irb, que impedirán que el agente se inicie automáticamente. Acepta una lista separada por comas. - Establezca esto en
"rake"para evitar que el agente se inicie en tareas de rake, o"rake,my_ruby_script.rb"para evitar que se inicie en rake y un script personalizado.
Problema
El agente de Ruby se inicia en contextos en los que no quiero que se inicie.
Solución
El agente de Ruby hace algunas suposiciones sobre los contextos en los que la mayoría de los clientes desean que el agente se inicie automáticamente.
Hay tres opciones de configuración disponibles para personalizar este comportamiento:
autostart.denylisted_constantsLa mayoría de las constantes de esta lista son comandos de Rails que realizan operaciones que rara vez se benefician del monitoreo.La lista no incluye
Rails::Command::RakeCommand, que permite ejecutar comandos comorails db:*así comorails solid_queue:start, y otros comandos de Rails relacionados con tareas de Rake.autostart.denylisted_executablesEsta configuración controla los ejecutables, comorspecyirb.autostart.denylisted_rake_tasksAntes de Rails 5.1, se usabarakeen lugar dethorpara muchos comandos, comodb:migrate. Los valores predeterminados para esta configuración enumeran muchos comandos de esa época. También puede agregar sus propios comandosrakea esta lista.
La API NewRelic::Agent.manual_start se puede usar para iniciar el agente en contextos específicos. Si establece :agent_enabled en false en el archivo de configuración o define la variable de entorno NEW_RELIC_AGENT_ENABLED=false, aún puede iniciar manualmente el agente mediante esta API.
NewRelic::Agent.manual_start(agent_enabled: true)Si desea detener el agente antes de que termine el proceso, puede llamar a NewRelic::Agent.shutdown.