远程写入prometheus存储具体方法

prometheus一般都是采用pull方式获取数据,但是有一些情况下,不方便配置exporter,就希望能通过push的方式上传指标数据。

简介

prometheus一般都是采用pull方式获取数据,但是有一些情况下,不方便配置exporter,就希望能通过push的方式上传指标数据。

1、可以采用pushgateway的方式,推送到pushgateway,然后prometheus通过pushgateway拉取数据。

2、在新版本中增加了一个参数:–enable-feature=remote-write-receiver,允许远程通过接口/api/v1/write,直接写数据到prometheus里面。

pushgateway在高并发的情况下还是比较消耗资源的,特别是开启一致性检查,高并发写入的时候特别慢。

第二种方式少了一层转发,速度应该比较快。

接口

可以通过prometheus的http接口/api/v1/write提交数据,这个接口的数据格式有有要求: 使用POST方式提交 需要经过protobuf编码,依赖github.com/gogo/protobuf/proto 可以使用snappy进行压缩,依赖github.com/golang/snappy

步骤:

收集指标名称,时间戳,值和标签 将数据转换成prometheus需要的数据格式 使用proto对数据进行编码,并用snappy进行压缩 通过httpClient提交数据

package prome

import (
   "bufio"
   "bytes"
   "context"
   "io"
   "io/ioutil"
   "net/http"
   "net/url"
   "regexp"
   "time"

   "github.com/gogo/protobuf/proto"
   "github.com/golang/snappy"
   "github.com/opentracing-contrib/go-stdlib/nethttp"
   opentracing "github.com/opentracing/opentracing-go"
   "github.com/pkg/errors"
   "github.com/prometheus/common/model"
   "github.com/prometheus/prometheus/pkg/labels"
   "github.com/prometheus/prometheus/prompb"
)

type RecoverableError struct {
   error
}

type HttpClient struct {
   url     *url.URL
   Client  *http.Client
   timeout time.Duration
}

var MetricNameRE = regexp.MustCompile(`^[a-zA-Z_:][a-zA-Z0-9_:]*$`)

type MetricPoint struct {
   Metric  string            `json:"metric"` // 指标名称
   TagsMap map[string]string `json:"tags"`   // 数据标签
   Time    int64             `json:"time"`   // 时间戳,单位是秒
   Value   float64           `json:"value"`  // 内部字段,最终转换之后的float64数值
}

func (c *HttpClient) remoteWritePost(req []byte) error {
   httpReq, err := http.NewRequest("POST", c.url.String(), bytes.NewReader(req))
   if err != nil {
       return err
   }
   httpReq.Header.Add("Content-Encoding""snappy")
   httpReq.Header.Set("Content-Type""application/x-protobuf")
   httpReq.Header.Set("User-Agent""opcai")
   httpReq.Header.Set("X-Prometheus-Remote-Write-Version""0.1.0")
   ctx, cancel := context.WithTimeout(context.Background(), c.timeout)
   defer cancel()

   httpReq = httpReq.WithContext(ctx)

   if parentSpan := opentracing.SpanFromContext(ctx); parentSpan != nil {
       var ht *nethttp.Tracer
       httpReq, ht = nethttp.TraceRequest(
           parentSpan.Tracer(),
           httpReq,
           nethttp.OperationName("Remote Store"),
           nethttp.ClientTrace(false),
       )
       defer ht.Finish()
   }

   httpResp, err := c.Client.Do(httpReq)
   if err != nil {
       // Errors from Client.Do are from (for example) network errors, so are
       // recoverable.
       return RecoverableError{err}
   }
   defer func() {
       io.Copy(ioutil.Discard, httpResp.Body)
       httpResp.Body.Close()
   }()

   if httpResp.StatusCode/100 != 2 {
       scanner := bufio.NewScanner(io.LimitReader(httpResp.Body, 512))
       line := ""
       if scanner.Scan() {
           line = scanner.Text()
       }
       err = errors.Errorf("server returned HTTP status %s: %s", httpResp.Status, line)
   }
   if httpResp.StatusCode/100 == 5 {
       return RecoverableError{err}
   }
   return err
}

func buildWriteRequest(samples []*prompb.TimeSeries) ([]byte, error) {

   req := &prompb.WriteRequest{
       Timeseries: samples,
   }
   data, err := proto.Marshal(req)
   if err != nil {
       return nil, err
   }
   compressed := snappy.Encode(nil, data)
   return compressed, nil
}

type sample struct {
   labels labels.Labels
   t      int64
   v      float64
}

const (
   LABEL_NAME = "__name__"
)

func convertOne(item *MetricPoint) (*prompb.TimeSeries, error) {
   pt := prompb.TimeSeries{}
   pt.Samples = []prompb.Sample{{}}
   s := sample{}
   s.t = item.Time
   s.v = item.Value
   // name
   if !MetricNameRE.MatchString(item.Metric) {
       return &pt, errors.New("invalid metrics name")
   }
   nameLs := labels.Label{
       Name:  LABEL_NAME,
       Value: item.Metric,
   }
   s.labels = append(s.labels, nameLs)
   for k, v := range item.TagsMap {
       if model.LabelNameRE.MatchString(k) {
           ls := labels.Label{
               Name:  k,
               Value: v,
           }
           s.labels = append(s.labels, ls)
       }
   }

   pt.Labels = labelsToLabelsProto(s.labels, pt.Labels)
   // 时间赋值问题,使用毫秒时间戳
   tsMs := time.Unix(s.t, 0).UnixNano() / 1e6
   pt.Samples[0].Timestamp = tsMs
   pt.Samples[0].Value = s.v
   return &pt, nil
}

func labelsToLabelsProto(labels labels.Labels, buf []*prompb.Label) []*prompb.Label {
   result := buf[:0]
   if cap(buf) for _, l := range labels {
       result = append(result, &prompb.Label{
           Name:  l.Name,
           Value: l.Value,
       })
   }
   return result
}

func (c *HttpClient) RemoteWrite(items []MetricPoint) (err error) {
   if len(items) == 0 {
       return
   }
   ts := make([]*prompb.TimeSeries, len(items))
   for i := range items {
       ts[i], err = convertOne(&items[i])
       if err != nil {
           return
       }
   }
   data, err := buildWriteRequest(ts)
   if err != nil {
       return
   }
   err = c.remoteWritePost(data)
   return
}

func NewClient(ur string, timeout time.Duration) (c *HttpClient, err error) {
   u, err := url.Parse(ur)
   if err != nil {
       return
   }
   c = &HttpClient{
       url:     u,
       Client:  &http.Client{},
       timeout: timeout,
   }
   return
}

测试

prometheus启动的时候记得加参数–enable-feature=remote-write-receiver

package prome

import (
   "testing"
   "time"
)

func TestRemoteWrite(t *testing.T) {
   c, err := NewClient("http://localhost:9090/api/v1/write", 10*time.Second)
   if err != nil {
       t.Fatal(err)
   }
   metrics := []MetricPoint{
       {Metric: "opcai1",
           TagsMap: map[string]string{"env""testing""op""opcai"},
           Time:    time.Now().Add(-1 * time.Minute).Unix(),
           Value:   1},
       {Metric: "opcai2",
           TagsMap: map[string]string{"env""testing""op""opcai"},
           Time:    time.Now().Add(-2 * time.Minute).Unix(),
           Value:   2},
       {Metric: "opcai3",
           TagsMap: map[string]string{"env""testing""op""opcai"},
           Time:    time.Now().Unix(),
           Value:   3},
       {Metric: "opcai4",
           TagsMap: map[string]string{"env""testing""op""opcai"},
           Time:    time.Now().Unix(),
           Value:   4},
   }
   err = c.RemoteWrite(metrics)
   if err != nil {
       t.Fatal(err)
   }
   t.Log("end...")
}

使用go test进行测试

go test -v

文章来源网络,作者:运维,如若转载,请注明出处:https://shuyeidc.com/wp/220585.html<

(0)
运维的头像运维
上一篇2025-04-14 15:36
下一篇 2025-04-14 15:37

相关推荐

  • 个人主题怎么制作?

    制作个人主题是一个将个人风格、兴趣或专业领域转化为视觉化或结构化内容的过程,无论是用于个人博客、作品集、社交媒体账号还是品牌形象,核心都是围绕“个人特色”展开,以下从定位、内容规划、视觉设计、技术实现四个维度,详细拆解制作个人主题的完整流程,明确主题定位:找到个人特色的核心主题定位是所有工作的起点,需要先回答……

    2025-11-20
    0
  • 社群营销管理关键是什么?

    社群营销的核心在于通过建立有温度、有价值、有归属感的社群,实现用户留存、转化和品牌传播,其管理需贯穿“目标定位-内容运营-用户互动-数据驱动-风险控制”全流程,以下从五个维度展开详细说明:明确社群定位与目标社群管理的首要任务是精准定位,需明确社群的核心价值(如行业交流、产品使用指导、兴趣分享等)、目标用户画像……

    2025-11-20
    0
  • 香港公司网站备案需要什么材料?

    香港公司进行网站备案是一个涉及多部门协调、流程相对严谨的过程,尤其需兼顾中国内地与香港两地的监管要求,由于香港公司注册地与中国内地不同,其网站若主要服务内地用户或使用内地服务器,需根据服务器位置、网站内容性质等,选择对应的备案路径(如工信部ICP备案或公安备案),以下从备案主体资格、流程步骤、材料准备、注意事项……

    2025-11-20
    0
  • 如何企业上云推广

    企业上云已成为数字化转型的核心战略,但推广过程中需结合行业特性、企业痛点与市场需求,构建系统性、多维度的推广体系,以下从市场定位、策略设计、执行落地及效果优化四个维度,详细拆解企业上云推广的实践路径,精准定位:明确目标企业与核心价值企业上云并非“一刀切”的方案,需先锁定目标客户群体,提炼差异化价值主张,客户分层……

    2025-11-20
    0
  • PS设计搜索框的实用技巧有哪些?

    在PS中设计一个美观且功能性的搜索框需要结合创意构思、视觉设计和用户体验考量,以下从设计思路、制作步骤、细节优化及交互预览等方面详细说明,帮助打造符合需求的搜索框,设计前的规划明确使用场景:根据网站或APP的整体风格确定搜索框的调性,例如极简风适合细线条和纯色,科技感适合渐变和发光效果,电商类则可能需要突出搜索……

    2025-11-20
    0

发表回复

您的邮箱地址不会被公开。必填项已用 * 标注