NewHub creates and initializes a Hub context and the underlying BPF, primes the kernel filter, and sets up the in-kernel metrics.

NewJob returns a Job for the trace.

NewKubernetes creates an Observer for Kubernetes.

WithKubernetesConfig will use the kubernetes configuration file.

WithKubernetesCRI is the fully-qualified path to the container-runtime interface UNIX socket.

WithKubernetesFieldSelector will only match hosts what matched this field-selector labelset.

WithKubernetesLabelSelector will only match hosts that match this label.

WithKubernetesNamespace will limit the observation to a specific kubernetes namespace.

WithKubernetesProcRoot will look for the ProcFS mount inside the path.

container started.

container stopped.

ErrBadNamespace is the error returned to indicate the observer was unable to resolve the PID-Namespace of the container.

ErrContainerNotFound is the error returned to indicate the container was unable to be resolved.

ErrNilContainer is the error returned to indicate the observer sent an empty container message.

ErrNilEvent is the error returned to indicate the observer sent an empty message.

ErrUnknownType is the error returned to indicate a malformed observer event.

Hub maintains all of the underlying kernel-filters, job request and output routing, metric-rules, de-duplication, garbage-collection using information it has obtained via the underlying Observer.

Job stores the trace specification and a running list of hosts which have matched this job.

JobContext contains information about the filters that were created in order to run a Job.

JobList is a wrapper around a simple linked-list for groups of JobContexts.

Kubernetes satisfies the Observer interface for the topology.

These are the two states in which an observer event can be in.