118 lines
3.9 KiB
Go
118 lines
3.9 KiB
Go
// Copyright 2015 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 provider
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"github.com/prometheus/common/model"
|
|
|
|
"github.com/prometheus/alertmanager/types"
|
|
)
|
|
|
|
var (
|
|
// ErrNotFound is returned if a provider cannot find a requested item.
|
|
ErrNotFound = fmt.Errorf("item not found")
|
|
)
|
|
|
|
// Iterator provides the functions common to all iterators. To be useful, a
|
|
// specific iterator interface (e.g. AlertIterator) has to be implemented that
|
|
// provides a Next method.
|
|
type Iterator interface {
|
|
// Err returns the current error. It is not safe to call it concurrently
|
|
// with other iterator methods or while reading from a channel returned
|
|
// by the iterator.
|
|
Err() error
|
|
// Close must be called to release resources once the iterator is not
|
|
// used anymore.
|
|
Close()
|
|
}
|
|
|
|
// AlertIterator is an Iterator for Alerts.
|
|
type AlertIterator interface {
|
|
Iterator
|
|
// Next returns a channel that will be closed once the iterator is
|
|
// exhausted. It is not necessary to exhaust the iterator but Close must
|
|
// be called in any case to release resources used by the iterator (even
|
|
// if the iterator is exhausted).
|
|
Next() <-chan *types.Alert
|
|
}
|
|
|
|
// NewAlertIterator returns a new AlertIterator based on the generic alertIterator type
|
|
func NewAlertIterator(ch <-chan *types.Alert, done chan struct{}, err error) AlertIterator {
|
|
return &alertIterator{
|
|
ch: ch,
|
|
done: done,
|
|
err: err,
|
|
}
|
|
}
|
|
|
|
// alertIterator implements AlertIterator. So far, this one fits all providers.
|
|
type alertIterator struct {
|
|
ch <-chan *types.Alert
|
|
done chan struct{}
|
|
err error
|
|
}
|
|
|
|
func (ai alertIterator) Next() <-chan *types.Alert {
|
|
return ai.ch
|
|
}
|
|
|
|
func (ai alertIterator) Err() error { return ai.err }
|
|
func (ai alertIterator) Close() { close(ai.done) }
|
|
|
|
// Alerts gives access to a set of alerts. All methods are goroutine-safe.
|
|
type Alerts interface {
|
|
// Subscribe returns an iterator over active alerts that have not been
|
|
// resolved and successfully notified about.
|
|
// They are not guaranteed to be in chronological order.
|
|
Subscribe() AlertIterator
|
|
// GetPending returns an iterator over all alerts that have
|
|
// pending notifications.
|
|
GetPending() AlertIterator
|
|
// Get returns the alert for a given fingerprint.
|
|
Get(model.Fingerprint) (*types.Alert, error)
|
|
// Put adds the given alert to the set.
|
|
Put(...*types.Alert) error
|
|
}
|
|
|
|
// Silences gives access to silences. All methods are goroutine-safe.
|
|
type Silences interface {
|
|
// The Silences provider must implement the Muter interface
|
|
// for all its silences. The data provider may have access to an
|
|
// optimized view of the data to perform this evaluation.
|
|
types.Muter
|
|
|
|
// All returns all existing silences.
|
|
All() (*types.SilencesQueryResponse, error)
|
|
// Set a new silence.
|
|
Set(*types.Silence) (uint64, error)
|
|
// Del removes a silence.
|
|
Del(uint64) error
|
|
// Get a silence associated with a fingerprint.
|
|
Get(uint64) (*types.Silence, error)
|
|
// Get at most n silences starting at o offset. Returns
|
|
// ErrorNoMoreSilences and silences if n exceeds number of silences
|
|
// found.
|
|
Query(n, o int) (*types.SilencesQueryResponse, error)
|
|
}
|
|
|
|
// Notifies provides information about pending and successful
|
|
// notifications. All methods are goroutine-safe.
|
|
type Notifies interface {
|
|
Get(dest string, fps ...model.Fingerprint) ([]*types.NotifyInfo, error)
|
|
// Set several notifies at once. All or none must succeed.
|
|
Set(ns ...*types.NotifyInfo) error
|
|
}
|