Antes de instalar el agente New Relic Ruby de, cerciorar de que su sistema cumpla con estos requisitos de sistema operativo compatible, protocolos de seguridad, Ruby versiones y marco/biblioteca compatibles.
Si aún no tiene una, comience creando una cuenta New Relic. Es gratis, para siempre.
Sistema operativo
El agente Ruby es compatible con sistemas operativos similares a UNIX, como Linux, Solaris, FreeBSD y macOS. Windows no recibe soporte oficial para entornos de producción, pero puede funcionar para desarrollo.
Requerimientos de seguridad
- Recopilación de datos: como medida de seguridad estándar para la recopilación de datos, su servidor de aplicaciones debe admitir SHA-2 (256 bits) para la comunicación SSL con New Relic. SHA-1 no es compatible.
- TLS: New Relic requiere TLS 1.2 o superior para todas las conexiones entrantes del agente.
Versiones Ruby
El agente Ruby de New Relic no admite versiones experimentales o no oficiales de Ruby. El agente se prueba continuamente con las versiones oficiales de Ruby.
Implementación de Ruby | Soportado | Notas |
|---|---|---|
CRuby (resonancia magnética) | 3.4.x, 3.3.x, 3.2.x, 3.1.x, 3.0.x, 2.7.x, 2.6.x, 2.5.x, 2.4.x | Ruby 2.3.x, 2.2.x: Último soporte total del agente v8.16.0. |
JRuby | 9.x | JRuby 1.7.x: Último agente v3.18.1. Las versiones anteriores no son compatibles. |
Nota: "Última versión totalmente compatible con el agente vX.YZ" significa que la versión del agente XYZ fue la última en garantizar compatibilidad. Es posible que los agentes más nuevos aún funcionen, pero no se prueban activamente contra esas versiones anteriores Ruby.
Servidores web
El agente Ruby admite los siguientes servidores sitio web. La instrumentación normalmente se conecta al Rack.
Servidor sitio web | Soportado | Notas |
|---|---|---|
Puma | 6.x, 5.x, 4.x, 3.x | Versiones '<' 3.x: El soporte puede variar. |
Unicornio | 6.x, 5.x | Versiones '<' 4.x: El soporte puede variar. |
Pasajero | 6.x, 5.x | Versiones '<' 5.x: El soporte puede variar. |
Thin | 1.x | |
Webrick | Incluido con versiones compatibles de Ruby | Generalmente compatible con desarrollo y aplicaciones básicas de Rack. |
Falcon | 0.30.x y superior |
Frameworks web
El agente Ruby proporciona instrumentación estable para estos marcos sitio web.
Framework | Soportado | Notas |
|---|---|---|
Rieles | 8.0.x, 7.1.x, 7.0.x, 6.1.x, 6.0.x, 5.2.x | Rails 5.1.x, 5.0.x, 4.2.x también ampliamente probado. |
Sinatra | 3.x, 2.x | Sinatra 1.4.x: Último soporte total del agente v8.16.0. Las versiones anteriores no son compatibles. |
Rack | 5.x, 4.x, 3.x | |
Grape | 1.7.x, 1.6.x, 1.5.x, 1.4.x, 1.3.x, 1.2.x | Grape 0.2.0: Último soporte total del agente v8.16.0. Es posible que las versiones anteriores no sean totalmente compatibles. |
Padrino | 0.15.x | Las versiones anteriores (por ejemplo, 0.14.x) fueron totalmente compatibles por última vez con el agente v8.16.0. |
Roda | 3.x |
Almacenes de datos y ORM
El agente instrumentó una amplia variedad de controladores de la base de datos y Mapeadores relacionales de objetos.
almacenamiento de datos / ORM | Nombre de la gema | Soportado | Notas |
|---|---|---|---|
Registro activo |
| Ver versiones de Rails | También se admite el uso independiente. Adaptador Redshift reconocido. |
Sequel |
| 5.17.0 y superior | Secuela 3.37.x, 4.0.x: Último soporte total del agente v8.16.0. |
MongoDB |
| 2.4.0 y superior | Mongo 1.8.x - 2.3.x: Último soporte total del agente v8.16.0. |
Redis |
| 5.x, 4.x, 3.x |
|
Memcached (Dalli) |
| 3.x, 2.7.x | |
Memcached (joya de memcached) |
| 1.8.x | |
Elasticsearch |
| 8.x, 7.x |
|
Búsqueda abierta |
| 3.x, 2.1.x | Soporte experimental, proporciona telemetría similar a Elasticsearch. |
DynamoDB (SDK de AWS) |
| 3.x |
New Relic recopila detalles de instancia para una variedad de base de datos y controlador de la base de datos. La capacidad de ver instancias específicas y los tipos de información de la base de datos en APM depende de la versión de su agente New Relic.
Admitimos los siguientes adaptadores:
Base de datos | Nombre de la gema adaptadora |
|---|---|
PostgreSQL |
|
MySQL |
|
SQLite |
|
Esta no es una lista completa.
Para solicitar información a nivel de instancia de almacenes de datos que actualmente no figuran en la lista para su agente de New Relic, obtenga soporte en support.newrelic.com.
Sistemas de mensajería y trabajos en segundo plano
instrumentación para procesamiento de trabajos en segundo plano popular y cola de mensajes biblioteca.
Sistema/biblioteca | Nombre de la gema | Soportado | Notas |
|---|---|---|---|
Sidekiq |
| 8.x, 7.x, 6.x, 5.x | Sidekiq 4.2.x: Último soporte total del agente v8.16.0. |
Resque |
| 2.x, 1.27.x | Soporte para |
Retrasado::Trabajo |
| 4.1.x | Registro activo y backend Mongoid. |
Trabajo activo |
| Ver versiones de Rails | |
Bunny (RabbitMQ) |
| 2.x | Bunny 2.0.x - 2.6.x: Último soporte total del agente v8.16.0. |
Kafka (rubí-kafka) |
| 1.x | |
Kafka (rdkafka) |
| 0.15.x+ | |
Kinesis (SDK de AWS) |
| 3.x | |
Manguera contra incendios (SDK de AWS) |
| 3.x | |
SQS (SDK de AWS) |
| 3.x | |
Cola estable |
| Ver ActiveJob | Se emplea con ActiveJob. |
Clientes HTTP y redes
El agente instrumentó varias bibliotecas de clientes HTTP para monitoreo de servicios externos.
Biblioteca | Nombre de la gema | Soportado | Notas |
|---|---|---|---|
Net::HTTP | (Biblioteca estándar de Ruby ) | Incluido con versiones compatibles de Ruby | Cliente HTTP principal. |
Cliente HTTP |
| 2.8.3 y superiores | HttpClient 2.2.0 - 2.8.0 (por debajo de la versión actual 2.8.x): Último soporte total del agente v8.16.0. |
Tifón |
| 1.4.x y superiores | Tifón 0.5.3 - 1.2.x: Último soporte total del agente v8.16.0. |
Excón |
| 0,56,0 y superior | Excon '<' 0.55.0: Último soporte total del agente v8.16.0. |
Ethon |
| 0.12.0 y superior | |
Frenar |
| 0.9.x y superior | |
HTTPX |
| 1.0.0 y superior | |
HTTP.rb (gema http) |
| 5.x, 4.x, 3.x, 2.x | HttpRb 0.9.9 - 2.2.1: Último soporte total del agente v8.16.0. |
Faraday |
| La instrumentación funciona a través de adaptadores instrumentados (p. ej., Net::HTTP, Excon). | |
Async::HTTP |
| 0,59.0 y superior | |
gRPC |
| 1.48.0 y superior | Para instrumentación de cliente y servidor gRPC. |
Biblioteca de IA y aprendizaje automático
New Relic está ampliando su soporte para biblioteca AI/ML.
Biblioteca | Nombre de la gema | Soportado | Notas |
|---|---|---|---|
OpenAI |
| 3.4.0 y por encima | Requiere |
Otras bibliotecas y tecnologías
Biblioteca | Nombre de la gema | Soportado | Notas |
|---|---|---|---|
Cable de acción |
| Ver versiones de Rails | |
Comerciante activo |
| 1.65.0 y superior | ActiveMerchant 1.25.0 - 1.64.x: Último soporte total del agente v8.16.0. |
Capistrano |
| 2.15.5 y superiores | |
Ruby concurrente |
| 1.1.5 y por encima | |
Fibra | Instrumentación de la clase Fiber de Ruby. | ||
GrafoQL |
| instrumentación proporcionada por la gema GraphQL | |
Lambda (SDK de AWS) |
| Consulte MonitoreoAWS Lambda para obtener más información. | |
Logger |
| Soporte para reenvío de logs de APM usando la biblioteca de Logger de Ruby. | |
Logstaher |
| 1.xx y superiores | Soporte para reenvío de logs de APM. |
Raya |
| 5.38.0 y superior | |
Hilo | Instrumentación de la clase Thread de Ruby. | ||
Ver componente | 2.53.x y superiores | ||
Yajl-Rubí |
| 1.2.1 y superiores |
Notas sobre las versiones compatibles
- El agente puede ser compatible con una gama más amplia de versiones (más antiguas o más nuevas) que las que se enumeran explícitamente. Sin embargo, las versiones enumeradas son objeto de las pruebas más rigurosas.
- Para obtener la información más actualizada sobre las nuevas versiones admitidas o las obsoletas, consulte siempre las notas de la versión del agente Ruby.
- Si una biblioteca no está listada, aún puede estar instrumentada si se basa en una tecnología subyacente que está instrumentada (por ejemplo, un framework creado en Rack o un ORM que usa un adaptador de base de datos estándar). Para bibliotecas críticas no incluidas en la lista, puede explorar la instrumentación personalizada o enviar una solicitud de característica.
Si tiene preguntas sobre versiones o bibliotecas específicas que no se tratan aquí, visite nuestro foro comunitario Explorers Hub.
Otro software APM
Si su aplicación utiliza otro software de monitoreo del rendimiento de aplicaciones (APM) (APM) además de nuestro agente, no podemos garantizar que nuestro agente funcionará correctamente y no podemos ofrecer soporte técnico. Para obtener más información, consulte Errores al utilizar otro software de monitoreo.
Conecte el agente a otras partes de New Relic
El agente Ruby se integra con otras capacidades de New Relic para brindarle visibilidad de un extremo a otro.
Capacidad | Descripción |
|---|---|
Puede recopilar datos de IA utilizando el agente Ruby y la gema | |
El agente Ruby inyecta automáticamente el agente JavaScript del navegador cuando habilita la instrumentación automática. Después de habilitar la inyección browser , puede ver datos en la página Resumen de APM y cambiar rápidamente entre el APM y los datos del navegador para una aplicación en particular. Para opciones de configuración e instrumentación manual, consulte la documentación del navegador y del agente Ruby. | |
Cuando instalas la infraestructura y el agente APM en el mismo host, se detectan automáticamente entre sí. Luego puede ver una lista de hosts en la UI de APM y filtrar sus hosts por aplicación de APM en la UI de infraestructura. Para obtener más información, consulte Datos de APM en la UI de la infraestructura. | |
Sintético traza de la transacción conecta las solicitudes del monitor Sintético a la transacción APM subyacente. |