Migration de l'en-tête Kafka

Dans cette phase, les traceurs n'envoient par défaut que les en-têtes binaires " X_INSTANA_C et " X_INSTANA_L

L'envoi d'en-têtes de chaîne au lieu d'en-têtes binaires ou l'envoi des deux ensembles d'en-têtes est possible. Pour plus d'informations, voir Options de configuration.

Lorsqu'un message est reçu, les traceurs recherchent les deux ensembles d'en-têtes et peuvent continuer une trace à partir des deux formats d'en-tête.

Cette phase s'est terminée avec le début de la phase 1.

Actuellement, tous les traceurs envoient par défaut des en-têtes binaires et des en-têtes de chaîne, c'est-à-dire " X_INSTANA_C et " X_INSTANA_L ainsi que " X_INSTANA_T et " X_INSTANA_S. Cette phase de transition permet aux traceurs d'être progressivement mis à niveau dans l'ensemble de votre infrastructure informatique.

Si le fait d'avoir quatre en-têtes « Instana » au lieu de deux vous préoccupe, vous pouvez appliquer la stratégie de migration suivante pour optimiser la charge liée aux en-têtes de message :

1. Configurez tous les services qui envoient un message Kafka pour envoyer uniquement des en-têtes binaires. Voir Options de configuration.
2. Avant le mois de septembre 2023, assurez-vous que tous les traceurs sont mis à niveau vers une version prenant en charge les deux formats d'en-tête.
3. Configurez tous les services qui envoient un message Kafka pour envoyer uniquement des en-têtes string . Voir Options de configuration. En utilisant ce paramètre, les services ne sont plus affectés par la migration en cours.
4. Une fois que tous les traceurs ont été mis à niveau vers une version de phase 2, la configuration du format d'en-tête peut être supprimée. Mais même si la configuration reste en place, elle sera ignorée.

Vous pouvez également ignorer l'étape 1 et utiliser directement le nouveau format d'en-tête si tous les traceurs ont déjà été mis à niveau vers une version qui est suffisamment nouvelle.

Cette phase commencera approximativement en septembre 2023.

À partir de cette phase, les traceurs d' Instana passeront par défaut de l'envoi du format d'en-tête binaire hérité au nouveau format d'en-tête sous forme de chaîne de caractères. La configuration du format d'en-tête (le cas échéant) sera ignorée. Il s'agit de la phase finale de la migration.

Définissez com.instana.tracing.kafka.header-format sur binary, stringou both. Voici un exemple de configuration :

com.instana.tracing:
  kafka:
    header-format: both # possible values: binary, both, string

Une option est fournie pour désactiver complètement l'injection d'en-têtes dans les messages Kafka . Consultez les exemples de paramètres suivants:

com.instana.tracing:
  kafka:
    trace-correlation: false

• Définissez la variable d'environnement INSTANA_KAFKA_HEADER_FORMAT sur le processus surveillé. Les valeurs admises pour la variable d'environnement sont binary, stringou both.
• Une option est également fournie pour désactiver complètement l'injection d'en-têtes dans les messages Kafka . Cela désactive également la corrélation de trace pour Kafka. Le paramètre correspondant est INSTANA_KAFKA_TRACE_CORRELATION=false.

En mode hérité, la corrélation des traces pour les messages Kafka utilise les deux en-têtes " X_INSTANA_C et " X_INSTANA_L, avec un contenu binaire.

Après la migration ou lorsque vous configurez l'envoi d'en-têtes de chaîne, la corrélation de trace pour le message Kafka utilise les en-têtes X_INSTANA_T, X_INSTANA_S (et éventuellement X_INSTANA_L_S). Les trois en-têtes sont envoyés avec des valeurs de chaîne.