Observability mit OpenTelemetry

Erfahre, wie du OpenTelemetry für Qwen Code aktivierst und einrichtest.

Observability mit OpenTelemetry

Wichtige Vorteile

🔍 Nutzungsanalysen: Verstehe Interaktionsmuster und die Feature-Nutzung in deinem Team
⚡ Performance-Monitoring: Überwache Antwortzeiten, Token-Verbrauch und Ressourcennutzung
🐛 Echtzeit-Debugging: Identifiziere Engpässe, Fehler und Fehlermuster, sobald sie auftreten
📊 Workflow-Optimierung: Triff fundierte Entscheidungen zur Verbesserung von Konfigurationen und Prozessen
🏢 Enterprise-Governance: Überwache die Nutzung über Teams hinweg, verfolge Kosten, stelle Compliance sicher und integriere dich in bestehende Monitoring-Infrastruktur

OpenTelemetry-Integration

Aufbauend auf OpenTelemetry — dem herstellerneutralen, branchenüblichen Observability-Framework — bietet das Observability-System von Qwen Code:

Universelle Kompatibilität: Export zu jedem OpenTelemetry-Backend (Aliyun, Jaeger, Prometheus, Datadog usw.)
Standardisierte Daten: Nutze konsistente Formate und Sammlungsmethoden in deiner Toolchain
Zukunftssichere Integration: Verbinde dich mit bestehender und zukünftiger Observability-Infrastruktur
Kein Vendor Lock-in: Wechsle zwischen Backends, ohne deine Instrumentierung ändern zu müssen

Konfiguration

Note

⚠️ Wichtiger Hinweis: Dieses Feature erfordert entsprechende Code-Änderungen. Diese Dokumentation wird vorab bereitgestellt; bitte beziehe dich für die tatsächliche Funktionalität auf zukünftige Code-Updates.

Das gesamte Telemetry-Verhalten wird über deine .qwen/settings.json-Datei gesteuert. Diese Einstellungen können durch Umgebungsvariablen oder CLI-Flags überschrieben werden.

Einstellung	Umgebungsvariable	CLI-Flag	Beschreibung	Werte	Standardwert
`enabled`	`QWEN_TELEMETRY_ENABLED`	`--telemetry` / `--no-telemetry`	Telemetry aktivieren oder deaktivieren	`true`/`false`	`false`
`target`	`QWEN_TELEMETRY_TARGET`	`--telemetry-target <local\|qwen>`	Wohin Telemetry-Daten gesendet werden	`"qwen"`/`"local"`	`"local"`
`otlpEndpoint`	`QWEN_TELEMETRY_OTLP_ENDPOINT`	`--telemetry-otlp-endpoint <URL>`	OTLP-Collector-Endpunkt	URL string	`http://localhost:4317`
`otlpProtocol`	`QWEN_TELEMETRY_OTLP_PROTOCOL`	`--telemetry-otlp-protocol <grpc\|http>`	OTLP-Transportprotokoll	`"grpc"`/`"http"`	`"grpc"`
`outfile`	`QWEN_TELEMETRY_OUTFILE`	`--telemetry-outfile <path>`	Telemetry in Datei speichern (überschreibt `otlpEndpoint`)	file path	-
`logPrompts`	`QWEN_TELEMETRY_LOG_PROMPTS`	`--telemetry-log-prompts` / `--no-telemetry-log-prompts`	Prompts in Telemetry-Logs einschließen	`true`/`false`	`true`
`useCollector`	`QWEN_TELEMETRY_USE_COLLECTOR`	-	Externen OTLP-Collector verwenden (fortgeschritten)	`true`/`false`	`false`

Hinweis zu booleschen Umgebungsvariablen: Für die booleschen Einstellungen (enabled, logPrompts, useCollector) aktiviert das Setzen der entsprechenden Umgebungsvariable auf true oder 1 das Feature. Jeder andere Wert deaktiviert es.

Detaillierte Informationen zu allen Konfigurationsoptionen findest du im Konfigurationsleitfaden.

Aliyun Telemetry

Direkter Export (Empfohlen)

Sendet Telemetry-Daten direkt an Aliyun-Services. Kein Collector erforderlich.

Aktiviere Telemetry in deiner .qwen/settings.json:


{
  "telemetry": {
    "enabled": true,
    "target": "qwen"
  }
}

Starte Qwen Code und sende Prompts.
Zeige Logs und Metriken in der Aliyun Console an.

Lokale Telemetry

Für die lokale Entwicklung und das Debugging kannst du Telemetry-Daten lokal erfassen:

Dateibasierte Ausgabe (Empfohlen)

Aktiviere Telemetry in deiner .qwen/settings.json:


{
  "telemetry": {
    "enabled": true,
    "target": "local",
    "otlpEndpoint": "",
    "outfile": ".qwen/telemetry.log"
  }
}

Starte Qwen Code und sende Prompts.
Zeige Logs und Metriken in der angegebenen Datei an (z. B. .qwen/telemetry.log).

Collector-basierter Export (Fortgeschritten)

Führe das Automatisierungsskript aus:
```
npm run telemetry -- --target=local
```
Dies führt Folgendes aus:
- Lädt Jaeger und den OTEL-Collector herunter und startet sie
- Konfiguriert deinen Workspace für lokale Telemetry
- Stellt eine Jaeger-UI unter http://localhost:16686 bereit
- Speichert Logs/Metriken in ~/.qwen/tmp/<projectHash>/otel/collector.log
- Stoppt den Collector beim Beenden (z. B. Ctrl+C)
Starte Qwen Code und sende Prompts.
Zeige Traces unter http://localhost:16686 und Logs/Metriken in der Collector-Logdatei an.

Logs und Metriken

Der folgende Abschnitt beschreibt die Struktur der für Qwen Code generierten Logs und Metriken.

Eine sessionId wird als gemeinsames Attribut in allen Logs und Metriken enthalten.

Logs

Logs sind zeitgestempelte Aufzeichnungen spezifischer Ereignisse. Die folgenden Ereignisse werden für Qwen Code protokolliert:

qwen-code.config: Dieses Ereignis tritt einmal beim Start mit der CLI-Konfiguration auf.
- Attribute:
  - model (string)
  - sandbox_enabled (boolean)
  - core_tools_enabled (string)
  - approval_mode (string)
  - file_filtering_respect_git_ignore (boolean)
  - debug_mode (boolean)
  - truncate_tool_output_threshold (number)
  - truncate_tool_output_lines (number)
  - hooks (string, durch Kommas getrennte Hook-Ereignistypen, entfällt wenn Hooks deaktiviert sind)
  - ide_enabled (boolean)
  - interactive_shell_enabled (boolean)
  - mcp_servers (string)
  - output_format (string: “text” oder “json”)
qwen-code.user_prompt: Dieses Ereignis tritt auf, wenn ein Benutzer einen Prompt sendet.
- Attribute:
  - prompt_length (int)
  - prompt_id (string)
  - prompt (string, dieses Attribut wird ausgeschlossen, wenn log_prompts_enabled auf false konfiguriert ist)
  - auth_type (string)
qwen-code.tool_call: Dieses Ereignis tritt für jeden Funktionsaufruf auf.
- Attribute:
  - function_name
  - function_args
  - duration_ms
  - success (boolean)
  - decision (string: “accept”, “reject”, “auto_accept” oder “modify”, falls zutreffend)
  - error (falls zutreffend)
  - error_type (falls zutreffend)
  - content_length (int, falls zutreffend)
  - metadata (falls zutreffend, Dictionary von string -> any)
qwen-code.file_operation: Dieses Ereignis tritt für jede Dateioperation auf.
- Attribute:
  - tool_name (string)
  - operation (string: “create”, “read”, “update”)
  - lines (int, falls zutreffend)
  - mimetype (string, falls zutreffend)
  - extension (string, falls zutreffend)
  - programming_language (string, falls zutreffend)
  - diff_stat (json string, falls zutreffend): Ein JSON-String mit folgenden Mitgliedern:
    - ai_added_lines (int)
    - ai_removed_lines (int)
    - user_added_lines (int)
    - user_removed_lines (int)
qwen-code.api_request: Dieses Ereignis tritt auf, wenn eine Anfrage an die Qwen API gestellt wird.
- Attribute:
  - model
  - request_text (falls zutreffend)
qwen-code.api_error: Dieses Ereignis tritt auf, wenn die API-Anfrage fehlschlägt.
- Attribute:
  - model
  - error
  - error_type
  - status_code
  - duration_ms
  - auth_type
qwen-code.api_response: Dieses Ereignis tritt beim Empfang einer Antwort von der Qwen API auf.
- Attribute:
  - model
  - status_code
  - duration_ms
  - error (optional)
  - input_token_count
  - output_token_count
  - cached_content_token_count
  - thoughts_token_count
  - tool_token_count
  - response_text (falls zutreffend)
  - auth_type
qwen-code.tool_output_truncated: Dieses Ereignis tritt auf, wenn die Ausgabe eines Tool-Aufrufs zu groß ist und gekürzt wird.
- Attribute:
  - tool_name (string)
  - original_content_length (int)
  - truncated_content_length (int)
  - threshold (int)
  - lines (int)
  - prompt_id (string)
qwen-code.malformed_json_response: Dieses Ereignis tritt auf, wenn eine generateJson-Antwort von der Qwen API nicht als JSON geparst werden kann.
- Attribute:
  - model
qwen-code.flash_fallback: Dieses Ereignis tritt auf, wenn Qwen Code als Fallback auf Flash wechselt.
- Attribute:
  - auth_type
qwen-code.slash_command: Dieses Ereignis tritt auf, wenn ein Benutzer einen Slash-Befehl ausführt.
- Attribute:
  - command (string)
  - subcommand (string, falls zutreffend)
qwen-code.extension_enable: Dieses Ereignis tritt auf, wenn eine Erweiterung aktiviert wird
qwen-code.extension_install: Dieses Ereignis tritt auf, wenn eine Erweiterung installiert wird
- Attribute:
  - extension_name (string)
  - extension_version (string)
  - extension_source (string)
  - status (string)
qwen-code.extension_uninstall: Dieses Ereignis tritt auf, wenn eine Erweiterung deinstalliert wird

Metriken

Metriken sind numerische Messwerte des Verhaltens über die Zeit. Die folgenden Metriken werden für Qwen Code erfasst (Metriknamen bleiben aus Kompatibilitätsgründen qwen-code.*):

qwen-code.session.count (Counter, Int): Wird einmal pro CLI-Start inkrementiert.
qwen-code.tool.call.count (Counter, Int): Zählt Tool-Aufrufe.
- Attribute:
  - function_name
  - success (boolean)
  - decision (string: “accept”, “reject” oder “modify”, falls zutreffend)
  - tool_type (string: “mcp” oder “native”, falls zutreffend)
qwen-code.tool.call.latency (Histogram, ms): Misst die Latenz von Tool-Aufrufen.
- Attribute:
  - function_name
  - decision (string: “accept”, “reject” oder “modify”, falls zutreffend)
qwen-code.api.request.count (Counter, Int): Zählt alle API-Anfragen.
- Attribute:
  - model
  - status_code
  - error_type (falls zutreffend)
qwen-code.api.request.latency (Histogram, ms): Misst die Latenz von API-Anfragen.
- Attribute:
  - model
qwen-code.token.usage (Counter, Int): Zählt die Anzahl der verwendeten Tokens.
- Attribute:
  - model
  - type (string: “input”, “output”, “thought”, “cache” oder “tool”)
qwen-code.file.operation.count (Counter, Int): Zählt Dateioperationen.
- Attribute:
  - operation (string: “create”, “read”, “update”): Der Typ der Dateioperation.
  - lines (Int, falls zutreffend): Anzahl der Zeilen in der Datei.
  - mimetype (string, falls zutreffend): MIME-Typ der Datei.
  - extension (string, falls zutreffend): Dateierweiterung der Datei.
  - model_added_lines (Int, falls zutreffend): Anzahl der vom Modell hinzugefügten/geänderten Zeilen.
  - model_removed_lines (Int, falls zutreffend): Anzahl der vom Modell entfernten/geänderten Zeilen.
  - user_added_lines (Int, falls zutreffend): Anzahl der vom Benutzer hinzugefügten/geänderten Zeilen in den vom KI vorgeschlagenen Änderungen.
  - user_removed_lines (Int, falls zutreffend): Anzahl der vom Benutzer entfernten/geänderten Zeilen in den vom KI vorgeschlagenen Änderungen.
  - programming_language (string, falls zutreffend): Die Programmiersprache der Datei.
qwen-code.chat_compression (Counter, Int): Zählt Chat-Komprimierungsvorgänge
- Attribute:
  - tokens_before: (Int): Anzahl der Tokens im Kontext vor der Komprimierung
  - tokens_after: (Int): Anzahl der Tokens im Kontext nach der Komprimierung