Configuration du capteur d' Java

En règle générale, Instana récupère automatiquement le nom de l'application à partir des sources suivantes :

• Fichier .jar d'application : dans ce .jar fichier, les attributs standard suivants sont disponibles META-INF/Manifest.MF:

  Implementation-Title=Demo App
  Implementation-Version=1.0.0
   

  En utilisant des outils de compilation, vous pouvez définir ces deux attributs lors de la compilation de l'application. Pour plus d'informations, consultez la documentation de Oracle.

• Ligne de commande : si le nom n'est pas disponible, la ligne de commande est utilisée pour le rechercher, de la même manière que les outils d' Java ation affichent les JVM.

• Propriétés système : si aucun nom n'est extrait du .jar fichier, Instana examine diverses propriétés système, par exemple -Dcatalina.home pour les conteneurs Tomcat.

Pour personnaliser le nom de l'application, utilisez l'une des options suivantes :

• Configurer le nom lors de l'initialisation d' JVM : pour définir explicitement le nom de l'application, spécifiez -Dcom.instana.agent.jvm.name="My Custom Name" l'attribut lors du démarrage d' JVM.

• Utiliser une propriété système existante : pour configurer l'agent afin qu'il utilise une propriété système personnalisée existante, indiquez une liste de propriétés dans le fichier de configuration.yaml l'agent. La première propriété existante s'appelle « JVM » :

com.instana.plugin.java:
  name-properties:
    - 'acme.app'
    - 'DEPLOYMENT'
 

Le object_name peut contenir des motifs avec caractères génériques, comme indiqué dans la documentation de l' Java ObjectName API.

L'exemple suivant illustre la configuration avec des motifs génériques :

com.instana.plugin.java:
  jmx:
    - object_name: 'kafka.*:type=*-metrics,client-id=*,*'
      metrics:
        - attributes: 'incoming-byte-rate'
          type: 'absolute'
        - attributes: 'incoming-byte-total'
          type: 'absolute'
        - attributes: 'outgoing-byte-rate'
          type: 'absolute'
        - attributes: 'outgoing-byte-total'
          type: 'absolute'
 

Dans le tableau de bord d' JVM, les indicateurs d' JMX s s'affichent sous la rubrique « Indicateurs d' JMX s personnalisés ».

Par défaut, l'instrumentation de trace d' Java est activée pour tous les processus Java. Vous pouvez la désactiver pour tous les processus ou pour un seul processus.

Vous pouvez désactiver certains plugins d'instrumentation afin de réduire la charge système ou d'exclure certaines technologies du traçage. Pour plus d'informations, consultez la section « Désactivation des plugins d'instrumentation ».

Pour activer la surveillance d' OpenTracing s de la trace d' Java, configurez le fichier de configuration.yaml l'agent comme suit :

com.instana.plugin.javatrace:
   instrumentation:
     opentracing: true
 

Pour désactiver l'instrumentation d' OpenTracing, définissez opentracing: false sur false.

Pour activer le SDK de traçage d' Java, configurez le fichier de configuration.yaml l'agent en fournissant une liste des paquets qui doivent être analysés pour l'annotation du SDK, comme suit. Par défaut, aucun package n'est analysé pour les annotations SDK.

com.instana.plugin.javatrace:
   instrumentation:
     sdk:
       packages:
         - 'com.instana.backend'
         - 'com.instana.frontend'
 

Pour désactiver le SDK de traçage d' Java, mettez en commentaire l'intégralité packages de la section.

Dans Kafka Streams, chaque opérateur de flux est capturé en tant qu'étendue intermédiaire. Cette fonction a un impact sur les performances de l'application si vous avez des flux de données importants. N'utilisez pas cette fonction dans les environnements de production.

Pour activer la capture des segments intermédiaires pour les flux d' Kafka, ajoutez les lignes suivantes à votre fichier configuration.yaml d'agent :

com.instana.plugin.javatrace:
   instrumentation:
    plugins:
     Kafka011StreamIntermediate: true
 

Vous pouvez activer la fonctionnalité permettant d'enregistrer chaque appel de service dans le serveur d'intégration d' WebMethods sous forme de segment intermédiaire. Mais si le serveur gère des charges de travail importantes, cette fonctionnalité peut avoir un impact sur les performances de votre application.

Pour activer la capture des appels de service internes pour le serveur d'intégration d' WebMethods, ajoutez les lignes suivantes au fichier de configuration del'agent ( YAML ) :

com.instana.plugin.javatrace:
   instrumentation:
     plugins:
       WebmethodsIntermediate: true
 

Pour éviter toute baisse de performances due à la création de segments intermédiaires lors de la capture des appels de service internes sur le serveur d' webMethods Integration, veillez à ajouter les lignes suivantes à votre fichier de configuration de l'agent ( YAML ), en plus de la configuration permettant la capture des appels de service internes :

com.instana.plugin.javatrace:
   instrumentation:
     enableIntermediateSpanOpt: true
     plugins:
       WebmethodsIntermediate: true
       enableIntermediateSpanOpt: true

Lorsque les consommateurs d' Kafka s récupèrent des messages, Instana génère généralement un seul élément « span » pour représenter l'ensemble de l'opération de sondage. Cela signifie que tous les messages récupérés au cours d'un même sondage sont regroupés sous une seule période de sondage, ce qui peut limiter la visibilité sur la manière dont chaque message est traité individuellement.

Pour améliorer la granularité de la traçabilité, l' Instana propose une option de configuration qui permet d'établir une corrélation pour chaque opération d'envoi et de réception, même lorsque les messages sont traités par lots. Cela permet de créer des intervalles distincts pour chaque message, offrant ainsi un aperçu plus détaillé du traitement au niveau des messages.

Cet instana.kafka.correlate.send.receive indicateur permet de visualiser les opérations effectuées lors du traitement individuel des enregistrements.

Quand ce drapeau est utile

Traitement des enregistrements individuels :

@KafkaListener(topics = "topicName", containerFactory = "kafkaListenerContainerFactory")
public void listen(ConsumerRecord<?, ?> record)
{
    // Process single record
    // DB operations, Kafka sends, etc.
}

Dans ce cas, cet indicateur permet de suivre les opérations d'enregistrement dans la base de données et les opérations d'envoi d' Kafka s qui ont lieu lors du traitement des enregistrements individuels.

Quand il n'est PAS recommandé d'utiliser ce drapeau

Traitement par lots avec des opérations groupées :

@KafkaListener(topics = "topicName")
public void receive(List<ConsumerRecord<?, ?>> consumerRecords) {
    // Direct bulk operations without iterating through individual records
}

Lorsque les enregistrements sont traités par lots et que des opérations en masse sont effectuées directement (comme les écritures en masse dans la base de données), cet indicateur n'apporte aucune valeur ajoutée et peut masquer les appels en aval dans la séquence POLL.

Recommandation pour le traitement par lots

Pour les cas d'utilisation impliquant un traitement par lots, vous pouvez désactiver cet indicateur en définissant une propriété système afin d'exclure l' JVM s en question au démarrage de l'application. Cette configuration garantit que les appels en aval restent visibles.

java -jar -Dcom.instana.kafka.correlate.send.receive=false app.jar

Considération importante concernant les modèles de traitement mixtes

Si votre application utilise à la fois des écouteurs par lots (traitement par lots) Kafka et des écouteurs standard (traitement enregistrement par enregistrement) Kafka, veuillez noter la restriction suivante concernant le instana.kafka.correlate.send.receive drapeau.

Lorsque l'indicateur est désactivé, les écouteurs d' Kafka s à enregistrement unique n'affichent plus le traitement sous forme de segments POLL individuels. Au lieu de cela, elles apparaissent sous la forme d'un seul segment POLL, tous les appels en aval étant regroupés sous ce segment, même si l'application traite les enregistrements individuellement.

Pour activer la corrélation inter- Kafka s, utilisez l'une des configurations suivantes :

• Configuration de l'agent : configurez le fichier de configuration.yaml l'agent.

  com.instana.tracing:  
    kafka:  
      correlateEverySendReceive: true # possible values: true or false

  Remarque :

  Redémarrez l'agent ou l'application après avoir modifié le fichier de configuration.yaml l'agent.

• Configuration des variables d'environnement : définissez la variable d'environnement comme indiqué dans l'exemple suivant :

  INSTANA_KAFKA_CORRELATE_SEND_RECEIVE=true # possible values: true or false

• Configuration des propriétés système : définissez la propriété suivante au démarrage de l' JVM :

  -Dcom.instana.kafka.correlate.send.receive=true # possible values: true or false 

Les images suivantes montrent comment se comporte la corrélation de portée lorsque cette configuration est activée ou désactivée.

Pour désactiver complètement la corrélation de plage d' Kafka s dans Instana, utilisez l'une des configurations suivantes :

• Configuration de l'agent:

  com.instana.tracing: 
    kafka: 
      correlateEverySendReceive: false 

• Configuration des variables d'environnement : définissez la variable d'environnement.

  INSTANA_KAFKA_CORRELATE_SEND_RECEIVE=false

• Configuration des propriétés du système : Indiquez cette option -Dcom.instana.kafka.correlate.send.receive=false lors du démarrage de l' JVM.

Ce instana.kafka.correlate.send.receive paramètre est désactivé par défaut afin d'éviter toute collecte inutile de données.

Pour configurer la corrélation des traces d' IBM Db2, utilisez l'une des options de configuration suivantes :

• Configuration de l'agent : configurez le fichier de configuration.yaml l'agent comme suit :

    com.instana.tracing:
      db2:
        trace-correlation: true
        db2CorrelationMode: dont-override
        db2CorrelationDelimiter: '|'
        db2CorrelationField: ClientHostname
   

• Configuration des variables d'environnement : définissez les variables d'environnement suivantes :

   INSTANA_DB2_TRACE_CORRELATION=true
   INSTANA_DB2_TRACE_CORRELATION_MODE=dont-override
   INSTANA_DB2_TRACE_CORRELATION_DELIMITER='|'
   INSTANA_DB2_TRACE_CORRELATION_FIELD=ClientHostname
   

• Configuration des propriétés système : définissez les propriétés système suivantes dans l' JVM instrumentée :

   -Djdbc.db2.correlation.enable=true
   -Djdbc.db2.correlation.mod=dont-override
   -Djdbc.db2.correlation.delimiter=|
   -Djdbc.db2.correlation.field=ClientHostname
   

Les appels aux composants EJB ( Java Bean) prennent en charge la corrélation entre les éléments d' WebLogic et T3.

Pour configurer la corrélation des traces d' WebLogics T3, utilisez l'une des options de configuration suivantes :

• Configuration de l'agent : configurez le fichier de configuration.yaml l'agent comme suit :

    # General Tracing Settings
    com.instana.tracing:
      weblogic:
        trace-correlation: true
   

• Configuration des variables d'environnement : définissez la variable d'environnement suivante :

  INSTANA_WEBLOGIC_EJB_TRACE_CORRELATION=true
   

• Configuration des propriétés système : définissez la propriété système suivante dans l' JVM instrumentée :

  -Dcom.instana.weblogic.ejb.trace.correlation=true
   

  Cette configuration ne fonctionne que si la communication « T3 » s'effectue entre des serveurs WebLogic. Toutefois, si le client WebLogic est utilisé en dehors du serveur WebLogic, la corrélation n'est pas possible.

• WeblogicRpcIntermediate: Pour activer la portée d'appel intermédiaire « RPC » (appel de procédure à distance) dans la trace d'appel d' WebLogic RPC, vous devez configurer le fichier de configuration.yaml l'agent comme suit. Lorsque vous activez la portée d'appel intermédiaire d' RPC, vous pouvez consulter les appels d' RPC au sein du même serveur d' WebLogic.

   com.instana.plugin.javatrace:
     instrumentation:
       enableIntermediateSpanOpt: true
       plugins:
         WeblogicRpcIntermediate: true

  WeblogicRpcIntermediate est désactivée par défaut afin d'éviter toute ingestion inutile de données.

  Pour éviter les problèmes de baisse de performances qui surviennent lorsque le système crée des segments intermédiaires, vous pouvez activer enableIntermediateSpanOpt.

Dans certains clients de consommation d' IBM MQ, la présence de données d'en-tête supplémentaires dans les messages d' IBM MQ peut entraîner des erreurs de traitement et le rejet des messages. Par conséquent, la corrélation des en-têtes de trace d' Instana n'est pas activée par défaut pour les applications IBM MQ Java.

Vous devez tester la corrélation des traces d' IBM MQ s dans un environnement hors production avant de l'activer dans un environnement de production. Si vous rencontrez des erreurs dans les applications client d' IBM MQ après avoir activé la corrélation des traces, procédez au dépannage comme suit :

• Si vous pouvez modifier l'application, mettez-la à jour afin qu'elle ignore les données supplémentaires de l'en-tête « IBM MQ » ajoutées par Instana. Pour obtenir de l'aide concernant les modifications à apporter au client d' IBM MQ, veuillez contacter le service d'assistance d' IBM MQ.
• Si vous ne pouvez pas modifier l'application, n 'activez pas la prise en charge de la corrélation des traces d' IBM MQ.

Pour activer la corrélation des traces pour l' IBM MQ, utilisez l'une des options de configuration suivantes :

• Configuration de l'agent : modifiez le fichier de configuration.yaml l'agent comme indiqué dans l'exemple suivant :

  # General Tracing Settings
  com.instana.tracing:
    ibm-mq:
      trace-correlation: true
      ibmmq-optin-queues-regexp: '^QueueName.*'
   

  Définissez la valeur de ibmmq-optin-queues-regexp l'expression régulière afin de filtrer les noms de files d'attente pour lesquels vous souhaitez activer la corrélation des traces. La valeur d'expression régulière est facultative et si elle est manquante, la corrélation de trace s'applique à toutes les files d'attente.

  Cette configuration est prise en compte dans l'un des scénarios suivants:

  • Au démarrage de la JVM
  • Lorsque le Tracer d' Java est mis à jour
  • Une fois que l'agent « Instana » a été arrêté pendant environ 15 minutes

  Il n'est pas rechargé à chaud lors de l'exécution. Un redémarrage rapide de l'agent peut ne pas prendre en compte ce changement de configuration car cette fonction est optimisée. Un changement de configuration nécessite une réinstrumentation complète.

• Configuration des propriétés système : vous pouvez également définir une propriété système sur les machines virtuelles Java (JVMs) de l'application hébergeant les clients d' IBM MQ, comme le montre l'exemple suivant :

  -Dinstana.ibm.mq.trace.correlation.enable=true -Dcom.instana.ibm.mq.trace.optin.queues="^QueueName.*"
   

Le capteur « IBM MQ » offre également une fonctionnalité de traçage via des exits utilisateur (traçage côté serveur pour IBM MQ ). Pour plus d'informations sur le capteur « IBM MQ », consultez la page « IBM MQ ».

Pour activer le format d'en-tête des en-têtes de corrélation de trace d' Kafka, utilisés par l'outil Java Tracer, utilisez l'une des options de configuration suivantes :

• Configuration de l'agent : configurez le fichier de configuration.yaml l'agent. Pour plus d'informations, consultez la section consacrée à l'agent hôte « Instana ».

• Configuration des variables d'environnement : définissez la variable d'environnement comme indiqué dans l'exemple suivant :

  INSTANA_KAFKA_HEADER_FORMAT= both # possible values: binary, both, string
   

  Les valeurs valides sont binary, string, ou both.

• Configuration des propriétés système : définissez la propriété suivante au démarrage de l' JVM :

  -Dcom.instana.kafka.trace.header.format=binary # possible values: binary, both, string
   

Pour désactiver complètement la corrélation des traces d' Kafka, utilisez l'une des options de configuration suivantes :

• Configuration de l'agent : voir l'agent hôte Instana.
• Configuration des variables d'environnement : définissez la variable d'environnement INSTANA_KAFKA_TRACE_CORRELATION=false, mais l'utilisation de cette option n'est pas recommandée.
• Configuration des propriétés du système : Indiquez cette option -Dcom.instana.kafka.trace.correlation=false lors du démarrage de l' JVM.

Pour plus d'informations, voir Kafka Header Migration.

Si vous désactivez le regroupement des segments, le nombre de segments individuels envoyés augmente, ce qui entraîne un volume de données plus important.

Pour désactiver le regroupement des balises span, utilisez l'une des options de configuration suivantes :

• Configuration de l'agent : Configurez le fichier de configuration de l'agent comme suit :

    com.instana.plugin.javatrace:
      instrumentation:
        spanBatchingEnabled: false
   

• Configuration des variables d'environnement : Définissez la variable d'environnement comme suit :

  INSTANA_SPANBATCHING_ENABLED=false
   

• Configuration des propriétés système : Définissez la propriété système dans l' JVM e instrumentée comme suit :

  -DspanBatchingEnabled=false
   

Le regroupement de segments intermédiaires entraîne la fusion du segment parent, ce qui rompt la relation parent-enfant et fait que les segments enfants apparaissent comme orphelins. La désactivation du traitement par lots pour les segments intermédiaires d' RPC permet d'éviter ce problème et de conserver une structure de trace correcte. Pour désactiver le regroupement des segments pour les segments intermédiaires WebLogic RPC, utilisez l'une des options de configuration suivantes :

• Configuration de l'agent : Configurez le fichier de configuration de l'agent (<agent_install_dir>/etc/instana/configuration.yaml) comme suit :

   com.instana.tracing:
     batching:
       disabled:
         - rpc-intermediate

• Configuration des variables d'environnement : Définissez la variable d'environnement comme suit :

  INSTANA_TRACING_BATCHING_DISABLED=rpc-intermediate

Des applications telles que Data Grid et JDBC mettent en œuvre les stratégies de regroupement personnalisées suivantes pour le regroupement par intervalle :

• Grille de données : les intervalles ne sont fusionnés que si et datagrid.cacheNamedatagrid.operation ont la même valeur dans des intervalles consécutifs. Le regroupement par tranchée n'est activé que si cette condition est remplie.

• JDBC : Les types de stratégies de regroupement de segments suivants sont pris en charge :

  • Traitement par lots par défaut (activé par défaut)

    Les intervalles sont fusionnés, quelle que soit la valeur des attributs d'intervalle de l'élément ` JDBC `.

  • Gestion personnalisée des lots (en option)

    Les intervalles ne sont fusionnés que si la valeur de JDBC.statement est identique dans les intervalles consécutifs.

La taille des données ingérées augmente si vous activez le regroupement personnalisé pour les segments d' JDBC.

Pour activer le regroupement personnalisé des segments d' JDBC, utilisez l'une des options de configuration suivantes :

• Configuration de l'agent : Configurez le fichier de configuration de l'agent comme suit :

    com.instana.plugin.javatrace:
      instrumentation:
        customJDBCSpanBatchingEnabled: true
   

• Configuration des variables d'environnement : Définissez les variables d'environnement comme suit :

  INSTANA_CUSTOM_JDBC_SPANBATCHING_ENABLED=true
   

• Configuration des propriétés système : Définissez la propriété système dans l' JVM e instrumentée comme suit :

  -DcustomJDBCSpanBatchingEnabled=true
   

La suppression des intervalles peut être configurée à l'aide des paramètres de configuration suivants :

• minspanduration: Ce paramètre définit la durée minimale d'un intervalle (par défaut : 4 ms). Toute longueur inférieure à cette valeur est ignorée.

  com.instana.plugin.javatrace:
    instrumentation:
      minspanduration: 1

• span-suppression-start: Ce paramètre définit le seuil de fréquence de balayage à partir duquel la suppression commence. Si le taux est inférieur à cette valeur, aucune portée n'est supprimée. Cependant, la suppression s'intensifie progressivement dès que le débit dépasse cette valeur, jusqu'à un maximum de 5 000 cycles par seconde (à partir duquel tous les cycles sont supprimés). Par exemple, si ce paramètre est défini sur 3000, la suppression ne commence que lorsque la fréquence de balayage dépasse 3 000 balayages par seconde.

  com.instana.plugin.javatrace:
    instrumentation:
      span-suppression-start: 3000

Pour configurer le niveau de journalisation, utilisez l'une des options de configuration suivantes :

• Configuration des propriétés système : définissez instana_log_level_capture sur ERROR ou WARN.
• Configuration des variables d'environnement : définissez-la INSTANA_LOG_LEVEL_CAPTURE sur ERROR ou WARN.

Si vous indiquez un niveau de journalisation non valide (par exemple, INFO ou TRACE), l'avertissement suivant est consigné dans les journaux de l'agent et le niveau de journalisation WARN par défaut est utilisé.

The value 'INFO' for 'INSTANA_LOG_LEVEL_CAPTURE' is not valid. Valid values are 'WARN', 'ERROR' and 'OFF'.
 

Pour désactiver la journalisation pour tous les modules de journalisation, vous pouvez utiliser l'une des options de configuration suivantes :

• Configuration de l'agent : configurez le traçage d' Java s afin de désactiver tous les plug-ins de journalisation dans le fichier d' configuration.yaml de l'agent :

      com.instana.plugin.javatrace:
        instrumentation:
          plugins:
            Logging: false
   

• Configuration des propriétés du système : Définir instana_log_level_capture="OFF".

• Configuration des variables d'environnement : Définir INSTANA_LOG_LEVEL_CAPTURE="OFF".

  Remarque : vous devez redémarrer l'agent ou l'application après avoir modifié le fichier ` configuration.yaml ` de l'agent.

Avant de configurer la fonctionnalité d'exclusion des points de terminaison, prenez connaissance des règles suivantes relatives au filtrage des segments :

• Lorsqu'une trace est ignorée, toutes les traces suivantes en aval sont également ignorées.
• Utilisez * pour ignorer tous les points de terminaison, méthodes ou commandes.
• Les valeurs des points de terminaison (telles que les noms de rubriques Kafka ou les commandes Redis ) restent identiques d'un service à l'autre.
• Les noms des méthodes peuvent varier en fonction du langage de programmation et de la technologie utilisés. Consultez l'interface utilisateur d' Instana pour déterminer la méthode et le point de terminaison appropriés pour votre service.

La capture d'écran suivante de l'interface utilisateur d' Instana fournit une référence visuelle permettant d'identifier la méthode et le point de terminaison appropriés pour la configuration :

La fonctionnalité permettant d'ignorer des points de terminaison ne fonctionne qu'avec des noms de méthode exacts. Assurez-vous d'utiliser le nom de méthode correct à filtrer.

Vous pouvez ignorer globalement les points de terminaison de tous vos services en les configurant via l'agent.

Pour configurer les points de terminaison à ignorer, indiquez les points de terminaison à exclure de la surveillance dans la com.instana.tracing.ignore-endpoints section de votre fichier de configuration de l'agent, comme le montre l'exemple suivant :

com.instana.tracing:
  ignore-endpoints:

    # Filtering by Method Name
    redis:
      - 'get'
      - 'type'
    dynamodb:
      - 'query'

    # Filtering by Method Name and Endpoint for Kafka
    kafka:
      - methods: ["consume"]
        endpoints: ["topic1", "topic2"]  # Exclude consume calls for topic1 and topic2
      - methods: ["consume", "publish"]
        endpoints: ["topic3"]  # Exclude both consume and send calls for topic3
      - methods: ["*"]
        endpoints: ["topic4"]  # Exclude all methods for topic4
      - methods: ["consume"]
        endpoints: ["*"]  # Exclude consume method for all topics

Dans l'exemple précédent, les traces suivantes sont ignorées pour les options de filtrage indiquées :

• Filtrer par méthode ( Redis et DynamoDB )

  • GET et TYPE les commandes dans Redis
  • QUERY commande dans l' DynamoDB

• Filtrage par méthode et paramètre d'évaluation (uniquement pour Kafka )

  • CONSUME méthode pour topic1 et topic2 dans Kafka et toutes les traces en aval
  • CONSUME et PUBLISH les méthodes pour topic3 l'in Kafka, ainsi que toutes les traces en aval
  • Toutes les méthodes (*) pour topic4 dans Kafka et toutes les traces en aval
  • CONSUME méthode pour tous les sujets (*) et toutes les traces en aval

Vous pouvez configurer les points de terminaison à ignorer en utilisant la variable INSTANA_IGNORE_ENDPOINTS d'environnement pour filtrer les points de terminaison par service.

Grâce à cette variable d'environnement, vous pouvez exclure des traces en fonction des méthodes et des points de terminaison.

INSTANA_IGNORE_ENDPOINTS=redis:get,type;dynamodb:query,scan;kafka:publish,consume

Cette configuration filtre les traces suivantes :

• GET et TYPE les commandes dans Redis
• QUERY et SCAN les commandes dans DynamoDB
• PUBLISH et CONSUME les méthodes de l'interface « Kafka » pour tous les points de terminaison

Dans le fichier ` Kafka `, vous pouvez définir des variables d'environnement pour ignorer certains points de terminaison, mais vous ne pouvez spécifier qu'un seul point de terminaison et une seule méthode à la fois.

INSTANA_IGNORE_ENDPOINTS=kafka:topic1,topic2,topic3,topic4,topic5,topic6,topic7,topic8,topic9,topic10,topic11

Pour Kafka, contrairement à Redis et DynamoDB,, la liste des points de terminaison n'est pas limitée à 10. Vous devez donc bien réfléchir à la taille de la liste, car cela peut avoir une incidence sur les performances.

En utilisant les options de méthode pour ` Kafka `, configurez la variable d'environnement comme suit :

INSTANA_IGNORE_ENDPOINTS=kafka:consume,publish
OR
INSTANA_IGNORE_ENDPOINTS=kafka:poll,send
OR
INSTANA_IGNORE_ENDPOINTS=kafka:*

Vous pouvez également utiliser la propriété système ` Java ` pour configurer les points de terminaison à ignorer. L'exemple suivant montre comment configurer des points de terminaison à ignorer à l'aide des propriétés système :

java -Dinstana.ignore-endpoints="redis:get,type;dynamodb:query,scan;kafka:publish,consume" -jar application-jar

Pour l' Kafka e, vous pouvez utiliser la propriété système permettant d'ignorer des points de terminaison, mais une seule méthode et un seul point de terminaison peuvent être spécifiés à la fois.

java -Dinstana.ignore-endpoints="kafka:topic1,topic2,topic3,topic4,topic5,topic6,topic7,topic8,topic9,topic10,topic11" -jar application-jar

Pour Kafka, contrairement à Redis et DynamoDB,, la liste des points de terminaison n'est pas limitée à 10. Vous devez donc bien réfléchir à la taille de la liste, car cela peut avoir une incidence sur les performances.

En utilisant les options de méthode pour ` Kafka `, configurez la propriété système comme suit :

java -Dinstana.ignore-endpoints="kafka:consume,publish" -jar application-jar
OR
java -Dinstana.ignore-endpoints="kafka:poll,send" -jar application-jar
OR
java -Dinstana.ignore-endpoints="kafka:*" -jar application-jar

Par défaut, vous pouvez ajouter jusqu'à 10 annotations à un segment et les afficher dans l'interface utilisateur d' Instana.

Définissez la configuration suivante dans le fichier de configuration de l'agent :

com.instana.tracing:
  stack.capture.timing: error

Comportement : ne capture les traces de pile que pour les segments présentant des erreurs (c'est-à-dire ceux dont les métadonnées contiennent des erreurs), ce qui améliore les performances et réduit le volume de données ingérées en excluant les traces de pile des segments réussis.

Définissez et exportez la variable d'environnement INSTANA_TRACING_STACK_CAPTURE_TIMING dans votre environnement comme suit :

export INSTANA_TRACING_STACK_CAPTURE_TIMING=error

Définissez la propriété suivante :

-Dcom.instana.tracing.stack.capture.timing=error 

Pour utiliser cette propriété système, vous devez ajouter l'argument suivant lors du lancement de l'application :

java -Dcom.instana.tracing.stack.capture.timing=error -jar application.jar