OpenTelemetryによるオブザーバビリティ

Qwen CodeでOpenTelemetryを有効化し、セットアップする方法について説明します。

OpenTelemetryによるオブザーバビリティ

移行に関する注意事項

tool_output_truncated は名前空間の一貫性のため qwen-code.tool_output_truncated に改名されました。古い名前でフィルタリングしているダウンストリームの利用者はクエリを更新する必要があります。
tool.call.latency ヒストグラムのドキュメントには以前 decision 属性が記載されていましたが、これはヒストグラムに設定されたことはありません（function_name のみが記録されます）。tool.call.count カウンターには引き続き decision が含まれます。
qwen-code.file_operation ログイベントと file.operation.count メトリクスのドキュメントには以前 diff-stat属性（model_added_lines, model_removed_lines, user_added_lines, user_removed_lines）が記載されていましたが、これらも設定されたことはありません。diff-statデータは tool_call ログイベントの metadata 属性から利用可能です。

主な利点

🔍 利用状況分析: チーム全体のインタラクションパターンと機能の採用状況を把握できます
⚡ パフォーマンスモニタリング: 応答時間、トークン消費量、リソース使用率を追跡できます
🐛 リアルタイムデバッグ: ボトルネック、障害、エラーパターンを発生時に特定できます
📊 ワークフローの最適化: 設定とプロセスを改善するための情報に基づいた意思決定を行えます
🏢 エンタープライズガバナンス: チーム間の利用状況を監視し、コストを追跡し、コンプライアンスを確保し、既存のモニタリングインフラと統合できます

OpenTelemetryとの統合

ベンダーニュートラルで業界標準のオブザーバビリティフレームワークである OpenTelemetry をベースに、Qwen Codeのオブザーバビリティシステムは以下を提供します:

普遍的な互換性: OpenTelemetryバックエンド（Aliyun、Jaeger、Prometheus、Datadogなど）にエクスポート可能
標準化されたデータ: ツールチェーン全体で一貫した形式と収集方法を使用可能
将来にわたる統合: 既存および将来のオブザーバビリティインフラと接続可能
ベンダーロックインなし: 計装を変更せずにバックエンドを切り替え可能

設定

すべてのTelemetryの動作は .qwen/settings.json ファイルを通じて制御されます。これらの設定は環境変数またはCLIフラグでオーバーライドできます。

Setting	Environment Variable	CLI Flag	Description	Values	Default
`enabled`	`QWEN_TELEMETRY_ENABLED`	`--telemetry` / `--no-telemetry`	Telemetryの有効化または無効化	`true`/`false`	`false`
`target`	`QWEN_TELEMETRY_TARGET`	`--telemetry-target <local\|gcp>` (deprecated)	情報提供用の宛先ラベル。エクスポートルーティングは制御しません。データ送信先を設定するには `otlpEndpoint` または `outfile` を設定してください	`"gcp"`/`"local"`	`"local"`
`otlpEndpoint`	`QWEN_TELEMETRY_OTLP_ENDPOINT`	`--telemetry-otlp-endpoint <URL>`	OTLPコレクターエンドポイント	URL string	`http://localhost:4317`
`otlpProtocol`	`QWEN_TELEMETRY_OTLP_PROTOCOL`	`--telemetry-otlp-protocol <grpc\|http>`	OTLPトランスポートプロトコル	`"grpc"`/`"http"`	`"grpc"`
`otlpTracesEndpoint`	`QWEN_TELEMETRY_OTLP_TRACES_ENDPOINT`	-	トレース用のシグナル別エンドポイントオーバーライド（HTTPのみ）	URL string	-
`otlpLogsEndpoint`	`QWEN_TELEMETRY_OTLP_LOGS_ENDPOINT`	-	ログ用のシグナル別エンドポイントオーバーライド（HTTPのみ）	URL string	-
`otlpMetricsEndpoint`	`QWEN_TELEMETRY_OTLP_METRICS_ENDPOINT`	-	メトリクス用のシグナル別エンドポイントオーバーライド（HTTPのみ）	URL string	-
`outfile`	`QWEN_TELEMETRY_OUTFILE`	`--telemetry-outfile <path>`	Telemetryをファイルに保存（OTLPエクスポートをオーバーライド）	file path	-
`logPrompts`	`QWEN_TELEMETRY_LOG_PROMPTS`	`--telemetry-log-prompts` / `--no-telemetry-log-prompts`	Telemetryログにプロンプトを含める	`true`/`false`	`true`
`userId`	`QWEN_TELEMETRY_USER_ID`	-	ARMS拡張の `gen_ai.user.id` としてGenAIスパンに書き込まれる安定したエンドユーザー識別子。仮名値を推奨します	string	-
`includeSensitiveSpanAttributes`	`QWEN_TELEMETRY_INCLUDE_SENSITIVE_SPAN_ATTRIBUTES`	-	標準GenAIメッセージ、指示、ツール定義、ツール引数、および成功したツール結果をネイティブスパン属性として含める	`true`/`false`	`false`
`sensitiveSpanAttributeMaxLength`	`QWEN_TELEMETRY_SENSITIVE_SPAN_ATTRIBUTE_MAX_LENGTH`	-	各センシティブなネイティブスパン属性の最大コンパクトJSON文字列長。バックエンドが大きな属性を拒否する場合は低く設定してください	`1..104857600`	`1048576`
`resourceAttributes`	`OTEL_RESOURCE_ATTRIBUTES` (+ `OTEL_SERVICE_NAME`)	-	エクスポートされるすべてのスパン/ログ/メトリクスに付加される静的リソース属性。以下のリソース属性を参照してください	`key=value,…`	`{}`
`metrics.includeSessionId`	`QWEN_TELEMETRY_METRICS_INCLUDE_SESSION_ID`	-	メトリクスデータポイントに `session.id` を含めます。時系列のファンアウトからメトリクスバックエンドを保護するため、デフォルトでは無効です	`true`/`false`	`false`

ブール値の環境変数に関する注意: ブール値の設定（enabled、logPrompts、includeSensitiveSpanAttributes）について、対応する環境変数を true または 1 に設定すると機能が有効になります。それ以外の値では無効になります。

整数の環境変数に関する注意: QWEN_TELEMETRY_SENSITIVE_SPAN_ATTRIBUTE_MAX_LENGTH は設定時に正の整数である必要があります。無効な値はサイレントにフォールバックするのではなく、Telemetry設定の解決を失敗させます。

gen_ai.tool.description はセンシティブではない静的レジストリメタデータであり、includeSensitiveSpanAttributes とは独立して出力されます。これにはMCPサーバーやその他のワークスペースツールプロバイダーから提供される説明が含まれます。値は4096 UTF-16コードユニットに制限され、動的な呼び出し詳細を含むことはありません。

センシティブなスパン属性: includeSensitiveSpanAttributes が有効な場合、以下の2つのことが起こります:

ネイティブスパン属性が標準的なOpenTelemetry GenAI JSONを保持します:
- LLM入力メッセージ（gen_ai.input.messages）
- システム指示（gen_ai.system_instructions）
- ツール定義（gen_ai.tool.definitions）
- LLM出力メッセージ（gen_ai.output.messages）
- 最終実行ツール引数（gen_ai.tool.call.arguments）
- 成功したツール結果（gen_ai.tool.call.result）
- インタラクションスパンはGenAI推論スパンではないため、引き続き new_context を使用します。
メインエージェントの入力はコンテキスト展開前の元のユーザーテキスト投影であり、メインエージェントの出力はすべてのツールおよび継続の作業が確定した後の最終的なユーザー可視回答です。LLM値はプロバイダー最終のSDKリクエストオブジェクトと生プロバイダー応答から取得され、その入力には履歴、展開されたファイル、システム指示、およびツール結果が含まれる可能性があり、その出力にはすべてのプロバイダー候補が含まれる可能性があります。ツール値は最終呼び出しパラメータと成功したモデル向け結果から取得されます。各標準GenAI値はコンパクトJSONであり、完全でスキーマ有効である必要があります。無効、循環参照、または sensitiveSpanAttributeMaxLength より長い値は全体として省略されます。JSONが切り詰められることはなく、プレビュー、ハッシュ、または切り詰めメタデータは出力されません。インタラクション固有の new_context 属性は既存の切り詰め動作を保持します。デフォルトの最大値は属性ごとに1 MiB（1048576）で、受け入れ範囲は 1..104857600（100 MiB）です。上限はUTF-8バイト数ではなくJavaScript文字列長として測定されます。したがって、非ASCIIコンテンツはOTLPエクスポート後にバイト数が増加する可能性があります。
ログからスパンへのブリッジスパン（ログエンドポイントなしでHTTPトレースがエクスポートされる場合に使用）は、ドロップされる代わりに既存の prompt、function_args、response_text フィールドを保持します。

⚠️ セキュリティ警告: このフラグを有効にすると、完全な会話履歴、read_file によって読み取られたファイルの内容、シェルコマンドとその出力（環境変数や引数に含まれるシークレットを含む）、およびモデルの応答が設定されたOTLPバックエンドにストリーミングされます。バックエンドは特権的なデータシンクとして扱ってください。このフラグのデフォルトは false です。

コスト / ペイロードサイズ: デフォルトの上限では、1つのLLMスパンは入力、出力、システム指示、ツール定義を合わせて最大約4 MiBを保持する可能性があります。1つのToolスパンは引数と結果を合わせて約2 MiBを保持する可能性があります。1つのインタラクションはAgent入力、Agent出力、および互換性の new_context を合わせて約3 MiBを保持する可能性があります。これはQwen Codeのアプリケーション側の上限であり、すべてのコレクターやバックエンドがそれほど大きな単一の属性を受け入れるという保証ではありません。スパンが拒否またはドロップされる場合は、sensitiveSpanAttributeMaxLength を下げ（例: 61440）、エクスポートのスループットを監視してください。

この設定はOTelログやその他のTelemetryシンク内のセンシティブデータを無効にするものではありません。非内部API応答のTelemetryは response_text を設定する可能性があるため、OTelログ、UI Telemetry、およびチャット記録は、この設定とは独立して応答テキストを受け取る可能性があります。QwenLoggerには response_text は含まれません。

HTTP OTLPシグナルルーティング: HTTPプロトコル（otlpProtocol: "http"）を使用する場合、Qwen Codeはベースの otlpEndpoint にシグナル固有のパス（/v1/traces、/v1/logs、/v1/metrics）を自動的に追加します。たとえば、http://collector:4318 はトレースの場合 http://collector:4318/v1/traces になります。URLがすでにシグナルパスで終わっている場合は、そのまま使用されます。シグナル別のエンドポイントオーバーライド（otlpTracesEndpoint など）はベースエンドポイントより優先され、そのまま使用されます。gRPCプロトコルはサービスベースのルーティングを使用し、パスを追加しません。

シグナル別のエンドポイント環境変数は、標準のOpenTelemetry名も受け付けます: OTEL_EXPORTER_OTLP_TRACES_ENDPOINT、OTEL_EXPORTER_OTLP_LOGS_ENDPOINT、OTEL_EXPORTER_OTLP_METRICS_ENDPOINT。QWEN_TELEMETRY_OTLP_* 変数は OTEL_* 変数より優先されます。

エンドユーザーID: telemetry.userId と QWEN_TELEMETRY_USER_ID は、ARMSスパン属性 gen_ai.user.id の明示的なオプトインです。環境変数は両方の値がトリミングされた後に優先され、空の環境値は設定にフォールバックします。識別子はインタラクション、LLM、Tool、およびAgentスパンにのみ書き込まれます。リソース属性、ログまたはメトリクス属性、アウトバウンドBaggage値、または現在のOpenTelemetry GenAI標準フィールドではありません。安定した仮名識別子を推奨します。値は起動時に解決されるため、設定変更には再起動が必要です。複数のエンドユーザーにサービスを提供するデーモンまたはチャネルインスタンスでプロセス全体の値を設定しないでください。

すべての設定オプションの詳細については、設定ガイドを参照してください。

リソース属性

リソース属性は、OTLP経由でエクスポートされるすべてのスパン、ログ、メトリクスに付加される静的なキーと値のペアです。チーム、環境、デプロイリージョン、またはバックエンドが関心を持つその他のディメンションでTelemetryをスライスするために使用します。

2つのソースがあり、優先順位順（低→高）にマージされます:

標準の OTEL_RESOURCE_ATTRIBUTES 環境変数
.qwen/settings.json 内の telemetry.resourceAttributes（キーの競合時に環境変数をオーバーライド）

OTEL_SERVICE_NAME は別のエスケープハッチです。設定すると、（OpenTelemetry仕様に従い）他のソースからの service.name をオーバーライドします。

例

チーム/環境ですべてのTelemetryをスライス:


export OTEL_RESOURCE_ATTRIBUTES="team=platform,env=prod,cost_center=eng-123"

service.name 経由でテナント別コレクターにルーティング:


export OTEL_SERVICE_NAME=qwen-code-ci

フリートベースライン（~/.qwen/settings.json）+ ホスト別のオーバーライド:


{
  "telemetry": {
    "resourceAttributes": {
      "deployment.environment": "production",
      "service.namespace": "engineering-tooling"
    }
  }
}


# 設定に触れずにワンオフのタグを追加:
export OTEL_RESOURCE_ATTRIBUTES="debug_run=true"

予約済みキー

一部のキーはランタイム制御されており、オーバーライドできません:

service.version — 常に実行中のCLIバージョンに設定されます。どのソースから設定しても警告とともにサイレントに破棄されます。
session.id — セッションごとにランタイム注入されます。環境変数または設定からのユーザー提供値は警告とともに破棄されます。その理由は、リソース属性がすべてのメトリクスデータポイントに自動付加されるため、ユーザーによるオーバーライドを許可すると、以下のカーディナリティ制御を回避してしまうからです。スパンとログは常に session.id を保持します。

service.name は予約済みではなく、上記の優先順位チェーンに従います。

形式

OTEL_RESOURCE_ATTRIBUTES はOpenTelemetry仕様に従います: key1=value1,key2=value2 で、値はパーセントエンコードされます。値内のスペースは %20 としてエンコードする必要があり、カンマは %2C としてエンコードする必要があります（エンコードされていないカンマは値を誤った境界で分割し、後半が不正な形式として破棄されます）。不正な形式のペアは、Telemetryの起動を失敗させるのではなく、警告とともにスキップされます。

トラブルシューティング: ユーザー提供の属性が有効にならないように見える場合

予約済みキー（service.version、session.id）、不正な形式のペア、非文字列の設定値、および無効なパーセントエンコードは、OpenTelemetry診断チャネル経由でログに記録される警告とともにサイレントに破棄されます。そのチャネルはデバッグログファイル（~/.qwen/log/otel-*.log）にルーティングされ、コンソールには出力されないため、サイレントな失敗のように見えることがあります。

カスタムリソース属性がエクスポートされたTelemetryに表示されない場合:

~/.qwen/log/otel-*.log で cannot override（予約済みキーが破棄）、Skipping malformed（不正な環境変数ペア）、または must be a string（非文字列の設定値）に一致する行を確認します。
環境変数がqwen-codeプロセスの環境（シェルだけでなく）で設定されており、値がパーセントエンコードされていることを確認します。
telemetry.enabled が true であることを確認します。Telemetryの初期化は有効な場合にのみ実行されます。

カーディナリティ制御

メトリクスはバックエンドで属性セットごとに集計されます。属性値のすべての異なる組み合わせが新しい時系列を生成します。session.id のような高カーディナリティフィールドをメトリクスに付加すると、セッション数に比例した時系列のファンアウトが発生し、メトリクスバックエンドのストレージをすぐに枯渇させてしまいます。

これを防ぐため、Qwen Codeはデフォルトでメトリクスデータポイントから高カーディナリティ属性を除外します。スパンとログはイベントごとであり影響を受けないため、トレースとログの相関のために引き続き session.id を保持します。

`telemetry.metrics.includeSessionId`（デフォルト: `false`）

これを true に設定する（設定または QWEN_TELEMETRY_METRICS_INCLUDE_SESSION_ID=true 経由）と、session.id がすべてのメトリクスデータポイントに再付加されます。

⚠️ 警告: 各CLIセッションは新しい値を作成します。フリートでこれを有効にすると、メトリクスストレージが爆発します。短期間のデバッグのみに推奨します。長期的なセッション相関には、代わりにトレースまたはログバックエンドをクエリしてください。

以前のバージョンからの移行

このリリース以前は、session.id がデフォルトでメトリクスに付加されていました。Prometheusクエリ/Grafanaダッシュボード/アラートルールがメトリクスの session_id を参照している場合、2つの選択肢があります:

オプションA — 短期間のデバッグのために以前の動作を復元:


export QWEN_TELEMETRY_METRICS_INCLUDE_SESSION_ID=true

または:


{
  "telemetry": {
    "metrics": { "includeSessionId": true }
  }
}

オプションB（推奨） — セッションレベルの分析をメトリクスから移動します。スパンとログは引き続き session.id を保持し、トレース/ログバックエンド（Jaeger、Tempo、Loki、Aliyun SLS / ARMS Tracing）はカーディナリティのプレッシャーなしにセッションごとのスライスをネイティブに処理します。

アウトバウンドフェッチ時のクライアント側HTTPスパン

Telemetryが有効な場合、Qwen Codeは UndiciInstrumentation を登録し、プロセスによって発信されるすべてのアウトバウンド fetch() リクエスト（LLM SDK（openai、@google/genai、@anthropic-ai/sdk）、MCP StreamableHTTPクライアント、WebFetch ツール、およびIDE拡張のプロセス外呼び出しを含む）に対してクライアント側HTTPスパンを作成します。このスパンにより、既存の api.generateContent スパン単独では区別できない上流のモデル処理時間から、ネットワークレイテンシ（TTFB / レスポンスボディ転送）を分けて確認できます。

これらのスパンは、他のTelemetryと同様に独自のOTLPコレクター（またはファイルアウトファイル）に送信されます。アウトバウンドHTTPリクエスト自体に書き込まれる内容には影響しません。W3C traceparent ヘッダーが送信リクエストストリームにも書き込まれるかどうかは、以下のアウトバウンド相関（セキュリティ関連）で説明されている別のセキュリティ関連設定によって制御されます。

フィードバックループの回避。 OTel SDKはOTLPデータをアップロードするために内部的に fetch を使用します。保護がない場合、fetch を計装するとそれらのアップロードもトレースされ、それ自体がアップロードされることで無限ループを引き起こします。Qwen Codeのundici計装は、設定された telemetry.otlpEndpoint / telemetry.otlpTracesEndpoint / telemetry.otlpLogsEndpoint / telemetry.otlpMetricsEndpoint プレフィックスに一致するURLをスキップする ignoreRequestHook で構成されています。ファイルアウトファイルモードではアウトバウンドHTTPアップロードがないため、フックはノーオペレーションになります。

アウトバウンド相関（セキュリティ関連）

これらの設定は、意図的に telemetry.* とは別のトップレベル名前空間に存在します。Telemetryはオペレーターの独自のオブザーバビリティバックエンドへのデータフローを制御しますが、outboundCorrelation.* はqwen-codeがサードパーティのLLMプロバイダーエンドポイント（DashScope、OpenAI、Anthropicなど）に到達するアウトバウンドLLM APIリクエストストリームに書き込むクライアント側相関データを制御します。異なる受信者、異なる同意の決定。すべての値はデフォルトでオフです。 フレーミングの根拠についてはPR #4390のレビュー議論を参照してください。

`outboundCorrelation.propagateTraceContext`


"outboundCorrelation": {
  "propagateTraceContext": false // default
}

false（デフォルト）の場合、Qwen Code は OTel SDK に no-op の TextMapPropagator をインストールします。UndiciInstrumentation は OTLP コレクター用のクライアント HTTP スパンを引き続き作成しますが、propagation.inject() は no-op となるため、アウトバウンドリクエストに traceparent は書き込まれません。トレース ID はオペレーターのコレクター内部に留まります。

true の場合、SDK のデフォルトの W3C 複合プロパゲーター（tracecontext + baggage）がインストールされ、すべてのアウトバウンド fetch に標準の traceparent ヘッダーが書き込まれます。


traceparent: 00-<32-hex traceId>-<16-hex parentSpanId>-<01-sampled | 00-not-sampled>

さらに、シェルの子プロセス（Bash ツール、フック、モニター）で TRACEPARENT および TRACESTATE 環境変数が設定されるため、生成されたコマンドが同じ分散トレースに参加できるようになります。

LLM プロバイダーもクロスプロセスのトレース結合のために OTLP コレクターにレポートを送信する場合（例：DashScope を提供する ARMS Tracing）にのみオプトインしてください。ほとんどのオペレーターでは値は false です。クロスベンダーのトレース継続はニッチなユースケースです。

telemetry.enabled: true に依存します。 OTel SDK はテレメトリが有効な場合にのみ初期化されるため、propagateTraceContext もその状態でのみ有効になります。テレメトリが無効な状態で true に設定しても、サイレントな no-op となります（SDK もプロパゲーターも存在せず、ネットワーク上に traceparent も送信されません）。ARMS+DashScope の相関設定を構築する際は、両方のフラグを確認してください。


{
  "telemetry": {
    "enabled": true,
    "otlpTracesEndpoint": "http://tracing-analysis-...",
  },
  "outboundCorrelation": {
    "propagateTraceContext": true,
  },
}

その他のアウトバウンド相関ヘッダー

X-Qwen-Code-Session-Id と X-Qwen-Code-Request-Id は この PR の対象外です。これらは、同じ outboundCorrelation.* 名前空間の下で、それぞれ独自の脅威モデルとオペレーターの同意フローを備えた後続の PR で設計・提案される予定です。PR #4390 のレビュー（LaZzyMan）で、「テレメトリの作業範囲には LLM プロバイダーへの識別子の送信は含まれない」という原則が確立されました。相関ヘッダーの作業は、テレメトリの下に実装するのではなく、独自の設計議論に移行されます。

インバウンド相関（デーモン HTTP API）

デーモン HTTP API は、すべてのリクエストで標準の W3C traceparent ヘッダーを受け付けます。2つのコンシューマーが独立して読み取ります:

リクエストスパンの親付け替え（Telemetry有効）。 Telemetry SDK が初期化されると、有効なヘッダーがリクエストスパンのリモート親として抽出されるため、デーモンスパンは新しいトレースを開始する代わりに呼び出し元のトレースの下に配置されます。_meta フォワーディングパスも同じ親チェーンを読み取るため、デーモンリクエスト経由でフォワードされるセッションサブプロセススパンもそれを継承します。
アクセスログの traceId フィールド（両モード）。 専用の事前認証キャプチャミドルウェアが、認証（401）で短絡されたもの、レートリミッター（429）、JSONボディパーサー（400）、またはどのルートにもマッチしなかったもの（404）を含むすべてのリクエストでヘッダーを解析し、アクセスログは呼び出し元のトレースIDをキャメルケースの traceId フィールドとして出力します。Telemetryが無効な場合、このフィールドはデーモンのログ行と呼び出し元のログ（またはトレースバックエンド）の間の唯一の結合点となるため、1つの保存済みクエリでTelemetry設定なしに両モードで機能します。

無効だが存在するヘッダーは拒否され（スパンは親なしのまま）、レート制限付きのDEBUGブレッドクラム（qwen-code.daemon.traceparent.invalid）に拒否された値が記録されるため、壊れたクロスサービス結合はデーモンログのみから診断可能です。

インバウンド親の下の強制サンプリング

デフォルトの parentbased_always_on サンプラー（およびその他のparentbasedデフォルト）では、リモート親の sampled=0 フラグは呼び出し元側のヘッドベースの決定であり、デーモンTelemetryをドロップするリクエストではないため、抽出はインバウンド親にSAMPLEDフラグを強制します。唯一のオプトアウトは OTEL_TRACES_SAMPLER=parentbased_always_off で、これは呼び出し元のフラグを尊重します。これはデーモン全体のルートスパンサンプリングも無効にする点に注意してください。インバウンドリンクされたリクエストだけでなく。

警告: 定数の traceparent（例: 負荷テストクライアントにハードコードされたもの）は、すべてのデーモンリクエストを1つの単一のトレースに親付け替えします。リクエストごとに新しいヘッダーを生成してください。

Aliyun Telemetry

手動 OTLP エクスポート

Alibaba Cloud Managed Service for OpenTelemetry で Qwen Code のテレメトリを表示するには、ARMS が提供する OTLP エンドポイントにエクスポートするように Qwen Code を構成します。

"target": "gcp" を設定するだけでは、エクスポート先は構成されません。otlpEndpoint が設定されていない場合、Qwen Code はデフォルトで http://localhost:4317 に設定されます。outfile が設定されている場合、それは otlpEndpoint をオーバーライドし、テレメトリは Alibaba Cloud に送信される代わりにファイルに書き込まれます。

.qwen/settings.json でテレメトリを有効にし、OTLP エンドポイントを設定します。

オプション A: gRPC プロトコル（標準 OTLP エンドポイント）:
```
{
  "telemetry": {
    "enabled": true,
    "target": "gcp",
    "otlpEndpoint": "https://<your-otlp-endpoint>",
    "otlpProtocol": "grpc"
  }
}
```
オプション B: シグナルごとのエンドポイントを持つ HTTP プロトコル（/v1/traces の代わりに /api/otlp/traces など、非標準のパスを使用するバックエンド用）:
```
{
  "telemetry": {
    "enabled": true,
    "otlpProtocol": "http",
    "otlpTracesEndpoint": "http://<host>/<token>/api/otlp/traces",
    "otlpLogsEndpoint": "http://<host>/<token>/api/otlp/logs",
    "otlpMetricsEndpoint": "http://<host>/<token>/api/otlp/metrics"
  }
}
```
注: otlpEndpoint のみを使用し（シグナルごとのオーバーライドなし）、HTTP プロトコルを使用する場合、Qwen Code はベース URL に標準の OTLP パス（/v1/traces、/v1/logs、/v1/metrics）を追加します。バックエンドが異なるパスを使用する場合は、オプション B に示すようにシグナルごとのエンドポイントオーバーライドを使用してください。

ARMS Session Analysis の User ID を設定するには、安定した仮名IDをスパンレベルの設定として追加します:
```
{
  "telemetry": {
    "userId": "user-079458",
    "resourceAttributes": {
      "acs.arms.service.feature": "genai_app"
    }
  }
}
```
コンテナデプロイメントでは、代わりに QWEN_TELEMETRY_USER_ID=user-079458 を設定してください。カスタムの telemetry.resourceAttributes.user.id は無関係なリソースディメンションのままであり、ARMS Session Analysis を設定しないため、スパンレベルの設定に移行する場合は削除してください。
Alibaba Cloud のエンドポイントで認証が必要な場合は、OTEL_EXPORTER_OTLP_HEADERS（またはシグナル固有のバリアント）などの標準的な OpenTelemetry 環境変数を通じて OTLP ヘッダーを指定します。Qwen Code は現在、.qwen/settings.json で OTLP 認証ヘッダーを直接公開していません。
Qwen Code を実行し、プロンプトを送信します。
Managed Service for OpenTelemetry でテレメトリを表示します。
- 製品概要: What is Managed Service for OpenTelemetry?
- 利用開始: Get started with Managed Service for OpenTelemetry
- コンソールエントリーポイント:
  - 中国本土: trace.console.aliyun.com （レガシーコンソール: tracing.console.aliyun.com ）
  - 国際: arms.console.alibabacloud.com
- コンソールで Applications を使用して、トレースとサービストポロジを検査します。
- OTLP エンドポイントとアクセス情報の場所を確認するには:
  - 新しいコンソール（trace.console.aliyun.com または国際版）: Integration Center に移動します。
  - レガシーコンソール（tracing.console.aliyun.com）: Cluster Configurations → Access point information に移動します。

ローカルテレメトリ

ローカル開発およびデバッグのために、テレメトリデータをローカルでキャプチャできます。

ファイルベースの出力（推奨）

.qwen/settings.json でテレメトリを有効にします。
```
{
  "telemetry": {
    "enabled": true,
    "outfile": ".qwen/telemetry.log"
  }
}
```
注: outfile が設定されると、OTLP エクスポートは自動的に無効になります。ファイルのみの出力には target と otlpEndpoint の設定は不要であり、設定から安全に省略できます。
Qwen Code を実行し、プロンプトを送信します。
指定されたファイル（例: .qwen/telemetry.log）でログとメトリクスを表示します。

コレクターベースのエクスポート（上級者向け）

自動化スクリプトを実行します。
```
npm run telemetry -- --target=local
```
これにより以下の処理が行われます。
- Jaeger と OTEL コレクターをダウンロードして起動します
- ローカルテレメトリ用にワークスペースを構成します
- http://localhost:16686 で Jaeger UI を提供します
- ログ/メトリクスを ~/.qwen/tmp/<projectHash>/otel/collector.log に保存します
- 終了時にコレクターを停止します（例: Ctrl+C）
Qwen Code を実行し、プロンプトを送信します。
http://localhost:16686 でトレースを、コレクターのログファイルでログ/メトリクスを表示します。

ログとメトリクス

以下のセクションでは、Qwen Code 用に生成されるログ、メトリクス、およびスパンの構造について説明します。

すべてのログとメトリクスには、共通属性として sessionId が含まれます。

ログ

ログは、特定のイベントのタイムスタンプ付きレコードです。すべてのログレコードには、event.name と event.timestamp 属性が自動的に含まれます。

以下のイベントがログに記録されます。

コアセッションイベント

qwen-code.config: 起動時に CLI 構成とともに 1 回だけ発行されます。
- 属性: model, sandbox_enabled, core_tools_enabled, approval_mode, file_filtering_respect_git_ignore, debug_mode, truncate_tool_output_threshold, truncate_tool_output_lines, hooks（カンマ区切り、無効な場合は省略）, ide_enabled, interactive_shell_enabled, mcp_servers, mcp_servers_count, mcp_tools, mcp_tools_count, output_format, skills, subagents
session.start: セッションが開始されます。起動時のテレメトリ初期化後およびセッション切り替えごとに出力されます。ライフサイクルセマンティクスはスパンセクションで説明されています。
- 属性: session.id (string)、session.previous_id (string、この開始が新しいセッション ID で永続化された会話を継続する場合にのみ存在)
session.end: セッションが終了します。セッション切り替えが現在のセッションを置き換える前、およびテレメトリシャットダウン時に出力されます。
- 属性: session.id (string)
qwen-code.user_prompt: ユーザーがプロンプトを送信します。
- 属性: prompt_length (int), prompt_id (string), prompt (string, log_prompts_enabled が false の場合は除外), auth_type (string)
qwen-code.user_retry: ユーザーが最後のプロンプトを再試行します。
- 属性: prompt_id (string)
qwen-code.conversation_finished: 会話のターンシーケンスが完了します。
- 属性: approvalMode (string), turnCount (int)
qwen-code.user_feedback: ユーザーがセッションフィードバックを送信します。
- 属性: session_id (string), rating (int: 1=bad, 2=fine, 3=good), model (string), approval_mode (string), prompt_id (string, オプション)

ツールイベント

qwen-code.tool_call: 各関数/ツールの呼び出し。ターミナルイベントは正規化され、status が権限を持ちます: successとcancelledイベントはエラーフィールドを省略し、errorイベントは常に空でない error_type を持ちます（プロデューサーがエラーを分類しなかった場合は unknown）。空のツール名は unknown_tool として出力されます。欠落した execution_status は unknown に正規化され、ターミナルの status から推論されることはありません。
- 属性: function_name (string), function_args (object), call_id (string, オプション), duration_ms (int), status (string: “success”, “error”, または “cancelled”), execution_status (string: “not_started”, “success”, “error”, “cancelled”, または “unknown”), success (boolean), decision (string: “accept”, “reject”, “auto_accept”, または “modify”、オプション), error (string, オプション), error_type (string, errorイベントに存在), prompt_id (string), response_id (string, オプション), content_length (int, オプション), tool_type (string: “native” または “mcp”), mcp_server_name (string, オプション), metadata (object, オプション — ファイル書き込みツールの場合、model_added_lines, model_removed_lines, user_added_lines, user_removed_lines, model_added_chars, model_removed_chars, user_added_chars, user_removed_chars を含む)
qwen-code.file_operation: 各ファイル操作。
- 属性: tool_name (string), operation (string: “create”, “read”, “update”), lines (int, オプション), mimetype (string, オプション), extension (string, オプション), programming_language (string, オプション)
qwen-code.tool_output_truncated: ツールの出力がサイズ閾値を超過しました。
- 属性: tool_name (string), original_content_length (int), truncated_content_length (int), threshold (int), lines (int), prompt_id (string)

API イベント

qwen-code.api_request: LLM API への送信リクエスト。
- 属性: model (string), prompt_id (string), request_text (string, オプション), subagent_name (string, オプション)
qwen-code.api_response: LLM API から受信したレスポンス。
- 属性: response_id (string), model (string), status_code (int/string, オプション), duration_ms (int), input_token_count (int), output_token_count (int), cached_content_token_count (int), thoughts_token_count (int), total_token_count (int), prompt_id (string), auth_type (string, オプション), response_text (string, オプション), subagent_name (string, オプション)
qwen-code.api_error: API リクエストが失敗しました。
- 属性: model (string), prompt_id (string), duration_ms (int), error_message (string), response_id (string, オプション), auth_type (string, オプション), error_type (string, オプション), status_code (int/string, オプション), subagent_name (string, オプション)
さらに、互換性のために OTel 標準のエイリアス（http.status_code, error.message, model_name, duration）が発行されます。
qwen-code.api_cancel: API リクエストがユーザーによってキャンセルされました。
- 属性: model (string), prompt_id (string), auth_type (string, オプション), loop_wakeups_cancelled (int, オプション)
qwen-code.api_retry: LLM 呼び出しサイトでの HTTP ステータスリトライ（429/5xx）。別の予算で InvalidStreamError リトライを処理する chat.content_retry とは区別されます。
- 属性: model (string), prompt_id (string, オプション), attempt_number (int), error_type (string, オプション), error_message (string), status_code (int/string, オプション), retry_delay_ms (int), duration_ms (int, retry_delay_ms と等しい — HTTP ラウンドトリップではなくバックオフスリープ時間。試行期間については qwen-code.llm_request スパンを参照), subagent_name (string, オプション)
qwen-code.malformed_json_response: generateJson のレスポンスを解析できませんでした。
- 属性: model (string)
qwen-code.flash_fallback: フォールバックとして flash モデルに切り替えました。
- 属性: auth_type (string)
qwen-code.ripgrep_fallback: フォールバックとして grep に切り替えました。
- 属性: use_ripgrep (boolean), use_builtin_ripgrep (boolean), error (string, オプション)

レジリエンスイベント

qwen-code.chat.content_retry: コンテンツエラーのリトライ（例: 空のストリーム）。
- 属性: attempt_number (int), error_type (string), retry_delay_ms (int), model (string)
qwen-code.chat.content_retry_failure: すべてのコンテンツリトライが使い果たされました。
- 属性: total_attempts (int), final_error_type (string), total_duration_ms (int, オプション), model (string)
qwen-code.chat.invalid_chunk: ストリームから無効なチャンクを受信しました。
- 属性: error.message (string, オプション)

コマンド＆拡張機能イベント

qwen-code.slash_command: ユーザーがスラッシュコマンドを実行します。
- 属性: command (string), subcommand (string, オプション), status (string: “success” または “error”、オプション)
qwen-code.slash_command.model: ユーザーが /model コマンドを介してモデルを切り替えます。
- 属性: model_name (string)
qwen-code.skill_launch: スキルが起動されます。
- 属性: skill_name (string), success (boolean), prompt_id (string)
qwen-code.extension_install: 拡張機能がインストールされました。
- 属性: extension_name (string), extension_version (string), extension_source (string), status (string: “success”/“error”)
qwen-code.extension_uninstall: 拡張機能がアンインストールされました。
- 属性: extension_name (string), status (string)
qwen-code.extension_enable: 拡張機能が有効化されました。
- 属性: extension_name (string), setting_scope (string)
qwen-code.extension_disable: 拡張機能が無効化されました。
- 属性: extension_name (string), setting_scope (string)
qwen-code.extension_update: 拡張機能が更新されました。
- 属性: extension_name (string), extension_id (string), extension_previous_version (string), extension_version (string), extension_source (string), status (string: “success”/“error”)
qwen-code.ide_connection: IDE 接続イベント。
- 属性: connection_type (string: “start” または “session”)
qwen-code.auth: 認証イベント。
- 属性: auth_type (string), action_type (“auto”, “manual”, “coding-plan”), status (“success”, “error”, “cancelled”), error_message (オプション)

サブエージェントイベント

qwen-code.subagent_execution: サブエージェントのライフサイクルイベント。
- 属性: subagent_name (string), status (“started”, “completed”, “failed”, “cancelled”), terminate_reason (オプション), result (オプション), execution_summary (オプション)

Arena イベント

qwen-code.arena_session_started: Arena セッションが開始されます。
- 属性: arena_session_id (string), model_ids (JSON 文字列配列), task_length (int)
qwen-code.arena_agent_completed: Arena エージェントが完了します。
- 属性: arena_session_id (string), agent_session_id (string), agent_model_id (string), status (string: “completed”/“failed”/“cancelled”), duration_ms (int), rounds (int), total_tokens (int), input_tokens (int), output_tokens (int), tool_calls (int), successful_tool_calls (int), failed_tool_calls (int)
qwen-code.arena_session_ended: Arena セッションが完了します。
- 属性: arena_session_id (string), status (string: “selected”/“discarded”/“failed”/“cancelled”), duration_ms (int), display_backend (string, オプション), agent_count (int), completed_agents (int), failed_agents (int), cancelled_agents (int), winner_model_id (string, オプション)

ワークフローイベント

qwen-code.workflow_keyword: ワークフローのキーワードトリガーが発火しました。
qwen-code.workflow_run: ワークフローの実行が終了状態に達しました。
- 属性: status (string), agents_dispatched (int), agents_completed (int), phase_count (int), tokens_spent (int), duration_ms (int)

自動メモリイベント

qwen-code.memory.extract: メモリ抽出の実行が完了しました。
- 属性: trigger (“auto”/“manual”), status (“completed”/“skipped”/“failed”), skipped_reason (オプション), patches_count (int), touched_topics (string), duration_ms (int)
qwen-code.memory.dream: メモリ統合（ドリーム）の実行が完了しました。
- 属性: trigger (“auto”/“manual”), status (“updated”/“noop”/“failed”/“cancelled”), deduped_entries (int), touched_topics_count (int), touched_topics (string), duration_ms (int)
qwen-code.memory.recall: メモリリコール操作が完了しました。
- 属性: query_length (int), docs_scanned (int), docs_selected (int), strategy (“none”/“heuristic”/“model”), duration_ms (int)

プロンプト提案＆推測イベント

qwen-code.prompt_suggestion: プロンプト提案の結果。
- 属性: outcome (“accepted”/“ignored”/“suppressed”), prompt_id (オプション), accept_method (“tab”/“enter”/“right”, オプション), accept_source (“live”/“fallback”, オプション), time_to_accept_ms (オプション), time_to_ignore_ms (オプション), time_to_first_keystroke_ms (オプション), suggestion_length (オプション), similarity (オプション), was_focused_when_shown (オプション), reason (オプション)
qwen-code.speculation: 投機実行の結果。
- 属性: outcome (“accepted”/“aborted”/“failed”), turns_used (int), files_written (int), tool_use_count (int), duration_ms (int), boundary_type (オプション), had_pipelined_suggestion (boolean)

その他のイベント

qwen-code.chat_compression: チャットコンテキストが圧縮されました。
- 属性: tokens_before (int), tokens_after (int), compression_input_token_count (int, オプション), compression_output_token_count (int, オプション)
qwen-code.next_speaker_check: 次の発言者の決定。
- 属性: prompt_id (string), finish_reason (string), result (string)
loop_detected: エージェントの実行中にループが検出されました。（注: qwen-code. プレフィックスなしで発行されます — 既存の不整合です。）
- 属性: loop_type (string), prompt_id (string)
kitty_sequence_overflow: Kitty グラフィックスプロトコルのシーケンスがバッファサイズを超過しました。（注: qwen-code. プレフィックスなしで発行されます — 既存の不整合です。）
- 属性: sequence_length (int), truncated_sequence (string, 最初の 20 文字)

メトリクス

メトリクスは、時間の経過に伴う動作の数値測定値です。メトリクス名には qwen-code.* プレフィックスが使用されます。

コアメトリクス

qwen-code.session.count (Counter, Int): CLI の起動ごとに 1 回ずつインクリメントされます。
qwen-code.tool.call.count (Counter, Int): ツール呼び出しをカウントします。
- 属性: function_name, status (“success”/“error”/“cancelled”), success (boolean, 互換性のために保持), decision (“accept”/“reject”/“auto_accept”/“modify”, オプション), tool_type (“mcp”/“native”, オプション)
qwen-code.tool.execution.count (Counter, Int): ツール実行の結果をカウントします。低カーディナリティを維持するため function_name ディメンションは意図的に含まれていません。実行失敗率を特定のツールに帰属させるには qwen-code.tool_call ログにドロップダウンする必要があります。実行失敗率の計算時は unknown、not_started、および cancelled を除外してください（分母は success + error です）。
- 属性: execution_status (“not_started”/“success”/“error”/“cancelled”/“unknown”), tool_type (“mcp”/“native”), さらにオプトインの session.id などのグローバル設定された共通メトリクス属性
qwen-code.tool.call.latency (Histogram, ms): ツール呼び出しのレイテンシを測定します。
- 属性: function_name (string)
qwen-code.api.request.count (Counter, Int): すべての API リクエストをカウントします。
- 属性: model, status_code, error_type (オプション)
qwen-code.api.request.latency (Histogram, ms): API リクエストのレイテンシを測定します。
- 属性: model (string)
qwen-code.token.usage (Counter, Int): 使用されたトークンをカウントします。
- 属性: model, type (“input”/“output”/“thought”/“cache”)
qwen-code.file.operation.count (Counter, Int): ファイル操作をカウントします。
- 属性: operation (“create”/“read”/“update”), lines (オプション), mimetype (オプション), extension (オプション), programming_language (オプション)
qwen-code.chat_compression (Counter, Int): チャット圧縮操作をカウントします。
- 属性: tokens_before (int), tokens_after (int)
qwen-code.slash_command.model.call_count (Counter, Int): モデルスラッシュコマンドの呼び出しをカウントします。
- 属性: slash_command.model.model_name (string)
qwen-code.subagent.execution.count (Counter, Int): サブエージェントの実行イベントをカウントします。
- 属性: subagent_name, status (“started”/“completed”/“failed”/“cancelled”), terminate_reason (オプション)

レジリエンスメトリクス

qwen-code.api.retry.count (Counter, Int): LLM 呼び出しサイトでの HTTP ステータスリトライ（429/5xx）。
- 属性: model (string)
qwen-code.chat.content_retry.count (Counter, Int): コンテンツエラーによるリトライ。
qwen-code.chat.content_retry_failure.count (Counter, Int): すべてのコンテンツリトライが使い果たされました。
qwen-code.chat.invalid_chunk.count (Counter, Int): ストリームからの無効なチャンク。

Arena メトリクス

qwen-code.arena.session.count (Counter, Int): ステータス別の Arena セッション。
- 属性: status, display_backend (オプション)
qwen-code.arena.session.duration (Histogram, ms): Arena セッションの所要時間。
- Attributes: status
qwen-code.arena.agent.count (Counter, Int): Arena エージェントの完了数。
- Attributes: status, model_id
qwen-code.arena.agent.duration (Histogram, ms): Arena エージェントの実行時間。
- Attributes: model_id
qwen-code.arena.agent.tokens (Counter, Int): Arena エージェントによるトークン使用量。
- Attributes: model_id, type (“input”/“output”)
qwen-code.arena.result.selected (Counter, Int): Arena 結果の選択数。
- Attributes: model_id

Auto-Memory Metrics

qwen-code.memory.extract.count (Counter, Int): Auto-memory の抽出実行回数。
- Attributes: trigger (“auto”/“manual”), status
qwen-code.memory.extract.duration (Histogram, ms): 抽出の所要時間。
- Attributes: trigger, status
qwen-code.memory.dream.count (Counter, Int): Auto-memory の dream 実行回数。
- Attributes: trigger (“auto”/“manual”), status
qwen-code.memory.dream.duration (Histogram, ms): dream 実行の所要時間。
- Attributes: trigger, status
qwen-code.memory.recall.count (Counter, Int): Auto-memory の recall 操作回数。
- Attributes: strategy (“none”/“heuristic”/“model”)
qwen-code.memory.recall.duration (Histogram, ms): recall の所要時間。
- Attributes: strategy

API Request Breakdown

qwen-code.api.request.breakdown (Histogram, ms): フェーズ別の API リクエスト時間の内訳。
- Attributes: model, phase (“request_preparation”/“network_latency”/“response_processing”/“token_processing”)

Daemon Metrics

デーモンプロセス（長時間稼働する HTTP サーバーモード）は、独自のメトリクスを公開します。

Note: 3 つの Observable Gauge (daemon.session.active, daemon.sse.active, daemon.process.heap_used) は、各収集間隔で更新されるコールバックベースのメトリクスです。観測コールバックを登録するには、デーモン初期化時に registerDaemonGaugeCallbacks() を呼び出す必要があります。

HTTP

qwen-code.daemon.http.request.count (Counter, Int): ルートおよびステータスクラス別のリクエスト数。
- Attributes: route, status_class (“2xx”/“4xx”/“5xx”)
qwen-code.daemon.http.request.duration (Histogram, ms): リクエストの所要時間。
- Attributes: route
- Buckets: 1, 2, 5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000, 10000, 30000

Sessions

qwen-code.daemon.session.active (ObservableGauge, Int): 現在アクティブなセッション数。
qwen-code.daemon.session.lifecycle (Counter, Int): セッションのライフサイクルイベント。
- Attributes: action (“spawn”/“close”/“die”)

Channels

qwen-code.daemon.channel.lifecycle (Counter, Int): ACP チャネルのライフサイクルイベント。
- Attributes: action (“spawn”/“exit”), expected (boolean, optional)

Prompts

qwen-code.daemon.prompt.queue_wait (Histogram, ms): プロンプト FIFO キューの待機時間。
- Buckets: 1, 5, 10, 50, 100, 500, 1000, 5000, 10000, 30000, 60000
qwen-code.daemon.prompt.duration (Histogram, ms): エンドツーエンドのプロンプト所要時間。
- Buckets: 100, 500, 1000, 2500, 5000, 10000, 30000, 60000, 120000, 300000, 600000

Errors

qwen-code.daemon.bridge.error.count (Counter, Int): 種類別のブリッジエラー数。
- Attributes: error_type (既知のクラス名または “unknown”)
qwen-code.daemon.cancel.count (Counter, Int): キャンセルリクエスト数。

Resources

qwen-code.daemon.sse.active (ObservableGauge, Int): アクティブな SSE 接続数。
qwen-code.daemon.process.heap_used (ObservableGauge, Int, bytes): ヒープメモリ使用量。

Spans

分散トレースの span は qwen-code.interaction をルートとするツリーを形成します。CLI では、各 interaction は独自の traceId を持つトレースルートであり、ACP とデーモンパスはインバウンドの親コンテキストを継承する場合があります。プロンプト間の相関には session.id 属性が使用されます。

セッションライフサイクルは、OpenTelemetry General Session セマンティック規約を通じてエクスポートされます。OTel ログパイプラインが有効な場合、Qwen Code は必須の session.id 属性を持つ session.start および session.end ログイベントを出力します（上記のコアセッションイベントに記載）。再開された永続化会話には、再開されたセッション ID が現在のものと異なる場合にのみ session.start イベントに session.previous_id が含まれます。コールドスタートの再開（--resume、--continue、--fork-session）には含まれません。/clear およびその他の置換フローは、以前の会話を破棄するため、意図的に継続を主張しません。

既存の Qwen 固有の qwen-code.config/cli_config および RUM session_start レコードは互換性のために引き続き利用可能です。GenAI リクエストスパンは、同じ所有セッション ID に gen_ai.conversation.id を引き続き使用します。

qwen-code.interaction: メインエージェントの呼び出し span。1 つの論理プロンプトに対するすべての LLM リクエスト、ツールの承認/実行、および継続をカバーします。ユーザークエリ、リトライ、cron プロンプト、通知、チームメートメッセージ、および Goal ターンは invocation を生成し、ツール結果、フック、および steering は正確なアクティブプロンプト ID を再利用します。
- GenAI 属性: gen_ai.operation.name (invoke_agent)、gen_ai.agent.name (qwen-code)、gen_ai.conversation.id、オプションの gen_ai.output.type（設定された JSON Schema の場合のみ json）、センシティブな gen_ai.input.messages、センシティブな gen_ai.output.messages、およびオプションの ARMS 拡張 gen_ai.user.id
- 互換性属性: session.id、qwen-code.prompt_id、qwen-code.message_type、qwen-code.model、qwen-code.approval_mode、interaction.sequence、interaction.duration_ms、qwen-code.turn_status (“ok”/“error”/“cancelled”)
- gen_ai.request.model は意図的に省略されています。エージェントはオーバーライド、フォールバック、および動的モデル選択をサポートしているためです。gen_ai.provider.name およびエージェント ID/バージョン/説明も省略されています。
- エージェント入力は 1 つの元のユーザープロンプトであり、展開されたモデルリクエストではありません。エージェント出力は 1 つの最終的なユーザー可視テキスト投影です。構造化 JSON は finish_reason=tool_call を持つコンパクト JSON テキストを使用します。どちらも、センシティブなスパン属性が有効で、完全な JSON が属性ごとの制限に収まる場合を除き省略されます。
qwen-code.llm_request: 単一の LLM API 呼び出しをラップします。
- GenAI属性: gen_ai.operation.name, gen_ai.provider.name, gen_ai.conversation.id, オプションのARMS拡張 gen_ai.user.id, gen_ai.request.model, gen_ai.request.stream, gen_ai.request.choice.count, gen_ai.request.max_tokens, gen_ai.request.temperature, gen_ai.request.top_p, gen_ai.request.frequency_penalty, gen_ai.request.presence_penalty, gen_ai.request.stop_sequences, オプションの gen_ai.output.type, gen_ai.response.id, gen_ai.response.model, gen_ai.response.finish_reasons, gen_ai.response.time_to_first_chunk, gen_ai.usage.input_tokens, gen_ai.usage.output_tokens, gen_ai.usage.cache_read.input_tokens, gen_ai.usage.cache_creation.input_tokens
- 互換性属性: session.id, qwen-code.prompt_id, llm_request.context (“subagent”/“interaction”/“standalone”), duration_ms, ttft_ms, request_setup_ms, attempt, retry_total_delay_ms, sampling_ms, output_tokens_per_second, success, error, finish_reason, thoughts_token_count, subagent_name, error_type, error_status_code
- 標準レスポンスフィールドはプロバイダーレスポンスから取得されます。標準トークンフィールドは、プロバイダーが報告した負でない安全な整数に対してのみ出力されます。プロバイダーがトークン総数のみの場合、入力/出力の使用量は推定されずに省略されます。
- 標準リクエストパラメータフィールドは、アダプターのデフォルト、オーバーライド、未サポートフィールドの削除、および出力ウィンドウのクランプ後の最初のプロバイダー最終SDKリクエストオブジェクトから取得されます。Qwen CodeはSDKまたはサーバーのデフォルトを推論しません。
- ストリーミングリクエストは gen_ai.request.stream=true を出力します。gen_ai.response.time_to_first_chunk はプロバイダー呼び出しからプロバイダーアダプターによって生成された最初の正規化レスポンスまでの秒数を測定します（生のネットワークフレームと異なる場合があります）。非ストリーミングリクエストは両方の標準ストリーミング属性を省略します。セマンティック規約では gen_ai.request.stream が absent の場合、非ストリーミングを意味するためです。
qwen-code.tool: ツールの完全なライフサイクル（承認待機 + 実行）をラップします。
- Attributes: session.id、オプションの ARMS 拡張 gen_ai.user.id、gen_ai.operation.name (execute_tool)、オプションの継承された gen_ai.agent.name、gen_ai.tool.name、gen_ai.tool.type (function)、gen_ai.tool.call.id、tool.call_id、duration_ms、success、error、失敗時の error.type、tool.failure_kind (string、オプション — 特定の失敗理由、例: “cancelled”, “tool_error”, “tool_exception”, “timeout”, “permission_denied”, “pre_hook_blocked”)
qwen-code.tool.execution: ツール実行フェーズ（承認後）をラップします。試行された実行に対してのみ出力されます。
- Attributes: session.id, gen_ai.tool.name (オプション), tool.call_id (オプション), duration_ms, success, error, execution_status (“success”/“error”/“cancelled”), error_type, error.type
qwen-code.tool.blocked_on_user: ツールがユーザー承認を待機している時間。
- Attributes: session.id, tool.name, tool.call_id, duration_ms, decision (“proceed_once”/“proceed_always”/“cancel”/“aborted”/“auto_approved”/“error”), source (“cli”/“ide”/“hook”/“auto”/“system”)
qwen-code.hook: 各 pre/post-tool-use フックの発火サイトをラップします。
- Attributes: session.id, hook_event (“PreToolUse”/“PostToolUse”/“PostToolUseFailure”/“PostToolBatch”), tool.name, tool.use_id (optional), is_interrupt (boolean, optional), duration_ms, success, should_proceed (optional), should_stop (optional), block_type (optional), error (optional)
qwen-code.subagent: 単一のサブエージェント呼び出しをラップします。
- Attributes: gen_ai.operation.name (invoke_agent), gen_ai.agent.name, gen_ai.agent.description, gen_ai.conversation.id, オプションのARMS拡張 gen_ai.user.id, オプションの gen_ai.request.model, qwen-code.subagent.id, qwen-code.subagent.name, qwen-code.subagent.invocation_kind (“foreground”/“fork”/“background”), qwen-code.subagent.is_built_in, qwen-code.subagent.depth, qwen-code.subagent.status, qwen-code.subagent.terminate_reason, qwen-code.subagent.duration_ms

成功およびキャンセルされた GenAI スパンは SpanStatus を UNSET のままにします。失敗時は ERROR、境界付きのステータス説明、および低カーディナリティの error.type を設定します。

GenAIフィールドの移行とARMS認識

LLMスパンは現在、正確に同等なプライベートエイリアスなしで標準の gen_ai.request.*、gen_ai.response.*、および gen_ai.usage.* フィールドを使用します。リクエストサンプリング属性は標準名でのみ書き込まれます。ベアの temperature、top_p、max_tokens、ペナルティ、選択肢カウント、またはstop-sequenceのエイリアスは出力されません。ツールスパンも同様に tool.name なしで gen_ai.tool.name を使用します。blocked-on-userとフックスパンはGenAI Toolスパンではないため tool.name を保持します。無効なエイリアス gen_ai.usage.cached_tokens、gen_ai.server.time_to_first_token、および gen_ai.usage.reasoning_tokens は出力されなくなりました。プロバイダー報告のキャッシュリードには gen_ai.usage.cache_read.input_tokens を使用し、標準ストリーミングレイテンシには gen_ai.response.time_to_first_chunk を使用してください。プライベートな ttft_ms スパン属性は最初のユーザー可視出力レイテンシとして引き続き利用可能で、/stats、sampling_ms、および出力トークンスループットを駆動し続けます。gen_ai.response.time_to_first_chunk は最初の正規化チャンクレイテンシを測定する独立した標準属性です。バージョンピン留めされた完全な契約と延期されたフィールドはGenAIおよびARMSフィールドアライメントに記載されています。

ARMSにエクスポートされたスパンをGenAIアプリケーションとして認識させるには、リソース機能を明示的に設定します:


{
  "telemetry": {
    "resourceAttributes": {
      "acs.arms.service.feature": "genai_app"
    }
  }
}

Qwen CodeはこのARMS固有のリソース属性または gen_ai.span.kind を注入しません。ARMSは gen_ai.operation.name からLLM、Tool、およびAgentの役割を推論できます。

qwen-code.daemon.request: デーモン HTTP リクエストをラップします。
- Attributes: http.request.method, http.route, qwen-code.daemon.operation, session.id, http.response.status_code
qwen-code.daemon.bridge: デーモンブリッジ操作をラップします。
- Attributes: qwen-code.daemon.operation

Resource Metrics

qwen-code.memory.usage (Histogram, bytes): メモリ使用量。テレメトリが有効な場合、メモリプレッシャーモニターによって記録されます。
- Attributes: memory_type (string: “heap_used”/“rss”)
qwen-code.cpu.usage (Histogram, percent): CPU 使用率。テレメトリが有効な場合、メモリプレッシャーモニターによって記録されます。
- Attributes: (none)

Performance Monitoring (Reserved)

以下のメトリクスは定義されていますが、本番環境ではまだ有効化されていません。専用のパフォーマンスモニタリング設定フラグの背後で有効化される予定です。

qwen-code.startup.duration (Histogram, ms): フェーズ別の CLI 起動時間。
- Attributes: phase (string)
qwen-code.tool.queue.depth (Histogram, count): 実行キュー内のツール数。
qwen-code.tool.execution.breakdown (Histogram, ms): フェーズ別のツール実行時間。
- Attributes: function_name, phase (“validation”/“preparation”/“execution”/“result_processing”)
qwen-code.token.efficiency (Histogram, ratio): トークン効率メトリクス。
- Attributes: model, metric, context (optional)
qwen-code.performance.score (Histogram, score): 複合パフォーマンススコア (0-100)。
- Attributes: category, baseline (optional)
qwen-code.performance.regression (Counter, Int): 回帰検出イベント。
- Attributes: metric, severity (“low”/“medium”/“high”), current_value, baseline_value
qwen-code.performance.regression.percentage_change (Histogram, percent): ベースラインに対する変化率。
- Attributes: metric, severity, current_value, baseline_value
qwen-code.performance.baseline.comparison (Histogram, percent): ベースラインに対するパフォーマンス。
- Attributes: metric, category, current_value, baseline_value