Integracje
Q247 sam nie generuje danych. Wszystko, co widać na dashboardach, pochodzi z systemów, które już działają u Klienta: repozytoriów kodu, Jiry, Confluence, dostawcy tożsamości. Ta część Konfiguracji odpowiada za połączenia z nimi.
Integracje dzielą się na trzy grupy o różnym charakterze. Pierwsza dostarcza dane o pracy i bez niej platforma jest pusta. Druga dotyczy kont i logowania i jest opcjonalna, bo organizacja może zarządzać kontami ręcznie. Trzecia obsługuje funkcje AI: przyjmuje dane o korzystaniu z narzędzi AI i udostępnia model językowy Asystentowi AI.
Integracje dostarczające dane
| Integracja | Co wnosi | Kiedy jest potrzebna |
|---|---|---|
| Konektory | commity i historia repozytoriów, z których liczone są Kalorie, Przyrosty i Linie, oraz historia wdrożeń CI/CD | zawsze, to podstawa działania Q247 |
| Jira | historia zmian statusów ticketów | gdy organizacja chce mierzyć Czas realizacji i Czas cyklu |
| Confluence | wysiłek wkładany w dokumentację | gdy dokumentacja jest istotną częścią pracy zespołu |
| Azure Boards | praca na work itemach Azure DevOps | gdy organizacja prowadzi zadania w Azure DevOps Server zamiast w Jirze albo obok niej |
| Azure Wiki | wysiłek wkładany w dokumentację w Azure DevOps | gdy dokumentacja mieszka w wiki Azure DevOps Server |
Konektory to podkategoria: jeden konektor odpowiada jednemu systemowi kontroli wersji, a Q247 obsługuje siedem typów, od GitLaba i GitHuba po repozytoria dodawane ręcznie.
Azure Boards i Azure Wiki dzielą jedną kartę integracji, przełączaną polem zakresu danych. Podłączenie drugiego z tych źródeł sprowadza się do zaznaczenia dodatkowego pola, bez ponownego podawania poświadczeń. Obie strony opisują pełną procedurę, więc wystarczy otworzyć tę, która dotyczy podłączanego źródła.
Uruchomienie analizy kodu to przewodnik po całym procesie od utworzenia konektora do pojawienia się danych na dashboardzie.
Kolejność czynności jest ważniejsza niż szczegóły pojedynczych pól. Objaw pominięcia jednego z kroków wygląda identycznie jak awaria integracji: konektor pokazuje status Operacyjny, a dashboardy są puste.
Integracje tożsamościowe
Te dwie obsługują różne rzeczy i wdraża się je niezależnie.
| Integracja | Za co odpowiada | Czego nie robi |
|---|---|---|
| SSO (OIDC) | logowanie przez zewnętrznego dostawcę tożsamości | nie tworzy kont |
| Provisioning SCIM | zakładanie, aktualizowanie i dezaktywowanie kont oraz zespołów | nie ma wpływu na sposób logowania |
Można wdrożyć jedną z nich, obie albo żadną. Przy obu naraz dostawca tożsamości zakłada konta, a użytkownicy logują się bez hasła po stronie Q247. Przy samym SSO konta trzeba założyć ręcznie, inaczej logowanie nie znajdzie ich odpowiednika w Q247.
Integracje funkcji AI
Obie są opcjonalne i niezależne od siebie, a każda obsługuje inną funkcję AI.
| Integracja | Za co odpowiada | Kierunek danych |
|---|---|---|
| Logi narzędzi AI | odbiór telemetrii z narzędzi AI, w tym Claude Code | do Q247 |
| Model językowy | model obsługujący Asystenta AI | z Q247 do modelu |
Pierwsza z nich zasila liczby w Adopcji AI, druga odpowiada za odpowiedzi Asystenta AI. Adopcja AI działa też bez telemetrii, opierając się wtedy na adnotacjach w wiadomościach commitów.
Czynności poza Q247
Integracje to jedyna część Konfiguracji, która wymaga czynności w innych systemach. W zależności od zakresu wdrożenia będzie potrzebna pomoc osób z odpowiednimi uprawnieniami:
- administrator systemu kontroli wersji: konto serwisowe i token z prawem odczytu do repozytoriów objętych analizą; w części systemów token potrzebuje szerszych uprawnień, wymienionych na stronach konektorów i w Uprawnieniach tokenów do zbierania wdrożeń CI/CD,
- administrator Jiry albo Confluence: jednorazowo, do zainstalowania aplikacji Q247 (wersje chmurowe) albo zarejestrowania webhooka (Data Center), gdy konektor pobiera dane webhookami (Jira, Confluence),
- administrator dostawcy tożsamości: rejestracja aplikacji dla SSO albo konfiguracja konektora SCIM,
- zespół sieciowy: przy wdrożeniach, w których wtyczka działa w infrastrukturze Klienta.
Każda strona integracji ma własną sekcję wymagań wstępnych z konkretną listą.
Podstrony
Konektory
Konektory systemów kontroli wersji: zasada działania, uprawnienia tokenu, poświadczenia ze zmiennych środowiskowych, dodawanie konektora i diagnostyka.
Uruchomienie analizy kodu
Uruchomienie analizy kodu: pięć kroków od pustej organizacji do danych na dashboardach, od wtyczki i konektora po przypisanie projektów i statusy kont.
Jira
Integracja z Jirą w wariantach Chmura i On-Premise: dane ticketów dla metryk przepływu, webhooki albo tryb API, dane historyczne, uruchomienie i diagnostyka.
Confluence
Integracja z Confluence w wariantach Chmura i On-Premise: Kalorie ze stron i komentarzy, webhooki albo tryb API, dane historyczne i diagnostyka.
Azure Boards
Integracja Azure Boards: Kalorie z work itemów Azure DevOps Server, przypisywane do projektów przez prefiks Area Path, z uruchomieniem i mapowaniem tożsamości.
Azure Wiki
Integracja Azure Wiki: Kalorie ze stron wiki Azure DevOps Server, przypisywane do projektów przez prefiks ścieżki, z uruchomieniem i mapowaniem tożsamości.
SSO (OIDC)
Logowanie SSO (OIDC) przez dostawcę tożsamości, np. Entra ID, Okta albo Keycloak: pola w Q247, konfiguracja u dostawcy i wymagania wobec kont.
Provisioning SCIM
Provisioning SCIM: automatyczne zakładanie i dezaktywowanie kont z dostawcy tożsamości, mapowanie grup na role i dostęp, uruchomienie i rotacja tokenu.
Logi narzędzi AI
Logi narzędzi AI: odbiór telemetrii OpenTelemetry z narzędzi AI, takich jak Claude Code, przez kolektor wbudowany we wtyczkę albo z Dynatrace.
Model językowy
Model językowy dla Asystenta AI w trzech wariantach: model Klienta w chmurze, model on-premise albo infrastruktura Q247, z ruchem sieciowym i zakresem danych.
Zobacz też
- Konfiguracja: pozostałe sekcje tej zakładki, bez połączeń na zewnątrz
- Enterprise Plugin: komponent, który obsługuje integracje danych
- Bezpieczeństwo Enterprise Plugin: zakres danych wymienianych z Q247