Instale el agente New Relic Ruby

Nuestro agente Ruby auto-instrumentó su código para que pueda iniciar la aplicación de monitoreo. Puede utilizar nuestro iniciador o seguir las instrucciones de este documento para completar una instalación básica del agente Ruby.

Instalar la gema

1. La gema del agente Ruby está disponible en rubygems.org como newrelic_rpm. Para una aplicación que use Bundler, agregue esta gema al Gemfile:

   gem 'newrelic_rpm'

   Copia

2. Para utilizar Infinite Tracing, la gema Infinite Tracing también está disponible en rubygems.org como newrelic-infinite_tracing. Para aplicaciones que usan Bundler, incluya adicionalmente la gema Infinite Tracing en el Gemfile:

   gem 'newrelic-infinite_tracing'

   Copia

3. El siguiente paso varía dependiendo de si estás usando Rails, Roda o Sinatra:

   Ruby installation	Comments
   Si usa Rails, Roda o Sinatra	Rails: Rails llamará automáticamente Bundler.require y hará que se requiera newrelic_rpm durante el inicio de su aplicación. Roda, Sinatra: Si está utilizando Roda, Sinatra u otro framework, debe llamar manualmente a require 'newrelic_rpm'. Además, si utiliza Infinite Tracing, llame manualmente a require 'newrelic/infinite_tracing'. Como alternativa, llame manualmente Bundler.require, lo que también habilita Infinite Tracing.
   Si no utiliza Rails, Roda o Sinatra	Para utilizar el monitoreo automático de aplicaciones browser en una aplicación Rack que no utiliza Roda, Sinatra o Rails, debe incluir manualmente middlewares Rack adicionales proporcionados por el agente. Coloque la gema New Relic lo más abajo posible en la lista, permitiendo que el marco encima de ella se instrumente cuando la gema se inicialice.

Instalar el archivo de configuración

Después de instalar el agente, deberá instalar el archivo de configuración newrelic.yml y nombrar su aplicación:

1. Descargue una copia de newrelic.yml de nuestro repositorio de GitHub.

2. Copie el archivo newrelic.yml en el subdirectorio config de su aplicación.

3. Edite el valor license_key para incluir su

   clave de licencia

   .

4. Edite el valor app_name por un nombre significativo.

Alternativamente, puede generar un archivo newrelic.yml manualmente con el siguiente comando:

newrelic install --license_key="YOUR_LICENSE_KEY" "YOUR_APP_NAME"

También puede utilizar la opción --force con este comando si necesita sobrescribir un newrelic.yml existente.

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

Consulte Actualizar las versiones del agente Ruby.

Instalar agente fuera del entorno de producción

Normalmente instalará el agente Ruby en su entorno de producción. Si desea probar el agente Ruby en un entorno de desarrollo o localhost, verifique en el bloque environment: correspondiente del archivo newrelic.yml que el valor de configuración monitor_mode se haya establecido en true.

Por ejemplo, para implementar New Relic en su entorno de desarrollo y aún poder ver la métrica de rendimiento de su aplicación: en el bloque development: , establezca el valor de configuración monitor_mode en true.

Desinstalar la gema del agente Ruby

Para desinstalar el agente Ruby usando Bundler, elimine gem 'newrelic_rpm' de su Gemfile. Si no utiliza Bundler, elimine todas las referencias a newrelic_rpm de su archivo environment.rb .

Instalar en versiones anteriores de Rails

Si está instalando el agente Ruby en Rails 2.x y no está utilizando Bundler, siga estos procedimientos.

require "newrelic_rpm"

require "newrelic/infinite_tracing"