Ruby agent release notesRSS

Fonctionnalité : ajout de l'instrumentation de Rails.event pour le logging structuré

L'agent prend désormais en charge Rails.event en tant qu'événements de log structurés. Lorsqu'ils sont activés, les événements publiés via Rails.event.notify sont capturés et transférés vers New Relic en tant qu'événements de log. Les charges d'événement, les tags, le contexte, les horodatages et les emplacements source sont automatiquement capturés en tant qu'attributs de log.

Cette instrumentation peut être configurée avec les options suivantes :

• instrumentation.rails_event_logger - Contrôle si l'instrumentation de Rails.event est activée. Utilise par défaut la valeur de application_logging.enabled.
• instrumentation.rails_event_logger.event_names - Un éventail de noms d'événements spécifiques à capturer. Si vide (par défaut), toutes les notifications Rails.event sont capturées. Utilisez ceci pour filtrer les événements par nom, par exemple : ['user.signup', 'payment.processed'].

PR#3526

Fonctionnalité : ajout de l'instrumentation pour les continuations Rails Active Job

L'agent instrumente désormais les continuations Rails Active Job, offrant une visibilité sur l'exécution des étapes individuelles au sein des tâches de longue durée. Les noms d’étapes sont inclus dans les métriques de segment (par exemple, Ruby/ActiveJob/default/MyJob/step/process_records) et des attributs spécifiques à l’étape tels que la position du curseur, le statut repris et le statut interrompu sont capturés. Une nouvelle option de configuration, disable_active_job_step_names, permet aux utilisateurs d'exclure les noms d'étapes des noms de métriques pour réduire la cardinalité des métriques si nécessaire (la valeur par défaut est false). PR#3493

Fonctionnalité : ajout de sidekiq.separate_transactions option de configuration

Une nouvelle option de configuration, sidekiq.separate_transactions, permet aux tâches Sidekiq exécutées pendant une transaction web de s'exécuter dans leur propre transaction séparée. Lorsqu'il est activé, cela empêche le temps d'exécution des jobs Sidekiq d'être inclus dans les métriques de transaction web, fournissant des données de performance plus précises. La fonctionnalité est optionnelle (par défaut : false) pour maintenir la rétrocompatibilité. Cela n'affecte que les tâches exécutées pendant des transactions web actives ; les tâches démarrant indépendamment ou imbriquées dans d'autres tâches d'arrière-plan ne sont pas affectées. Problème n° 3364 PR#3514

Correction de bug : mise à jour des regex qui auraient pu être vulnérables aux attaques ReDOS

Auparavant, l'agent avait quelques regex identifiées comme cibles possibles pour des attaques de complexité temporelle polynomiale (ReDOS). Ces regex sont maintenant mises à jour pour répondre aux préoccupations. PR#3520

Correction de bug : empêcher les plantages lors de la création de segments HTTPX

Auparavant, si start_external_request_segment rencontrait une erreur et renvoyait nil, l'agent déclenchait un NoMethodError en tentant d'ajouter des en-têtes au segment manquant. Nous avons ajouté un contrôle de sécurité pour garantir que l'instrumentation gère ces cas avec élégance.

Bravo à @thebravoman pour le rapport ! Issue#3509 PR#3510

Correctif : rendre Transaction#finish idempotent

Auparavant, si la méthode Transaction#finish était appelée plusieurs fois, plus d’une transaction pouvait être créée pour la même opération. Désormais, un mutex protège les appels à Transaction#finish pour s’assurer que les opérations de finalisation ne s’exécutent qu’une seule fois. PR#3513

Correction de bug : Avertissement unique de dépréciation de Log pour l'API Datastores.wrap

Auparavant, cet avertissement était logué lors de chaque appel à Datastores.wrap. Désormais, il fera l'objet d'un log uniquement lors du premier appel. De plus, la documentation a été mise à jour pour indiquer le statut obsolète des deuxième et troisième arguments de rappel. Issue#3516 PR#3519

Fonctionnalité : ajouter le nommage de requête de base de données via des commentaires SQL

Les requêtes de base de données peuvent désormais être nommées explicitement à l'aide de commentaires SQL. Les requêtes peuvent inclure des commentaires /* NewRelicQueryName: CustomName */ afin d'attribuer des noms stables pour un meilleur suivi et une meilleure identification. Cela est particulièrement utile pour suivre des requêtes de base de données spécifiques lors de régressions de performances ou d'incidents. PR#3480

Fonctionnalité : ajout de l'instrumentation de Semantic Logger

L'agent prend désormais en charge le transfert de logs et la décoration de l'enregistreur Semantic Logger pour les versions 4.6.0+ de la gemme semantic_logger. Si vous utilisiez précédemment l’appender New Relic intégré de l’enregistreur Semantic Logger, il est recommandé de choisir une approche pour éviter d’envoyer un log en double. L'instrumentation de l'enregistreur sémantique de New Relic peut être désactivée en définissant instrumentation.semantic_logger sur disabled. PR#3467

Merci à @jdelStrother d'avoir fourni un retour précieux qui a aidé à façonner cette instrumentation.

Fonctionnalité : ajouter une nouvelle configuration « ignored_middleware_classes »

Une nouvelle option de configuration, ignored_middleware_classes, permet aux utilisateurs d'exclure des middlewares spécifiques de l'instrumentation (ex. Rack::Cors). Sa valeur par défaut est un éventail vide. Issue#1814 PR#3481

Fonctionnalité : ajouter une nouvelle API NewRelic::Agent.add_transaction_log_attributes

Une nouvelle API, NewRelic::Agent.add_transaction_log_attributes, permet aux utilisateurs d'ajouter des attributs personnalisés au niveau de la transaction aux événements de log pour la transaction actuelle. Ces attributs seront appliqués uniquement aux logs créés dans le cadre de la transaction en cours. PR#3472

Correctif : fournir une option de configuration pour réduire la cardinalité des métriques de diffusion ActionCable

Par défaut, les métriques pour les appels de méthode de diffusion ActionCable incluent la valeur de la diffusion. Cette valeur peut avoir une très forte cardinalité. Désormais, l'option de configuration :simplify_action_cable_broadcast_metrics permet aux utilisateurs de supprimer la valeur de diffusion du nom de la métrique. Cela crée une métrique qui ressemble à : Ruby/ActionCable/broadcast. Lorsque cette option de configuration est activée, la valeur de diffusion sera ajoutée en tant qu'attribut de span. PR#3463

Correctif : supprimer le require « digest/md5 » mort pour la conformité FIPS/FedRAMP

Dans la version 7.1.0 de l’agent, l’utilisation de MD5 a été remplacée par SHA1 pour la conformité FIPS (PR). Cependant, l'ancien require de « digest/md5 » n'a pas été supprimé. Nous avons supprimé l’exigence pour aider nos utilisateurs FIPS/FedRAMP. Merci à @ashleyboehs d'avoir porté cela à notre attention ! Issue#3469 PR#3470

Correction de bug : empêcher l'agent de démarrer pendant rails test pour éviter un délai d'arrêt

Auparavant, l’agent provoquait un délai d’arrêt de -3 secondes lors de l’exécution de la commande rails test. La constante Rails::Command::TestCommand a été ajoutée à la liste autostart.denylisted_constants par défaut pour empêcher l'agent de démarrer lors de l'exécution des tests Rails. Merci à @varyform d’avoir porté cela à notre attention. PR#3478

Correction de bug : corrige les avertissements "Impossible de calculer le temps écoulé de la transaction" lors de l'utilisation du serveur Web Falcon

L'agent utilise désormais Fiber.current.object_id au lieu de Thread.current.object_id pour suivre l'état de la transaction lors de l'exécution sous Falcon, empêchant les collisions dues aux requests simultanées partageant le même thread. Corrige également une erreur "NameError: uninitialized constant Async::HTTP::VERSION" lors de l'utilisation de Falcon. Merci à @97jaz et @gsar d'avoir porté cela à notre attention. PR#3483

Correctif : correction d'une faute de frappe dans harvest.rb causant une NoMethodError

Une faute de frappe dans lib/new_relic/agent/agent_helpers/harvest.rb a causé un NoMethodError: undefined method 'agent' for NewRelic:Module. Merci à @oakbow d'avoir signalé ce problème. PR#3484

Correction de bug : suppression de l'utilisation de ObjectSpace._id2ref obsolète

L’agent utilise désormais une approche alternative au lieu de la méthode ObjectSpace._id2ref obsolète, éliminant les avertissements de dépréciation lors de l’exécution sur Ruby 4.0+. PR#3490

Correction de bug : correction de NoMethoError dans l'instrumentation de Logging

Auparavant, lorsque l'instrumentation de la gem Logging tentait de décorer les log locaux, elle levait un NoMethodError si elle rencontrait un objet autre qu'une chaîne de caractères. Ce problème est maintenant résolu. PR#3501

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