Ruby agent release notesRSS

Feature: SpanLink events are now supported for the Hybrid agent

Spans created by an OpenTelemetry API can now have Span Links associated with them. Links can be added on a span's start, by passing them to the links argument, or by calling the OpenTelemetry::Trace::Span#add_link API. PR#3586

Feature: SpanEvent events are now supported for the Hybrid agent

Spans created by an OpenTelemetry API can now have SpanEvent events associated with them via the OpenTelemetry::Trace::Span#add_event API. SpanEvent events capture timestamped annotations on a span and are sent to New Relic alongside the parent span. PR#3587

Feature: Set span kind on all Hybrid agent spans

Previously, only OpenTelemetry spans translated into external request segments or datastore segments added span kind as an attribute. Now, the agent adds span kind to all OpenTelemetry spans where the value is available. PR#3589

Feature: Add support for OpenTelemetry::Tracer#start_root_span

The OpenTelemetry::Tracer#start_root_span API can now be used to force a transaction to start for a given span, provided it has a :server or :consumer span kind. For any other span kinds, it will no-op. This method is most commonly used in background job instrumentation. PR#3588

Bugfix: Fix instrumentation.rails_event_logger: false not disabling the instrumentation

Previously, setting instrumentation.rails_event_logger to false didn't disable the Rails.event instrumentation as expected; it would still be installed during Rails boot. This is now fixed. PR#3564

Bugfix: Normalize boolean-like values to disabled for instrumentation config keys

Previously, only disabled would turn off an instrumentation.* config key. Now, boolean-like values such as false, no, or off also resolve to disabled and prevent the instrumentation from being installed. PR#3579

Bugfix: Per-library logging supportability metrics now reflect each library's instrumentation state

Previously, the Supportability/Logging/Ruby/{library}/{enabled|disabled} metrics reported the value of the global application_logging.enabled setting for every library, rather than each library's actual state. As a result, the metric reported enabled even when you had disabled logging instrumentation for a specific library or weren't using that library's gem at all. Now, each library's metric reflects whether its own logging instrumentation is enabled. PR#3571

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