mirror of
https://github.com/prometheus/prometheus.git
synced 2024-09-21 16:27:32 -07:00
a55602df4a
It is the case with the benchmark tool that we thought that we generated multiple series and saved them to the disk as such, when in reality, we overwrote the fields of the outgoing metrics via Go map reference behavior. This was accidental. In the course of diagnosing this, a few errors were found: 1. ``newSeriesFrontier`` should check to see if the candidate fingerprint is within the given domain of the ``diskFrontier``. If not, as the contract in the docstring stipulates, a ``nil`` ``seriesFrontier`` should be emitted. 2. In the interests of aiding debugging, the raw LevelDB ``levigoIterator`` type now includes a helpful forensics ``String()`` method. This work produced additional cleanups: 1. ``Close() error`` with the storage stack is technically incorrect, since nowhere in the bowels of it does an error actually occur. The interface has been simplified to remove this for now.
61 lines
2.3 KiB
Go
61 lines
2.3 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 raw
|
|
|
|
import (
|
|
"github.com/prometheus/prometheus/coding"
|
|
"github.com/prometheus/prometheus/storage"
|
|
)
|
|
|
|
// Persistence models a key-value store for bytes that supports various
|
|
// additional operations.
|
|
type Persistence interface {
|
|
// Close reaps all of the underlying system resources associated with this
|
|
// persistence.
|
|
Close()
|
|
// Has informs the user whether a given key exists in the database.
|
|
Has(key coding.Encoder) (bool, error)
|
|
// Get retrieves the key from the database if it exists or returns nil if
|
|
// it is absent.
|
|
Get(key coding.Encoder) ([]byte, error)
|
|
// Drop removes the key from the database.
|
|
Drop(key coding.Encoder) error
|
|
// Put sets the key to a given value.
|
|
Put(key, value coding.Encoder) error
|
|
// ForEach is responsible for iterating through all records in the database
|
|
// until one of the following conditions are met:
|
|
//
|
|
// 1.) A system anomaly in the database scan.
|
|
// 2.) The last record in the database is reached.
|
|
// 3.) A FilterResult of STOP is emitted by the Filter.
|
|
//
|
|
// Decoding errors for an entity cause that entity to be skipped.
|
|
ForEach(decoder storage.RecordDecoder, filter storage.RecordFilter, operator storage.RecordOperator) (scannedEntireCorpus bool, err error)
|
|
// Commit applies the Batch operations to the database.
|
|
Commit(Batch) error
|
|
}
|
|
|
|
// Batch models a pool of mutations for the database that can be committed
|
|
// en masse. The interface implies no protocol around the atomicity of
|
|
// effectuation.
|
|
type Batch interface {
|
|
// Close reaps all of the underlying system resources associated with this
|
|
// batch mutation.
|
|
Close()
|
|
// Put follows the same protocol as Persistence.Put.
|
|
Put(key, value coding.Encoder)
|
|
// Drop follows the same protocol as Persistence.Drop.
|
|
Drop(key coding.Encoder)
|
|
}
|