Ruby agent release notesRSS

Fonctionnalité : les événements SpanLink sont désormais pris en charge pour l'agent hybride

Les spans créés par une API OpenTelemetry peuvent désormais avoir des liens de span qui leur sont associés. Des liens peuvent être ajoutés au début d'un span, en les passant à l'argument links, ou en appelant l'API OpenTelemetry::Trace::Span#add_link. PR#3586

Fonctionnalité : les événements SpanEvent sont désormais pris en charge pour l'agent hybride

Les spans créés par une API OpenTelemetry peuvent désormais avoir des événements SpanEvent qui leur sont associés via l’API OpenTelemetry::Trace::Span#add_event. Les événements SpanEvent capturent des annotations avec horodatage sur un span et sont envoyés à New Relic avec le span parent. PR#3587

Fonctionnalité : définir le type de span sur tous les spans de l'agent hybride

Auparavant, seuls les spans OpenTelemetry traduits en segments de requêtes externes ou en segments de datastore ajoutaient le type de span en tant qu’attribut. Désormais, l’agent ajoute le type de span à tous les spans OpenTelemetry où la valeur est disponible. PR#3589

Fonctionnalité : ajouter la prise en charge d’OpenTelemetry::Tracer#start_root_span

L'API OpenTelemetry::Tracer#start_root_span peut désormais être utilisée pour forcer le démarrage d'une transaction pour un span donné, à condition qu'il ait un type de span :server ou :consumer. Pour tous les autres types de spans, elle n'effectuera aucune opération. Cette méthode est le plus souvent utilisée dans l'instrumentation des tâches en arrière-plan. PR#3588

Correction de bug : correction de instrumentation.rails_event_logger: false qui ne désactive pas l'instrumentation

Auparavant, définir instrumentation.rails_event_logger sur false ne désactivait pas l'instrumentation Rails.event comme prévu ; elle était toujours installée lors du démarrage de Rails. Ce problème est maintenant résolu. PR#3564

Correction de bug : normaliser les valeurs de type booléen à disabled pour les clés de configuration d'instrumentation

Auparavant, seul disabled désactivait une clé de configuration instrumentation.*. Désormais, les valeurs de type booléen telles que false, no ou off se résolvent également en disabled et empêchent l'installation de l'instrumentation. PR#3579

Correction de bug : les métriques de supportabilité de logging par bibliothèque reflètent désormais l’état d’instrumentation de chaque bibliothèque

Auparavant, les métriques Supportability/Logging/Ruby/{library}/{enabled|disabled} signalaient la valeur du paramètre global application_logging.enabled pour chaque bibliothèque, plutôt que l'état réel de chaque bibliothèque. Par conséquent, la métrique signalait enabled même lorsque vous aviez désactivé l'instrumentation de logging pour une bibliothèque spécifique ou que vous n'utilisiez pas du tout le gem de cette bibliothèque. Désormais, la métrique de chaque bibliothèque reflète si sa propre instrumentation de logging est activée. 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