El agente de Ruby instrumenta automáticamente el código para que pueda comenzar el monitoreo de la aplicación.
Sugerencia
¿Se ejecuta en Kubernetes? Consulte Adjuntar automáticamente el APM en Kubernetes.
Requisitos previos
Verifique estos requisitos antes de comenzar.
Requisito | Detalles |
|---|---|
Cuenta de New Relic | Necesita una cuenta de New Relic y su . Téngalo listo antes de comenzar. |
Versión de Ruby | Consulte los requisitos del agente Ruby y los frameworks compatibles para conocer las versiones de Ruby compatibles. |
Sistema operativo | Sistemas operativos tipo UNIX: Linux, Solaris, FreeBSD y macOS. Consulte los requisitos del agente Ruby y los frameworks compatibles para obtener más detalles. |
Instalar la gema
Agregue la gema del agente de Ruby al Gemfile:
gem 'newrelic_rpm'Luego, ejecute:
$bundle installImportante
Si está usando el agente en un contenedor de Docker, instale el agente dentro de cada contenedor. Consulte Instalar en el entorno flexible de GAE para ver un ejemplo de despliegue basado en Docker.
Notas específicas del framework:
- Rails: Rails llama automáticamente a
Bundler.require, por lo quenewrelic_rpmes necesario durante el inicio sin pasos adicionales. - Roda o Sinatra: debe llamar manualmente a
require 'newrelic_rpm'en la aplicación. - Otras aplicaciones Rack: para usar el monitoreo de browser automático, incluya manualmente los middlewares de Rack proporcionados por el agente.
Configurar el agente
Descargue newrelic.yml del respositorio de GitHub de New Relic y cópielo en el directorio config de la aplicación.
Los únicos dos ajustes que debe cambiar antes de pasar a producción:
- Establezca
license_keyen su . - Establezca
app_namecomo un nombre significativo para la aplicación.
Como alternativa, genere el archivo de configuración con la CLI:
$newrelic install --license_key="YOUR_LICENSE_KEY" "YOUR_APP_NAME"Verifique que los datos estén fluyendo
Reinicie su servidor web.
Envíe al menos dos requests a la aplicación.
Espere 2-3 minutos, luego abra one.newrelic.com > APM y busque la aplicación por nombre.
Sugerencia
¿No aparece la aplicación? Consulte No se muestran datos (Ruby).
Artículos relacionados
- Requisitos del agente Ruby y frameworks compatibles — Versiones de Ruby, sistemas operativos y frameworks compatibles.
- Configuración del agente Ruby — Todas las opciones de configuración disponibles.
- Actualizar el agente Ruby — Cómo actualizar a una versión más reciente.
- Agente de Ruby en Heroku — Pasos de instalación específicos para Heroku.