Exigences de l'agent Ruby et framework pris en charge

Avant d' installer l'agent Ruby de New Relic, assurez-vous que votre système répond à ces exigences en matière de système d'exploitation compatible, de protocoles de sécurité, de versions Ruby et de framework/bibliothèque pris en charge.

Si vous n'en avez pas déjà un, commencez par créer un compte New Relic. C'est gratuit, pour toujours.

système d'exploitation

L'agent Ruby prend en charge les systèmes d'exploitation de type UNIX tels que Linux, Solaris, FreeBSD et macOS. Windows n'est pas officiellement pris en charge pour l'environnement de production mais peut fonctionner pour le développement.

Exigences de sécurité

Collecte de données : en tant que mesure de sécurité standard pour la collecte de données, votre serveur d’applications doit prendre en charge SHA-2 (256 bits) pour la communication SSL avec New Relic. SHA-1 n'est pas pris en charge.
TLS : New Relic nécessite TLS 1.2 ou supérieur pour toutes les connexions entrantes de l'agent.

Versions de Ruby

L'agent New Relic Ruby ne prend pas en charge les versions expérimentales ou non officielles de Ruby. L'agent est continuellement testé par rapport à la sortie officielle Ruby.

Implémentation de Ruby	Soutenu	Remarques
CRuby (MRI)	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 : Dernière version entièrement prise en charge par l'agent v8.16.0. Ruby 2.1.x, 2.0.x : Dernière version entièrement prise en charge par l'agent v6.15.0. Ruby 1.9.3 : Dernier agent v3.18.1. Ruby 1.8.7 : Dernier agent v3.18.1.
JRuby	9.x	JRuby 1.7.x : Dernier agent v3.18.1. Les anciennes versions ne sont pas prises en charge.

Remarque : « Dernière prise en charge complète par l'agent vX.YZ » signifie que la version de l'agent XYZ a été la dernière à garantir la prise en charge. Les agents plus récents peuvent toujours fonctionner mais ne sont pas testés activement par rapport aux anciennes versions de Ruby.

Serveurs Web

L'agent Ruby prend en charge les serveurs Web suivants. L'instrumentation se connecte généralement au Rack.

Serveur Web	Soutenu	Remarques
Puma	6.x, 5.x, 4.x, 3.x	Versions '<' 3.x : la prise en charge peut varier.
Licorne	6.x, 5.x	Versions '<' 4.x : la prise en charge peut varier.
Passager	6.x, 5.x	Versions '<' 5.x : la prise en charge peut varier.
Thin	1.x
Webrick	Livré avec les versions Ruby prises en charge	Généralement pris en charge pour le développement et les applications Rack de base.
Falcon	0.30.x et supérieur

Frameworks Web

L'agent Ruby fournit une instrumentation robuste pour ces frameworks Web.

Framework	Soutenu	Remarques
Rails	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 également largement testé. Rails 3.2.x : Dernière version entièrement prise en charge par l'agent v8.16.0. Anciennes versions (par exemple, 2.x, 3.0.x, 3.1.x) ne sont pas pris en charge par les agents récents.
Sinatra	3.x, 2.x	Sinatra 1.4.x : Dernière version entièrement prise en charge par l'agent v8.16.0. Les anciennes versions ne sont pas prises en charge.
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 : Dernière version entièrement prise en charge par l'agent v8.16.0. Les versions plus anciennes peuvent ne pas être entièrement prises en charge.
Padrino	0.15.x	Les versions plus anciennes (par exemple, 0.14.x) étaient entièrement prises en charge par l'agent v8.16.0.
Roda	3.x

Magasins de données et ORM

L’agent instrumente une grande variété de pilotes de base de données et de mappeurs objet-relationnels.

Magasin de données / ORM	Nom de la gemme	Soutenu	Remarques
Enregistrement actif	`activerecord`	Voir les versions de Rails	L'utilisation autonome est également prise en charge. Adaptateur Redshift reconnu.
Suite	`sequel`	5.17.0 et supérieur	Suite 3.37.x, 4.0.x : Dernière version entièrement prise en charge par l'agent v8.16.0.
MongoDB	`mongo`	2.4.0 et supérieur	Mongo 1.8.x - 2.3.x : Dernière version entièrement prise en charge par l'agent v8.16.0.
Redis	`redis`	5.x, 4.x, 3.x	`redis-client` (utilisé par redis-rb 5+) est également instrumenté.
Memcached (Dalli)	`dalli`	3.x, 2.7.x
Memcached (gemme memcached)	`memcached`	1.8.x
Elasticsearch	`elasticsearch`	8.x, 7.x	`elasticsearch.capture_cluster_name` option de configuration disponible.
Recherche ouverte	`opensearch-ruby`	3.x, 2.1.x	Support expérimental, fournit une télémétrie similaire à Elasticsearch.
DynamoDB (AWS SDK)	`aws-sdk-dynamodb`	3.x

New Relic collecte les détailsinstance pour une variété de bases de données et de pilotes de bases de données. La possibilité d'afficher une instance spécifique et les types d'informations de base de données dans APM dépend de la version de votre agent New Relic.

Nous prenons en charge les adaptateurs suivants :

base de données	Nom de l'adaptateur Gem
PostgreSQL	`pg`
MySQL	`mysql2`, `trilogy`
SQLite	`sqlite3`

Cette liste n’est pas exhaustive.

Pour demander des informations au niveau de l'instance à partir de magasins de données actuellement non répertoriés pour votre agent New Relic, obtenez de l'aide sur support.newrelic.com.

Travail en arrière-plan et système de messagerie

Instrumentation pour le traitement des tâches d'arrière-plan populaires et le fichier d'attente des messages bibliothèque.

Système / bibliothèque	Nom de la gemme	Soutenu	Remarques
Sidekiq	`sidekiq`	8.x, 7.x, 6.x, 5.x	Sidekiq 4.2.x : Dernière version entièrement prise en charge par l'agent v8.16.0. `sidekiq-delay_extensions` également pris en charge.
Rescousse	`resque`	2.x, 1.27.x	Prise en charge de `FORK_PER_JOB`.
Delayed::Job	`delayed_job`	4.1.x	Enregistrement actif et backend Mongoid. Delayed_Job 2.0.x - 4.0.x : Dernière version entièrement prise en charge par l'agent v8.16.0.
Emploi actif	`activejob`	Voir les versions de Rails
Bunny (RabbitMQ)	`bunny`	2.x	Bunny 2.0.x - 2.6.x : Dernière version entièrement prise en charge par l'agent v8.16.0.
Kafka (ruby-kafka)	`ruby-kafka`	1.x
Kafka (rdkafka)	`rdkafka`	0.15.x+
Kinesis (AWS SDK)	`aws-sdk-kinesis`	3.x
Firehose (AWS SDK)	`aws-sdk-firehose`	3.x
SQS (AWS SDK)	`aws-sdk-sqs`	3.x
SolidQueue	`solid_queue`	Voir ActiveJob	Utilisé avec ActiveJob. `ThreadError: queue empty` ignoré par défaut.

Clients HTTP et réseau

L'agent instrumente diverses bibliothèques de clients HTTP pour monitoring de services externes.

Bibliothèque	Nom de la gemme	Soutenu	Remarques
Net::HTTP	(bibliothèque Ruby Standard)	Livré avec les versions Ruby prises en charge	Client HTTP principal.
Client HTTP	`httpclient`	2.8.3 et supérieur	HttpClient 2.2.0 - 2.8.0 (inférieur à la version actuelle 2.8.x) : Dernière version entièrement prise en charge par l'agent v8.16.0.
Typhée	`typhoeus`	1.4.x et supérieur	Typhoée 0.5.3 - 1.2.x : Dernière version entièrement prise en charge par l'agent v8.16.0. Soutien Hydra.
Ex-conservateur	`excon`	0.56.0 et supérieur	Excon '<' 0.55.0: Dernière version entièrement prise en charge par l'agent v8.16.0.
Éthon	`ethon`	0.12.0 et supérieur
Curb	`curb`	0.9.x et supérieur
HTTPX	`httpx`	1.0.0 et supérieur
HTTP.rb (gemme http)	`http`	5.x, 4.x, 3.x, 2.x	HttpRb 0.9.9 - 2.2.1 : Dernière version entièrement prise en charge par l'agent v8.16.0.
Faraday	`faraday`		L'instrumentation fonctionne via des adaptateurs instrumentés (par exemple, Net::HTTP, Excon).
Async::HTTP	`async-http`	0.59.0 et supérieur
gRPC	`grpc`	1.48.0 et supérieur	Pour l'instrumentation du serveur et du client gRPC.

Bibliothèque d'IA et d'apprentissage automatique

New Relic étend son support pour la bibliothèque AI/ML.

Bibliothèque	Nom de la gemme	Soutenu	Remarques
OpenAI	`ruby-openai`	3.4.0 et au-dessus	Nécessite `ai_monitoring.enabled = true`. Capture les appels vers l'incorporation (intégration) et le point de terminaison du chat. L'attribut personnalisé peut être ajouté avec le préfixe `llm.`.

Autres bibliothèques et technologies

Bibliothèque	Nom de la gemme	Soutenu	Remarques
ActionCable	`actioncable`	Voir les versions de Rails
ActiveMerchant	`activemerchant`	1.65.0 et supérieur	ActiveMerchant 1.25.0 - 1.64.x : Dernière version entièrement prise en charge par l'agent v8.16.0.
Capistrano	`capistrano`	2.15.5 et supérieur
Ruby simultané	`concurrent-ruby`	1.1.5 et au-dessus
Fibre			Instrumentation de la classe Fiber de Ruby.
GraphQL	`graphql`		Instrumentation fournie par GraphQL gem
Lambda (AWS SDK)	`aws-sdk-lambda`		Consultez AWS Lambda Monitoring pour plus d'informations.
enregistreur	`logger`		Prise en charge du transfert de logAPM à l'aide de la bibliothèque Logger de Ruby.
Logstasher	`logstasher`	1.xx et supérieur	Prise en charge du transfert de log APM.
Stripe	`stripe`	5.38.0 et supérieur
Fil			Instrumentation de la classe Thread de Ruby.
Afficher le composant		2.53.x et supérieur
Yajl-Ruby	`yajl-ruby`	1.2.1 et supérieur

Remarques sur les versions prises en charge

L'agent peut être compatible avec une gamme plus large de versions (anciennes ou plus récentes) que celles explicitement répertoriées. Cependant, les versions répertoriées reçoivent les tests les plus rigoureux.
Pour obtenir les informations les plus récentes sur les versions nouvellement prises en charge ou les dépréciations, reportez-vous toujours aux notes de sortie de l'agentRuby .
Si une bibliothèque n'est pas répertoriée, elle peut toujours être instrumentée si elle s'appuie sur une technologie sous-jacente qui est instrumentée (par exemple, un framework construit sur Rack, ou un ORM utilisant un adaptateur de base de données standard). Pour les bibliothèques critiques non répertoriées, vous pouvez explorer l'instrumentation personnalisée ou soumettre une demande de fonctionnalités.

Si vous avez des questions sur des versions ou des bibliothèques spécifiques non couvertes ici, veuillez visiter notre forum communautaire Explorers Hub.

Autres logiciels APM

Si votre application utilise d'autres logiciels monitoring des performances des applications (APM) en plus de notre agent, nous ne pouvons pas garantir que notre agent fonctionnera correctement et nous ne pouvons pas offrir de support technique. Pour plus d'informations, consultez Erreurs lors de l'utilisation d'autres logiciels monitoring .

Connectez l'agent à d'autres parties de New Relic

L'agent Ruby s'intègre à d'autres fonctionnalités New Relic pour vous offrir une visibilité de bout en bout.

Capacité	Description
Monitoring de l'IA	Vous pouvez collecter des données d'IA à l'aide de l'agent Ruby et du gem`ruby-openai` . Cette fonctionnalité a été introduite dans la version 9.8.0 de l'agent Ruby et prend en charge `ruby-openai` versions 3.4.0 et au-dessus.
Monitoring de navigateurs	L'agent Ruby injecte automatiquement l'agent JavaScript du navigateur lorsque vous activez auto-instrumentation. Après avoir activé du navigateur,injection vous pouvez afficher les données dans la page Résumé de l'APM et basculer rapidement entre l'APM et les données du navigateur pour une application particulière. Pour les options de configuration et l'instrumentation manuelle, consultez la documentation du navigateur et de l'agent Ruby.
Monitoring de l'infrastructure	Lorsque vous installez l’infrastructure et les agents APM sur le même hôte, ils se détectent automatiquement. Vous pouvez ensuite afficher une liste d'hôtes dans UI l'APM et filtrer vos hôtes par application APM dans l'UI d'infrastructure. Pour plus d’informations, consultez les données APM dans l’UI infrastructure.
Monitoring synthétique	Synthétique trace de transaction connecte requests du moniteur Synthétique à la transaction APM sous-jacente.

Cette traduction automatique est fournie pour votre commodité.