prome

README

prome

Prometheus Client for easy use.

Documentation

Index

• Variables
• type Client
  • func NewClient(serviceName string, path string) *Client
  • func (c *Client) AddCounter(opts prometheus.CounterOpts) prometheus.Counter
  • func (c *Client) AddCounterVec(opts prometheus.CounterOpts, labelNames []string) *prometheus.CounterVec
  • func (c *Client) AddGauge(opts prometheus.GaugeOpts) prometheus.Gauge
  • func (c *Client) AddGaugeVec(opts prometheus.GaugeOpts, labelNames []string) *prometheus.GaugeVec
  • func (c *Client) AddHistogram(opts prometheus.HistogramOpts) prometheus.Histogram
  • func (c *Client) AddHistogramVec(opts prometheus.HistogramOpts, labelNames []string) *prometheus.HistogramVec
  • func (c *Client) AddSummary(opts prometheus.SummaryOpts) prometheus.Summary
  • func (c *Client) AddSummaryVec(opts prometheus.SummaryOpts, labelNames []string) *prometheus.SummaryVec
  • func (c *Client) Close() error
  • func (c *Client) Handler() http.Handler
  • func (c *Client) ListenAndServe(addr string) error
  • func (c *Client) MiddlewareRequestCount(metricsName string) gin.HandlerFunc
  • func (c *Client) MiddlewareRequestDuration(metricsName string, objectives map[float64]float64) gin.HandlerFunc

Variables

var DefaultRequestDurationSummaryObjectives = map[float64]float64{
	0.5:  0.05,
	0.9:  0.01,
	0.95: 0.005,
	0.99: 0.001,
}

DefaultRequestDurationSummaryObjectives represents objectives of request duration middleware summary.

Types

type Client

type Client struct {
	ServiceName string
	Path        string

	// Enable metrics of runtime. Default enabled.
	EnableRuntime bool

	// Labels which will always be attached to metrics.
	ConstLabels prometheus.Labels
	// contains filtered or unexported fields
}

Client represents the client for prometheus server to pull data from.

func NewClient

func NewClient(serviceName string, path string) *Client

NewClient creates and returns a new Client instance.

func (*Client) AddCounter

func (c *Client) AddCounter(opts prometheus.CounterOpts) prometheus.Counter

func (*Client) AddCounterVec

func (c *Client) AddCounterVec(
	opts prometheus.CounterOpts, labelNames []string,
) *prometheus.CounterVec

func (*Client) AddGauge

func (c *Client) AddGauge(opts prometheus.GaugeOpts) prometheus.Gauge

func (*Client) AddGaugeVec

func (c *Client) AddGaugeVec(
	opts prometheus.GaugeOpts, labelNames []string,
) *prometheus.GaugeVec

func (*Client) AddHistogram

func (c *Client) AddHistogram(opts prometheus.HistogramOpts) prometheus.Histogram

func (*Client) AddHistogramVec

func (c *Client) AddHistogramVec(
	opts prometheus.HistogramOpts, labelNames []string,
) *prometheus.HistogramVec

func (*Client) AddSummary

func (c *Client) AddSummary(opts prometheus.SummaryOpts) prometheus.Summary

func (*Client) AddSummaryVec

func (c *Client) AddSummaryVec(
	opts prometheus.SummaryOpts, labelNames []string,
) *prometheus.SummaryVec

func (*Client) Close

func (c *Client) Close() error

Close shutdown of listening.

func (*Client) Handler

func (c *Client) Handler() http.Handler

Handler returns the http handler which can be used for fetch metrics data.

func (*Client) ListenAndServe

func (c *Client) ListenAndServe(addr string) error

ListenAndServe listen on the addr and provide access for prometheus server to pull data.

func (*Client) MiddlewareRequestCount

func (c *Client) MiddlewareRequestCount(metricsName string) gin.HandlerFunc

MiddlewareRequestCount returns a gin HandlerFunc which can be used as middleware to capture request count.

func (*Client) MiddlewareRequestDuration

func (c *Client) MiddlewareRequestDuration(
	metricsName string, objectives map[float64]float64,
) gin.HandlerFunc

MiddlewareRequestDuration returns a gin handler which can be used as middleware to capture request duration summary.