Health Check (metryki kondycji projektów i zespołów)
Sekcja nosi w interfejsie nazwę "Health Check (metryki kondycji projektów i zespołów)" i ustawia progi, od których zależą oceny kondycji na wszystkich widokach.
Sam opis metryk, ich definicje i sposób liczenia oceny węzła są na stronie Metryki kondycji.
Sekcję widzą wyłącznie konta z organizacyjną rolą Admin, opisaną w Uprawnieniach.
Włączenie funkcji
Przełącznik "Pokaż Health Check" decyduje o tym, czy sekcje kondycji pojawiają się na Pulpicie i na Zespołach oraz czy pigułki kondycji są widoczne w nagłówkach stron projektu i zespołu.
Poza tym przełącznikiem potrzebne są jeszcze dwie rzeczy: funkcja musi być udostępniona organizacji, a Enterprise Plugin musi być w wersji q247-enterprise-plugin-linux-v2.4.2 lub nowszej. Starsza wtyczka nie dostarcza danych, z których liczą się te metryki.
Przełącznik można zapisać bez dotykania progów. Organizacja działa wtedy na wartościach domyślnych.
Pola progów
| Pole | Czego dotyczy | Domyślnie |
|---|---|---|
| Obserwacja od (%) | dolna granica stanu Obserwacja, poniżej niej zaczyna się stan Krytyczny | od 60,0 do 85,0 zależnie od metryki |
| Zdrowy od (%) | dolna granica stanu Zdrowy, osobna dla każdej metryki | od 75,0 do 90,0 zależnie od metryki |
| Akceptowalny czas recenzji (dni robocze) | próg metryki Zaległe PR-y | 2 |
| Scalony bez recenzji szybciej niż (minuty) | próg metryki Błyskawiczne PR-y | 1 |
| Zbyt duży PR powyżej (kal) | próg metryki Zbyt duże PR-y | 450 |
Dwa pierwsze pola powtarzają się przy każdej z pięciu metryk. Trzy kolejne należą do pojedynczych metryk i ustawiają granicę, od której zdarzenie przestaje mieścić się w normie.
Wartości domyślne poszczególnych metryk są zestawione w tabeli na stronie Metryki kondycji.
Próg Obserwacji musi być niższy od progu stanu Zdrowy. Odwrotna kolejność blokuje zapis całej sekcji, łącznie z pozostałymi metrykami.
Przycisk Anuluj przywraca stan sprzed wejścia w tryb edycji. Organizacja, która ustawiła własne wartości, zachowuje je również wtedy, gdy zmienią się wartości domyślne produktu.
Wykresy rozkładu w trybie edycji
Histogramy pojawiają się dopiero po wejściu w tryb edycji i znikają po zapisaniu albo anulowaniu. Pokazują, jak ustawiany próg rozkłada realne dane organizacji, więc pozwalają zobaczyć, ile projektów przejdzie na drugą stronę granicy przed zatwierdzeniem zmiany.
Wykres po lewej jest przy każdej metryce. Pokazuje rozkład projektów według wartości tej metryki, ze znacznikami obu progów procentowych. Kliknięcie słupka pokazuje zawartość kubełka, czyli wartość kondycji poszczególnych projektów.
Wykres po prawej jest tylko przy trzech metrykach, które mają własny próg wartości: Zbyt duże PR-y, Zaległe PR-y i Błyskawiczne PR-y. Pokazuje rozkład pojedynczych pull requestów względem tego progu, a kliknięcie słupka podaje liczbę pull requestów w projekcie. Metryki PR bez recenzji i Aktywność w nadgodzinach mają wyłącznie wykres lewy, bo nie mają progu wartości.
Znaczniki progów przesuwają się na wykresie przy każdym wciśnięciu klawisza, a liczby w podpisie pod wykresem dociągają się z serwera z opóźnieniem. Rozjazd między jednym a drugim w trakcie wpisywania wartości jest normalny i znika po chwili.
Okno danych na wykresach
Histogramy liczą się zawsze z ostatnich 90 dni. Ta wartość jest stała i nie zależy ani od ustawień organizacji, ani od zakresu dat wybranego gdzie indziej w aplikacji. W Zarządzaniu Organizacją nie ma zresztą selektora zakresu dat na górnym pasku.
Rozkład na wykresie służy do dobrania progu. Bieżącą kondycję organizacji pokazuje sekcja przeglądu kondycji na Pulpicie.
Wyłączanie pojedynczych repozytoriów
Progi z tej sekcji obowiązują całą organizację, ale pojedyncze repozytorium można w ogóle wyłączyć z pomiaru. Służy do tego kolumna Health Metrics na liście Źródeł, z akcją wierszową i zbiorczą.
Wyłączone repozytorium nie wchodzi ani do licznika, ani do mianownika żadnej z pięciu metryk, na żadnym poziomie. To właściwe narzędzie dla repozytoriów, których sposób pracy nie poddaje się tej ocenie: kodu generowanego, importów z zewnątrz czy repozytoriów archiwalnych. Dobieranie progów pod taki przypadek zafałszowałoby ocenę wszystkich pozostałych projektów.
Wykluczenie działa wyłącznie na metryki kondycji. Pozostałe widoki i metryki pokazują te dane dalej.
Zasięg zmiany progów
Progi obowiązują całą organizację. Nie da się ustawić ich osobno dla projektu ani dla zespołu.
Zmiana progu działa też wstecz: stany wyliczane są od nowa przy najbliższym przeliczeniu, także dla dat sprzed zmiany. Ponowne skanowanie repozytoriów nie jest do tego potrzebne.
Zobacz też
- Metryki kondycji: definicje pięciu metryk i sposób liczenia oceny
- Kalendarz pracy: godziny pracy i święta, na których opiera się Aktywność w nadgodzinach
- Źródła: wyłączanie pojedynczych repozytoriów z pomiaru