Telemetria (eksport OTLP)
Speedwave może wysyłać dane OpenTelemetry (OTLP) z sesji Claude Code działającej w kontenerze do wybranego przez ciebie kolektora. Domyślnie telemetria jest wyłączona i nic nie wychodzi na zewnątrz, dopóki nie włączysz jej w Ustawienia → Telemetria. Sekcja jest obecnie objęta funkcjami beta, więc najpierw włącz przełącznik beta, aby ją zobaczyć; opisane niżej wymuszanie polityki przez organizację działa niezależnie od trybu beta.
Włączanie
Dział zatytułowany „Włączanie”- Otwórz Ustawienia → Telemetria i przełącz główny przełącznik.
- Ustaw adres kolektora, na przykład
https://collector.example.com:4318. - Kliknij Testuj połączenie, aby jeszcze przed pierwszym eksportem sprawdzić, czy kolektor jest osiągalny z tego hosta.
- Wybierz protokół: gRPC, HTTP protobuf albo HTTP JSON.
- Włącz eksport Metryk lub Logów (albo obu), zależnie od tego, które sygnały chcesz zbierać.
- Opcjonalnie ustaw nagłówki uwierzytelniające (na przykład
Authorization=Bearer <token>). Po zapisaniu pole zostaje zamaskowane. Speedwave nigdy nie wyświetla zapisanej wartości nagłówka, a jedynie informację o tym, czy została ustawiona. - Opcjonalnie ustaw atrybuty zasobu, aby otagować eksportowane dane, oraz Dołącz UUID konta, jeśli chcesz, by ten atrybut trafiał do twoich metryk.
Interwał metryk oraz Interwał logów określają, co ile milisekund eksportowany jest każdy z tych sygnałów.
Bramki prywatności dla treści
Dział zatytułowany „Bramki prywatności dla treści”Same metryki i logi niosą liczniki oraz zdarzenia, ale nie samą treść rozmów. To, czy eksportowane logi obejmą również tę treść, kontrolują cztery osobne pola wyboru, a każde z nich jest domyślnie wyłączone:
| Bramka | Zawiera |
|---|---|
| Loguj prompty użytkownika | Tekst, który wysyłasz do Claude |
| Loguj odpowiedzi asystenta | Odpowiedzi Claude |
| Loguj szczegóły narzędzi | Polecenia narzędzi i parametry, które uruchamia Claude |
| Loguj surowe treści API | Surowe treści żądań i odpowiedzi do dostawcy modelu |
Włączenie którejkolwiek z tych opcji wymaga wyraźnego potwierdzenia, ponieważ do twojego kolektora trafia wtedy treść rozmów i kodu. Aby bramki w ogóle zadziałały, musi być też włączony eksport logów: sterują one zawartością wewnątrz tego eksportu i nie tworzą osobnej ścieżki wysyłki.
Wymuszanie przez organizację (MDM)
Dział zatytułowany „Wymuszanie przez organizację (MDM)”Administrator może wymusić lub zablokować dowolny podzbiór tych ustawień, umieszczając plik managed-config.json w lokalizacji obejmującej całą maszynę i dostępnej tylko dla administratora:
- macOS:
/Library/Application Support/Speedwave/managed-config.json - Windows:
<ProgramData>\Speedwave\managed-config.json, rozwiązywane przez własne API znanych folderów Windows, a nie przez zmienną środowiskową%ProgramData%, dzięki czemu spreparowana zmienna nie ukryje polityki przed Speedwave.
Blokadą jest już sama obecność pliku: każde pole, które on ustawia, staje się w Ustawieniach polem tylko do odczytu, oznaczonym ikoną kłódki i opisem “zarządzane przez twoją organizację”. Jeśli pole pominiesz, kontrolę nad nim zachowuje użytkownik. Brak pliku niczego nie zmienia, a plik źle sformatowany albo polityka, której Speedwave nie potrafi rozwiązać, jest wychwytywana jednorazowo przy starcie i zatrzymuje uruchomienie aplikacji błędem “Organization policy error”, zamiast po cichu ignorować politykę albo zastosować ją tylko częściowo. Ustawienie enabled: false w zarządzanym pliku działa jak wyłącznik awaryjny: cała sekcja Telemetria zwija się wtedy do zablokowanego banera z napisem “Zarządzane przez twoją organizację, telemetrii nie można tu zmienić”, pozbawionego jakichkolwiek edytowalnych kontrolek.
Speedwave wymusza zablokowane wartości powtórnie także na poziomie procesu: jeszcze przed uruchomieniem kontenera usuwa każdą ustawioną przez użytkownika zmienną środowiskową odpowiadającą zablokowanemu polu i wstawia w jej miejsce wartość zarządzaną. Dzięki temu zablokowane ustawienie pozostaje zablokowane, nawet gdy coś innego w środowisku próbuje je nadpisać.
Pełną listę kluczy konfiguracji, które Speedwave zapisuje w innych miejscach, znajdziesz w Kluczach konfiguracji oraz Zmiennych środowiskowych. O tym, jakie dane w ogóle wychodzą z twojej maszyny, przeczytasz w Dane i prywatność.