tracer

Tracer - logging service

Пример логирования в проекте

package main

import (
	"context"
	"fmt"
	"io/ioutil"
	"net/http"

	"gitlab.com/tehidev/tracer"
)

func main() {
	// Создаём контекст приложения
	ctx := context.Background()

	// Инициализируем трейсер
	ringBufferSize := 1024 * 1024 * 5 // 5 MB
	exporterSecret := ""
	tracing := logger.New().
		WithStdout(true /* colored */).
		WithExporter(ringBufferSize, exporterSecret).
		WithFile("app.log", &logger.FileRotationConfig{
			MaxSizeMB:  50,
			MaxAgeDays: 200,
		})

	// Начинаем трассировку
	appCtx, span := tracing.Start(ctx, "main")
	// В конце выполнения программы заканчиваем трассировку
	defer span.Finish()

	// Просто лог о начале запуска
	span.Info().Msg("app started")

	// Создаём http роутер
	mux := http.NewServeMux()

	// Прописываем ручку экспорта логов по URL /logs
	mux.Handle("/logs", tracing.Handler())

	// Тестовая ручка с логированием
	mux.HandleFunc("/hello", func(w http.ResponseWriter, r *http.Request) {
		// Начинаем трассировку на основе контекста реквеста
		ctx, span := logger.Start(r.Context(), "http.request")
		// В конце выполнения функции заканчиваем трассировку
		defer span.Finish()

		// Пробрасываем поле во все ветки логов
		span.Forward(span.With().
			Str("request_remote_addr", r.RemoteAddr),
		)

		span.Trace().
			Str("uri", r.RequestURI).
			Msg("request info")

		if r.Body != nil {
			if body, err := ioutil.ReadAll(r.Body); err != nil {
				span.Trace().Bytes("body", body).Msg("request body")
			}
			defer r.Body.Close()
		}

		doResponse(ctx, w)
	})

	span.Info().Msg("  follow http://localhost:5050/hello")
	span.Info().Msg("see logs http://localhost:5050/logs")

	http.ListenAndServe(":5050", http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		// Прокидываем контекст трассировки приложения в контекст каждого реквеста
		r = r.WithContext(
			logger.WithContext(r.Context(), appCtx),
		)
		mux.ServeHTTP(w, r)
	}))
}

func doResponse(ctx context.Context, w http.ResponseWriter) {
	// Начинаем трассировку на основе переданного контекста
	span := logger.StartSpan(ctx, "doResponse")
	// В конце выполнения функции заканчиваем трассировку
	defer span.Finish()

	span.Debug().Msg("begin")

	w.WriteHeader(http.StatusOK)
	fmt.Fprint(w, "hello!")
}

Ошибки со стеком

Используйте создание или оборачивание ошибок через gitlab.com/tehidev/tracer/errors

• New
• Newf
• Stack
• Is