// Copyright 2019 The Go Authors. All rights reserved. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. package debug import ( "archive/zip" "bytes" "context" "fmt" "html/template" "io" "log" "net" "net/http" "net/http/pprof" "os" "path" "path/filepath" "runtime" rpprof "runtime/pprof" "strconv" "strings" "sync" "time" "golang.org/x/tools/internal/event" "golang.org/x/tools/internal/event/core" "golang.org/x/tools/internal/event/export" "golang.org/x/tools/internal/event/export/metric" "golang.org/x/tools/internal/event/export/ocagent" "golang.org/x/tools/internal/event/export/prometheus" "golang.org/x/tools/internal/event/keys" "golang.org/x/tools/internal/event/label" "golang.org/x/tools/internal/lsp/cache" "golang.org/x/tools/internal/lsp/debug/tag" "golang.org/x/tools/internal/lsp/protocol" "golang.org/x/tools/internal/lsp/source" "golang.org/x/xerrors" ) type instanceKeyType int const instanceKey = instanceKeyType(0) // An Instance holds all debug information associated with a gopls instance. type Instance struct { Logfile string StartTime time.Time ServerAddress string DebugAddress string ListenedDebugAddress string Workdir string OCAgentConfig string LogWriter io.Writer exporter event.Exporter ocagent *ocagent.Exporter prometheus *prometheus.Exporter rpcs *rpcs traces *traces State *State } // State holds debugging information related to the server state. type State struct { mu sync.Mutex clients []*Client servers []*Server } // Caches returns the set of Cache objects currently being served. func (st *State) Caches() []*cache.Cache { var caches []*cache.Cache seen := make(map[string]struct{}) for _, client := range st.Clients() { cache, ok := client.Session.Cache().(*cache.Cache) if !ok { continue } if _, found := seen[cache.ID()]; found { continue } seen[cache.ID()] = struct{}{} caches = append(caches, cache) } return caches } // Cache returns the Cache that matches the supplied id. func (st *State) Cache(id string) *cache.Cache { for _, c := range st.Caches() { if c.ID() == id { return c } } return nil } // Sessions returns the set of Session objects currently being served. func (st *State) Sessions() []*cache.Session { var sessions []*cache.Session for _, client := range st.Clients() { sessions = append(sessions, client.Session) } return sessions } // Session returns the Session that matches the supplied id. func (st *State) Session(id string) *cache.Session { for _, s := range st.Sessions() { if s.ID() == id { return s } } return nil } // Views returns the set of View objects currently being served. func (st *State) Views() []*cache.View { var views []*cache.View for _, s := range st.Sessions() { for _, v := range s.Views() { if cv, ok := v.(*cache.View); ok { views = append(views, cv) } } } return views } // View returns the View that matches the supplied id. func (st *State) View(id string) *cache.View { for _, v := range st.Views() { if v.ID() == id { return v } } return nil } // Clients returns the set of Clients currently being served. func (st *State) Clients() []*Client { st.mu.Lock() defer st.mu.Unlock() clients := make([]*Client, len(st.clients)) copy(clients, st.clients) return clients } // View returns the View that matches the supplied id. func (st *State) Client(id string) *Client { for _, c := range st.Clients() { if c.Session.ID() == id { return c } } return nil } // Servers returns the set of Servers the instance is currently connected to. func (st *State) Servers() []*Server { st.mu.Lock() defer st.mu.Unlock() servers := make([]*Server, len(st.servers)) copy(servers, st.servers) return servers } // A Client is an incoming connection from a remote client. type Client struct { Session *cache.Session DebugAddress string Logfile string GoplsPath string ServerID string } // A Server is an outgoing connection to a remote LSP server. type Server struct { ID string DebugAddress string Logfile string GoplsPath string ClientID string } // AddClient adds a client to the set being served. func (st *State) addClient(session *cache.Session) { st.mu.Lock() defer st.mu.Unlock() st.clients = append(st.clients, &Client{Session: session}) } // DropClient removes a client from the set being served. func (st *State) dropClient(session source.Session) { st.mu.Lock() defer st.mu.Unlock() for i, c := range st.clients { if c.Session == session { copy(st.clients[i:], st.clients[i+1:]) st.clients[len(st.clients)-1] = nil st.clients = st.clients[:len(st.clients)-1] return } } } // AddServer adds a server to the set being queried. In practice, there should // be at most one remote server. func (st *State) addServer(server *Server) { st.mu.Lock() defer st.mu.Unlock() st.servers = append(st.servers, server) } // DropServer drops a server from the set being queried. func (st *State) dropServer(id string) { st.mu.Lock() defer st.mu.Unlock() for i, s := range st.servers { if s.ID == id { copy(st.servers[i:], st.servers[i+1:]) st.servers[len(st.servers)-1] = nil st.servers = st.servers[:len(st.servers)-1] return } } } func (i *Instance) getCache(r *http.Request) interface{} { return i.State.Cache(path.Base(r.URL.Path)) } func (i *Instance) getSession(r *http.Request) interface{} { return i.State.Session(path.Base(r.URL.Path)) } func (i Instance) getClient(r *http.Request) interface{} { return i.State.Client(path.Base(r.URL.Path)) } func (i Instance) getServer(r *http.Request) interface{} { i.State.mu.Lock() defer i.State.mu.Unlock() id := path.Base(r.URL.Path) for _, s := range i.State.servers { if s.ID == id { return s } } return nil } func (i Instance) getView(r *http.Request) interface{} { return i.State.View(path.Base(r.URL.Path)) } func (i *Instance) getFile(r *http.Request) interface{} { identifier := path.Base(r.URL.Path) sid := path.Base(path.Dir(r.URL.Path)) s := i.State.Session(sid) if s == nil { return nil } for _, o := range s.Overlays() { if o.Identity().Identifier == identifier { return o } } return nil } func (i *Instance) getInfo(r *http.Request) interface{} { buf := &bytes.Buffer{} i.PrintServerInfo(r.Context(), buf) return template.HTML(buf.String()) } func getMemory(r *http.Request) interface{} { var m runtime.MemStats runtime.ReadMemStats(&m) return m } func init() { event.SetExporter(makeGlobalExporter(os.Stderr)) } func GetInstance(ctx context.Context) *Instance { if ctx == nil { return nil } v := ctx.Value(instanceKey) if v == nil { return nil } return v.(*Instance) } // WithInstance creates debug instance ready for use using the supplied // configuration and stores it in the returned context. func WithInstance(ctx context.Context, workdir, agent string) context.Context { i := &Instance{ StartTime: time.Now(), Workdir: workdir, OCAgentConfig: agent, } i.LogWriter = os.Stderr ocConfig := ocagent.Discover() //TODO: we should not need to adjust the discovered configuration ocConfig.Address = i.OCAgentConfig i.ocagent = ocagent.Connect(ocConfig) i.prometheus = prometheus.New() i.rpcs = &rpcs{} i.traces = &traces{} i.State = &State{} i.exporter = makeInstanceExporter(i) return context.WithValue(ctx, instanceKey, i) } // SetLogFile sets the logfile for use with this instance. func (i *Instance) SetLogFile(logfile string) (func(), error) { // TODO: probably a better solution for deferring closure to the caller would // be for the debug instance to itself be closed, but this fixes the // immediate bug of logs not being captured. closeLog := func() {} if logfile != "" { if logfile == "auto" { logfile = filepath.Join(os.TempDir(), fmt.Sprintf("gopls-%d.log", os.Getpid())) } f, err := os.Create(logfile) if err != nil { return nil, fmt.Errorf("unable to create log file: %w", err) } closeLog = func() { defer f.Close() } log.SetOutput(io.MultiWriter(os.Stderr, f)) i.LogWriter = f } i.Logfile = logfile return closeLog, nil } // Serve starts and runs a debug server in the background. // It also logs the port the server starts on, to allow for :0 auto assigned // ports. func (i *Instance) Serve(ctx context.Context) error { if i.DebugAddress == "" { return nil } listener, err := net.Listen("tcp", i.DebugAddress) if err != nil { return err } i.ListenedDebugAddress = listener.Addr().String() port := listener.Addr().(*net.TCPAddr).Port if strings.HasSuffix(i.DebugAddress, ":0") { log.Printf("debug server listening on port %d", port) } event.Log(ctx, "Debug serving", tag.Port.Of(port)) go func() { mux := http.NewServeMux() mux.HandleFunc("/", render(mainTmpl, func(*http.Request) interface{} { return i })) mux.HandleFunc("/debug/", render(debugTmpl, nil)) mux.HandleFunc("/debug/pprof/", pprof.Index) mux.HandleFunc("/debug/pprof/cmdline", pprof.Cmdline) mux.HandleFunc("/debug/pprof/profile", pprof.Profile) mux.HandleFunc("/debug/pprof/symbol", pprof.Symbol) mux.HandleFunc("/debug/pprof/trace", pprof.Trace) if i.prometheus != nil { mux.HandleFunc("/metrics/", i.prometheus.Serve) } if i.rpcs != nil { mux.HandleFunc("/rpc/", render(rpcTmpl, i.rpcs.getData)) } if i.traces != nil { mux.HandleFunc("/trace/", render(traceTmpl, i.traces.getData)) } mux.HandleFunc("/cache/", render(cacheTmpl, i.getCache)) mux.HandleFunc("/session/", render(sessionTmpl, i.getSession)) mux.HandleFunc("/view/", render(viewTmpl, i.getView)) mux.HandleFunc("/client/", render(clientTmpl, i.getClient)) mux.HandleFunc("/server/", render(serverTmpl, i.getServer)) mux.HandleFunc("/file/", render(fileTmpl, i.getFile)) mux.HandleFunc("/info", render(infoTmpl, i.getInfo)) mux.HandleFunc("/memory", render(memoryTmpl, getMemory)) if err := http.Serve(listener, mux); err != nil { event.Error(ctx, "Debug server failed", err) return } event.Log(ctx, "Debug server finished") }() return nil } // MonitorMemory starts recording memory statistics each second. func (i *Instance) MonitorMemory(ctx context.Context) { tick := time.NewTicker(time.Second) nextThresholdGiB := uint64(1) go func() { for { <-tick.C var mem runtime.MemStats runtime.ReadMemStats(&mem) if mem.HeapAlloc < nextThresholdGiB*1<<30 { continue } if err := i.writeMemoryDebug(nextThresholdGiB, true); err != nil { event.Error(ctx, "writing memory debug info", err) } if err := i.writeMemoryDebug(nextThresholdGiB, false); err != nil { event.Error(ctx, "writing memory debug info", err) } event.Log(ctx, fmt.Sprintf("Wrote memory usage debug info to %v", os.TempDir())) nextThresholdGiB++ } }() } func (i *Instance) writeMemoryDebug(threshold uint64, withNames bool) error { suffix := "withnames" if !withNames { suffix = "nonames" } filename := fmt.Sprintf("gopls.%d-%dGiB-%s.zip", os.Getpid(), threshold, suffix) zipf, err := os.OpenFile(filepath.Join(os.TempDir(), filename), os.O_CREATE|os.O_RDWR, 0644) if err != nil { return err } zipw := zip.NewWriter(zipf) f, err := zipw.Create("heap.pb.gz") if err != nil { return err } if err := rpprof.Lookup("heap").WriteTo(f, 0); err != nil { return err } f, err = zipw.Create("goroutines.txt") if err != nil { return err } if err := rpprof.Lookup("goroutine").WriteTo(f, 1); err != nil { return err } for _, cache := range i.State.Caches() { cf, err := zipw.Create(fmt.Sprintf("cache-%v.html", cache.ID())) if err != nil { return err } if _, err := cf.Write([]byte(cache.PackageStats(withNames))); err != nil { return err } } if err := zipw.Close(); err != nil { return err } return zipf.Close() } func makeGlobalExporter(stderr io.Writer) event.Exporter { p := export.Printer{} var pMu sync.Mutex return func(ctx context.Context, ev core.Event, lm label.Map) context.Context { i := GetInstance(ctx) if event.IsLog(ev) { // Don't log context cancellation errors. if err := keys.Err.Get(ev); xerrors.Is(err, context.Canceled) { return ctx } // Make sure any log messages without an instance go to stderr. if i == nil { pMu.Lock() p.WriteEvent(stderr, ev, lm) pMu.Unlock() } } ctx = protocol.LogEvent(ctx, ev, lm) if i == nil { return ctx } return i.exporter(ctx, ev, lm) } } func makeInstanceExporter(i *Instance) event.Exporter { exporter := func(ctx context.Context, ev core.Event, lm label.Map) context.Context { if i.ocagent != nil { ctx = i.ocagent.ProcessEvent(ctx, ev, lm) } if i.prometheus != nil { ctx = i.prometheus.ProcessEvent(ctx, ev, lm) } if i.rpcs != nil { ctx = i.rpcs.ProcessEvent(ctx, ev, lm) } if i.traces != nil { ctx = i.traces.ProcessEvent(ctx, ev, lm) } if event.IsLog(ev) { if s := cache.KeyCreateSession.Get(ev); s != nil { i.State.addClient(s) } if sid := tag.NewServer.Get(ev); sid != "" { i.State.addServer(&Server{ ID: sid, Logfile: tag.Logfile.Get(ev), DebugAddress: tag.DebugAddress.Get(ev), GoplsPath: tag.GoplsPath.Get(ev), ClientID: tag.ClientID.Get(ev), }) } if s := cache.KeyShutdownSession.Get(ev); s != nil { i.State.dropClient(s) } if sid := tag.EndServer.Get(ev); sid != "" { i.State.dropServer(sid) } if s := cache.KeyUpdateSession.Get(ev); s != nil { if c := i.State.Client(s.ID()); c != nil { c.DebugAddress = tag.DebugAddress.Get(ev) c.Logfile = tag.Logfile.Get(ev) c.ServerID = tag.ServerID.Get(ev) c.GoplsPath = tag.GoplsPath.Get(ev) } } } return ctx } metrics := metric.Config{} registerMetrics(&metrics) exporter = metrics.Exporter(exporter) exporter = export.Spans(exporter) exporter = export.Labels(exporter) return exporter } type dataFunc func(*http.Request) interface{} func render(tmpl *template.Template, fun dataFunc) func(http.ResponseWriter, *http.Request) { return func(w http.ResponseWriter, r *http.Request) { var data interface{} if fun != nil { data = fun(r) } if err := tmpl.Execute(w, data); err != nil { event.Error(context.Background(), "", err) http.Error(w, err.Error(), http.StatusInternalServerError) } } } func commas(s string) string { for i := len(s); i > 3; { i -= 3 s = s[:i] + "," + s[i:] } return s } func fuint64(v uint64) string { return commas(strconv.FormatUint(v, 10)) } func fuint32(v uint32) string { return commas(strconv.FormatUint(uint64(v), 10)) } func fcontent(v []byte) string { return string(v) } var baseTemplate = template.Must(template.New("").Parse(` {{template "title" .}} {{block "head" .}}{{end}} Main Info Memory Metrics RPC Trace

{{template "title" .}}

{{block "body" .}} Unknown page {{end}} {{define "cachelink"}}Cache {{.}}{{end}} {{define "clientlink"}}Client {{.}}{{end}} {{define "serverlink"}}Server {{.}}{{end}} {{define "sessionlink"}}Session {{.}}{{end}} {{define "viewlink"}}View {{.}}{{end}} {{define "filelink"}}{{.URI}}{{end}} `)).Funcs(template.FuncMap{ "fuint64": fuint64, "fuint32": fuint32, "fcontent": fcontent, "localAddress": func(s string) string { // Try to translate loopback addresses to localhost, both for cosmetics and // because unspecified ipv6 addresses can break links on Windows. // // TODO(rfindley): In the future, it would be better not to assume the // server is running on localhost, and instead construct this address using // the remote host. host, port, err := net.SplitHostPort(s) if err != nil { return s } ip := net.ParseIP(host) if ip == nil { return s } if ip.IsLoopback() || ip.IsUnspecified() { return "localhost:" + port } return s }, }) var mainTmpl = template.Must(template.Must(baseTemplate.Clone()).Parse(` {{define "title"}}GoPls server information{{end}} {{define "body"}}

Caches

Sessions

Views

Clients

Servers

{{end}} `)) var infoTmpl = template.Must(template.Must(baseTemplate.Clone()).Parse(` {{define "title"}}GoPls version information{{end}} {{define "body"}} {{.}} {{end}} `)) var memoryTmpl = template.Must(template.Must(baseTemplate.Clone()).Parse(` {{define "title"}}GoPls memory usage{{end}} {{define "head"}}{{end}} {{define "body"}}

Stats

Allocated bytes{{fuint64 .HeapAlloc}}
Total allocated bytes{{fuint64 .TotalAlloc}}
System bytes{{fuint64 .Sys}}
Heap system bytes{{fuint64 .HeapSys}}
Malloc calls{{fuint64 .Mallocs}}
Frees{{fuint64 .Frees}}
Idle heap bytes{{fuint64 .HeapIdle}}
In use bytes{{fuint64 .HeapInuse}}
Released to system bytes{{fuint64 .HeapReleased}}
Heap object count{{fuint64 .HeapObjects}}
Stack in use bytes{{fuint64 .StackInuse}}
Stack from system bytes{{fuint64 .StackSys}}
Bucket hash bytes{{fuint64 .BuckHashSys}}
GC metadata bytes{{fuint64 .GCSys}}
Off heap bytes{{fuint64 .OtherSys}}

By size

{{range .BySize}}{{end}}
SizeMallocsFrees
{{fuint32 .Size}}{{fuint64 .Mallocs}}{{fuint64 .Frees}}
{{end}} `)) var debugTmpl = template.Must(template.Must(baseTemplate.Clone()).Parse(` {{define "title"}}GoPls Debug pages{{end}} {{define "body"}} Profiling {{end}} `)) var cacheTmpl = template.Must(template.Must(baseTemplate.Clone()).Parse(` {{define "title"}}Cache {{.ID}}{{end}} {{define "body"}}

memoize.Store entries

Per-package usage - not accurate, for guidance only

{{.PackageStats true}} {{end}} `)) var clientTmpl = template.Must(template.Must(baseTemplate.Clone()).Parse(` {{define "title"}}Client {{.Session.ID}}{{end}} {{define "body"}} Using session: {{template "sessionlink" .Session.ID}}
{{if .DebugAddress}}Debug this client at: {{localAddress .DebugAddress}}
{{end}} Logfile: {{.Logfile}}
Gopls Path: {{.GoplsPath}}
{{end}} `)) var serverTmpl = template.Must(template.Must(baseTemplate.Clone()).Parse(` {{define "title"}}Server {{.ID}}{{end}} {{define "body"}} {{if .DebugAddress}}Debug this server at: {{localAddress .DebugAddress}}
{{end}} Logfile: {{.Logfile}}
Gopls Path: {{.GoplsPath}}
{{end}} `)) var sessionTmpl = template.Must(template.Must(baseTemplate.Clone()).Parse(` {{define "title"}}Session {{.ID}}{{end}} {{define "body"}} From: {{template "cachelink" .Cache.ID}}

Views

Overlays

{{end}} `)) var viewTmpl = template.Must(template.Must(baseTemplate.Clone()).Parse(` {{define "title"}}View {{.ID}}{{end}} {{define "body"}} Name: {{.Name}}
Folder: {{.Folder}}
From: {{template "sessionlink" .Session.ID}}

Environment

{{end}} `)) var fileTmpl = template.Must(template.Must(baseTemplate.Clone()).Parse(` {{define "title"}}Overlay {{.Identity.Identifier}}{{end}} {{define "body"}} {{with .Identity}} From: {{template "sessionlink" .SessionID}}
URI: {{.URI}}
Identifier: {{.Identifier}}
Version: {{.Version}}
Kind: {{.Kind}}
{{end}}

Contents

{{fcontent .Data}}
{{end}} `))