web-dev-qa-db-ja.com

Prometheusコレクターが「同じ名前とラベル値で以前に収集されたメトリックが収集された」というエラーで失敗する

次の形式でJSONとして温度測定値を公開するデバイスがあります。

[
  {
    "dataPointId": 123456,
    "values": [
      {
        "t": 1589236277000,
        "v": 14.999993896484398
      },
      {
        "t": 1589236877000,
        "v": 14.700006103515648
      },
      {
        "t": 1589237477000,
        "v": 14.999993896484398
      },
[..]

ご覧のとおり、値にはタイムスタンプと温度測定値の両方が含まれています。これらの測定値をPrometheusメトリックスで公開したいので、prometheus/client_golangエクスポーターを構築します。

私の期待は/metricsエンドポイントは、上記のデータから次のようなものを公開します。

# HELP my_temperature_celsius Temperature
# TYPE my_temperature_celsius gauge
my_temperature_celsius{id="123456"} 14.999993896484398 1589236277000
my_temperature_celsius{id="123456"} 14.700006103515648 1589236877000
my_temperature_celsius{id="123456"} 14.999993896484398 1589237477000

シンプルなprometheus.Collectorと私は問題なく静的メトリックを追加しています。上記の測定では、NewMetricWithTimestampがタイムスタンプ付きのメトリックを追加する唯一の方法であると思われるため、次のようなものを使用してこれらの値を繰り返し処理します。

for _, measurements := range dp.Values {
  ch <- prometheus.NewMetricWithTimestamp(
    time.Unix(measurements.T, 0),
    prometheus.MustNewConstMetric(
      collector.temperature,
      prometheus.GaugeValue,
      float64(measurements.V),
      device.DatapointID))
}

しかし、これは私が完全には理解していない次のエラーにつながります:

An error has occurred while serving metrics:

1135 error(s) occurred:
* collected metric "my_temperature_celsius" { label:<name:"id" value:"123456" > gauge:<value:14.999993896484398 > timestamp_ms:1589236877000000 } was collected before with the same name and label values
* collected metric "my_temperature_celsius" { label:<name:"id" value:"123456" > gauge:<value:14.700006103515648 > timestamp_ms:1589237477000000 } was collected before with the same name and label values
[..]
  • metriclabelの組み合わせは一意である必要があることを理解していますが、タイムスタンプも追加しているため、一意のメトリックとしてカウントされませんか?上記の私の期待は可能ですか?

  • Prometheusエクスポーターでこれらの測定値をどのように表すことができますか?

4
Simon

参照元 Prometheus

A gauge is a metric that represents a single numerical value that can arbitrarily go up and down.

A histogram samples observations (usually things like request durations or response sizes) and counts them in configurable buckets. 

Gaugeは、私たちが気にする1つの値に使用され、タイムスタンプは気にしません。昨日の気温ではなく、現在の気温と同じです。

Gaugeは、探している指標タイプではありません。または、プロメテウスはあなたが探しているものではないかもしれません。

温度を監視する場合は、histogramを使用します。平均温度、最小温度、または最大値を短時間で計算できます。ただし、独自のタイムスタンプを使用する場合は、ヒストグラムコレクタを自分で実装する必要があります。このファイルは prometheus/client_golang/histogram.go から確認できます。単純ではないAT ALL。

あなたが本当に必要なのはA time series database、influxdbなど。 jsonをhttpにポストするのと同じくらい簡単に、カスタムタイムスタンプを受け入れるinfluxdbにデータをプッシュし、grafanaでデータを監視できます。

お役に立てれば幸いです。

1
Billy Yuan

よく見ると、タイムスタンプは親キーではなく、デバイスIDと値の配列としての値を持っているのではなく、各デバイスの内部にあるため、メトリックコレクションのコンテキストではJSONデータ形式が少し冗長であることがわかります。そうして初めて、リアルタイムの系列データをループし、ラベルはループのように静的になりません。ラベルの一意性は、ラベル名+ラベル値が一緒にハッシュされたものです。

私はそれから、好ましいアプローチはゲージベクトルを作ることだと思います。 WithLabelValuesを使用してGaugeオブジェクトを取得し、Setを呼び出して値を設定します

deviceTempGaugeVector := prometheus.NewGaugeVec(
    prometheus.GaugeOpts{
        Name: "my_temperature_celsius",
    },
    []string{
        "device_id" // Using single label instead of 2 labels "id" and "value"
    },
)

prometheus.MustRegister(deviceTempGaugeVector)

for _, point := range dp.TimeStamps {
  for _, measurements := range point {
    deviceId := measurements.DatapointID
    value := measurements.V
    metric := deviceTempGaugeVector.WithLabelValues(deviceId).Set(value)
    ch <- prometheus.NewMetricWithTimestamp(time.Unix(measurements.T, 0),metric)
  }
}

参照: https://godoc.org/github.com/prometheus/client_golang/prometheus#NewGaugeVec

2
sakshamsaxena