targets

Documentation

Index

• Constants
• func DropTargetLabels(series, target labels.Labels) labels.Labels
• type Cache
  • func NewCache(logger log.Logger, client *http.Client, promURL *url.URL) *Cache
  • func (c *Cache) Get(ctx context.Context, lset labels.Labels) (*Target, error)
  • func (c *Cache) Run(ctx context.Context)
• type Target

Constants

const DefaultAPIEndpoint = "api/v1/targets"

Functions

func DropTargetLabels

func DropTargetLabels(series, target labels.Labels) labels.Labels

DropTargetLabels drops labels from the series that are found in the target with exact name/value matches.

Types

type Cache

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

Cache retrieves target information from the Prometheus API and caches it. It works reliably and efficiently for configurations where targets are identified unique by job and instance label and an optional but consistent set of additional labels. It only provides best effort matching for configurations where targets are identified by a varying set of labels within a job and instance combination. Implements TargetGetter.

func NewCache

func NewCache(logger log.Logger, client *http.Client, promURL *url.URL) *Cache

func (*Cache) Get

func (c *Cache) Get(ctx context.Context, lset labels.Labels) (*Target, error)

Get returns a target that matches the job/instance combination of the input labels and has the same labels values for other labels keys they have in common. If multiple targets satisfy this property, it is undefined which one is returned. This is generally a non-issue if the additional label keys are consistently set across all targets for the job/instance combination. If no target is found, nil is returned.

func (*Cache) Run

func (c *Cache) Run(ctx context.Context)

Run background refreshing of the cache.

type Target

type Target struct {
	Labels           labels.Labels `json:"labels"`
	DiscoveredLabels labels.Labels `json:"discoveredLabels"`
}