2017-10-07 00:16:47 +00:00
|
|
|
// Copyright 2011 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.
|
|
|
|
|
|
|
|
// CPU profiling.
|
|
|
|
//
|
|
|
|
// The signal handler for the profiling clock tick adds a new stack trace
|
2018-12-28 15:30:48 +00:00
|
|
|
// to a log of recent traces. The log is read by a user goroutine that
|
|
|
|
// turns it into formatted profile data. If the reader does not keep up
|
|
|
|
// with the log, those writes will be recorded as a count of lost records.
|
|
|
|
// The actual profile buffer is in profbuf.go.
|
2017-10-07 00:16:47 +00:00
|
|
|
|
|
|
|
package runtime
|
|
|
|
|
|
|
|
import (
|
|
|
|
"runtime/internal/atomic"
|
2018-12-28 15:30:48 +00:00
|
|
|
"runtime/internal/sys"
|
2017-10-07 00:16:47 +00:00
|
|
|
"unsafe"
|
|
|
|
)
|
|
|
|
|
2018-12-28 15:30:48 +00:00
|
|
|
const maxCPUProfStack = 64
|
2017-10-07 00:16:47 +00:00
|
|
|
|
|
|
|
type cpuProfile struct {
|
2018-12-28 15:30:48 +00:00
|
|
|
lock mutex
|
|
|
|
on bool // profiling is on
|
|
|
|
log *profBuf // profile events written here
|
|
|
|
|
|
|
|
// extra holds extra stacks accumulated in addNonGo
|
|
|
|
// corresponding to profiling signals arriving on
|
|
|
|
// non-Go-created threads. Those stacks are written
|
|
|
|
// to log the next time a normal Go thread gets the
|
|
|
|
// signal handler.
|
|
|
|
// Assuming the stacks are 2 words each (we don't get
|
|
|
|
// a full traceback from those threads), plus one word
|
|
|
|
// size for framing, 100 Hz profiling would generate
|
|
|
|
// 300 words per second.
|
|
|
|
// Hopefully a normal Go thread will get the profiling
|
|
|
|
// signal at least once every few seconds.
|
|
|
|
extra [1000]uintptr
|
|
|
|
numExtra int
|
|
|
|
lostExtra uint64 // count of frames lost because extra is full
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
|
|
|
|
2018-12-28 15:30:48 +00:00
|
|
|
var cpuprof cpuProfile
|
2017-10-07 00:16:47 +00:00
|
|
|
|
|
|
|
// SetCPUProfileRate sets the CPU profiling rate to hz samples per second.
|
|
|
|
// If hz <= 0, SetCPUProfileRate turns off profiling.
|
|
|
|
// If the profiler is on, the rate cannot be changed without first turning it off.
|
|
|
|
//
|
|
|
|
// Most clients should use the runtime/pprof package or
|
|
|
|
// the testing package's -test.cpuprofile flag instead of calling
|
|
|
|
// SetCPUProfileRate directly.
|
|
|
|
func SetCPUProfileRate(hz int) {
|
|
|
|
// Clamp hz to something reasonable.
|
|
|
|
if hz < 0 {
|
|
|
|
hz = 0
|
|
|
|
}
|
|
|
|
if hz > 1000000 {
|
|
|
|
hz = 1000000
|
|
|
|
}
|
|
|
|
|
2018-12-28 15:30:48 +00:00
|
|
|
lock(&cpuprof.lock)
|
2017-10-07 00:16:47 +00:00
|
|
|
if hz > 0 {
|
2018-12-28 15:30:48 +00:00
|
|
|
if cpuprof.on || cpuprof.log != nil {
|
2017-10-07 00:16:47 +00:00
|
|
|
print("runtime: cannot set cpu profile rate until previous profile has finished.\n")
|
2018-12-28 15:30:48 +00:00
|
|
|
unlock(&cpuprof.lock)
|
2017-10-07 00:16:47 +00:00
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
cpuprof.on = true
|
2018-12-28 15:30:48 +00:00
|
|
|
cpuprof.log = newProfBuf(1, 1<<17, 1<<14)
|
|
|
|
hdr := [1]uint64{uint64(hz)}
|
|
|
|
cpuprof.log.write(nil, nanotime(), hdr[:], nil)
|
2017-10-07 00:16:47 +00:00
|
|
|
setcpuprofilerate(int32(hz))
|
2018-12-28 15:30:48 +00:00
|
|
|
} else if cpuprof.on {
|
2017-10-07 00:16:47 +00:00
|
|
|
setcpuprofilerate(0)
|
|
|
|
cpuprof.on = false
|
2018-12-28 15:30:48 +00:00
|
|
|
cpuprof.addExtra()
|
|
|
|
cpuprof.log.close()
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
2018-12-28 15:30:48 +00:00
|
|
|
unlock(&cpuprof.lock)
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// add adds the stack trace to the profile.
|
|
|
|
// It is called from signal handlers and other limited environments
|
|
|
|
// and cannot allocate memory or acquire locks that might be
|
|
|
|
// held at the time of the signal, nor can it use substantial amounts
|
2018-12-28 15:30:48 +00:00
|
|
|
// of stack.
|
2017-10-07 00:16:47 +00:00
|
|
|
//go:nowritebarrierrec
|
2018-12-28 15:30:48 +00:00
|
|
|
func (p *cpuProfile) add(gp *g, stk []uintptr) {
|
|
|
|
// Simple cas-lock to coordinate with setcpuprofilerate.
|
|
|
|
for !atomic.Cas(&prof.signalLock, 0, 1) {
|
|
|
|
osyield()
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
|
|
|
|
2018-12-28 15:30:48 +00:00
|
|
|
if prof.hz != 0 { // implies cpuprof.log != nil
|
|
|
|
if p.numExtra > 0 || p.lostExtra > 0 {
|
|
|
|
p.addExtra()
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
2018-12-28 15:30:48 +00:00
|
|
|
hdr := [1]uint64{1}
|
|
|
|
// Note: write "knows" that the argument is &gp.labels,
|
|
|
|
// because otherwise its write barrier behavior may not
|
|
|
|
// be correct. See the long comment there before
|
|
|
|
// changing the argument here.
|
|
|
|
cpuprof.log.write(&gp.labels, nanotime(), hdr[:], stk)
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
|
|
|
|
2018-12-28 15:30:48 +00:00
|
|
|
atomic.Store(&prof.signalLock, 0)
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
|
|
|
|
2018-12-28 15:30:48 +00:00
|
|
|
// addNonGo adds the non-Go stack trace to the profile.
|
|
|
|
// It is called from a non-Go thread, so we cannot use much stack at all,
|
|
|
|
// nor do anything that needs a g or an m.
|
|
|
|
// In particular, we can't call cpuprof.log.write.
|
|
|
|
// Instead, we copy the stack into cpuprof.extra,
|
|
|
|
// which will be drained the next time a Go thread
|
|
|
|
// gets the signal handling event.
|
2017-10-07 00:16:47 +00:00
|
|
|
//go:nosplit
|
|
|
|
//go:nowritebarrierrec
|
2018-12-28 15:30:48 +00:00
|
|
|
func (p *cpuProfile) addNonGo(stk []uintptr) {
|
|
|
|
// Simple cas-lock to coordinate with SetCPUProfileRate.
|
|
|
|
// (Other calls to add or addNonGo should be blocked out
|
|
|
|
// by the fact that only one SIGPROF can be handled by the
|
|
|
|
// process at a time. If not, this lock will serialize those too.)
|
|
|
|
for !atomic.Cas(&prof.signalLock, 0, 1) {
|
|
|
|
osyield()
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
|
|
|
|
2018-12-28 15:30:48 +00:00
|
|
|
if cpuprof.numExtra+1+len(stk) < len(cpuprof.extra) {
|
|
|
|
i := cpuprof.numExtra
|
|
|
|
cpuprof.extra[i] = uintptr(1 + len(stk))
|
|
|
|
copy(cpuprof.extra[i+1:], stk)
|
|
|
|
cpuprof.numExtra += 1 + len(stk)
|
|
|
|
} else {
|
|
|
|
cpuprof.lostExtra++
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
|
|
|
|
2018-12-28 15:30:48 +00:00
|
|
|
atomic.Store(&prof.signalLock, 0)
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
|
|
|
|
2018-12-28 15:30:48 +00:00
|
|
|
// addExtra adds the "extra" profiling events,
|
|
|
|
// queued by addNonGo, to the profile log.
|
|
|
|
// addExtra is called either from a signal handler on a Go thread
|
|
|
|
// or from an ordinary goroutine; either way it can use stack
|
|
|
|
// and has a g. The world may be stopped, though.
|
|
|
|
func (p *cpuProfile) addExtra() {
|
|
|
|
// Copy accumulated non-Go profile events.
|
|
|
|
hdr := [1]uint64{1}
|
|
|
|
for i := 0; i < p.numExtra; {
|
|
|
|
p.log.write(nil, 0, hdr[:], p.extra[i+1:i+int(p.extra[i])])
|
|
|
|
i += int(p.extra[i])
|
|
|
|
}
|
|
|
|
p.numExtra = 0
|
|
|
|
|
|
|
|
// Report any lost events.
|
|
|
|
if p.lostExtra > 0 {
|
|
|
|
hdr := [1]uint64{p.lostExtra}
|
|
|
|
lostStk := [2]uintptr{
|
|
|
|
_LostExternalCodePC + sys.PCQuantum,
|
|
|
|
_ExternalCodePC + sys.PCQuantum,
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
2018-12-28 15:30:48 +00:00
|
|
|
cpuprof.log.write(nil, 0, hdr[:], lostStk[:])
|
|
|
|
p.lostExtra = 0
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2018-12-28 15:30:48 +00:00
|
|
|
func (p *cpuProfile) addLostAtomic64(count uint64) {
|
|
|
|
hdr := [1]uint64{count}
|
|
|
|
lostStk := [2]uintptr{
|
|
|
|
_LostSIGPROFDuringAtomic64PC + sys.PCQuantum,
|
|
|
|
_SystemPC + sys.PCQuantum,
|
|
|
|
}
|
|
|
|
cpuprof.log.write(nil, 0, hdr[:], lostStk[:])
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
|
|
|
|
2018-12-28 15:30:48 +00:00
|
|
|
// CPUProfile panics.
|
|
|
|
// It formerly provided raw access to chunks of
|
|
|
|
// a pprof-format profile generated by the runtime.
|
|
|
|
// The details of generating that format have changed,
|
|
|
|
// so this functionality has been removed.
|
2017-10-07 00:16:47 +00:00
|
|
|
//
|
2018-12-28 15:30:48 +00:00
|
|
|
// Deprecated: use the runtime/pprof package,
|
|
|
|
// or the handlers in the net/http/pprof package,
|
|
|
|
// or the testing package's -test.cpuprofile flag instead.
|
2017-10-07 00:16:47 +00:00
|
|
|
func CPUProfile() []byte {
|
2018-12-28 15:30:48 +00:00
|
|
|
panic("CPUProfile no longer available")
|
2017-10-07 00:16:47 +00:00
|
|
|
}
|
|
|
|
|
2019-06-02 15:48:37 +00:00
|
|
|
//go:linkname runtime_pprof_runtime_cyclesPerSecond runtime..z2fpprof.runtime_cyclesPerSecond
|
2017-10-07 00:16:47 +00:00
|
|
|
func runtime_pprof_runtime_cyclesPerSecond() int64 {
|
|
|
|
return tickspersecond()
|
|
|
|
}
|
2018-12-28 15:30:48 +00:00
|
|
|
|
|
|
|
// readProfile, provided to runtime/pprof, returns the next chunk of
|
|
|
|
// binary CPU profiling stack trace data, blocking until data is available.
|
|
|
|
// If profiling is turned off and all the profile data accumulated while it was
|
|
|
|
// on has been returned, readProfile returns eof=true.
|
|
|
|
// The caller must save the returned data and tags before calling readProfile again.
|
|
|
|
//
|
2019-06-02 15:48:37 +00:00
|
|
|
//go:linkname runtime_pprof_readProfile runtime..z2fpprof.readProfile
|
2018-12-28 15:30:48 +00:00
|
|
|
func runtime_pprof_readProfile() ([]uint64, []unsafe.Pointer, bool) {
|
|
|
|
lock(&cpuprof.lock)
|
|
|
|
log := cpuprof.log
|
|
|
|
unlock(&cpuprof.lock)
|
|
|
|
data, tags, eof := log.read(profBufBlocking)
|
|
|
|
if len(data) == 0 && eof {
|
|
|
|
lock(&cpuprof.lock)
|
|
|
|
cpuprof.log = nil
|
|
|
|
unlock(&cpuprof.lock)
|
|
|
|
}
|
|
|
|
return data, tags, eof
|
|
|
|
}
|