Przejdź do głównej zawartości

Logi narzędzi AI

Ta integracja dostarcza Q247 dane o tym, jak zespół korzysta z narzędzi opartych o duże modele językowe: ile czasu w nich pracuje, ile tokenów zużywa, ile to kosztuje i ile linii kodu z nich pochodzi. Standardem odbioru tych danych jest OpenTelemetry, więc mechanizm jest przygotowany pod dowolne narzędzie AI raportujące w tym formacie. Zaimplementowanym i obsługiwanym źródłem jest dziś Claude Code; dodanie kolejnego narzędzia wymaga modułu odczytującego jego dane, bez zmian w samej integracji.

Bez tej integracji Adopcja AI nadal działa, ale opiera się wyłącznie na rozpoznawaniu wiadomości commitów, więc pokazuje proporcję pracy z udziałem AI bez kosztów i zużycia tokenów.

Zasada działania​

Narzędzie AI działające na komputerze programisty eksportuje telemetrię pod wskazany adres. Enterprise Plugin zbiera te dane, agreguje je dziennie w podziale na użytkowników i przekazuje wynik do Q247. Same rozmowy z modelem ani treść promptów nie są przedmiotem tej integracji: przekazywane są liczniki.

Dane wiąże z kontami w Q247 adres e-mail, którym narzędzie AI podpisuje swoją telemetrię. Dopasowanie adresów opisuje Adopcja AI w Konfiguracji.

Wariant OTel Collector​

Narzędzie AI wysyła metryki bezpośrednio do kolektora OpenTelemetry wbudowanego w Enterprise Plugin.

  • Co robi Klient: konfiguruje eksport telemetrii w narzędziu AI i, jeśli to konieczne, udostępnia port kolektora w sieci wewnętrznej.
  • Co robi Q247: dostarcza kolektor jako element wtyczki.
  • Zmiany po stronie Klienta: żadna dodatkowa platforma monitoringu ani baza danych.
  • Dla kogo: organizacje bez wdrożonego narzędzia klasy APM.

Przykładowa konfiguracja w ustawieniach organizacji Claude Code:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://ep-plugin.firma.pl:4318",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Bearer TOKEN",
    "OTEL_EXPORTER_OTLP_LOGS_ENDPOINT": "http://ep-plugin.firma.pl:4318/v1/logs",
    "OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE": "delta",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}
Adres kolektora i token traktuj jak dane wrażliwe

W przykładzie ep-plugin.firma.pl i TOKEN to wartości zastępcze. Nagłówek OTEL_EXPORTER_OTLP_HEADERS przenosi token uprawniający do wysyłania telemetrii, więc obowiązują go te same zasady co każdemu innemu poświadczeniu: nie trafia do repozytorium ani do zgłoszeń, a jego rotacja odbywa się po stronie Klienta.

Sam kolektor wystawiaj wyłącznie w sieci wewnętrznej. Jeśli musi być dostępny szerzej, postaw przed nim terminację TLS, bo telemetria zawiera adresy e-mail użytkowników i nazwy projektów.

Wariant Dynatrace SaaS​

Narzędzie AI wysyła metryki do Dynatrace, tak samo jak pozostałe dane monitoringowe. Enterprise Plugin pobiera je z Dynatrace w cyklu dobowym.

  • Co robi Klient: konfiguruje eksport do Dynatrace i przekazuje adres środowiska oraz token API z uprawnieniem odczytu metryk.
  • Co robi Q247: konfiguruje połączenie wtyczki z Dynatrace.
  • Zmiany po stronie Klienta: żadne w firewallu, bo wtyczka łączy się wychodząco do Dynatrace.
  • Dla kogo: organizacje korzystające już z Dynatrace.
{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "https://TENANT.live.dynatrace.com/api/v2/otlp/v1/metrics",
    "OTEL_EXPORTER_OTLP_HEADERS": "Authorization=Api-Token TOKEN",
    "OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE": "delta",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_METRICS_EXPORTER": "otlp"
  }
}
Cykl dobowy oznacza dobę opóźnienia

W wariancie Dynatrace dane o kosztach i tokenach pojawiają się w Q247 z opóźnieniem do jednego dnia. Weryfikacja konfiguracji tego samego dnia, w którym została wprowadzona, nic więc nie pokaże.

Dane dostępne po uruchomieniu​

  • Czas pracy w narzędziu AI, w podziale na użytkowników.
  • Liczba tokenów i koszt, zestawiane z liczbą wykupionych licencji.
  • Liczba linii wygenerowanych przez narzędzie AI, zestawiana z pracą powstałą bez jego udziału.

Wszystkie te dane pokazuje widżet Adopcji AI na dashboardach.

Wymagania wstępne​

  • Enterprise Plugin działający w infrastrukturze Klienta, ten sam komponent, który analizuje repozytoria.
  • Narzędzie AI z włączonym eksportem telemetrii w standardzie OpenTelemetry, skierowanym do wybranego miejsca docelowego.
  • Wybrany wariant dostarczania metryk, kolektor we wtyczce albo Dynatrace.
  • Konto z rolą Admin w Q247, bo tylko ona otwiera zakładkę Konfiguracja.
  • Adresy e-mail w narzędziu AI zgodne z adresami kont w Q247, albo gotowość do ręcznego dopasowania tych, które się różnią.

Ruch sieciowy​

PołączenieKierunekWymagane
Narzędzie AI → kolektor we wtyczcewewnątrz sieci Klientatak, w wariancie OTel Collector
Narzędzie AI → Dynatracewychodzący od Klientatak, w wariancie Dynatrace
Wtyczka → Dynatracewychodzący od Klientatak, w wariancie Dynatrace
Wtyczka → Q247wychodzący od Klientatak
Q247 → wtyczkabraknie

Uruchomienie krok po kroku​

  1. Wybór wariantu: kolektor we wtyczce albo Dynatrace, zależnie od tego, czy organizacja ma już platformę monitoringu.
  2. Konfiguracja eksportu w narzędziu AI: blok env w ustawieniach organizacji, według przykładu dla wybranego wariantu.
  3. Konfiguracja odbioru: kolektor jest częścią wtyczki, a przy wariancie Dynatrace potrzebny jest adres środowiska i token odczytu metryk, przekazywane zespołowi wdrożeniowemu Q247.
  4. Włączenie widoczności w sekcji Adopcja AI w Konfiguracji.
  5. Dopasowanie adresów e-mail, po jednym lub dwóch dniach roboczych, gdy telemetria zdąży spłynąć.

Weryfikacja​

Pierwsze dane pojawiają się po kilku godzinach w wariancie kolektora i po dobie w wariancie Dynatrace. Pojawienie się adresów w sekcji "Nieprzypisani użytkownicy narzędzi AI" w Konfiguracji potwierdza, że telemetria dociera do Q247 i brakuje jedynie powiązania z kontami. Wpis w kategorii "adres bez danych" utrzymujący się kilka dni wskazuje na błąd w samym adresie.

Zakres danych​

Do Q247 trafiają dzienne, zagregowane liczniki: czas pracy, liczba tokenów, koszt, liczba wygenerowanych linii oraz adres e-mail, do którego te wartości należą. Prompty, odpowiedzi modelu i treść kodu pozostają w narzędziu AI oraz w infrastrukturze, w której działa wtyczka.

Zobacz też​