Estas instrucciones son para instalar el agente Ruby como complemento de Rails. Para la mayoría de los casos de uso, debería instalar la gema del agente.
Instale el complemento New Relic Rails
Importante
Recomendamos encarecidamente instalar el agente Ruby como una gema para tener un mejor control sobre las versiones y dependencias.
Para instalar el complemento Rails desde Github, use los siguientes comandos para las versiones 2 o superiores de Rails:
script/plugin install git://github.com/newrelic/newrelic-ruby-agent.gitmv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agent
Esto exportará el complemento Rails al directorio vendor/plugins
de su aplicación. Si no puede instalar el complemento Rails directamente desde la URL de git, puede clonar el repositorio en el directorio proveedor/complemento.
¿Te ha ayudado este documento con la instalación?
Actualizar el archivo de configuración
Después de instalar el agente, copie el archivo newrelic.yml
en el subdirectorio config
de su aplicación. Puede descargar un newrelic.yml
nuevo que incluye su del Account settings cuando inicie sesión en New Relic.
Importante
Como parte del proceso de instalación, cambie el nombre de la aplicación predeterminada por un nombre significativo.
Actualice el archivo newrelic.yml
Siempre que actualice el agente, confirme que su archivo de configuración del agente Ruby (config/newrelic.yml
) esté actualizado:
- Abra el archivo
newrelic.yml
predeterminado que se encuentra en la carpeta de complementos del agente Ruby (vendor/plugins/newrelic-ruby-agent/newrelic.yml
). - Busque nuevas opciones de configuración que no estén en su archivo
config/newrelic.yml
.
Sugerencia
Puede hacer referencia a secretos almacenados en las credenciales de Rails en su archivo newrelic.yml
mediante la interpolación YAML:
# When you have a key that exists in config/credentials.yml.enc like 'newrelic_license_key'... license_key: <%= Rails.application.credentials.newrelic_license_key %>
Ver el registro de sus datos de infraestructura y APM
También puede reunir los datos de su registro y de la aplicación para que la resolución de problemas sea más fácil y rápida. Con el contexto de inicio de sesión, puede ver el mensaje de registro relacionado con sus errores y la traza directamente en UI de su aplicación. También puede ver el inicio de sesión en el contexto de los datos de su infraestructura, como el clúster de Kubernetes. No es necesario cambiar a otra página de UI.
Actualizar el agente Ruby
Cuando utilice Subversion con el complemento Rails, asegúrese de eliminar el complemento del agente antiguo antes de reinstalarlo.
Sugerencia
Usa la gema si es posible.
svn rm vendor/plugins/newrelic-ruby-agent svn commit vendor/plugins -m "removing old version of newrelic"
Luego, para instalar el último complemento del agente Ruby:
script/rails plugin install git://github.com/newrelic/newrelic-ruby-agent.git vendor/plugins/newrelic-ruby-agentmv vendor/plugins/rpm vendor/plugins/newrelic-ruby-agentsvn add vendor/plugins/newrelic-ruby-agentsvn commit vendor/plugins -m "upgrading newrelic to version X.X.X"
Desinstalar el complemento Rails
Para desinstalar el complemento Rails:
svn rm vendor/plugins/newrelic-ruby-agent svn commit vendor/plugins