Désactiver l'instrumentation Scala, Netty, Akka et Play 2

Ce document décrit comment désactiver Java instrumentation d'agent sur ces frameworks asynchrones populaires :

• Scala
• Netty
• Akka
• Play 2

Vous pouvez choisir de désactiver une partie ou la totalité de cette instrumentation si vous constatez que les mesures rapportées ne vous sont pas utiles ou si l'instrumentation entraîne plus de frais généraux que vous ne le souhaiteriez. Si vous désactivez de manière sélective une partie de l'instrumentation, certains segments d'activité ne seront pas signalés et votre temps total sera sous-estimé.

Versions d'agent Java 3.21 ou inférieures

Si vous utilisez l'agent Java version 3.22 ou inférieure, ajoutez ce qui suit à la section class_transformer de vos paramètres newrelic.yml :

# This section is for settings common to all environments.
# Do not add anything above this next line.
common: &default_settings

  class_transformer: 
    akka_instrumentation:
      enabled: false
    netty_instrumenation:
      enabled: false
    play2_instrumentation:
      enabled: false
    scala_instrumentation:
      enabled: false

Versions d'agent Java 3.22 ou supérieures

Les anciens noms des frameworks de configuration d'instrumentation Scala, Netty, Akka et Play 2 sont obsolètes dans l'agent Java version 3.22 . Si vous utilisez l'agent Java 3.22 ou supérieur, ajoutez ce qui suit à la section class_transformer de vos paramètres newrelic.yml :

common: &default_settings

  class_transformer:
    # Disable all Akka instrumentations
    com.newrelic.instrumentation.akka-2.0:
      enabled: false
    com.newrelic.instrumentation.akka-2.1:
      enabled: false
    # Disabling 2.2 also disables higher versions
    com.newrelic.instrumentation.akka-2.2:
      enabled: false

    # Disable all Netty instrumentations
    com.newrelic.instrumentation.netty-3.4:
      enabled: false
    com.newrelic.instrumentation.netty-3.8:
      enabled: false
    com.newrelic.instrumentation.netty-4.0.0:
      enabled: false
    com.newrelic.instrumentation.netty-4.0.8:
      enabled: false

    # Disable all Play 2 instrumentations
    com.newrelic.instrumentation.play-2.1:
      enabled: false
    com.newrelic.instrumentation.play-2.2:
      enabled: false
    com.newrelic.instrumentation.play-2.3:
      enabled: false
    # New in Release 3.22, the Play 2.4 instrumentation does not respect
    # the older play2_instrumentation configuration setting 
    com.newrelic.instrumentation.play-2.4:
      enabled: false

    # Disable all Scala-language instrumentations
    com.newrelic.instrumentation.scala-2.9.3:
      enabled: false

Les noms instrumentation antérieurs à la version 3.22 seront respectés pendant un certain temps, mais ils seront supprimés lors des prochaines sorties. Si elle est désactivée par l'ancienne ou la nouvelle configuration d'instrumentation, l'instrumentation sera désactivée.

Rechercher les paramètres de configuration obsolètes

Toute utilisation des noms instrumentation antérieurs à la version 3.22 sera enregistrée avec des messages similaires à :

INFO: Using deprecated configuration setting akka_instrumentation for instrumentation com.newrelic.instrumentation.akka-2.2

OU

INFO: The configuration setting akka_instrumentation is deprecated, please update the class_transformer config to use com.newrelic.instrumentation.akka-2.2 instead

L'utilisation des paramètres obsolètes n'indique pas que l'instrumentation obsolète a été chargée ou est en cours d'utilisation. Ces messages indiquent à l'utilisateur qu'il est temps de mettre à jour vos paramètres de configuration.

Play 2.4 ne respecte pas les anciens paramètres de configuration play2_instrumentation, car il s'agit d'une nouvelle instrumentation. Dans tous les cas, si vous utilisez agent Java version 3.22 ou supérieure, vous devez utiliser les nouveaux instrumentation noms pour les frameworks Scala Netty, Akka, et Play 2 dans leur newrelic.yml.