plain-optimize
Captures and analyzes performance traces to identify slow queries and N+1 problems. Use when analyzing performance or optimizing database queries.
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Captures and analyzes performance traces to identify slow queries and N+1 problems. Use when analyzing performance or optimizing database queries.
How to use
Uruchom obserwator wydajności na wybranej ścieżce aplikacji poleceniem uv run plain observer request /path. Jeśli chcesz testować jako zalogowany użytkownik, dodaj flagę --user z identyfikatorem lub adresem e-mail, np. uv run plain observer request /path --user 1. Dla żądań POST użyj flag --method POST --data z danymi w formacie JSON.
Przeanalizuj zwrócony raport JSON, zwracając szczególną uwagę na tablicę issues — tam znajdują się automatycznie wykryte duplikaty zapytań wraz z lokalizacjami w kodzie. Sprawdź także liczniki query_count i duplicate_query_count, aby zrozumieć skalę problemu.
Zidentyfikuj główne bottlenecki: szukaj zapytań powtarzających się wiele razy (N+1), zapytań o wysokim total_duration_ms, brakujących indeksów w bazie lub niepotrzebnych operacji na gorących ścieżkach kodu.
Zastosuj poprawki — dla N+1 dodaj select_related() lub prefetch_related(), dla wolnych zapytań rozważ indeksy, a dla drogich obliczeń wdroż cache.
Uruchom ponownie to samo polecenie obserwatora i porównaj metryki query_count, duplicate_query_count oraz trace.duration_ms, aby potwierdzić poprawę wydajności.