io_prometheus_client

package
v0.6.1 Latest Latest
Warning

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

 Go to latest Published: Mar 26, 2024 License: Apache-2.0 Imports: 5 Imported by: 3,778

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var (
	MetricType_name = map[int32]string{
		0: "COUNTER",
		1: "GAUGE",
		2: "SUMMARY",
		3: "UNTYPED",
		4: "HISTOGRAM",
		5: "GAUGE_HISTOGRAM",
	}
	MetricType_value = map[string]int32{
		"COUNTER":         0,
		"GAUGE":           1,
		"SUMMARY":         2,
		"UNTYPED":         3,
		"HISTOGRAM":       4,
		"GAUGE_HISTOGRAM": 5,
	}
)

Enum value maps for MetricType.

View Source 
var File_io_prometheus_client_metrics_proto protoreflect.FileDescriptor

Functions

This section is empty.

Types

type Bucket 

type Bucket struct {
	CumulativeCount      *uint64   `protobuf:"varint,1,opt,name=cumulative_count,json=cumulativeCount" json:"cumulative_count,omitempty"`                   // Cumulative in increasing order.
	CumulativeCountFloat *float64  `protobuf:"fixed64,4,opt,name=cumulative_count_float,json=cumulativeCountFloat" json:"cumulative_count_float,omitempty"` // Overrides cumulative_count if > 0.
	UpperBound           *float64  `protobuf:"fixed64,2,opt,name=upper_bound,json=upperBound" json:"upper_bound,omitempty"`                                 // Inclusive.
	Exemplar             *Exemplar `protobuf:"bytes,3,opt,name=exemplar" json:"exemplar,omitempty"`
	// contains filtered or unexported fields
}

A Bucket of a conventional histogram, each of which is treated as an individual counter-like time series by Prometheus.

func (*Bucket) Descriptor deprecated 

func (*Bucket) Descriptor() ([]byte, []int)

Deprecated: Use Bucket.ProtoReflect.Descriptor instead.

func (*Bucket) GetCumulativeCount 

func (x *Bucket) GetCumulativeCount() uint64

func (*Bucket) GetCumulativeCountFloat added in v0.3.0 

func (x *Bucket) GetCumulativeCountFloat() float64

func (*Bucket) GetExemplar added in v0.2.0 

func (x *Bucket) GetExemplar() *Exemplar

func (*Bucket) GetUpperBound 

func (x *Bucket) GetUpperBound() float64

func (*Bucket) ProtoMessage 

func (*Bucket) ProtoMessage()

func (*Bucket) ProtoReflect added in v0.4.0 

func (x *Bucket) ProtoReflect() protoreflect.Message

func (*Bucket) Reset 

func (x *Bucket) Reset()

func (*Bucket) String 

func (x *Bucket) String() string

type BucketSpan added in v0.3.0 

type BucketSpan struct {
	Offset *int32  `protobuf:"zigzag32,1,opt,name=offset" json:"offset,omitempty"` // Gap to previous span, or starting point for 1st span (which can be negative).
	Length *uint32 `protobuf:"varint,2,opt,name=length" json:"length,omitempty"`   // Length of consecutive buckets.
	// contains filtered or unexported fields
}

A BucketSpan defines a number of consecutive buckets in a native histogram with their offset. Logically, it would be more straightforward to include the bucket counts in the Span. However, the protobuf representation is more compact in the way the data is structured here (with all the buckets in a single array separate from the Spans).

func (*BucketSpan) Descriptor deprecated added in v0.3.0 

func (*BucketSpan) Descriptor() ([]byte, []int)

Deprecated: Use BucketSpan.ProtoReflect.Descriptor instead.

func (*BucketSpan) GetLength added in v0.3.0 

func (x *BucketSpan) GetLength() uint32

func (*BucketSpan) GetOffset added in v0.3.0 

func (x *BucketSpan) GetOffset() int32

func (*BucketSpan) ProtoMessage added in v0.3.0 

func (*BucketSpan) ProtoMessage()

func (*BucketSpan) ProtoReflect added in v0.4.0 

func (x *BucketSpan) ProtoReflect() protoreflect.Message

func (*BucketSpan) Reset added in v0.3.0 

func (x *BucketSpan) Reset()

func (*BucketSpan) String added in v0.3.0 

func (x *BucketSpan) String() string

type Counter 

type Counter struct {
	Value            *float64               `protobuf:"fixed64,1,opt,name=value" json:"value,omitempty"`
	Exemplar         *Exemplar              `protobuf:"bytes,2,opt,name=exemplar" json:"exemplar,omitempty"`
	CreatedTimestamp *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=created_timestamp,json=createdTimestamp" json:"created_timestamp,omitempty"`
	// contains filtered or unexported fields
}

func (*Counter) Descriptor deprecated 

func (*Counter) Descriptor() ([]byte, []int)

Deprecated: Use Counter.ProtoReflect.Descriptor instead.

func (*Counter) GetCreatedTimestamp added in v0.5.0 

func (x *Counter) GetCreatedTimestamp() *timestamppb.Timestamp

func (*Counter) GetExemplar added in v0.2.0 

func (x *Counter) GetExemplar() *Exemplar

func (*Counter) GetValue 

func (x *Counter) GetValue() float64

func (*Counter) ProtoMessage 

func (*Counter) ProtoMessage()

func (*Counter) ProtoReflect added in v0.4.0 

func (x *Counter) ProtoReflect() protoreflect.Message

func (*Counter) Reset 

func (x *Counter) Reset()

func (*Counter) String 

func (x *Counter) String() string

type Exemplar added in v0.2.0 

type Exemplar struct {
	Label     []*LabelPair           `protobuf:"bytes,1,rep,name=label" json:"label,omitempty"`
	Value     *float64               `protobuf:"fixed64,2,opt,name=value" json:"value,omitempty"`
	Timestamp *timestamppb.Timestamp `protobuf:"bytes,3,opt,name=timestamp" json:"timestamp,omitempty"` // OpenMetrics-style.
	// contains filtered or unexported fields
}

func (*Exemplar) Descriptor deprecated added in v0.2.0 

func (*Exemplar) Descriptor() ([]byte, []int)

Deprecated: Use Exemplar.ProtoReflect.Descriptor instead.

func (*Exemplar) GetLabel added in v0.2.0 

func (x *Exemplar) GetLabel() []*LabelPair

func (*Exemplar) GetTimestamp added in v0.2.0 

func (x *Exemplar) GetTimestamp() *timestamppb.Timestamp

func (*Exemplar) GetValue added in v0.2.0 

func (x *Exemplar) GetValue() float64

func (*Exemplar) ProtoMessage added in v0.2.0 

func (*Exemplar) ProtoMessage()

func (*Exemplar) ProtoReflect added in v0.4.0 

func (x *Exemplar) ProtoReflect() protoreflect.Message

func (*Exemplar) Reset added in v0.2.0 

func (x *Exemplar) Reset()

func (*Exemplar) String added in v0.2.0 

func (x *Exemplar) String() string

type Gauge 

type Gauge struct {
	Value *float64 `protobuf:"fixed64,1,opt,name=value" json:"value,omitempty"`
	// contains filtered or unexported fields
}

func (*Gauge) Descriptor deprecated 

func (*Gauge) Descriptor() ([]byte, []int)

Deprecated: Use Gauge.ProtoReflect.Descriptor instead.

func (*Gauge) GetValue 

func (x *Gauge) GetValue() float64

func (*Gauge) ProtoMessage 

func (*Gauge) ProtoMessage()

func (*Gauge) ProtoReflect added in v0.4.0 

func (x *Gauge) ProtoReflect() protoreflect.Message

func (*Gauge) Reset 

func (x *Gauge) Reset()

func (*Gauge) String 

func (x *Gauge) String() string

type Histogram 

type Histogram struct {
	SampleCount      *uint64  `protobuf:"varint,1,opt,name=sample_count,json=sampleCount" json:"sample_count,omitempty"`
	SampleCountFloat *float64 `protobuf:"fixed64,4,opt,name=sample_count_float,json=sampleCountFloat" json:"sample_count_float,omitempty"` // Overrides sample_count if > 0.
	SampleSum        *float64 `protobuf:"fixed64,2,opt,name=sample_sum,json=sampleSum" json:"sample_sum,omitempty"`
	// Buckets for the conventional histogram.
	Bucket           []*Bucket              `protobuf:"bytes,3,rep,name=bucket" json:"bucket,omitempty"` // Ordered in increasing order of upper_bound, +Inf bucket is optional.
	CreatedTimestamp *timestamppb.Timestamp `protobuf:"bytes,15,opt,name=created_timestamp,json=createdTimestamp" json:"created_timestamp,omitempty"`
	// schema defines the bucket schema. Currently, valid numbers are -4 <= n <= 8.
	// They are all for base-2 bucket schemas, where 1 is a bucket boundary in each case, and
	// then each power of two is divided into 2^n logarithmic buckets.
	// Or in other words, each bucket boundary is the previous boundary times 2^(2^-n).
	// In the future, more bucket schemas may be added using numbers < -4 or > 8.
	Schema         *int32   `protobuf:"zigzag32,5,opt,name=schema" json:"schema,omitempty"`
	ZeroThreshold  *float64 `protobuf:"fixed64,6,opt,name=zero_threshold,json=zeroThreshold" json:"zero_threshold,omitempty"`      // Breadth of the zero bucket.
	ZeroCount      *uint64  `protobuf:"varint,7,opt,name=zero_count,json=zeroCount" json:"zero_count,omitempty"`                   // Count in zero bucket.
	ZeroCountFloat *float64 `protobuf:"fixed64,8,opt,name=zero_count_float,json=zeroCountFloat" json:"zero_count_float,omitempty"` // Overrides sb_zero_count if > 0.
	// Negative buckets for the native histogram.
	NegativeSpan []*BucketSpan `protobuf:"bytes,9,rep,name=negative_span,json=negativeSpan" json:"negative_span,omitempty"`
	// Use either "negative_delta" or "negative_count", the former for
	// regular histograms with integer counts, the latter for float
	// histograms.
	NegativeDelta []int64   `protobuf:"zigzag64,10,rep,name=negative_delta,json=negativeDelta" json:"negative_delta,omitempty"` // Count delta of each bucket compared to previous one (or to zero for 1st bucket).
	NegativeCount []float64 `protobuf:"fixed64,11,rep,name=negative_count,json=negativeCount" json:"negative_count,omitempty"`  // Absolute count of each bucket.
	// Positive buckets for the native histogram.
	// Use a no-op span (offset 0, length 0) for a native histogram without any
	// observations yet and with a zero_threshold of 0. Otherwise, it would be
	// indistinguishable from a classic histogram.
	PositiveSpan []*BucketSpan `protobuf:"bytes,12,rep,name=positive_span,json=positiveSpan" json:"positive_span,omitempty"`
	// Use either "positive_delta" or "positive_count", the former for
	// regular histograms with integer counts, the latter for float
	// histograms.
	PositiveDelta []int64   `protobuf:"zigzag64,13,rep,name=positive_delta,json=positiveDelta" json:"positive_delta,omitempty"` // Count delta of each bucket compared to previous one (or to zero for 1st bucket).
	PositiveCount []float64 `protobuf:"fixed64,14,rep,name=positive_count,json=positiveCount" json:"positive_count,omitempty"`  // Absolute count of each bucket.
	// Only used for native histograms. These exemplars MUST have a timestamp.
	Exemplars []*Exemplar `protobuf:"bytes,16,rep,name=exemplars" json:"exemplars,omitempty"`
	// contains filtered or unexported fields
}

func (*Histogram) Descriptor deprecated 

func (*Histogram) Descriptor() ([]byte, []int)

Deprecated: Use Histogram.ProtoReflect.Descriptor instead.

func (*Histogram) GetBucket 

func (x *Histogram) GetBucket() []*Bucket

func (*Histogram) GetCreatedTimestamp added in v0.5.0 

func (x *Histogram) GetCreatedTimestamp() *timestamppb.Timestamp

func (*Histogram) GetExemplars added in v0.6.0 

func (x *Histogram) GetExemplars() []*Exemplar

func (*Histogram) GetNegativeCount added in v0.3.0 

func (x *Histogram) GetNegativeCount() []float64

func (*Histogram) GetNegativeDelta added in v0.3.0 

func (x *Histogram) GetNegativeDelta() []int64

func (*Histogram) GetNegativeSpan added in v0.3.0 

func (x *Histogram) GetNegativeSpan() []*BucketSpan

func (*Histogram) GetPositiveCount added in v0.3.0 

func (x *Histogram) GetPositiveCount() []float64

func (*Histogram) GetPositiveDelta added in v0.3.0 

func (x *Histogram) GetPositiveDelta() []int64

func (*Histogram) GetPositiveSpan added in v0.3.0 

func (x *Histogram) GetPositiveSpan() []*BucketSpan

func (*Histogram) GetSampleCount 

func (x *Histogram) GetSampleCount() uint64

func (*Histogram) GetSampleCountFloat added in v0.3.0 

func (x *Histogram) GetSampleCountFloat() float64

func (*Histogram) GetSampleSum 

func (x *Histogram) GetSampleSum() float64

func (*Histogram) GetSchema added in v0.3.0 

func (x *Histogram) GetSchema() int32

func (*Histogram) GetZeroCount added in v0.3.0 

func (x *Histogram) GetZeroCount() uint64

func (*Histogram) GetZeroCountFloat added in v0.3.0 

func (x *Histogram) GetZeroCountFloat() float64

func (*Histogram) GetZeroThreshold added in v0.3.0 

func (x *Histogram) GetZeroThreshold() float64

func (*Histogram) ProtoMessage 

func (*Histogram) ProtoMessage()

func (*Histogram) ProtoReflect added in v0.4.0 

func (x *Histogram) ProtoReflect() protoreflect.Message

func (*Histogram) Reset 

func (x *Histogram) Reset()

func (*Histogram) String 

func (x *Histogram) String() string

type LabelPair 

type LabelPair struct {
	Name  *string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
	Value *string `protobuf:"bytes,2,opt,name=value" json:"value,omitempty"`
	// contains filtered or unexported fields
}

func (*LabelPair) Descriptor deprecated 

func (*LabelPair) Descriptor() ([]byte, []int)

Deprecated: Use LabelPair.ProtoReflect.Descriptor instead.

func (*LabelPair) GetName 

func (x *LabelPair) GetName() string

func (*LabelPair) GetValue 

func (x *LabelPair) GetValue() string

func (*LabelPair) ProtoMessage 

func (*LabelPair) ProtoMessage()

func (*LabelPair) ProtoReflect added in v0.4.0 

func (x *LabelPair) ProtoReflect() protoreflect.Message

func (*LabelPair) Reset 

func (x *LabelPair) Reset()

func (*LabelPair) String 

func (x *LabelPair) String() string

type Metric 

type Metric struct {
	Label       []*LabelPair `protobuf:"bytes,1,rep,name=label" json:"label,omitempty"`
	Gauge       *Gauge       `protobuf:"bytes,2,opt,name=gauge" json:"gauge,omitempty"`
	Counter     *Counter     `protobuf:"bytes,3,opt,name=counter" json:"counter,omitempty"`
	Summary     *Summary     `protobuf:"bytes,4,opt,name=summary" json:"summary,omitempty"`
	Untyped     *Untyped     `protobuf:"bytes,5,opt,name=untyped" json:"untyped,omitempty"`
	Histogram   *Histogram   `protobuf:"bytes,7,opt,name=histogram" json:"histogram,omitempty"`
	TimestampMs *int64       `protobuf:"varint,6,opt,name=timestamp_ms,json=timestampMs" json:"timestamp_ms,omitempty"`
	// contains filtered or unexported fields
}

func (*Metric) Descriptor deprecated 

func (*Metric) Descriptor() ([]byte, []int)

Deprecated: Use Metric.ProtoReflect.Descriptor instead.

func (*Metric) GetCounter 

func (x *Metric) GetCounter() *Counter

func (*Metric) GetGauge 

func (x *Metric) GetGauge() *Gauge

func (*Metric) GetHistogram 

func (x *Metric) GetHistogram() *Histogram

func (*Metric) GetLabel 

func (x *Metric) GetLabel() []*LabelPair

func (*Metric) GetSummary 

func (x *Metric) GetSummary() *Summary

func (*Metric) GetTimestampMs 

func (x *Metric) GetTimestampMs() int64

func (*Metric) GetUntyped 

func (x *Metric) GetUntyped() *Untyped

func (*Metric) ProtoMessage 

func (*Metric) ProtoMessage()

func (*Metric) ProtoReflect added in v0.4.0 

func (x *Metric) ProtoReflect() protoreflect.Message

func (*Metric) Reset 

func (x *Metric) Reset()

func (*Metric) String 

func (x *Metric) String() string

type MetricFamily 

type MetricFamily struct {
	Name   *string     `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
	Help   *string     `protobuf:"bytes,2,opt,name=help" json:"help,omitempty"`
	Type   *MetricType `protobuf:"varint,3,opt,name=type,enum=io.prometheus.client.MetricType" json:"type,omitempty"`
	Metric []*Metric   `protobuf:"bytes,4,rep,name=metric" json:"metric,omitempty"`
	Unit   *string     `protobuf:"bytes,5,opt,name=unit" json:"unit,omitempty"`
	// contains filtered or unexported fields
}

func (*MetricFamily) Descriptor deprecated 

func (*MetricFamily) Descriptor() ([]byte, []int)

Deprecated: Use MetricFamily.ProtoReflect.Descriptor instead.

func (*MetricFamily) GetHelp 

func (x *MetricFamily) GetHelp() string

func (*MetricFamily) GetMetric 

func (x *MetricFamily) GetMetric() []*Metric

func (*MetricFamily) GetName 

func (x *MetricFamily) GetName() string

func (*MetricFamily) GetType 

func (x *MetricFamily) GetType() MetricType

func (*MetricFamily) GetUnit added in v0.6.0 

func (x *MetricFamily) GetUnit() string

func (*MetricFamily) ProtoMessage 

func (*MetricFamily) ProtoMessage()

func (*MetricFamily) ProtoReflect added in v0.4.0 

func (x *MetricFamily) ProtoReflect() protoreflect.Message

func (*MetricFamily) Reset 

func (x *MetricFamily) Reset()

func (*MetricFamily) String 

func (x *MetricFamily) String() string

type MetricType 

type MetricType int32
const (
	// COUNTER must use the Metric field "counter".
	MetricType_COUNTER MetricType = 0
	// GAUGE must use the Metric field "gauge".
	MetricType_GAUGE MetricType = 1
	// SUMMARY must use the Metric field "summary".
	MetricType_SUMMARY MetricType = 2
	// UNTYPED must use the Metric field "untyped".
	MetricType_UNTYPED MetricType = 3
	// HISTOGRAM must use the Metric field "histogram".
	MetricType_HISTOGRAM MetricType = 4
	// GAUGE_HISTOGRAM must use the Metric field "histogram".
	MetricType_GAUGE_HISTOGRAM MetricType = 5
)

func (MetricType) Descriptor added in v0.4.0 

func (MetricType) Descriptor() protoreflect.EnumDescriptor

func (MetricType) Enum 

func (x MetricType) Enum() *MetricType

func (MetricType) EnumDescriptor deprecated 

func (MetricType) EnumDescriptor() ([]byte, []int)

Deprecated: Use MetricType.Descriptor instead.

func (MetricType) Number added in v0.4.0 

func (x MetricType) Number() protoreflect.EnumNumber

func (MetricType) String 

func (x MetricType) String() string

func (MetricType) Type added in v0.4.0 

func (MetricType) Type() protoreflect.EnumType

func (*MetricType) UnmarshalJSON deprecated 

func (x *MetricType) UnmarshalJSON(b []byte) error

Deprecated: Do not use.

type Quantile 

type Quantile struct {
	Quantile *float64 `protobuf:"fixed64,1,opt,name=quantile" json:"quantile,omitempty"`
	Value    *float64 `protobuf:"fixed64,2,opt,name=value" json:"value,omitempty"`
	// contains filtered or unexported fields
}

func (*Quantile) Descriptor deprecated 

func (*Quantile) Descriptor() ([]byte, []int)

Deprecated: Use Quantile.ProtoReflect.Descriptor instead.

func (*Quantile) GetQuantile 

func (x *Quantile) GetQuantile() float64

func (*Quantile) GetValue 

func (x *Quantile) GetValue() float64

func (*Quantile) ProtoMessage 

func (*Quantile) ProtoMessage()

func (*Quantile) ProtoReflect added in v0.4.0 

func (x *Quantile) ProtoReflect() protoreflect.Message

func (*Quantile) Reset 

func (x *Quantile) Reset()

func (*Quantile) String 

func (x *Quantile) String() string

type Summary 

type Summary struct {
	SampleCount      *uint64                `protobuf:"varint,1,opt,name=sample_count,json=sampleCount" json:"sample_count,omitempty"`
	SampleSum        *float64               `protobuf:"fixed64,2,opt,name=sample_sum,json=sampleSum" json:"sample_sum,omitempty"`
	Quantile         []*Quantile            `protobuf:"bytes,3,rep,name=quantile" json:"quantile,omitempty"`
	CreatedTimestamp *timestamppb.Timestamp `protobuf:"bytes,4,opt,name=created_timestamp,json=createdTimestamp" json:"created_timestamp,omitempty"`
	// contains filtered or unexported fields
}

func (*Summary) Descriptor deprecated 

func (*Summary) Descriptor() ([]byte, []int)

Deprecated: Use Summary.ProtoReflect.Descriptor instead.

func (*Summary) GetCreatedTimestamp added in v0.5.0 

func (x *Summary) GetCreatedTimestamp() *timestamppb.Timestamp

func (*Summary) GetQuantile 

func (x *Summary) GetQuantile() []*Quantile

func (*Summary) GetSampleCount 

func (x *Summary) GetSampleCount() uint64

func (*Summary) GetSampleSum 

func (x *Summary) GetSampleSum() float64

func (*Summary) ProtoMessage 

func (*Summary) ProtoMessage()

func (*Summary) ProtoReflect added in v0.4.0 

func (x *Summary) ProtoReflect() protoreflect.Message

func (*Summary) Reset 

func (x *Summary) Reset()

func (*Summary) String 

func (x *Summary) String() string

type Untyped 

type Untyped struct {
	Value *float64 `protobuf:"fixed64,1,opt,name=value" json:"value,omitempty"`
	// contains filtered or unexported fields
}

func (*Untyped) Descriptor deprecated 

func (*Untyped) Descriptor() ([]byte, []int)

Deprecated: Use Untyped.ProtoReflect.Descriptor instead.

func (*Untyped) GetValue 

func (x *Untyped) GetValue() float64

func (*Untyped) ProtoMessage 

func (*Untyped) ProtoMessage()

func (*Untyped) ProtoReflect added in v0.4.0 

func (x *Untyped) ProtoReflect() protoreflect.Message

func (*Untyped) Reset 

func (x *Untyped) Reset()

func (*Untyped) String 

func (x *Untyped) String() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.