https://github.com/b0ch3nski/go-prom-remote-write

Bare minimum Prometheus Remote-Write client.
https://github.com/b0ch3nski/go-prom-remote-write

golang metrics monitoring prometheus remote-write time-series

Last synced: 1 day ago
JSON representation

Bare minimum Prometheus Remote-Write client.

• Host: GitHub
• URL: https://github.com/b0ch3nski/go-prom-remote-write
• Owner: b0ch3nski
• License: apache-2.0
• Created: 2023-10-08T19:23:39.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2024-08-11T21:39:19.000Z (3 months ago)
• Last Synced: 2024-08-11T22:37:13.612Z (3 months ago)
• Topics: golang, metrics, monitoring, prometheus, remote-write, time-series
• Language: Go
• Homepage:
• Size: 42 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# go-prom-remote-write

[![license](https://img.shields.io/github/license/b0ch3nski/go-prom-remote-write)](LICENSE)

[![release](https://img.shields.io/github/v/release/b0ch3nski/go-prom-remote-write)](https://github.com/b0ch3nski/go-prom-remote-write/releases)

[![go.dev](https://pkg.go.dev/badge/github.com/b0ch3nski/go-prom-remote-write)](https://pkg.go.dev/github.com/b0ch3nski/go-prom-remote-write)

[![goreportcard](https://goreportcard.com/badge/github.com/b0ch3nski/go-prom-remote-write)](https://goreportcard.com/report/github.com/b0ch3nski/go-prom-remote-write)

[![issues](https://img.shields.io/github/issues/b0ch3nski/go-prom-remote-write)](https://github.com/b0ch3nski/go-prom-remote-write/issues)

[![sourcegraph](https://sourcegraph.com/github.com/b0ch3nski/go-prom-remote-write/-/badge.svg)](https://sourcegraph.com/github.com/b0ch3nski/go-prom-remote-write)

Bare minimum Prometheus Remote-Write client, based on Proto files acquired from upstream [repository][repo]. \

All dependencies were cut down with only `snappy` and `protobuf` remaining. \

Data marshaling doesn't use reflection, thanks to the [vtprotobuf][vtproto] generation helper.

For a code generation procedure, see included [Makefile](Makefile).

Simple client fulfills the Remote-Write [specification][spec] with couple small additions, like ability to handle

timeouts and Basic authentication.

[repo]: https://github.com/prometheus/prometheus/tree/main/prompb

[vtproto]: https://github.com/planetscale/vtprotobuf

[spec]: https://prometheus.io/docs/concepts/remote_write_spec

## install

```

go get github.com/b0ch3nski/go-prom-remote-write@latest

```

## example

```go

import "github.com/b0ch3nski/go-prom-remote-write/promrw"

import "github.com/b0ch3nski/go-prom-remote-write/promrw/model"

promClient := promrw.

	NewClient("http://localhost:9090/api/v1/write").

	WithAuthBasic("username", "password").

	WithTimeout(3 * time.Second).

	WithHttpClient(&http.Client{Transport: &http.Transport{MaxConnsPerHost: 0}})

series := []*model.TimeSeries{

	{

		Samples: []*model.Sample{

			{

				Value:     321.123,

				Timestamp: time.Now().UTC().UnixMilli(),

			},

		},

		Labels: []*model.Label{

			{

				Name:  "__name__",

				Value: "test_metric",

			},

		},

	},

}

promClient.Write(context.Background(), series)

```