Langfuse SDK と Alibaba Cloud Python エージェントの両方を使用する必要がある場合があります。どちらも OpenTelemetry 拡張機能を基盤としているため、競合が発生する可能性があります。このトピックでは、構成を使用して Langfuse SDK が収集するデータを Alibaba Cloud Python エージェントが収集するデータから分離する方法について説明します。
1. Langfuse の初期化
最初に、グローバル Langfuse インスタンスを初期化します。次に、インスタンス内の TracerProvider オブジェクトを専用の TracerProvider に置き換えます。以下の例をご参照ください。
from langfuse import Langfuse
from opentelemetry.sdk.trace import TracerProvider
# 専用の TracerProvider を初期化します
langfuse_trace_provider = TracerProvider()
langfuse = Langfuse(
# 実際のパブリックキーとシークレットキーに置き換えてください
public_key="your_public_key",
secret_key="your_secret_key",
tracer_provider=langfuse_trace_provider,
# 実際のインジェストエンドポイントに置き換えてください
host="https://cloud.langfuse.com",
tracing_enabled=True
)2. OpenTelemetry API 互換性フラグの無効化
OTEL_PYTHON_DISABLED_INSTRUMENTATIONS 環境変数を otelapi に設定します。これにより、エージェントの実行パスが Langfuse から完全に分離されます。
この環境変数を設定すると、OpenTelemetry API のインストルメンテーションが無効になります。その結果、trace.get_current_span() の呼び出しは無効なスパンを返し、戻り値が 00000000000000000000000000000000 であるため、有効な トレース ID を取得できません。コード内で トレース ID と スパン ID を取得するには、以下の例に示すように、Alibaba Cloud がカスタマイズした OpenTelemetry Python SDK を使用できます。
from aliyun.opentelemetry import trace
span = trace.get_current_span()
ctx = span.get_span_context()
trace_id = format(ctx.trace_id, "032x")
span_id = format(ctx.span_id, "016x")3. Alibaba Cloud Python エージェントの統合
上記の手順を完了したら、アプリケーションモニタリング を参照し、Alibaba Cloud Python エージェントに適した接続タイプを選択します。