Ruby agent release notesRSS

Fonctionnalité : ajouter la prise en charge de Dalli 5.0 et corriger l'instrumentation du méta-protocole

L’agent prend désormais en charge Dalli 5.0+, qui a supprimé Dalli::Protocol::Binary au profit exclusif du méta-protocole. Pour Dalli 3.2.0+, L'instrumentation pipelined_get cible désormais correctement Dalli::Protocol::Base (où la méthode est définie) plutôt que Dalli::Protocol::Binary, corrigeant une lacune où les appels get_multi n'étaient pas instrumentés lors de l'utilisation du méta-protocole. Pour Dalli 5.0+, l’agent instrumente également Dalli::Protocol::Meta#read_multi_req, qui est invoqué par l’optimisation get_multi à serveur unique de Dalli. PR#3541

Fonctionnalité : ajouter une option de configuration active_record_use_table_name

Une nouvelle option de configuration, active_record_use_table_name, utilise le nom de table d'un modèle Active Record au lieu de son nom de classe pour nommer les métriques, les spans et les segments de trace de transaction. Cela peut être particulièrement utile pour réduire la cardinalité dans les applications utilisant l’héritage à table unique. L'option est définie par défaut sur false pour préserver le comportement existant. PR#3540

Fonctionnalité : masquer partiellement les clés de licence dans les logs de l'agent

Auparavant, l'agent masquait complètement les clés de licence New Relic dans les logs de l'agent. Maintenant, les 10 premiers caractères sont visibles tandis que le reste est remplacé par *. Cela préserve suffisamment d’informations pour résoudre les problèmes liés à la région sans exposer la partie secrète de la clé. PR#3547

Correctif : résolution de l'incompatibilité de l'instrumentation de l'enregistreur sémantique avec rails_semantic_logger

Auparavant, un ArgumentError était levé lorsqu'une exception atteignait ActionDispatch::DebugExceptions lors de l'utilisation de rails_semantic_logger. Ce problème est résolu. Merci à @jdelStrother de l’avoir signalé ! PR#3548

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