次の形式で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
[..]
metricとlabelの組み合わせは一意である必要があることを理解していますが、タイムスタンプも追加しているため、一意のメトリックとしてカウントされませんか?上記の私の期待は可能ですか?
Prometheusエクスポーターでこれらの測定値をどのように表すことができますか?
参照元 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
でデータを監視できます。
お役に立てれば幸いです。
よく見ると、タイムスタンプは親キーではなく、デバイス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