mirror of
https://github.com/prometheus/prometheus.git
synced 2025-02-21 03:16:00 -08:00
ce1ee444f1
This does two things:
1) Make TieredStorage.AppendSamples() write directly to memory instead of
buffering to a channel first. This is needed in cases where a rule might
immediately need the data generated by a previous rule.
2) Replace the single storage mutex by two new ones:
- memoryMutex - needs to be locked at any time that two concurrent
goroutines could be accessing (via read or write) the
TieredStorage memoryArena.
- memoryDeleteMutex - used to prevent any deletion of samples from
memoryArena as long as renderView is running and
assembling data from it.
The LevelDB disk storage does not need to be protected by a mutex when
rendering a view since renderView works off a LevelDB snapshot.
The rationale against adding memoryMutex directly to the memory storage: taking
a mutex does come with a small inherent time cost, and taking it is only
required in few places. In fact, no locking is required for the memory storage
instance which is part of a view (and not the TieredStorage).
83 lines
2.9 KiB
Go
83 lines
2.9 KiB
Go
// 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 (
|
|
"github.com/prometheus/prometheus/model"
|
|
"github.com/prometheus/prometheus/storage"
|
|
"time"
|
|
)
|
|
|
|
// MetricPersistence is a system for storing metric samples in a persistence
|
|
// layer.
|
|
type MetricPersistence interface {
|
|
// A storage system may rely on external resources and thusly should be
|
|
// closed when finished.
|
|
Close()
|
|
|
|
// Commit all pending operations, if any, since some of the storage components
|
|
// queue work on channels and operate on it in bulk.
|
|
// Flush() error
|
|
|
|
// Record a new sample in the storage layer.
|
|
AppendSample(model.Sample) error
|
|
|
|
// Record a group of new samples in the storage layer.
|
|
AppendSamples(model.Samples) error
|
|
|
|
// Get all of the metric fingerprints that are associated with the provided
|
|
// label set.
|
|
GetFingerprintsForLabelSet(model.LabelSet) (model.Fingerprints, error)
|
|
|
|
// Get all of the metric fingerprints that are associated for a given label
|
|
// name.
|
|
GetFingerprintsForLabelName(model.LabelName) (model.Fingerprints, error)
|
|
|
|
// Get the metric associated with the provided fingerprint.
|
|
GetMetricForFingerprint(model.Fingerprint) (*model.Metric, error)
|
|
|
|
GetValueAtTime(model.Fingerprint, time.Time) model.Values
|
|
GetBoundaryValues(model.Fingerprint, model.Interval) (first model.Values, second model.Values)
|
|
GetRangeValues(model.Fingerprint, model.Interval) model.Values
|
|
|
|
ForEachSample(IteratorsForFingerprintBuilder) (err error)
|
|
|
|
// Get all label values that are associated with a given label name.
|
|
GetAllValuesForLabel(model.LabelName) (model.LabelValues, error)
|
|
|
|
// Requests the storage stack to build a materialized View of the values
|
|
// contained therein.
|
|
// MakeView(builder ViewRequestBuilder, deadline time.Duration) (View, error)
|
|
}
|
|
|
|
// View provides view of the values in the datastore subject to the request of a
|
|
// preloading operation.
|
|
type View interface {
|
|
GetValueAtTime(model.Fingerprint, time.Time) model.Values
|
|
GetBoundaryValues(model.Fingerprint, model.Interval) (first model.Values, second model.Values)
|
|
GetRangeValues(model.Fingerprint, model.Interval) model.Values
|
|
|
|
// Destroy this view.
|
|
Close()
|
|
}
|
|
|
|
type Series interface {
|
|
Fingerprint() model.Fingerprint
|
|
Metric() model.Metric
|
|
}
|
|
|
|
type IteratorsForFingerprintBuilder interface {
|
|
ForStream(stream stream) (storage.RecordDecoder, storage.RecordFilter, storage.RecordOperator)
|
|
}
|