Przejdź do głównej zawartości

Telemetria (eksport OTLP)

Speedwave umożliwia eksport metryk i zdarzeń OpenTelemetry (OTLP) z sesji Claude Code bezpośrednio do firmowego kolektora telemetrii. Domyślnie telemetria jest wyłączona. Aby skonfigurować parametry eksportu, przejdź do sekcji Ustawienia -> Telemetria (dostępnej po włączeniu opcji Beta features w menu zasobnika). Wymuszenia administracyjne (MDM) obowiązują niezależnie od stanu flagi beta użytkownika.

  1. Otwórz Ustawienia -> Telemetria i włącz główny przełącznik.
  2. Wprowadź adres punktu końcowego kolektora (np. https://collector.example.com:4318).
  3. Kliknij Testuj połączenie, aby zweryfikować dostępność sieciową serwera z poziomu stacji roboczej.
  4. Wybierz protokół transportowy: gRPC, http/protobuf lub http/json.
  5. Aktywuj strumienie eksportu Metryk oraz Logów zgodnie z potrzebami monitorowania.
  6. Opcjonalnie zdefiniuj nagłówki autoryzacyjne (np. Authorization=Bearer <token>). Zapisane wartości są maskowane w interfejsie użytkownika.
  7. Skonfiguruj atrybuty zasobów oraz opcję Dołącz UUID konta, aby jednoznacznie identyfikować stację roboczą w zagregowanych metrykach.

Częstotliwość wysyłania danych regulują parametry Interwał metryk oraz Interwał logów (wartości w milisekundach).

Domyślne strumienie metryk i zdarzeń rejestrują liczby operacji oraz czasy wykonania bez rejestrowania treści rozmów. Cztery niezależne przełączniki regulują obecność danych tekstowych w eksportowanych logach (domyślnie wyłączone):

Opcja prywatnościPrzesyłane dane
Loguj prompty użytkownikaSurowy tekst poleceń wysyłanych do Claude
Loguj odpowiedzi asystentaWygenerowane odpowiedzi modelu
Loguj szczegóły narzędziWykonywane polecenia powłoki, ścieżki plików i parametry narzędzi
Loguj surowe treści APIPełne struktury JSON zapytań i odpowiedzi przekazywane do dostawcy LLM

Włączenie każdej z powyższych opcji wymaga jednoznacznego potwierdzenia. Filtry treści działają wyłącznie w ramach strumienia eksportu logów (wymagana aktywna opcja Eksportuj logi).

Administratorzy systemowi mogą zablokować konfigurację telemetrii na poziomie całej stacji roboczej, wdrażając plik managed-config.json w katalogu systemowym:

  • macOS: /Library/Application Support/Speedwave/managed-config.json
  • Windows: <ProgramData>\Speedwave\managed-config.json (ścieżka pobierana z natywnego API Windows Known Folders w celu ochrony przed manipulacją zmiennymi środowiskowymi).

Obecność zdefiniowanych kluczy w pliku managed-config.json blokuje ich edycję w interfejsie graficznym, oznaczając je ikoną kłódki. Brakujące wpisy pozostają edytowalne dla użytkownika. Błędy składniowe lub nierozpoznane polityki zatrzymują uruchamianie aplikacji z jawnym komunikatem błędu. Ustawienie enabled: false na poziomie zarządzanym całkowicie dezaktywuje moduł telemetrii.

Wymuszone ustawienia są egzekwowane na poziomie procesów kontenerowych: zmienne środowiskowe zdefiniowane w powłoce użytkownika są zastępowane wartościami zadeklarowanymi w polityce przed startem kontenera.

Dodatkowe informacje znajdziesz w sekcjach Klucze konfiguracji, Zmienne środowiskowe oraz Dane i prywatność.