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.
Konfiguracja kolektora telemetrii
Dział zatytułowany „Konfiguracja kolektora telemetrii”- Otwórz Ustawienia -> Telemetria i włącz główny przełącznik.
- Wprowadź adres punktu końcowego kolektora (np.
https://collector.example.com:4318). - Kliknij Testuj połączenie, aby zweryfikować dostępność sieciową serwera z poziomu stacji roboczej.
- Wybierz protokół transportowy:
gRPC,http/protobuflubhttp/json. - Aktywuj strumienie eksportu Metryk oraz Logów zgodnie z potrzebami monitorowania.
- Opcjonalnie zdefiniuj nagłówki autoryzacyjne (np.
Authorization=Bearer <token>). Zapisane wartości są maskowane w interfejsie użytkownika. - 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).
Kontrola prywatności w logach
Dział zatytułowany „Kontrola prywatności w logach”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ści | Przesyłane dane |
|---|---|
| Loguj prompty użytkownika | Surowy tekst poleceń wysyłanych do Claude |
| Loguj odpowiedzi asystenta | Wygenerowane odpowiedzi modelu |
| Loguj szczegóły narzędzi | Wykonywane polecenia powłoki, ścieżki plików i parametry narzędzi |
| Loguj surowe treści API | Peł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).
Wymuszanie przez organizację (MDM)
Dział zatytułowany „Wymuszanie przez organizację (MDM)”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ść.