symbol

Documentation

Index

• Variables
• type Option
  • func WithAttemptThreshold(t int) Option
  • func WithCacheItemTTL(ttl time.Duration) Option
  • func WithCacheSize(size int) Option
  • func WithDemangleMode(mode string) Option
• type Symbolizer
  • func NewSymbolizer(logger log.Logger, opts ...Option) (*Symbolizer, error)
  • func (s *Symbolizer) Close() error
  • func (s *Symbolizer) Symbolize(ctx context.Context, m *pb.Mapping, locations []*pb.Location, ...) ([][]profile.LocationLine, error)

Variables

var ErrLinerCreationFailedBefore = errors.New("failed to initialize liner")

Types

type Option

type Option func(*Symbolizer)

func WithAttemptThreshold

func WithAttemptThreshold(t int) Option

func WithCacheItemTTL

func WithCacheItemTTL(ttl time.Duration) Option

func WithCacheSize

func WithCacheSize(size int) Option

func WithDemangleMode

func WithDemangleMode(mode string) Option

type Symbolizer

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

Symbolizer converts the memory addresses, which have been encountered in stack traces, in the ingested profiles, to the corresponding human-readable source code lines.

func NewSymbolizer

func NewSymbolizer(logger log.Logger, opts ...Option) (*Symbolizer, error)

NewSymbolizer creates a new Symbolizer.

By default the cache can hold up to 1000 items with an item TTL 1 minute. The item is a liner that provides access to a single object file to resolve its memory addresses to source code lines.

If a Symbolizer failed to extract source lines, by default it will retry up to 3 times.

The default demangle mode is "simple".

func (*Symbolizer) Close

func (s *Symbolizer) Close() error

Close cleans up resources, e.g., the cache.

func (*Symbolizer) Symbolize

func (s *Symbolizer) Symbolize(ctx context.Context, m *pb.Mapping, locations []*pb.Location, debugInfoFile string) ([][]profile.LocationLine, error)

Symbolize symbolizes locations for the given mapping and object file path using DwarfLiner if the file contains debug info. Otherwise it attempts to use GoLiner, and falls back to SymtabLiner as a last resort.