Paramètres du traceur de transaction de l’agent Java

Le traceur de transaction est activé par défaut. Réglez ceci sur false pour le désactiver.

Détermine si l'agent capturera le plan EXPLAIN pour la requête lente. Uniquement pris en charge pour MySQL et PostgreSQL.

seuil en secondes pour le temps d'exécution de la requête en dessous duquel la lente de la requête et le plan EXPLAIN (si supporté) ne seront pas capturés. Concerne la requête lente uniquement lorsque record_sql est défini sur raw ou obfuscated. Concerne les plans EXPLAIN uniquement lorsque explain_enabled est défini sur true.

Pour les requêtes SQL volumineuses, l'exécution des expressions régulières qui tentent d'analyser les instructions exec et call peut prendre un temps considérable. Définir cette option sur « vrai » désactivera l'exécution de ces expressions régulières complexes.

Cette configuration existe dans la version 8.25.0 et suivantes de l'agent Java.

La limite de caractères pour la chaîne de requête SQL. Si vous avez de nombreuses requêtes SQL lentes avec de gros morceaux d'informations, cela pourrait affecter négativement les performances ou la rapidité avec laquelle vous voyez vos données dans New Relic. Augmentez progressivement la valeur jusqu’à trouver le bon équilibre entre informations et performances.

Définissez sur true pour activer le logging de la requête dans le agent fichier de au log lieu du téléchargement vers New Relic. les requêtes sont enregistrées en utilisant le mode record_sql .

Lorsque le traceur de transaction est activé, les instructions de requête peuvent éventuellement être enregistrées. L'enregistreur dispose de trois modes :

• off: N'envoyez aucune requête.
• raw: Envoyez l'instruction de requête dans sa forme originale.
• obfuscated: Supprime les littéraux numériques et les chaînes.

Contrôle l'ajout de commentaires au début des instructions SQL exécutées, utilisés par le produit New Relic Query Performance Monitoring pour la liaison d'entités. La valeur par défaut est false.

Un commentaire résultant ressemblerait à ceci : /nr_service_guid=MTE3NDc2MDB8QVBNfAAAAAxJQEEEEE9OfDI4MTc5NDEIEA/

Cette option est réservée à Play 2.x+ uniquement. L'instrumentation Play/Scala peut utiliser Thread.getStackTrace() pour améliorer la dénomination du traceur, mais au prix d'une surcharge accrue.

Définit un seuil (en secondes) pour collecter la trace d'appels d'un appel SQL. Lorsque les instructions SQL dépassent ce seuil, l'agent capturera la trace d'appels en cours. Cela est utile pour identifier l’origine des appels SQL longs.

Utilisez ce paramètre pour contrôler la variété de votre trace de transaction. top_n est un entier qui représente le nombre de transactions uniques et lentes pour lesquelles une trace sera créée.

• Si vous souhaitez que les traces de transaction reflètent plus précisément les transactions réellement les plus lentes de votre application, rendez cette valeur plus basse.

• Si vous souhaitez échantillonner un éventail plus diversifié de transactions, rendez la valeur plus élevée.

  Une valeur de 0 signifierait que seule la transaction la plus lente génère toujours une trace. Cependant, cela n'est pas considéré comme optimal, car vous pouvez avoir une ou deux transactions qui sont toujours les plus lentes, et voir de façon répétée ces mêmes traces de transaction ne vous apportera probablement pas beaucoup de valeur.

  Si la même transaction est souvent la plus lente, le paramètre top_n permet à l'agent Java (au fil du temps) d'échantillonner les transactions n les plus lentes. Cela vous donne une plus grande variété et des informations plus détaillées dans votre application.

Le seuil de temps utilisé pour déterminer quand une transaction est éligible pour être tracée. Lorsque le temps de réponse de la transaction dépasse ce seuil, la transaction devient éligible pour une trace de transaction. Si elle est échantillonnée, cette trace de transaction sera enregistrée et envoyée à New Relic.

La valeur par défaut est apdex_f (par défaut), ce qui définit le seuil sur le niveau Apdex « Frustré » (quatre fois la apdex_t valeur ). Vous pouvez également définir un seuil de temps spécifique en saisissant une valeur de virgule flottante qui représente un nombre de secondes.

Par défaut, le mode haute sécurité ne permet pas à l'agent de collecter les requêtes lentes. Activez cette option pour collecter les requêtes Cassandra du pilote DataStax, même avec une sécurité élevée activée. Si vous n'utilisez pas une sécurité élevée, l'agent collecte automatiquement les requêtes lentes.

Pour le pilote DataStax 2.1.2, ajoutez cette règle à votre liste de domaines autorisés :

transaction_tracer:
  slow_query_whitelist:
    'com.newrelic.instrumentation.cassandra-datastax-2.1.2'

Pour le pilote DataStax 3.0.0, ajoutez cette règle à votre liste de domaines autorisés :

transaction_tracer:
  slow_query_whitelist:
    'com.newrelic.instrumentation.cassandra-datastax-3.0.0'

Par défaut, le mode haute sécurité ne permet pas à l'agent de collecter les requêtes lentes. Activez cette option pour collecter les requêtes Cassandra du pilote DataStax, même avec une sécurité élevée activée. Si vous n'utilisez pas une sécurité élevée, l'agent collecte automatiquement les requêtes lentes.

Pour le pilote DataStax 2.1.2, ajoutez cette règle à votre liste de domaines autorisés :

transaction_tracer:
  collect_slow_queries_from:
    'com.newrelic.instrumentation.cassandra-datastax-2.1.2'

Pour le pilote DataStax 3.0.0, ajoutez cette règle à votre liste de domaines autorisés :

transaction_tracer:
  collect_slow_queries_from:
    'com.newrelic.instrumentation.cassandra-datastax-3.0.0'

Ce paramètre peut être utilisé pour activer ou désactiver tous les attributs de suivi de transaction. Si attributes.enabled au niveau racine est false, aucun attribut ne sera envoyé pour tracer la transaction, quelle que soit la manière dont cette propriété (transaction_tracer.attributes.enabled) est définie.

Si les attributs sont activés pour le suivi de transaction, toutes les clés d'attribut trouvées dans cette liste seront envoyées à New Relic dans le suivi de transaction. Pour plus d'informations, consultez les règles d'attribut de l'agent.

Toutes les clés d'attribut trouvées dans cette liste ne seront pas envoyées à New Relic lors de la trace de la transaction. Pour plus d'informations, consultez les règles d'attribut de l'agent.

Limite le nombre de jetons pouvant être créés par transaction. L’augmentation de cette valeur peut avoir un impact sur les performances, car elle augmente la quantité de mémoire utilisée par l’agent et la quantité de données envoyées à New Relic.

Limite le nombre de segments pouvant être créés par transaction. L’augmentation de cette valeur peut avoir un impact sur les performances, car elle augmente la quantité de mémoire utilisée par l’agent et la quantité de données envoyées à New Relic.

Activez le service transaction événement.

Le nombre maximal d'événements de transaction échantillonnés signalés toutes les 60 secondes.

Une liste de cartes avec les clés appariées header_name et l'optionnelle header_alias. Choisissez un ou plusieurs en-têtes de requête HTTP personnalisés à ajouter comme attribut de transaction.

Vous pouvez répertorier plusieurs configurations d’en-tête :

transaction_events:
  custom_request_headers:
    -
      header_name: "X-Custom-Header-1"
    -
      header_name: "X-Custom-Header-2"
      header_alias: "CustomHeader2alias"

Dans le premier ensemble de cartes, X-Custom-Header-1 est capturé et signalé par l'agent comme nom d'en-tête pour une valeur correspondante de l'objet de demande. Le header_name sera également le nom de l'attribut envoyé à New Relic.

Dans le deuxième ensemble de cartes, l'en-tête de la requête est X-Custom-Header-2, mais CustomHeader2alias est le nom envoyé à New Relic.

Ce paramètre peut être utilisé pour activer ou désactiver tous les attributs d'un événement de transaction. Si attributes.enabled est false au niveau racine, alors aucun attribut ne sera envoyé à l'événement de transaction, quelle que soit la manière dont cette propriété est définie sous transaction_events.

Si les attributs sont activés pour l'événement de transaction, toutes les clés d'attribut trouvées dans cette liste seront envoyées à New Relic dans l'événement de transaction. Pour plus d'informations, consultez les règles d'attribut de l'agent.

Toutes les clés d'attribut trouvées dans cette liste ne seront pas envoyées à New Relic dans l'événement de transaction. Pour plus d'informations, consultez les règles d'attribut de l'agent.

Ce paramètre peut être utilisé pour activer ou désactiver tous les attributs des segments de transaction. Si attributes.enabled au niveau racine est false, aucun attribut ne sera envoyé aux segments de transaction, quelle que soit la manière dont cette propriété (transaction_segments.attributes.enabled) est définie.

Si les attributs sont activés pour les segments de transaction, toutes les clés d'attribut trouvées dans cette liste seront envoyées à New Relic dans les segments de transaction. Pour plus d'informations, consultez les règles d'attribut de l'agent.

Toutes les clés d’attribut trouvées dans cette liste ne seront pas envoyées à New Relic dans les segments de transaction. Pour plus d'informations, consultez les règles d'attribut de l'agent.

Ajoute des propriétés de message à l'attribut traceur. Réglez ceci sur false pour le désactiver.