# 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](/pl/docs/guides/beta-features/), 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

1. Otwórz **Ustawienia → Telemetria** i przełącz główny przełącznik.
2. Ustaw **adres kolektora**, na przykład `https://collector.example.com:4318`.
3. Kliknij **Testuj połączenie**, aby jeszcze przed pierwszym eksportem sprawdzić, czy kolektor jest osiągalny z tego hosta.
4. Wybierz **protokół**: gRPC, HTTP protobuf albo HTTP JSON.
5. Włącz eksport **Metryk** lub **Logów** (albo obu), zależnie od tego, które sygnały chcesz zbierać.
6. 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.
7. 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

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.
**Te dane wychodzą z twojej maszyny:** Gdy bramka prywatności jest włączona, prompty, odpowiedzi, szczegóły narzędzi lub surowe treści API trafiają pod skonfigurowany przez ciebie adres kolektora. Zanim włączysz którąkolwiek z nich, skieruj eksport na infrastrukturę, której ufasz.

## 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.
**Polityka konsoli Claude tu nie obowiązuje:** Jeśli administrujesz Claude Team albo Enterprise, polityka telemetrii ustawiona we własnych Ustawieniach administracyjnych Claude nie sięga do Claude Code wewnątrz Speedwave. Sesje działają za lokalnym proxy Speedwave, więc `ANTHROPIC_BASE_URL` nigdy nie ma wartości domyślnej, a ustawienia zarządzane po stronie serwera Anthropic zostają pominięte. Posłuż się w zamian plikiem `managed-config.json` Speedwave.

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](/pl/docs/reference/config-keys/) oraz [Zmiennych środowiskowych](/pl/docs/reference/env-vars/). O tym, jakie dane w ogóle wychodzą z twojej maszyny, przeczytasz w [Dane i prywatność](/pl/docs/security/data-and-privacy/).