Python agent release notesRSS

Remarques

Cette version de l'agent Python ajoute la prise en charge Python 3.14, de nouvelles variables d'environnement pour les paramètres de filtre d'attributs, la prise en charge des générateurs asynchrones dans les décorateurs de transaction, des modèles supplémentaires dans AWS Bedrock et de nouvelles méthodes dans AWS Kinesis. Cette sortie corrige également un bug dans aiomysql qui provoquait RecursionError lors de l'utilisation de ConnectionPool lorsqu'il était enveloppé plusieurs fois, un bug où les propriétés n'étaient pas correctement transmises dans le producteur de kombu, et une erreur lorsque shutdown_agent est appelé depuis le thread de récolte.

Installez l'agent en utilisant easy_install/pip/distribute via l' index des packagesPython , en utilisant conda via l' index des packages Conda-Forge, ou téléchargez-le directement depuis le site de téléchargement de New Relic.

Caractéristiques

• Ajout de la prise en charge de Python 3.14

  • Ajout de la prise en charge de Python 3.14.

• Ajouter des variables d'environnement pour les paramètres des filtres d'attributs

  • Les paramètres suivants peuvent désormais être définis via des variables d'environnement :

    Paramètres de configuration	Variable d'environnement
    attributes.enabled	NEW_RELIC_ATTRIBUTES_ENABLED
    attributes.exclude	NEW_RELIC_ATTRIBUTES_EXCLUDE
    attributes.include	NEW_RELIC_ATTRIBUTES_INCLUDE
    browser_monitoring.attributes.enabled	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_ENABLED
    browser_monitoring.attributes.exclude	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_EXCLUDE
    browser_monitoring.attributes.include	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_INCLUDE
    error_collector.attributes.enabled	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_ENABLED
    error_collector.attributes.exclude	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_EXCLUDE
    error_collector.attributes.include	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_INCLUDE
    span_events.attributes.enabled	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_ENABLED
    span_events.attributes.exclude	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_EXCLUDE
    span_events.attributes.include	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_INCLUDE
    transaction_events.attributes.enabled	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_ENABLED
    transaction_events.attributes.exclude	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_EXCLUDE
    transaction_events.attributes.include	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_INCLUDE
    transaction_segments.attributes.enabled	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_ENABLED
    transaction_segments.attributes.exclude	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_EXCLUDE
    transaction_segments.attributes.include	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_INCLUDE
    transaction_tracer.attributes.enabled	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_ENABLED
    transaction_tracer.attributes.exclude	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_EXCLUDE
    transaction_tracer.attributes.include	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_INCLUDE

• Ajouter la prise en charge des générateurs asynchrones dans les décorateurs transaction

  • Auparavant, les décorateurs de transaction ne prenaient pas en charge l'encapsulation autour des générateurs asynchrones. Cette fonctionnalité a été ajoutée, et les transactions du générateur asynchrone mesureront désormais automatiquement le temps d'attente de la boucle d'événements et d'autres statistiques.

• Ajout de la prise en charge de modèles supplémentaires dans l'instrumentation AWS Bedrock

  • Mise à jour de l'instrumentation AWS Bedrock via botocore et aiobotocore pour prendre en charge les modèles supplémentaires suivants

    • Modèles Claude Sonnet 3+
    • Modèles préfixés par une région (adaptatifs aux régions)

• Ajouter l'instrumentation pour les nouvelles méthodes Kinesis

  • Ajoute l'instrumentation botocore pour prendre en charge les nouvelles méthodes AWS Kinesis

    • describe_account_settings
    • update_account_settings
    • update_max_record_size
    • update_stream_warm_throughput

Débogage

• Prévenir une erreur de récursion dans le pool de connexions aiomysql

  • Auparavant, une erreur RecursionError était levée dans aiomysql lors de l'utilisation de connexions mises en pool. Des chaînes profondes ObjectProxy ont été créées autour de connexions mises en commun en raison d'un enroulement répété. Ce problème a été résolu.

• Correction d'un bug où les propriétés n'étaient pas correctement transmises au producteur de Kombu

  • Correction d'un bug où l'instrumentation pour kombu.messaging.Producer.publish() entraînait l'imbrication accidentelle de propriétés à l'intérieur du dictionnaire, ce qui faisait que les propriétés se trouvaient au mauvais endroit et n'étaient pas lues par le package en aval.

• Correction d'une erreur lors de l'appel de shutdown_agent depuis le thread de récolte

  • Auparavant, un RuntimeError pouvait se produire lorsque shutdown_agent était appelé depuis le thread de récolte. Cela corrige ce problème en ajoutant une protection pour empêcher le plantage.

Déclaration de soutien

Nous vous recommandons de mettre à jour vers la dernière version de l'agent dès qu'elle est disponible. Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version, mettez à jour vos agents vers une version datant de moins de 90 jours. En savoir plus sur la façon de tenir les agents informés.

Consultez la politique EOL de l'agent Python de New Relic pour obtenir des informations sur la sortie de l'agent et les dates de support.

Remarques

Cette sortie de l'agent Python fournit des correctifs pour l'activation précoce dans l'instrumentation Django, les remplacements côté serveur pour max_samples_stored ignorés et les protections contre les plantages de trace_cache.pop().

Installez l'agent à l'aide de easy_install/pip/distribute via l' index du packagePython ou téléchargez-le directement depuis le site de téléchargement de New Relic.

Débogage

• Empêche l'activation précoce dans l'instrumentation Django

  • Supprimez les appels à application_settings() dans l'instrumentation Django pour éviter les problèmes liés aux activations précoces dans les applications pré-fork.

• Résoudre les problèmes de synchronisation de la configuration du serveur avec la configuration locale

  • Cela corrige un bug créé lorsque les paramètres event_harvest_config.harvest_limits.* étaient obsolètes au profit des paramètres *.max_samples_stored. Certaines configurations côté serveur ne remplaçaient pas la configuration côté client, ce qui entraînait l'envoi de données au collecteur malgré la désactivation de cette fonction par l'utilisateur.

• Protégez-vous contre les accidents de trace_cache.pop()

  • Dans la classe ContextOf, il y a eu un accès non sécurisé de trace_cache via pop(key) sans valeur par défaut. Cela a provoqué des plantages lorsque le weakref dans le dictionnaire était déjà récupéré par le garbage collector.

Déclaration de soutien

Nous vous recommandons de mettre à jour vers la dernière version de l'agent dès qu'elle est disponible. Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version, mettez à jour vos agents vers une version datant de moins de 90 jours. En savoir plus sur la façon de tenir les agents informés.

Consultez la politique EOL de l'agent Python de New Relic pour obtenir des informations sur la sortie de l'agent et les dates de support.

Remarques

Cette sortie de l'agent Python apporte les modifications suivantes :

• Supprime la prise en charge de Python 3.7
• Supprime et/ou déprécie diverses API et paramètres
• Obsolète l'instrumentation aioredis
• Augmente la version minimale prise en charge de setuptools et setuptools_scm
• Ajoute une nouvelle instrumentation pour AutoGen
• Ajoute une nouvelle instrumentation pour Pyzeebe
• Ajoute de nouveaux MCP (Model Context Protocol) nommés spans
• Corrige un crash dans psycopg
• Garantit que les étendues MCP ne sont enregistrées que lorsque monitoring de l'IA est activée

Installez l'agent à l'aide de easy_install/pip/distribute via l' index du packagePython ou téléchargez-le directement depuis le site de téléchargement de New Relic.

Fonctionnalité supprimée

• Supprime la prise en charge de Python 3.7

  • Python 3.7 a pris fin le 27 juin 2023. L'agent Python n'en prend plus en charge.

• Supprime diverses API obsolètes

  • Les API suivantes ont été supprimées :

    API héritée	API de remplacement
    accept_distributed_trace_payload	accept_distributed_trace_headers
    add_custom_parameter	add_custom_attribute
    add_custom_parameters	add_custom_attributes
    create_distributed_trace_payload	insert_distributed_trace_headers
    get_browser_timing_footer	La fonctionnalité de ceci a été intégrée dans get_browser_timing_header()
    record_exception	notice_error()
    NewRelicLogHandler	NewRelicLogForwardingHandler
    lambda_handler & LambdaHandlerWrapper	Ces API ont été déplacées vers le package newrelic-lambda.

• Supprime divers paramètres obsolètes

  • Les paramètres suivants ont été supprimés :

    héritage Réglage	Paramètre de remplacement
    transaction_tracer.capture_attributes	transaction_tracer.attributes.enabled
    error_collector.capture_attributes	error_collector.attributes.enabled
    browser_monitoring.capture_attributes	browser_monitoring.attributes.enabled
    analytics_events.enabled	transaction_events.enabled
    analytics_events.capture_attributes	transaction_events.attributes.enabled
    error_collector.ignore_errors	error_collector.ignore_classes
    strip_exception_messages.whitelist	strip_exception_messages.allowlist
    ssl	Ceci est désormais codé en dur sur true, il a donc été supprimé en tant qu'option de paramètre.
    ignored_params	Utilisez plutôt newrelic.attributes.exclude = request.parameters.{name}. Ajoutez chaque clé de paramètre de demande à la liste newrelic.attributes.exclude, délimitée par des virgules. Assurez-vous de préfixer la clé avec request.parameters.
    agent_limits.merge_stats_maximum	Ceci est désormais complètement ignoré au profit de la configuration côté serveur.

Fonctionnalité obsolète

• L'instrumentation pour aioredis est obsolète

  • Le package aioredis a été abandonné au profit de redis qui inclut désormais le sous-module redis.asyncio. Par conséquent, l’instrumentation pour aioredis est également obsolète. Veuillez plutôt utiliser la bibliothèque redis. Cette instrumentation sera retirée lors d'une prochaine sortie.

• Supprime certains paramètres de récolte existants pour correspondre à d'autres agents de langage

  • Afin d'être plus cohérent avec les conventions des autres agents de langage, les paramètres de récolte suivants sont désormais obsolètes :

    héritage Réglage	Paramètre de remplacement
    event_harvest_config.harvest_limits.analytic_event_data	transaction_events.max_samples_stored
    event_harvest_config.harvest_limits.span_event_data	span_events.max_samples_stored
    event_harvest_config.harvest_limits.error_event_data	error_collector.max_event_samples_stored
    event_harvest_config.harvest_limits.custom_event_data	custom_insights_events.max_samples_stored
    event_harvest_config.harvest_limits.log_event_data	application_logging.forwarding.max_samples_stored

    Il s'agit d'une annulation d'une modification précédente qui a renommé ces paramètres de *.max_samples_stored au format event_harvest_config.harvest_limits.*. Cette décision a été annulée et les noms des paramètres d'origine ont été restaurés pour correspondre aux autres agents linguistiques qui n'ont pas modifié ces noms de paramètres. Les paramètres obsolètes continueront de fonctionner pour le moment, mais ils seront supprimés lors d'une prochaine sortie.

• Désapprouve la configuration de l'agent via le dictionnaire d'environnement WSGI

  • Les paramètres suivants, qui pouvaient auparavant être configurés via le dictionnaire d'environnement WSGI, sont désormais obsolètes. Veuillez configurer ces paramètres via des variables d'environnement ou le fichier de configuration.

    • newrelic.set_background_task
    • newrelic.suppress_apdex_metric
    • newrelic.suppress_transaction_trace
    • newrelic.capture_request_params
    • newrelic.disable_browser_autorum

• Supprime la prise en charge de la création de l'agent avec setuptools<61.2 ou setuptools_scm<6.4

  • Les versions minimales prises en charge de setuptools et setuptools_scm ont été augmentées à 61.2 et 6.4 respectivement. Ceci permet de prendre en charge l'utilisation de pyproject.toml pour configurer les métadonnées du package et les instructions de construction. L'agent peut désormais être construit avec des outils de construction plus modernes qui n'enregistreront plus les avertissements concernant l'absence d'un fichier pyproject.toml.
  • Cette modification ajoute un nouvel attribut de version au package, newrelic.__version__ et newrelic.__version_tuple__, qui peut être utilisé pour vérifier par programmation la version de l'agent au moment de l'exécution.

Nouvelles fonctionnalités

• Ajoute une nouvelle instrumentation pour AutoGen

  • Ajoute une instrumentation (étendues nommées et événement Llm personnalisé) pour les agents et les outils dans AutoGen

• Ajoute une nouvelle instrumentation pour Pyzeebe

  • Ajoute une instrumentation automatique et un attribut d'agent spécifique frameworkpour Pyzeebe

• Ajoute de nouveaux MCP (Model Context Protocol) nommés spans

  • Ajoute de nouvelles étendues nommées pour les appels d'outils MCP (Model Context Protocol) effectués via le gestionnaire d'outils pour prendre en charge Streamable HTTP

Débogage

• Corrige un crash dans psycopg>=3.2.0 lors de l'appel as_string()

  • Corrige un problème dans psycopg>=3.2.0 où la méthode as_string() ne nécessitait plus d'arguments, provoquant un plantage potentiel. Ce problème a été corrigé et les deux signatures de cette méthode sont prises en charge.

• Garantit que les étendues MCP (Model Context Protocol) ne sont enregistrées que lorsque monitoring de l'IA est activée

  • Garantit que les étendues MCP (Model Context Protocol) ne sont enregistrées que lorsque le paramètre ai_monitoring.enabled est activé.

Déclaration de soutien

Nous vous recommandons de mettre à jour vers la dernière version de l'agent dès qu'elle est disponible. Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version, mettez à jour vos agents vers une version datant de moins de 90 jours. En savoir plus sur la façon de tenir les agents informés.

Consultez la politique EOL de l'agent Python de New Relic pour obtenir des informations sur la sortie de l'agent et les dates de support.

Remarques

Cette sortie de l'agent Python ajoute la prise en charge des éléments suivants :

• Tâches personnalisées dans Celery
• Monitoringde Graphene-Django
• Filtrage middleware dans Django
• API AWS Bedrock Converse
• Indicateur d'échantillon d'en-tête W3CTraceParent

Cette sortie fournit également les correctifs suivants :

• Garanties pour le chemin unique le plus profond dans GraphQL
• Mesures de protection pour l'analyse des requêtes d'URL Web
• Recours à ElasticSearch et GraphQL lorsque trace.settings==None
• Supprimer la méthode options de la liste des clients ElasticSearch asynchrones

Installez l'agent à l'aide de easy_install/pip/distribute via l' index du packagePython ou téléchargez-le directement depuis le site de téléchargement de New Relic.

Nouvelles fonctionnalités

• Ajoute la prise en charge des tâches personnalisées dans Celery

  • Ajoutez la prise en charge monitoring pour les classes de tâches personnalisées dans Celery. Auparavant, seules les tâches utilisant la classe de tâches par défaut pouvaient être monitorées. Remarque : cette version de l'agent Python ne prendra plus en charge les versions de Celery inférieures à la version 5.2.0.

• Ajoute la prise en charge de Graphene-Django

  • Ajoutez la prise en charge monitoring pour les schémas synchrones créés avec Graphene-Django. Auparavant, les schémas créés avec Graphene-Django n'étaient que partiellement monitorés, ce qui entraînait l'absence d'attributs liés GraphQL.

• Ajoute la prise en charge du filtrage middleware dans Django

  • Les utilisateurs sont désormais en mesure de filtrer le middleware Django à monitorer. Il existe désormais trois paramètres supplémentaires:

    • instrumentation.middleware.django.enabled (La valeur par défaut est true)
    • instrumentation.middleware.django.exclude
    • instrumentation.middleware.django.include

  Consultez la page Filtrage du middleware Django pour plus d’informations et d’exemples.

• Ajoute la prise en charge de l'API AWS Bedrock Converse

  • Ajoutez la prise en charge monitoring pour l'API Converse non diffusée en continu. Cela inclut la prise en charge des appels de fin de discussion converse effectués à l'aide des clients boto3 et aioboto3.

• Ajoute la prise en charge de l'indicateur d'échantillonnage de l'en-tête W3CTraceParent

  • Lorsqu'un service en amont envoie l'en-tête W3CTraceParent avec l'indicateur d'échantillonnage défini, New Relic prendra en compte cette décision d'échantillonnage pour décider si la transaction en cours sera échantillonnée.

• Ajout de la prise en charge des décisions d'échantillonnage en fonction de l'échantillonnage du parent distant

  • Ajout de la prise en charge de deux nouvelles options de configuration :

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

  • default est le comportement par défaut et se comporte comme avant ce changement (il transmet la décision d'échantillonnage à l'algorithme d'échantillonnage adaptatif pour déterminer si la transaction sera échantillonnée).

  • always_on signifie que la trace qui a un parent distant échantillonné ou un parent distant non échantillonné sera toujours échantillonnée.

  • always_off signifie que la trace qui a un parent distant échantillonné ou un parent distant non échantillonné ne sera jamais échantillonnée.

Débogage

• Ajouter une protection pour le chemin unique le plus profond dans GraphQL

  • Certains utilisateurs rencontraient des problèmes avec le chemin unique le plus profond dans GraphQL qui n'était pas généré en raison d'un nom de champ renvoyant None. Ce problème a été résolu.

• Ajouter une protection pour l'analyse des requêtes Web

  • Certains utilisateurs ont rencontré une erreur d'analyse lorsque request_uri était mal formé ou contenait des caractères non valides. Cela peut se produire à ce stade si le request_uri dans l'en-tête de la requête n'est pas valide et ne correspond pas à l'URL (valide) fournie à l'origine. Bien que cette protection ait désormais été mise en place dans New Relic, urllib a résolu ce problème pour les versions de Python sortie après le 31 janvier 2025.

• Correction du crash dans ElasticSearch et GraphQL lorsque trace.settings==None

  • Dans les cas où trace.settings est None, l'instrumentation pour ElasticSearch a fait planter l'application. Une solution de secours global_settings a été mise en place. Cela résout également le même problème rencontré dans GraphQL.

• Supprimer la méthode options de la liste des clients ElasticSearch asynchrones

  • L'instrumentation précédente d'ElasticSearch a provoqué un crash car options figurait dans la liste des méthodes asynchrones. Cette méthode n'est plus encapsulée dans un DatastoreTrace car elle n'effectue aucune opération/requests datastore.

Déclaration de soutien

Nous vous recommandons de mettre à jour vers la dernière version de l'agent dès qu'elle est disponible. Si vous ne pouvez pas effectuer la mise à niveau vers la dernière version, mettez à jour vos agents vers une version datant de moins de 90 jours. En savoir plus sur la façon de tenir les agents informés.

Consultez la politique EOL de l'agent Python de New Relic pour obtenir des informations sur la sortie de l'agent et les dates de support.