logging-best-practices
Logging best practices focused on wide events (canonical log lines) for powerful debugging and analytics
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Logging best practices focused on wide events (canonical log lines) for powerful debugging and analytics
How to use
Zainstaluj umiejętność w swoim środowisku agenta lub MCP server, wskazując repozytorium neondatabase/mcp-server-neon oraz ścieżkę do folderu logging-best-practices.
Zastosuj wytyczne, gdy piszesz lub przeglądasz kod logowania — szczególnie przy dodawaniu console.log, logger.info lub podobnych instrukcji w swoich handlerach żądań.
Przeanalizuj swoją obecną strategię logowania i zidentyfikuj miejsca, gdzie rozrzucasz wiele linii logów po całym kodzie obsługi żądania. Zamiast tego skonsoliduj wszystkie dane w jeden obiekt zdarzenia.
Utwórz strukturę "wide event" — pojedyncze zdarzenie kontekstowe zawierające metadane żądania (method, path, requestId, timestamp), dane użytkownika, dane biznesowe (koszyk, stan transakcji) oraz wynik (status_code, outcome, duration_ms).
Emituj to zdarzenie w bloku finally lub na koniec obsługi żądania, aby upewnić się, że wszystkie informacje — zarówno ze ścieżki sukcesu, jak i błędu — są zawarte w jednym logu strukturyzowanym.
Upewnij się, że zdarzenie zawiera pola o wysokiej kardynalności (ID użytkownika, ID żądania) i wysokiej wymiarowości (wiele różnych pól), aby umożliwić zaawansowaną analitykę i debugowanie w narzędziach do obsługi logów.