procutil

type CPUPercentStat struct {
	UserPct   float64
	SystemPct float64
}

type CPUTimesStat struct {
	User      float64
	System    float64
	Idle      float64
	Nice      float64
	Iowait    float64
	Irq       float64
	Softirq   float64
	Steal     float64
	Guest     float64
	GuestNice float64
	Stolen    float64
	Timestamp int64
}

type DataScrubber struct {
	Enabled           bool
	StripAllArguments bool
	SensitivePatterns []DataScrubberPattern
	// contains filtered or unexported fields
}

type DataScrubberPattern struct {
	FastCheck string
	Re        *regexp.Regexp
}

type IOCountersRateStat struct {
	ReadRate       float64
	WriteRate      float64
	ReadBytesRate  float64
	WriteBytesRate float64
}

type IOCountersStat struct {
	ReadCount  int64
	WriteCount int64
	ReadBytes  int64
	WriteBytes int64
}

type InjectionState int

type MemoryInfoExStat struct {
	RSS    uint64 // bytes
	VMS    uint64 // bytes
	Shared uint64 // bytes
	Text   uint64 // bytes
	Lib    uint64 // bytes
	Data   uint64 // bytes
	Dirty  uint64 // bytes
}

type MemoryInfoStat struct {
	RSS  uint64 // bytes
	VMS  uint64 // bytes
	Swap uint64 // bytes
}

type NumCtxSwitchesStat struct {
	Voluntary   int64
	Involuntary int64
}

type Option func(p Probe)

type Probe interface {
	Close()
	StatsForPIDs(pids []int32, now time.Time) (map[int32]*Stats, error)
	ProcessesByPID(now time.Time, collectStats bool) (map[int32]*Process, error)
	StatsWithPermByPID(pids []int32) (map[int32]*StatsWithPerm, error)
}

type Process struct {
	Pid      int32
	Ppid     int32
	NsPid    int32 // process namespaced PID
	Name     string
	Cwd      string
	Exe      string
	Comm     string
	Cmdline  []string
	Username string // (Windows only)
	Uids     []int32
	Gids     []int32
	Language *languagemodels.Language

	// ports are stored on the process because they may/should be collected by default in the future
	// however, currently this data is collected by service discovery collection
	PortsCollected bool
	TCPPorts       []uint16
	UDPPorts       []uint16

	Stats          *Stats
	Service        *Service
	InjectionState InjectionState // APM auto-injector detection status
}

type Service struct {
	// GeneratedName is the name generated from the process info
	GeneratedName string

	// GeneratedNameSource indicates the source of the generated name
	GeneratedNameSource string

	// AdditionalGeneratedNames contains other potential names for the service
	AdditionalGeneratedNames []string

	// TracerMetadata contains APM tracer metadata
	TracerMetadata []tracermetadata.TracerMetadata

	// DDService is the value from DD_SERVICE environment variable
	DDService string

	// APMInstrumentation indicates the APM instrumentation status
	APMInstrumentation bool

	// LogFiles contains paths to log files associated with this service
	LogFiles []string
}

type Stats struct {
	CreateTime int64 // milliseconds
	// Status returns the process status. https://man7.org/linux/man-pages/man5/proc_pid_stat.5.html
	// Supported return values:
	// U: unknown state
	// D: uninterruptible sleep
	// R: running
	// S: interruptible sleep
	// T: stopped
	// W: waiting (todo: potentially removable, W = paging only before Linux 2.6.0, waking Linux 2.6.33 to 3.13 only)
	// Z: zombie
	// The character is the same within all supported platforms.
	Status      string
	Nice        int32
	OpenFdCount int32
	NumThreads  int32
	CPUPercent  *CPUPercentStat
	CPUTime     *CPUTimesStat
	MemInfo     *MemoryInfoStat
	MemInfoEx   *MemoryInfoExStat
	IOStat      *IOCountersStat
	IORateStat  *IOCountersRateStat
	CtxSwitches *NumCtxSwitchesStat
}

type StatsWithPerm struct {
	OpenFdCount int32
	IOStat      *IOCountersStat
}