metadata

Documentation

Index

• Constants
• type Cache
  • func NewCache(client *http.Client, promURL *url.URL, staticMetadata []scrape.MetricMetadata) *Cache
  • func (c *Cache) Get(ctx context.Context, job, instance, metric string) (*scrape.MetricMetadata, error)

Constants

const DefaultEndpointPath = "api/v1/targets/metadata"

DefaultEndpointPath is the default HTTP path on which Prometheus serves the target metadata endpoint.

const MetricTypeUntyped = "untyped"

The old metric type value for textparse.MetricTypeUnknown that is used in Prometheus 2.4 and earlier.

Types

type Cache

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

Cache populates and maintains a cache of metric metadata it retrieves from a given Prometheus server. Its methods are not safe for concurrent use.

func NewCache

func NewCache(client *http.Client, promURL *url.URL, staticMetadata []scrape.MetricMetadata) *Cache

NewCache returns a new cache that gets populated by the metadata endpoint at the given URL. It uses the default endpoint path if no specific path is provided.

func (*Cache) Get

func (c *Cache) Get(ctx context.Context, job, instance, metric string) (*scrape.MetricMetadata, error)

Get returns metadata for the given metric and job. If the metadata is not in the cache, it blocks until we have retrieved it from the Prometheus server. If no metadata is found in the Prometheus server, a matching entry from the static metadata or nil is returned.