Kafka Migration des en-têtes

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

Il est possible d'envoyer des en-têtes de chaîne au lieu d'en-têtes binaires, ou d'envoyer les deux ensembles d'en-têtes. 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 sont en mesure de poursuivre une trace à partir des deux formats d'en-têtes.

Cette phase a pris fin 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 de mettre progressivement à niveau les traceurs dans l'ensemble de votre infrastructure informatique.

Si vous êtes préoccupé par le fait que quatre en-têtes Instana soient attachés au lieu de deux, vous pouvez appliquer la stratégie de migration suivante pour optimiser la surcharge des en-têtes de message :

1. Configurez tous les services qui envoient des messages Kafka pour qu'ils n'envoient que des en-têtes binaires. Voir les options de configuration.
2. Avant septembre 2023, veillez à ce que tous les traceurs soient mis à jour vers une version prenant en charge les deux formats d'en-tête.
3. Configurez tous les services qui envoient des messages Kafka pour qu'ils n'envoient que des en-têtes de chaîne. Voir les 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 sont passés à 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 sauter l'étape 1 et utiliser directement le nouveau format d'en-tête, si tous les traceurs ont déjà été mis à jour vers une version suffisamment récente.

Cette phase débutera approximativement en septembre 2023.

À partir de cette phase, les traceurs Instana passeront de l'ancien format d'en-tête binaire au nouveau format d'en-tête de chaîne par défaut. La configuration du format de l'en-tête (si elle existe) sera ignorée. Il s'agit de la phase finale de la migration.

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

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

Une option permet de désactiver complètement l'injection d'en-têtes dans les messages Kafka. Voir l'exemple de paramétrage suivant :

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

• Définir la variable d'environnement INSTANA_KAFKA_HEADER_FORMAT sur le processus surveillé. Les valeurs valables pour la variable d'environnement sont binary, string, ou both.
• Une option permet également de désactiver complètement l'injection d'en-têtes dans les messages Kafka. Cela désactivera également la corrélation des traces pour Kafka. Le réglage est le suivant : 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.