package history import ( "bytes" "context" "encoding/json" "fmt" "io" "net" "os" "slices" "time" "github.com/containerd/console" "github.com/containerd/containerd/v2/core/content/proxy" "github.com/docker/buildx/builder" "github.com/docker/buildx/util/cobrautil/completion" "github.com/docker/buildx/util/otelutil" "github.com/docker/buildx/util/otelutil/jaeger" "github.com/docker/cli/cli/command" controlapi "github.com/moby/buildkit/api/services/control" "github.com/opencontainers/go-digest" ocispecs "github.com/opencontainers/image-spec/specs-go/v1" "github.com/pkg/browser" "github.com/pkg/errors" "github.com/spf13/cobra" jaegerui "github.com/tonistiigi/jaeger-ui-rest" ) type traceOptions struct { builder string ref string containerName string addr string } func runTrace(ctx context.Context, dockerCli command.Cli, opts traceOptions) error { b, err := builder.New(dockerCli, builder.WithName(opts.builder)) if err != nil { return err } nodes, err := b.LoadNodes(ctx) if err != nil { return err } for _, node := range nodes { if node.Err != nil { return node.Err } } recs, err := queryRecords(ctx, opts.ref, nodes) if err != nil { return err } var rec *historyRecord if opts.ref == "" { slices.SortFunc(recs, func(a, b historyRecord) int { return b.CreatedAt.AsTime().Compare(a.CreatedAt.AsTime()) }) for _, r := range recs { if r.CompletedAt != nil { rec = &r break } } } else { rec = &recs[0] } if rec == nil { if opts.ref == "" { return errors.New("no records found") } return errors.Errorf("no record found for ref %q", opts.ref) } if rec.CompletedAt == nil { return errors.Errorf("build %q is not completed, only completed builds can be traced", rec.Ref) } if rec.Trace == nil { // build is complete but no trace yet. try to finalize the trace time.Sleep(1 * time.Second) // give some extra time for last parts of trace to be written c, err := rec.node.Driver.Client(ctx) if err != nil { return err } _, err = c.ControlClient().UpdateBuildHistory(ctx, &controlapi.UpdateBuildHistoryRequest{ Ref: rec.Ref, Finalize: true, }) if err != nil { return err } recs, err := queryRecords(ctx, rec.Ref, []builder.Node{*rec.node}) if err != nil { return err } if len(recs) == 0 { return errors.Errorf("build record %q was deleted", rec.Ref) } rec = &recs[0] if rec.Trace == nil { return errors.Errorf("build record %q is missing a trace", rec.Ref) } } c, err := rec.node.Driver.Client(ctx) if err != nil { return err } store := proxy.NewContentStore(c.ContentClient()) ra, err := store.ReaderAt(ctx, ocispecs.Descriptor{ Digest: digest.Digest(rec.Trace.Digest), MediaType: rec.Trace.MediaType, Size: rec.Trace.Size, }) if err != nil { return err } spans, err := otelutil.ParseSpanStubs(io.NewSectionReader(ra, 0, ra.Size())) if err != nil { return err } wrapper := struct { Data []jaeger.Trace `json:"data"` }{ Data: spans.JaegerData().Data, } var term bool if _, err := console.ConsoleFromFile(os.Stdout); err == nil { term = true } if len(wrapper.Data) == 0 { return errors.New("no trace data") } if !term { enc := json.NewEncoder(dockerCli.Out()) enc.SetIndent("", " ") return enc.Encode(wrapper) } srv := jaegerui.NewServer(jaegerui.Config{}) buf := &bytes.Buffer{} enc := json.NewEncoder(buf) enc.SetIndent("", " ") if err := enc.Encode(wrapper); err != nil { return err } if err := srv.AddTrace(string(wrapper.Data[0].TraceID), bytes.NewReader(buf.Bytes())); err != nil { return err } ln, err := net.Listen("tcp", opts.addr) if err != nil { return err } url := "http://" + ln.Addr().String() + "/trace/" + string(wrapper.Data[0].TraceID) go func() { time.Sleep(100 * time.Millisecond) browser.OpenURL(url) }() fmt.Fprintf(dockerCli.Err(), "Trace available at %s\n", url) go func() { <-ctx.Done() ln.Close() }() err = srv.Serve(ln) if err != nil { select { case <-ctx.Done(): return nil default: } } return err } func traceCmd(dockerCli command.Cli, rootOpts RootOptions) *cobra.Command { var options traceOptions cmd := &cobra.Command{ Use: "trace [OPTIONS] [REF]", Short: "Show the OpenTelemetry trace of a build record", Args: cobra.MaximumNArgs(1), RunE: func(cmd *cobra.Command, args []string) error { if len(args) > 0 { options.ref = args[0] } options.builder = *rootOpts.Builder return runTrace(cmd.Context(), dockerCli, options) }, ValidArgsFunction: completion.Disable, } flags := cmd.Flags() flags.StringVar(&options.containerName, "container", "", "Container name") flags.StringVar(&options.addr, "addr", "127.0.0.1:0", "Address to bind the UI server") return cmd }