Kafka ヘッダーのマイグレーション

このフェーズでは、トレーサーはデフォルトでバイナリヘッダ'X_INSTANA_Cと'X_INSTANA_L送信する。

バイナリー・ヘッダーの代わりにストリング・ヘッダーを送信することも、両方のヘッダー・セットを送信することもできます。 詳しくは、 構成オプションを参照してください。

メッセージが受信されると、トレーサーは両方のヘッダー・セットを検索し、両方のヘッダー・フォーマットからトレースを続行できます。

このフェーズは、 フェーズ 1の開始で終了しました。

現時点では、すべてのトレーサーは、デフォルトでバイナリと文字列の両方のヘッダーを送信します。つまり、'X_INSTANA_Cと 'X_INSTANA_Lと 'X_INSTANA_Tと 'X_INSTANA_S です。 この移行フェーズにより、トレーサーを IT インフラストラクチャー全体にわたって段階的にアップグレードすることができます。

Instana ヘッダーが2つではなく4つ付加されることを懸念される場合は、メッセージヘッダーのオーバーヘッドを最適化するために、以下の移行戦略を適用することができます：

1. Kafka メッセージを送信するすべてのサービスがバイナリー・ヘッダーのみを送信するように構成します。 構成オプションを参照してください。
2. 2023 年 9 月より前のある時点で、すべてのトレーサーが、両方のヘッダー・フォーマットをサポートする バージョン にアップグレードされていることを確認してください。
3. Kafka メッセージを送信するすべてのサービスが string ヘッダーのみを送信するように構成します。 構成オプションを参照してください。 この設定を使用すると、サービスは進行中のマイグレーションの影響を受けなくなります。
4. すべてのトレーサーがフェーズ 2 バージョンにアップグレードされた後、ヘッダー・フォーマットの構成を削除できます。 ただし、構成がそのままになっていても無視されます。

また、すべてのトレーサーが既に新しい バージョン にアップグレードされている場合は、ステップ 1 をスキップして、新しいヘッダー・フォーマットを直接使用することもできます。

このフェーズは、約 2023 年 9 月に開始します。

このフェーズから、 Instana のトレーサーは、デフォルトで従来のバイナリヘッダー形式から新しい文字列ヘッダー形式への送信に切り替わります。 ヘッダー形式の構成 (存在する場合) は無視されます。 これは、マイグレーションの最終フェーズです。

com.instana.tracing.kafka.header-format を binary、 string、または bothに設定します。 以下は、構成例を示しています。

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

Kafka メッセージへのヘッダーの注入を完全に無効にするオプションが提供されています。 以下の設定例を参照してください。

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

• モニター対象プロセスに環境変数 INSTANA_KAFKA_HEADER_FORMAT を設定します。 環境変数の有効な値は、 binary、 string、または bothです。
• Kafka メッセージへのヘッダーの注入を完全に無効にするオプションも用意されています。 これにより、 Kafkaのトレース相関も無効になります。 この設定は INSTANA_KAFKA_TRACE_CORRELATION=falseです。

レガシーモードでは、Kafkaメッセージのトレース相関は、バイナリコンテンツを持つ2つのヘッダー'X_INSTANA_Cと'X_INSTANA_Lを使用します。

マイグレーション後、またはストリング・ヘッダーを送信するように構成した場合、 Kafka メッセージのトレース相関は、ヘッダー X_INSTANA_T、 X_INSTANA_S (およびオプションで X_INSTANA_L_S) を使用します。 3 つのヘッダーはすべて、ストリング値とともに送信されます。