mirror of
https://github.com/zrepl/zrepl.git
synced 2024-12-01 21:04:59 +01:00
10a14a8c50
package trace:
- introduce the concept of tasks and spans, tracked as linked list within ctx
- see package-level docs for an overview of the concepts
- **main feature 1**: unique stack of task and span IDs
- makes it easy to follow a series of log entries in concurrent code
- **main feature 2**: ability to produce a chrome://tracing-compatible trace file
- either via an env variable or a `zrepl pprof` subcommand
- this is not a CPU profile, we already have go pprof for that
- but it is very useful to visually inspect where the
replication / snapshotter / pruner spends its time
( fixes #307 )
usage in package daemon/logging:
- goal: every log entry should have a trace field with the ID stack from package trace
- make `logging.GetLogger(ctx, Subsys)` the authoritative `logger.Logger` factory function
- the context carries a linked list of injected fields which
`logging.GetLogger` adds to the logger it returns
- `logging.GetLogger` also uses package `trace` to get the
task-and-span-stack and injects it into the returned logger's fields
48 lines
833 B
Go
48 lines
833 B
Go
package trace
|
|
|
|
import (
|
|
"encoding/base64"
|
|
"math/rand"
|
|
"os"
|
|
"strings"
|
|
"time"
|
|
|
|
"github.com/zrepl/zrepl/util/envconst"
|
|
)
|
|
|
|
var genIdPRNG = rand.New(rand.NewSource(1))
|
|
|
|
func init() {
|
|
genIdPRNG.Seed(time.Now().UnixNano())
|
|
genIdPRNG.Seed(int64(os.Getpid()))
|
|
}
|
|
|
|
var genIdNumBytes = envconst.Int("ZREPL_TRACE_ID_NUM_BYTES", 3)
|
|
|
|
func init() {
|
|
if genIdNumBytes < 1 {
|
|
panic("trace node id byte length must be at least 1")
|
|
}
|
|
}
|
|
|
|
func genID() string {
|
|
var out strings.Builder
|
|
enc := base64.NewEncoder(base64.RawStdEncoding, &out)
|
|
buf := make([]byte, genIdNumBytes)
|
|
for i := 0; i < len(buf); {
|
|
n, err := genIdPRNG.Read(buf[i:])
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
i += n
|
|
}
|
|
n, err := enc.Write(buf[:])
|
|
if err != nil || n != len(buf) {
|
|
panic(err)
|
|
}
|
|
if err := enc.Close(); err != nil {
|
|
panic(err)
|
|
}
|
|
return out.String()
|
|
}
|