instrumentation

Documentation

Overview

Package instrumentation holds code commonly used between all instrumentation declinations (currently httpsec/grpcsec).

Index

• Constants
• func SetAppSecEnabledTags(span TagSetter)
• func SetEventSpanTags(span TagSetter, events []any) error
• func SetStringTags(span TagSetter, tags map[string]string)
• func SetTags(span TagSetter, tags map[string]interface{})
• type ContextKey
• type SecurityEventsHolder
  • func (s *SecurityEventsHolder) AddSecurityEvents(events []any)
  • func (s *SecurityEventsHolder) ClearEvents()
  • func (s *SecurityEventsHolder) Events() []any
• type TagSetter
• type TagsHolder
  • func NewTagsHolder() TagsHolder
  • func (m *TagsHolder) AddTag(k string, v interface{})
  • func (m *TagsHolder) Tags() map[string]interface{}

Constants

const BlockedRequestTag = "appsec.blocked"

BlockedRequestTag used to convey whether a request is blocked

Functions

func SetAppSecEnabledTags

func SetAppSecEnabledTags(span TagSetter)

SetAppSecEnabledTags sets the AppSec-specific span tags that are expected to be in the web service entry span (span of type `web`) when AppSec is enabled.

func SetEventSpanTags

func SetEventSpanTags(span TagSetter, events []any) error

SetEventSpanTags sets the security event span tags into the service entry span.

func SetStringTags

func SetStringTags(span TagSetter, tags map[string]string)

SetStringTags fills the span tags using the key/value pairs of strings found in `tags`

func SetTags

func SetTags(span TagSetter, tags map[string]interface{})

SetTags fills the span tags using the key/value pairs found in `tags`

Types

type ContextKey

type ContextKey struct{}

ContextKey is used as a key to store operations in the request's context (gRPC/HTTP)

type SecurityEventsHolder

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

SecurityEventsHolder is a wrapper around a thread safe security events slice. The purpose of this struct is to be used by composition in an Operation to allow said operation to handle security events addition/retrieval. See httpsec/http.go and grpcsec/grpc.go.

func (*SecurityEventsHolder) AddSecurityEvents

func (s *SecurityEventsHolder) AddSecurityEvents(events []any)

AddSecurityEvents adds the security events to the collected events list. Thread safe.

func (*SecurityEventsHolder) ClearEvents

func (s *SecurityEventsHolder) ClearEvents()

ClearEvents clears the list of stored events

func (*SecurityEventsHolder) Events

func (s *SecurityEventsHolder) Events() []any

Events returns the list of stored events.

type TagSetter

type TagSetter interface {
	SetTag(string, interface{})
}

TagSetter is the interface needed to set a span tag.

type TagsHolder

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

TagsHolder wraps a map holding tags. The purpose of this struct is to be used by composition in an Operation to allow said operation to handle tags addition/retrieval. See httpsec/http.go and grpcsec/grpc.go.

func NewTagsHolder

func NewTagsHolder() TagsHolder

NewTagsHolder returns a new instance of a TagsHolder struct.

func (*TagsHolder) AddTag

func (m *TagsHolder) AddTag(k string, v interface{})

AddTag adds the key/value pair to the tags map

func (*TagsHolder) Tags

func (m *TagsHolder) Tags() map[string]interface{}

Tags returns the tags map