Ruby agent release notesRSS

Fonctionnalité : Introduction de l'agent hybride pour la prise en charge du traçage OpenTelemetry

Les API de tracing OpenTelemetry peuvent désormais être traduites en télémétrie New Relic grâce aux nouvelles fonctionnalités d'agent hybride de l'agent Ruby New Relic. Cela permet au gem newrelic_rpm de se comporter de manière similaire à un SDK OpenTelemetry, en acceptant les appels d'API OpenTelemetry et en les transformant en transactions et segments New Relic avec des attributs et des noms familiers.

Les options de configuration suivantes concernent les fonctionnalités de l'Agent hybride :

Fonctionnalité : Ajout de l'option de configuration error_collector.backtrace_truncate_location

Une nouvelle option de configuration a été ajoutée, error_collector.backtrace_truncate_location, qui permet à l'utilisateur de spécifier où tronquer la backtrace lorsque le nombre de frames dépasse error_collector.max_backtrace_frames. Les options sont 'top' (supprime les cadres du début), 'middle' (supprime les cadres du milieu, en conservant le début et la fin) ou 'end' (supprime les cadres de la fin). La valeur par défaut est 'middle'. PR#3424

Fonctionnalité : Ajout de l'instrumentation de la gem Logging

L'Agent enregistrera désormais les logs générés par le gem Logging. PR#3420

Fonctionnalité : Ajout de l'option de configuration utilization.detect_in_parallel

Une nouvelle option de configuration a été ajoutée, utilization.detect_in_parallel, qui contrôle si l'agent utilise des threads lors de la détection des informations sur le fournisseur de cloud afin d'accélérer le démarrage de l'agent. Lorsque défini sur false, la détection du fournisseur s'exécute séquentiellement sans créer de threads. La valeur par défaut est true. PR#3439

Feature: Add support for forking processes in Parallel gem instrumentation

Parallel gem instrumentation has been added to allow more consistent monitoring in processes forked using the Parallel gem. PR#3405

Feature: Add support for Grape v3.1.0

Grape's release of v3.1.0 introduced changes that were incompatible with the agent's instrumentation, causing issues when collecting transaction names. The agent has been updated to properly extract class names for transaction naming in the updated Grape API structure. PR#3413

Bugfix: Create health check files in forked processes

The agent now properly initializes health check loops after forking, ensuring each process generates its own health check file. This fix also has the effect of correctly including entity.guid values in the health check files. PR#3409 Issue#3408

Bugfix: Fix sidekiq.ignore_retry_errors

The configuration option sidekiq.ignore_retry_errors: true was continuing to report retry errors. The agent now correctly ignores retry errors and only reports when jobs permanently fail. PR#3399

Changement radical : Suppression de la prise en charge de Ruby 2.4 et 2.5

La prise en charge des versions Ruby 2.4 et 2.5 a été supprimée. La nouvelle version minimale requise de Ruby est désormais la 2.6. PR#3314

Changement important : Suppression du Cross Application Tracing (CAT)

Auparavant, le suivi inter-applications (CAT) était obsolète au profit du suivi distribué. La fonctionnalité CAT a maintenant été supprimée. L'option de configuration cross_application_tracer.enabled a été supprimée. Les méthodes d'API publiques NewRelic::Agent::External.process_request_metadata, NewRelic::Agent::External.get_response_metadata, NewRelic::Agent::Transaction::ExternalRequestSegment#process_response_metadata, NewRelic::Agent::Transaction::ExternalRequestSegment#get_request_metadata et NewRelic::Agent::Transaction::ExternalRequestSegment#read_response_headers ont également été supprimées. PR#3333

Modification importante : Renommer les métriques et segments ActiveJob

Les métriques ActiveJob ont été mises à jour pour inclure le nom de la classe du job pour des rapports plus spécifiques. Il s'agit d'un changement radical qui peut nécessiter la mise à jour des tableaux de bord ou des alertes personnalisés. PR#3370 PR#3320

• Ancien format : Ruby/ActiveJob/<QueueName>/<Method>
• Nouveau format : Ruby/ActiveJob/<QueueName>/<ClassName>/<Method>

De plus, les segments créés pour les actions de mise en file d’attente Active Job incluent désormais la classe de travail.

• Ancien format : ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>
• Nouveau format : ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>/<ClassName>

Changement important : renommer la commande bin/newrelic en bin/newrelic_rpm

Le fichier exécutable pour l'interface de ligne de commande (CLI) de l'agent a été renommé de bin/newrelic en bin/newrelic_rpm. Ce changement résout un conflit de noms avec l'outil CLI New Relic autonome. PR#3323

Changement radical : supprimer la commande CLI newrelic deployments

La commande CLI newrelic deployments obsolète a été supprimée. Pour suivre les changements et les déploiements dans New Relic, veuillez consulter notre guide sur Suivi des changements pour une liste des options disponibles. PR#3299

Changement radical : Supprimer la méthode NewRelic::Agent::SqlSampler#notice_sql

Les utilisateurs doivent appeler NewRelic::Agent::Datastores.notice_sql à la place. PR#3338

Modification importante : Supprimer les arguments inutilisés de diverses API NewRelic::Agent::Datastores

Les API suivantes de la classe NewRelic::Agent::Datastores ont vu leurs arguments de méthode supprimés :

• NewRelic::Agent::Datastores.notice_sql, avait auparavant trois arguments de position, query, scoped_metric et elapsed. Maintenant, il n'en a que query.
• NewRelic::Agent::Datastores.notice_statement, avait auparavant deux arguments positionnels query et elapsed. Maintenant, il n’a que query.
• NewRelic::Agent::Datastores.wrap nécessite une proc. Auparavant, la proc recevait trois arguments : le résultat du yield, le nom de métrique le plus spécifique et le temps écoulé de l'appel. Désormais, elle n'en reçoit qu'un seul : le résultat du yield.

Les valeurs des arguments supprimés sont dérivées du segment actuel au moment de l'appel. PR#3347

Changement radical : Supprimer la fonctionnalité expérimentale Configurable Security Policies (CSP)

La fonctionnalité expérimentale, Configurable Security Policies (CSP), n'est plus prise en charge et a été supprimée. PR#3292

Changement radical : supprimer la prise en charge des versions de Puma '<' 3.9.0

La version minimale de Puma désormais prise en charge est 3.9.0 ou supérieure. PR#3326

Changement important : améliorer la validation et la coercition de la configuration

Les éléments internes utilisés pour contraindre et valider les valeurs fournies pour la configuration de l’agent sont désormais plus performants et plus précis.

• Les messages d'avertissement seront désormais enregistrés dans le fichier newrelic_agent.log lorsque la valeur nil est fournie comme valeur de configuration pour un paramètre qui ne le prend pas en charge.
• Les valeurs entières sont autorisées pour les types de configuration Float
• Les valeurs flottantes sont autorisées pour les types de configuration Integer
• Les interruptions fatales sont évitées lorsqu'une valeur par défaut peut être trouvée pour remplacer une valeur d'entrée non valide PR#3341

Changement important : remplacer l'option 'default' par 'adaptive' pour les échantillonneurs parents distants de tracing distribué

Auparavant, l’option par défaut pour distributed_tracing.sampler.remote_parent_sampled et distributed_tracing.sampler.remote_parent_not_sampled était default, qui utilisait l’échantillonneur adaptatif préexistant. L’option default a été renommée adaptive. PR#3363

Fonctionnalité : Ajouter logger en tant que dépendance

La gemme logger est désormais répertoriée comme dépendance de l'agent pour assurer la continuité de la fonctionnalité de logging et la prise en charge de Ruby 4.0.0 et des versions plus récentes. PR#3293

Fonctionnalité : Ajouter une option de configuration de liste d'autorisation de notification de support actif

Une nouvelle option de configuration, instrumentation.active_support_notifications.active_support_events, permet aux utilisateurs de définir une liste d’autorisation des noms d’événements de notifications Active Support auxquels l’agent doit s’abonner. Par défaut, l’agent s’abonne à tous les événements Active Support : Mise en cache et Active Support : Messages. PR#3327

Fonctionnalité : Utiliser la compression Gzip intégrée de Ruby

L’agent utilise désormais la méthode Zlib.gzip intégrée de la bibliothèque standard Ruby pour la compression, remplaçant l’implémentation personnalisée précédente. PR#3332

Fonctionnalité : Ajouter la validation des arguments pour l’API NewRelic::Agent#record_custom_event

L'API NewRelic::Agent#record_custom_event déclenche désormais une ArgumentError lorsqu'un event_type non valide est fourni. Un type d'événement valide doit être composé uniquement de caractères alphanumériques, de traits de soulignement (_), de deux-points (:) ou d'espaces ( ). PR#3319

Fonctionnalité : ajouter des options de configuration d'échantillonnage racine

Vous pouvez désormais configurer le comportement d'échantillonnage des traces provenant du service actuel à l'aide de distributed_tracing.sampler.root. PR#3330

Quatre modes sont disponibles :

Fonctionnalité : ajouter des options d'échantillonnage basées sur le ratio d'ID de trace

L'agent peut désormais échantillonner les traces à l'aide de l'algorithme d'échantillonneur basé sur le ratio d'ID de trace OpenTelemetry. PR#3330 Cela échantillonne les traces en fonction d'une probabilité comprise entre 0,0 et 1,0 basée sur l'ID de trace.

Pour utiliser cette option, vous devez d'abord définir votre configuration d'échantillonneur de suivi distribué sur trace_id_ratio_based, puis définir l'échantillonneur distributed_tracing.sampler.*.trace_id_ratio_based.ratio correspondant sur un nombre à virgule flottante compris entre 0,0 et 1,0.

Par exemple:

distributed_tracing.sampler.remote_parent_sampled: 'trace_id_ratio_based'
  distributed_tracing.sampler.remote_parent_sampled.trace_id_ratio_based.ratio': 0.5

Cette configuration échantillonnerait environ 50 % de vos traces pour toutes les traces où le parent distant est échantillonné.

Cette option est disponible pour :

• distributed_tracing.sampler.root
• distributed_tracing.sampler.remote_parent_sampled
• distributed_tracing.sampler.remote_parent_not_sampled

Fonctionnalité : Ajouter l'ID d'entité aux fichiers de contrôle de l'état de l'agent

Lorsque l'agent est démarré dans un environnement de contrôle de l'agent, un fichier de vérification de l'état est créé à l'emplacement de fichier configuré pour chaque processus d'agent. Ce fichier inclut désormais le guid de l'entité liée à l'agent lorsqu'il est disponible. PR#3371

Correction de bug : Résoudre un NoMethodError dans la détection d'utilisation de GCP.

La logique de découverte des métadonnées GCP gérera désormais avec élégance nil ou des valeurs inattendues, empêchant les plantages d'initialisation du service. PR#3388

Fonctionnalité : Rappel de dépréciation pour l’API SqlSampler#notice_sql

La méthode NewRelic::Agent::SqlSampler#notice_sql est obsolète et sera supprimée dans une future version majeure. Au lieu de cela, l'utilisateur doit appeler NewRelic::Agent::Datastores.notice_sql. PR#3345

fonctionnalité : Avertissement de dépréciation pour les deuxième et troisième arguments de Datastores.notice_sql API

Les deuxième (scoped_metric) et troisième (elapsed) arguments de la méthode NewRelic::Agent::Datastores.notice_sql sont obsolètes. Elles n'ont pas été utilisées par cette méthode depuis un certain temps. Ces valeurs seront plutôt définies en fonction du segment actuel lors de l'appel de l'API. PR#3345

fonctionnalité : Avis de dépréciation pour le deuxième argument de Datastores.notice_statement API

Le deuxième argument (elapsed) de la méthode NewRelic::Agent::Datastores.notice_statement est obsolète. Cette méthode n'a pas été utilisée depuis un certain temps. Cette valeur sera plutôt définie en fonction du segment actuel lors de l'appel de l'API. PR#3346

Fonctionnalité : Avis de dépréciation concernant les deuxième et troisième arguments de la procédure dans l’API Datastores.wrap

La méthode NewRelic::Agent::Datastores.wrap est en cours de modification. Dans une future version majeure, la procédure n'acceptera qu'un seul argument : le résultat de la fonction yield. Le nom de la métrique à portée et les arguments écoulés seront supprimés, car ils sont supprimés de la méthode Datastores.notice_sql. Le nom de la métrique et les valeurs écoulées sont dérivés du segment actuel lorsque le retour à la ligne est atteint. PR#3346

fonctionnalité : Ajouter sidekiq.ignore_retry_errors option de configuration

Une nouvelle option de configuration, sidekiq.ignore_retry_errors, a été ajoutée pour contrôler si les nouvelles tentatives de tâches Sidekiq sont capturées. Les erreurs de nouvelle tentative sont capturées par défaut, mais maintenant si sidekiq.ignore_retry_errors est défini sur true, l'agent ignorera les exceptions levées lors des tentatives de nouvelle tentative de Sidekiq et ne signalera l'erreur que si la tâche échoue définitivement. Merci DonGiulio d'avoir reconnu cette amélioration et d'avoir contribué à la solution. PR#3317

fonctionnalité : Avis de dépréciation pour l'enregistrement déployé à l'aide de Capistrano

L'envoi d'informations de déploiement d'application via une recette Capistrano est obsolète et sera supprimé dans la version 10.0.0 de l'agent. Pour l'enregistrement du déploiement, veuillez consulter notre guide sur le suivi des changements pour obtenir la liste des options disponibles.

Fonctionnalité : Utiliser la configuration d'échantillonnage du parent distant pour les décisions dans davantage de scénarios.

Auparavant, les options de configuration distributed_tracing.sampler.remote_parent_sampled et distributed_tracing.sampler.remote_parent_not_sampled étaient utilisées pour la décision d'échantillonnage uniquement lorsque les en-têtes traceparent et tracestate étaient présents. Ces options de configuration sont désormais appliquées dans les cas où l'en-tête tracestate est manquant et où seul l'en-tête newrelic est disponible. Ce changement rend l'échantillonnage distribué traceplus cohérent et prévisible. PR#3306