prometheus

Documentation

Index

• func AreIdenticalSeriesFast(s1, s2 string) bool
• func GetRowsDiff(s1, s2 string) string
• func MustParsePromMetrics(s string, offsetMsecs int64) []prompbmarshal.TimeSeries
• type Row
• type Rows
  • func (rs *Rows) Reset()
  • func (rs *Rows) Unmarshal(s string)
  • func (rs *Rows) UnmarshalWithErrLogger(s string, errLogger func(s string))
• type Tag

Functions

func AreIdenticalSeriesFast

func AreIdenticalSeriesFast(s1, s2 string) bool

AreIdenticalSeriesFast returns true if s1 and s2 contains identical Prometheus series with possible different values.

This function is optimized for speed.

func GetRowsDiff

func GetRowsDiff(s1, s2 string) string

GetRowsDiff returns rows from s1, which are missing in s2.

The returned rows have default value 0 and have no timestamps.

func MustParsePromMetrics

func MustParsePromMetrics(s string, offsetMsecs int64) []prompbmarshal.TimeSeries

MustParsePromMetrics parses metrics in Prometheus text exposition format from s and returns them.

Metrics must be delimited with newlines.

offsetMsecs is added to every timestamp in parsed metrics.

This function is for testing purposes only. Do not use it in non-test code.

Types

type Row

type Row struct {
	Metric    string
	Tags      []Tag
	Value     float64
	Timestamp int64
}

Row is a single Prometheus row.

type Rows

type Rows struct {
	Rows []Row
	// contains filtered or unexported fields
}

Rows contains parsed Prometheus rows.

func (*Rows) Reset

func (rs *Rows) Reset()

Reset resets rs.

func (*Rows) Unmarshal

func (rs *Rows) Unmarshal(s string)

Unmarshal unmarshals Prometheus exposition text rows from s.

See https://github.com/prometheus/docs/blob/master/content/docs/instrumenting/exposition_formats.md#text-format-details

s shouldn't be modified while rs is in use.

func (*Rows) UnmarshalWithErrLogger

func (rs *Rows) UnmarshalWithErrLogger(s string, errLogger func(s string))

UnmarshalWithErrLogger unmarshal Prometheus exposition text rows from s.

It calls errLogger for logging parsing errors.

s shouldn't be modified while rs is in use.

type Tag

type Tag struct {
	Key   string
	Value string
}

Tag is a Prometheus tag.