Help us shape the future of Go! Take the 2026 Go Developer Survey

observability

package
v0.4.19 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 2, 2026 License: Apache-2.0 Imports: 10 Imported by: 0

Documentation

Index

Constants

View Source
const (
	SourceApplication         SourceClass = "application"
	SourceApplicationProvider SourceClass = "application-provider"
	SourcePlatformProvider    SourceClass = "platform-provider"

	SignalMetrics SignalKind = "metrics"
	SignalLogs    SignalKind = "logs"
	SignalTraces  SignalKind = "traces"
)

Variables

This section is empty.

Functions

func ParseRuntimeTarget added in v0.4.15

func ParseRuntimeTarget(target string) (project, service string, ok bool)

func PruneOwnedProviderInstances added in v0.4.15

func PruneOwnedProviderInstances(provider capability.ProviderKind, class SourceClass, scope capability.ProviderScope, ownerApplication string, keepIDs map[string]struct{}) error

func ReconcileSignals added in v0.4.15

func ReconcileSignals(id string, desired []SignalSource) error

func RegisterProviderSignals added in v0.4.15

func RegisterProviderSignals(registration ProviderSignalRegistration) error

func Remove

func Remove(id string) error

func RuntimeTarget added in v0.4.15

func RuntimeTarget(project, service string) string

func Update

func Update(source MetricsSource) error

func UpdateSignal added in v0.4.15

func UpdateSignal(source SignalSource) error

Types

type MetricsSource

type MetricsSource struct {
	ID               string
	Provider         capability.ProviderKind
	Class            SourceClass
	Scope            capability.ProviderScope
	SharingBoundary  string
	OwnerApplication string
	Network          string
	Target           string
	Path             string
	Scheme           string
	Security         Security
}

MetricsSource remains the focused compatibility type used by current metrics provider call sites. Update converts it into the generic signal registry.

func ListMetrics

func ListMetrics(placement capability.ProviderPlacement, applications []string, includeApplicationProviders, includePlatformProviders bool) ([]MetricsSource, error)

func (MetricsSource) Validate

func (s MetricsSource) Validate() error

type ProviderSignalRegistration added in v0.4.15

type ProviderSignalRegistration struct {
	ID               string
	Descriptor       capability.IntegrationDescriptor
	Class            SourceClass
	Scope            capability.ProviderScope
	SharingBoundary  string
	OwnerApplication string
	Enabled          map[SignalKind]bool
	Signals          map[string]ProviderSignalRuntime
}

ProviderSignalRegistration binds a provider integration descriptor to one concrete runtime instance. Multiple signal kinds intentionally share ID so Remove(ID) tears down all BaseHarbor-owned observability registrations for that provider instance.

type ProviderSignalRuntime added in v0.4.15

type ProviderSignalRuntime struct {
	Network  string
	Target   string
	Security Security
}

ProviderSignalRuntime is provider realization state for one declared signal. It contains reachability/security details only; portable application intent and product-specific collector configuration do not flow through this type.

type Security added in v0.4.15

type Security struct {
	TLSRequired       bool   `json:"tls_required"`
	Authentication    string `json:"authentication,omitempty"`
	TrustFile         string `json:"trust_file,omitempty"`
	ClientCertificate string `json:"client_certificate,omitempty"`
	ClientKey         string `json:"client_key,omitempty"`
	ServerName        string `json:"server_name,omitempty"`
}

func (Security) Validate added in v0.4.15

func (s Security) Validate() error

type SignalKind added in v0.4.15

type SignalKind string

type SignalSource added in v0.4.15

type SignalSource struct {
	ID                 string                                   `json:"id"`
	Kind               SignalKind                               `json:"kind"`
	Provider           capability.ProviderKind                  `json:"provider"`
	Class              SourceClass                              `json:"class"`
	Scope              capability.ProviderScope                 `json:"scope"`
	SharingBoundary    string                                   `json:"sharing_boundary,omitempty"`
	OwnerApplication   string                                   `json:"owner_application,omitempty"`
	Network            string                                   `json:"network,omitempty"`
	Target             string                                   `json:"target"`
	Protocol           string                                   `json:"protocol"`
	Path               string                                   `json:"path,omitempty"`
	Mode               capability.ObservabilityRealizationMode  `json:"mode,omitempty"`
	SemanticConvention string                                   `json:"semantic_convention,omitempty"`
	Verification       capability.ObservabilityVerificationMode `json:"verification,omitempty"`
	Security           Security                                 `json:"security"`
}

func List added in v0.4.15

func List(kind SignalKind, placement capability.ProviderPlacement, applications []string, includeApplicationProviders, includePlatformProviders bool) ([]SignalSource, error)

func ListLogs added in v0.4.15

func ListLogs(placement capability.ProviderPlacement, applications []string, includeApplicationProviders, includePlatformProviders bool) ([]SignalSource, error)

func ListTraces added in v0.4.15

func ListTraces(placement capability.ProviderPlacement, applications []string, includeApplicationProviders, includePlatformProviders bool) ([]SignalSource, error)

func (SignalSource) Validate added in v0.4.15

func (s SignalSource) Validate() error

type SourceClass

type SourceClass string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL