monitoring

Documentation

Overview

Package monitoring registers Prometheus metrics for HTTP request tracking.

Three metric vectors are registered as a side effect of importing this package:

• TrafficMetric — counter http_request_total (labels: method, route, status_code)
• ActiveRequests — gauge http_active_requests (labels: method, route)
• LatencyMetric — histogram http_request_duration_seconds (labels: method, route)

Helper functions IncrementTraffic, IncrementActiveRequests, DecrementActiveRequests, and ObserveLatency provide label-safe access. These are called automatically by the middleware.MetricsMonitor middleware.

Index

• Variables
• func DecrementActiveRequests(method, route string)
• func IncrementActiveRequests(method, route string)
• func IncrementTraffic(method, route string, status int)
• func ObserveLatency(method, route string, latency float64)

Variables

var (
	TrafficMetric = prometheus.NewCounterVec(
		prometheus.CounterOpts{
			Name: "http_request_total",
			Help: "Total number of HTTP requests.",
		},
		[]string{"method", "route", "status_code"},
	)

	ActiveRequests = prometheus.NewGaugeVec(
		prometheus.GaugeOpts{
			Name: "http_active_requests",
			Help: "Number of active HTTP requests.",
		},
		[]string{"method", "route"},
	)

	LatencyMetric = prometheus.NewHistogramVec(
		prometheus.HistogramOpts{
			Name: "http_request_duration_seconds",
			Help: "Latency of HTTP requests.",
		},
		[]string{"method", "route"},
	)
)

Functions

func DecrementActiveRequests

func DecrementActiveRequests(method, route string)

DecrementActiveRequests decrements the active requests metric

func IncrementActiveRequests

func IncrementActiveRequests(method, route string)

IncrementActiveRequests increments the active requests metric

func IncrementTraffic

func IncrementTraffic(method, route string, status int)

IncrementTraffic increments the traffic metric

func ObserveLatency

func ObserveLatency(method, route string, latency float64)

ObserveLatency observes the latency metric