// Copyright 2013 Prometheus Team // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package metric import ( "fmt" "github.com/prometheus/prometheus/model" "github.com/prometheus/prometheus/storage" "github.com/prometheus/prometheus/utility" "github.com/ryszard/goskiplist/skiplist" "sort" "time" ) const ( // Used as a separator in the format string for generating the internal label // value pair set fingerprints. reservedDelimiter = `"` ) // Models a given sample entry stored in the in-memory arena. type value interface { // Gets the given value. get() model.SampleValue } // Models a single sample value. It presumes that there is either no subsequent // value seen or that any subsequent values are of a different value. type singletonValue model.SampleValue func (v singletonValue) get() model.SampleValue { return model.SampleValue(v) } type skipListTime time.Time func (t skipListTime) LessThan(o skiplist.Ordered) bool { return time.Time(o.(skipListTime)).Before(time.Time(t)) } type stream struct { metric model.Metric values *skiplist.SkipList } func (s stream) add(timestamp time.Time, value model.SampleValue) { s.values.Set(skipListTime(timestamp), singletonValue(value)) } func (s stream) forEach(decoder storage.RecordDecoder, filter storage.RecordFilter, operator storage.RecordOperator) (scannedEntireCorpus bool, err error) { if s.values.Len() == 0 { return } iterator := s.values.SeekToLast() defer iterator.Close() for !(iterator.Key() == nil || iterator.Value() == nil) { decodedKey, decodeErr := decoder.DecodeKey(iterator.Key()) if decodeErr != nil { panic(decodeErr) } decodedValue, decodeErr := decoder.DecodeValue(iterator.Value()) if decodeErr != nil { panic(decodeErr) } switch filter.Filter(decodedKey, decodedValue) { case storage.STOP: return case storage.SKIP: continue case storage.ACCEPT: opErr := operator.Operate(decodedKey, decodedValue) if opErr != nil { if opErr.Continuable { continue } break } } if !iterator.Previous() { break } } scannedEntireCorpus = true return } func newStream(metric model.Metric) stream { return stream{ values: skiplist.New(), metric: metric, } } type memorySeriesStorage struct { fingerprintToSeries map[model.Fingerprint]stream labelPairToFingerprints map[string]model.Fingerprints labelNameToFingerprints map[model.LabelName]model.Fingerprints } func (s memorySeriesStorage) AppendSamples(samples model.Samples) (err error) { for _, sample := range samples { s.AppendSample(sample) } return } func (s memorySeriesStorage) AppendSample(sample model.Sample) (err error) { var ( metric = sample.Metric fingerprint = model.NewFingerprintFromMetric(metric) series, ok = s.fingerprintToSeries[fingerprint] ) if !ok { series = newStream(metric) s.fingerprintToSeries[fingerprint] = series for k, v := range metric { labelPair := fmt.Sprintf("%s%s%s", k, reservedDelimiter, v) labelPairValues := s.labelPairToFingerprints[labelPair] labelPairValues = append(labelPairValues, fingerprint) s.labelPairToFingerprints[labelPair] = labelPairValues labelNameValues := s.labelNameToFingerprints[k] labelNameValues = append(labelNameValues, fingerprint) s.labelNameToFingerprints[k] = labelNameValues } } series.add(sample.Timestamp, sample.Value) return } func (s memorySeriesStorage) GetFingerprintsForLabelSet(l model.LabelSet) (fingerprints model.Fingerprints, err error) { sets := []utility.Set{} for k, v := range l { signature := fmt.Sprintf("%s%s%s", k, reservedDelimiter, v) values := s.labelPairToFingerprints[signature] set := utility.Set{} for _, fingerprint := range values { set.Add(fingerprint) } sets = append(sets, set) } setCount := len(sets) if setCount == 0 { return } base := sets[0] for i := 1; i < setCount; i++ { base = base.Intersection(sets[i]) } for _, e := range base.Elements() { fingerprint := e.(model.Fingerprint) fingerprints = append(fingerprints, fingerprint) } return } func (s memorySeriesStorage) GetFingerprintsForLabelName(l model.LabelName) (fingerprints model.Fingerprints, err error) { values := s.labelNameToFingerprints[l] fingerprints = append(fingerprints, values...) return } func (s memorySeriesStorage) GetMetricForFingerprint(f model.Fingerprint) (metric *model.Metric, err error) { series, ok := s.fingerprintToSeries[f] if !ok { return } metric = &series.metric return } // XXX: Terrible wart. func interpolateSample(x1, x2 time.Time, y1, y2 float32, e time.Time) model.SampleValue { yDelta := y2 - y1 xDelta := x2.Sub(x1) dDt := yDelta / float32(xDelta) offset := float32(e.Sub(x1)) return model.SampleValue(y1 + (offset * dDt)) } func (s memorySeriesStorage) GetValueAtTime(fp model.Fingerprint, t time.Time, p StalenessPolicy) (sample *model.Sample, err error) { series, ok := s.fingerprintToSeries[fp] if !ok { return } iterator := series.values.Seek(skipListTime(t)) if iterator == nil { return } foundTime := time.Time(iterator.Key().(skipListTime)) if foundTime.Equal(t) { value := iterator.Value().(value) sample = &model.Sample{ Metric: series.metric, Value: value.get(), Timestamp: t, } return } if t.Sub(foundTime) > p.DeltaAllowance { return } secondTime := foundTime secondValue := iterator.Value().(value).get() if !iterator.Previous() { sample = &model.Sample{ Metric: series.metric, Value: iterator.Value().(value).get(), Timestamp: t, } return } firstTime := time.Time(iterator.Key().(skipListTime)) if t.Sub(firstTime) > p.DeltaAllowance { return } if firstTime.Sub(secondTime) > p.DeltaAllowance { return } firstValue := iterator.Value().(value).get() sample = &model.Sample{ Metric: series.metric, Value: interpolateSample(firstTime, secondTime, float32(firstValue), float32(secondValue), t), Timestamp: t, } return } func (s memorySeriesStorage) GetBoundaryValues(fp model.Fingerprint, i model.Interval, p StalenessPolicy) (first *model.Sample, second *model.Sample, err error) { first, err = s.GetValueAtTime(fp, i.OldestInclusive, p) if err != nil { return } else if first == nil { return } second, err = s.GetValueAtTime(fp, i.NewestInclusive, p) if err != nil { return } else if second == nil { first = nil } return } func (s memorySeriesStorage) GetRangeValues(fp model.Fingerprint, i model.Interval) (samples *model.SampleSet, err error) { series, ok := s.fingerprintToSeries[fp] if !ok { return } samples = &model.SampleSet{ Metric: series.metric, } iterator := series.values.Seek(skipListTime(i.NewestInclusive)) if iterator == nil { return } for { timestamp := time.Time(iterator.Key().(skipListTime)) if timestamp.Before(i.OldestInclusive) { break } samples.Values = append(samples.Values, model.SamplePair{ Value: iterator.Value().(value).get(), Timestamp: timestamp, }) if !iterator.Next() { break } } // XXX: We should not explicitly sort here but rather rely on the datastore. // This adds appreciable overhead. if samples != nil { sort.Sort(samples.Values) } return } func (s memorySeriesStorage) Close() (err error) { // This can probably be simplified: // // s.fingerPrintToSeries = map[model.Fingerprint]*stream{} // s.labelPairToFingerprints = map[string]model.Fingerprints{} // s.labelNameToFingerprints = map[model.LabelName]model.Fingerprints{} for fingerprint := range s.fingerprintToSeries { delete(s.fingerprintToSeries, fingerprint) } for labelPair := range s.labelPairToFingerprints { delete(s.labelPairToFingerprints, labelPair) } for labelName := range s.labelNameToFingerprints { delete(s.labelNameToFingerprints, labelName) } return } func (s memorySeriesStorage) GetAllMetricNames() (metrics []string, err error) { metricSet := map[string]bool{} for _, series := range s.fingerprintToSeries { if metricName, ok := series.metric["name"]; !ok { err = fmt.Errorf("Found timeseries without metric name label: %v", series.metric) } else { metricSet[string(metricName)] = true } } for metricName := range metricSet { metrics = append(metrics, metricName) } sort.Strings(metrics) return } func (s memorySeriesStorage) ForEachSample(builder IteratorsForFingerprintBuilder) (err error) { for _, stream := range s.fingerprintToSeries { decoder, filter, operator := builder.ForStream(stream) stream.forEach(decoder, filter, operator) } return } func NewMemorySeriesStorage() memorySeriesStorage { return memorySeriesStorage{ fingerprintToSeries: make(map[model.Fingerprint]stream), labelPairToFingerprints: make(map[string]model.Fingerprints), labelNameToFingerprints: make(map[model.LabelName]model.Fingerprints), } }