Go Academy · Lekcja

Dlaczego logi strukturalne

Logowanie w formacie czytelnym dla maszyn

Lekcja 1 z 413 kroki

Dlaczego logi strukturalne to bezpłatna lekcja Go Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Go Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Go Academy zawiera 4 lekcji w sumie.

Logi czytelne dla maszyn

Tradycyjne logi to ciągi znaków o dowolnym formacie: "user 42 logged in from 1.2.3.4". Są łatwe do odczytania przez ludzi, ale ich odpytywanie przez maszyny jest uciążliwe. Logowanie strukturalne zapisuje pary klucz-wartość, dzięki czemu agregatory logów mogą niezawodnie filtrować i agregować dane.

Problem z logami tekstowymi

Analizowanie tekstu o dowolnym formacie jest kruche:

Formaty zmieniają się z czasem
Wyrażenia regularne zawodzą w przypadkach brzegowych
Nie można łatwo zapytać o „wszystkie zdarzenia, w których userID=42”

Logi strukturalne sprawiają, że każde pole staje się pełnoprawnym atrybutem, który można odpytywać.

slog znajduje się w bibliotece standardowej

Od wersji Go 1.21 logowanie strukturalne jest dostępne w pakiecie biblioteki standardowej log/slog. Nie jest potrzebna żadna zewnętrzna zależność.

import "log/slog"

Pierwszy log strukturalny

Najprostsze wywołanie zapisuje komunikat oraz atrybuty w postaci klucz-wartość:

package main

import "log/slog"

func main() {
    slog.Info("user logged in", "userID", 42, "ip", "1.2.3.4")
}

Odczytywanie danych wyjściowych

Domyślny handler wypisuje coś podobnego do:

2009/11/10 23:00:00 INFO user logged in userID=42 ip=1.2.3.4

Każdy atrybut jest osobną parą key=value, gotową do przetwarzania maszynowego.

Wbudowane poziomy

slog udostępnia cztery poziomy: Debug, Info, Warn, Error. Każdy przyjmuje komunikat oraz naprzemienne atrybuty w postaci klucz-wartość.

slog.Warn("disk almost full", "freePct", 5)
slog.Error("db connection failed", "attempt", 3)

Pary klucz-wartość

Atrybuty przekazuje się jako naprzemienne argumenty: klucz, wartość, klucz, wartość. Samotny nieparzysty argument jest zapisywany ze specjalnym oznaczeniem !BADKEY, dlatego należy zawsze przekazywać je parami.

slog.Info("order placed", "orderID", 1001, "total", 49.99)

JSON w środowisku produkcyjnym

W środowisku produkcyjnym zazwyczaj generuje się dane w formacie JSON, aby narzędzia przesyłające logi (Loki, ELK, CloudWatch) mogły automatycznie indeksować pola. slog ma handler JSON przeznaczony dokładnie do tego celu; zostanie on omówiony w następnej lekcji.

Porównanie ze starym pakietem log

Klasyczny pakiet log wypisuje tylko ciągi znaków. slog zachowuje znajomy sposób pracy, a jednocześnie dodaje strukturę, poziomy i wymienne handlery, bez konieczności jednoczesnej przebudowy całej bazy kodu.

Kiedy struktura się opłaca

Logowanie strukturalne przynosi największe korzyści, gdy:

Centralizują Państwo logi z wielu usług
Tworzą Państwo pulpity i alerty na podstawie pól
Muszą Państwo korelować żądania za pomocą identyfikatora

Program uruchamialny: dane strukturalne

Uruchomienie tego programu pozwala zobaczyć atrybuty strukturalne w domyślnych danych wyjściowych.

package main

import "log/slog"

func main() {
    slog.Info("request handled",
        "method", "GET",
        "path", "/health",
        "status", 200,
        "ms", 12,
    )
}

Szybkie sprawdzenie

Sprawdź, czy rozumiesz logowanie strukturalne.

Odpowiedz w interaktywnej lekcji

Podsumowanie

Nauczyli się Państwo, dlaczego logi strukturalne są ważne:

Atrybuty w postaci klucz-wartość można odpytywać maszynowo
log/slog znajduje się w bibliotece standardowej (Go 1.21+)
Wbudowane poziomy to: Debug, Info, Warn, Error
Atrybuty należy przekazywać naprzemiennie jako pary klucz, wartość

Następnie: wybór handlerów tekstowych lub JSON.

Bezpłatny start

Ucz się Go dzięki korepetycjom AI — za darmo

Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.

Kursy: 51
Lekcje: 203

Zacznij naukę bezpłatnie Wyświetl pełny kurs

Często zadawane pytania

Czy lekcja „Dlaczego logi strukturalne” jest bezpłatna?

Tak — pełny tekst „Dlaczego logi strukturalne” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Go Academy, przejdź na CoddyKit PRO. Kurs Go Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Dlaczego logi strukturalne”?

Logowanie w formacie czytelnym dla maszyn Ćwiczysz Go Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Go Academy?

Nie wymagamy żadnego doświadczenia. Go Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.

Ile czasu zajmuje lekcja „Dlaczego logi strukturalne”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Go Academy?

Tak. Każda lekcja Go Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Go Academy