Логирование: ревью всего кода и рефакторинг в соответствии с конвенциями

internal/metadata/http.go

@@ -10,6 +10,9 @@ import (
 	"net/http"
 	"net/url"
 	"time"
+
+	"git.vakhrushev.me/av/jellybit/internal/logctx"
+	"git.vakhrushev.me/av/jellybit/internal/logging"
 )
 
 const defaultTimeout = 10 * time.Second
@@ -38,8 +41,9 @@ func newHTTPClient(proxy string, timeout time.Duration) (*http.Client, error) {
 const maxBody = 4 << 20 // 4 MiB — потолок на тело ответа
 
 // getJSON выполняет GET и декодирует JSON-ответ в out. headers — опц.
-// дополнительные заголовки (напр. Authorization).
-func getJSON(ctx context.Context, hc *http.Client, log *slog.Logger, rawURL string, headers map[string]string, out any) error {
+// дополнительные заголовки (напр. Authorization). service/operation — поля
+// ext.* для телеметрии вызова.
+func getJSON(ctx context.Context, hc *http.Client, log *slog.Logger, service, operation, rawURL string, headers map[string]string, out any) error {
 	req, err := http.NewRequestWithContext(ctx, http.MethodGet, rawURL, nil)
 	if err != nil {
 		return fmt.Errorf("metadata: build request: %w", err)
@@ -48,11 +52,11 @@ func getJSON(ctx context.Context, hc *http.Client, log *slog.Logger, rawURL stri
 	for k, v := range headers {
 		req.Header.Set(k, v)
 	}
-	return doJSON(hc, log, req, out)
+	return doJSON(ctx, hc, log, service, operation, req, out)
 }
 
 // postJSON выполняет POST с JSON-телом и декодирует ответ.
-func postJSON(ctx context.Context, hc *http.Client, log *slog.Logger, rawURL string, body, out any) error {
+func postJSON(ctx context.Context, hc *http.Client, log *slog.Logger, service, operation, rawURL string, body, out any) error {
 	payload, err := json.Marshal(body)
 	if err != nil {
 		return fmt.Errorf("metadata: marshal body: %w", err)
@@ -63,46 +67,39 @@ func postJSON(ctx context.Context, hc *http.Client, log *slog.Logger, rawURL str
 	}
 	req.Header.Set("Content-Type", "application/json")
 	req.Header.Set("Accept", "application/json")
-	return doJSON(hc, log, req, out)
+	return doJSON(ctx, hc, log, service, operation, req, out)
 }
 
-// doJSON выполняет запрос и декодирует ответ, логируя исход. В лог идут только
-// host и path (без query) — у TMDB api_key передаётся query-параметром, его
-// нельзя светить в логах.
-func doJSON(hc *http.Client, log *slog.Logger, req *http.Request, out any) error {
-	if log == nil {
-		log = slog.Default()
-	}
-	start := time.Now()
+// doJSON выполняет запрос и декодирует ответ, логируя исход телеметрией ext.*
+// (логическая operation вместо URL: у TMDB api_key передаётся query-параметром,
+// его нельзя светить в логах). Логгер берётся из ctx (scoped-логгер загрузки),
+// при отсутствии — переданный fallback.
+func doJSON(ctx context.Context, hc *http.Client, log *slog.Logger, service, operation string, req *http.Request, out any) error {
+	log = logctx.FromOr(ctx, log)
+	call := logging.ExtCall{Service: service, Operation: operation, Start: time.Now()}
 	resp, err := hc.Do(req)
 	if err != nil {
-		log.Warn("metadata: request failed",
-			"method", req.Method, "host", req.URL.Host, "path", req.URL.Path,
-			"duration", time.Since(start), "err", err)
+		call.Failure(log, err)
 		return fmt.Errorf("metadata: request: %w", err)
 	}
 	defer func() { _ = resp.Body.Close() }()
+	call.Status = resp.StatusCode
 
 	raw, err := io.ReadAll(io.LimitReader(resp.Body, maxBody))
 	if err != nil {
-		log.Warn("metadata: read body failed",
-			"host", req.URL.Host, "path", req.URL.Path, "err", err)
+		call.Failure(log, err)
 		return fmt.Errorf("metadata: read body: %w", err)
 	}
 	if resp.StatusCode != http.StatusOK {
-		log.Warn("metadata: non-ok status",
-			"method", req.Method, "host", req.URL.Host, "path", req.URL.Path,
-			"status", resp.StatusCode, "duration", time.Since(start))
-		return fmt.Errorf("metadata: status %d: %s", resp.StatusCode, snippet(raw))
+		err := fmt.Errorf("metadata: status %d: %s", resp.StatusCode, snippet(raw))
+		call.Failure(log, err)
+		return err
 	}
 	if err := json.Unmarshal(raw, out); err != nil {
-		log.Warn("metadata: decode failed",
-			"host", req.URL.Host, "path", req.URL.Path, "err", err)
+		call.Failure(log, err)
 		return fmt.Errorf("metadata: decode: %w (body: %s)", err, snippet(raw))
 	}
-	log.Debug("metadata: request ok",
-		"method", req.Method, "host", req.URL.Host, "path", req.URL.Path,
-		"duration", time.Since(start))
+	call.Success(log)
 	return nil
 }