Using profiler labels

Goroutines are functions or methods that run concurrently with other functions or methods. To create a goroutine, use the go keyword followed by a function invocation (for example, go func(p string, rid int64)). But using lots of goroutines makes a program harder to debug. To differentiate between goroutines, you can label goroutines with custom data.

Since Go 1.9, you can record additional information to provide more context about the execution path. You can record any set of labels as a part of the profiling data and use these labels later to examine the profiler output.

For example, you have a queue handler that processes events created somewhere. The handler can set labels to identify where these events were created.

During debugging and core dump analysis, the context information might be helpful. For example, you can use this information to find a particular goroutine more easily.

Adding labels

The runtime/pprof package has several new functions that you can use to add labels. The most popular is the Do function. The Do function takes context, adds labels to this context, and passes new context to the f function.

func Do(ctx context.Context, labels LabelSet, f func(context.Context))

The Do function writes labels only for the current goroutine. If you create new goroutines in the f function, you can pass the context as an argument.

func main() {
    ctx := context.Background()
    for i := 0; i < 10; i++ {
        labels := pprof.Labels("path", "/api/profile", "userId", strconv.Itoa(rand.Intn(100)))
        go pprof.Do(ctx, labels, f)
    }
    time.Sleep(time.Second)
}

Viewing labels in GoLand

For illustrative purposes, copy the following code example from GitHub.

Put a breakpoint where the println("ok") is called. To put the breakpoint, click the gutter at line 21. Run the debug for the main function. To start debugging, click the Run icon () in the gutter near the main function and select Debug <run_debug_configuration_name>. From the Goroutines list, observe available goroutines.

Press Control+F2 to stop debugging. Delete the f(ctx) call and uncomment the Do function. Rerun the debugging process by pressing Control Shift D. Explore the Goroutines list. Goroutine names include the following information: /api/profile, userId: <some number>. You can use this information to find a particular goroutine during debugging or core dump analysis.

Useful links

How to Find Goroutines During Debugging: read the tutorial on how to use profiler tags in GoLand.
Profiler labels in Go at rakyll.org: read more about profiler labels.

Last modified: 17 March 2022