Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zsais/go-gin-prometheus
Gin Web Framework Prometheus metrics exporter
https://github.com/zsais/go-gin-prometheus
gin-gonic go middleware prometheus
Last synced: about 2 hours ago
JSON representation
Gin Web Framework Prometheus metrics exporter
- Host: GitHub
- URL: https://github.com/zsais/go-gin-prometheus
- Owner: zsais
- License: mit
- Created: 2015-09-01T23:08:26.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-08-11T18:27:57.000Z (6 months ago)
- Last Synced: 2024-10-29T17:29:38.484Z (3 months ago)
- Topics: gin-gonic, go, middleware, prometheus
- Language: Go
- Size: 38.1 KB
- Stars: 451
- Watchers: 2
- Forks: 133
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-gin - zsais/go-gin-prometheus
README
# go-gin-prometheus
[](https://godoc.org/github.com/zsais/go-gin-prometheus) [](https://opensource.org/licenses/MIT)
Gin Web Framework Prometheus metrics exporter
## Installation
`$ go get github.com/zsais/go-gin-prometheus`
## Usage
```go
package main
import (
"github.com/gin-gonic/gin"
"github.com/zsais/go-gin-prometheus"
)
func main() {
r := gin.New()
p := ginprometheus.NewPrometheus("gin")
p.Use(r)
r.GET("/", func(c *gin.Context) {
c.JSON(200, "Hello world!")
})
r.Run(":29090")
}
```
See the [example.go file](https://github.com/zsais/go-gin-prometheus/blob/master/example/example.go)
## Preserving a low cardinality for the request counter
The request counter (`requests_total`) has a `url` label which,
although desirable, can become problematic in cases where your
application uses templated routes expecting a great number of
variations, as Prometheus explicitly recommends against metrics having
high cardinality dimensions:
https://prometheus.io/docs/practices/naming/#labels
If you have for instance a `/customer/:name` templated route and you
don't want to generate a time series for every possible customer name,
you could supply this mapping function to the middleware:
```go
package main
import (
"github.com/gin-gonic/gin"
"github.com/zsais/go-gin-prometheus"
)
func main() {
r := gin.New()
p := ginprometheus.NewPrometheus("gin")
p.ReqCntURLLabelMappingFn = func(c *gin.Context) string {
url := c.Request.URL.Path
for _, p := range c.Params {
if p.Key == "name" {
url = strings.Replace(url, p.Value, ":name", 1)
break
}
}
return url
}
p.Use(r)
r.GET("/", func(c *gin.Context) {
c.JSON(200, "Hello world!")
})
r.Run(":29090")
}
```
which would map `/customer/alice` and `/customer/bob` to their
template `/customer/:name`, and thus preserve a low cardinality for
our metrics.