symbolizer

Documentation

Index

• Variables
• func UnsymbolizableMapping(m *pb.Mapping) bool
• type DebuginfoFetcher
• type DebuginfoMetadata
• type MappingLocations
• type Option
  • func WithAttemptThreshold(t int) Option
  • func WithDemangleMode(mode string) Option
• type Symbolizer
  • func New(logger log.Logger, reg prometheus.Registerer, metadata DebuginfoMetadata, ...) *Symbolizer
  • func (s *Symbolizer) Run(ctx context.Context, interval time.Duration) error
  • func (s *Symbolizer) Symbolize(ctx context.Context, locations []*pb.Location) error

Variables

var (
	ErrNotValidElf = errors.New("not a valid ELF file")
	ErrNoDebuginfo = errors.New("no debug info found")
	ErrLinerFailed = errors.New("liner creation failed")
)

Functions

func UnsymbolizableMapping

func UnsymbolizableMapping(m *pb.Mapping) bool

UnsymbolizableMapping returns true if a mapping points to a binary for which locations can't be symbolized in principle, at least now. Examples are "[vdso]", [vsyscall]" and some others, see the code.

Types

type DebuginfoFetcher

type DebuginfoFetcher interface {
	// Fetch ensures that the debug info for the given build ID is available on
	// a local filesystem and returns a path to it.
	FetchDebuginfo(ctx context.Context, dbginfo *debuginfopb.Debuginfo) (io.ReadCloser, error)
}

type DebuginfoMetadata

type DebuginfoMetadata interface {
	SetQuality(ctx context.Context, buildID string, quality *debuginfopb.DebuginfoQuality) error
	Fetch(ctx context.Context, buildID string) (*debuginfopb.Debuginfo, error)
}

type MappingLocations

type MappingLocations struct {
	Mapping   *pb.Mapping
	Locations []*pb.Location

	// LocationsLines is a list of lines per location.
	LocationsLines [][]profile.LocationLine
}

type Option

type Option func(*Symbolizer)

func WithAttemptThreshold

func WithAttemptThreshold(t int) Option

func WithDemangleMode

func WithDemangleMode(mode string) Option

type Symbolizer

type Symbolizer struct {
	// contains filtered or unexported fields
}

func New

func New(
	logger log.Logger,
	reg prometheus.Registerer,
	metadata DebuginfoMetadata,
	metastore pb.MetastoreServiceClient,
	debuginfo DebuginfoFetcher,
	tmpDir string,
	batchSize uint32,
	opts ...Option,
) *Symbolizer

func (*Symbolizer) Run

func (s *Symbolizer) Run(ctx context.Context, interval time.Duration) error

func (*Symbolizer) Symbolize

func (s *Symbolizer) Symbolize(ctx context.Context, locations []*pb.Location) error