alerts

Documentation

Index

• type Alert
• type Alerter
  • func WithOrigin(alerter Alerter, origin string) Alerter
• type Manager
  • func NewManager() *Manager
  • func (m *Manager) Active() []Alert
  • func (m *Manager) DismissAlerts(ctx context.Context, ids ...types.Hash256) error
  • func (m *Manager) RegisterAlert(ctx context.Context, alert Alert) error
  • func (m *Manager) RegisterWebhookBroadcaster(b webhooks.Broadcaster)
• type Severity
  • func (s Severity) MarshalJSON() ([]byte, error)
  • func (s Severity) String() string
  • func (s *Severity) UnmarshalJSON(b []byte) error

Types

type Alert

type Alert struct {
	// ID is a unique identifier for the alert.
	ID types.Hash256 `json:"id"`
	// Severity is the severity of the alert.
	Severity Severity `json:"severity"`
	// Message is a human-readable message describing the alert.
	Message string `json:"message"`
	// Data is a map of arbitrary data that can be used to provide
	// additional context to the alert.
	Data      map[string]any `json:"data,omitempty"`
	Timestamp time.Time      `json:"timestamp"`
}

An Alert is a dismissible message that is displayed to the user.

type Alerter

type Alerter interface {
	RegisterAlert(_ context.Context, a Alert) error
	DismissAlerts(_ context.Context, ids ...types.Hash256) error
}

func WithOrigin

func WithOrigin(alerter Alerter, origin string) Alerter

WithOrigin wraps an Alerter in an originAlerter which always attaches the origin field to alerts.

type Manager

type Manager struct {
	// contains filtered or unexported fields
}

A Manager manages the host's alerts.

func NewManager

func NewManager() *Manager

NewManager initializes a new alerts manager.

func (*Manager) Active

func (m *Manager) Active() []Alert

Active returns the host's active alerts.

func (*Manager) DismissAlerts

func (m *Manager) DismissAlerts(ctx context.Context, ids ...types.Hash256) error

DismissAlerts implements the Alerter interface.

func (*Manager) RegisterAlert

func (m *Manager) RegisterAlert(ctx context.Context, alert Alert) error

RegisterAlert implements the Alerter interface.

func (*Manager) RegisterWebhookBroadcaster

func (m *Manager) RegisterWebhookBroadcaster(b webhooks.Broadcaster)

type Severity

type Severity uint8

Severity indicates the severity of an alert.

const (
	// SeverityInfo indicates that the alert is informational.
	SeverityInfo Severity = iota + 1
	// SeverityWarning indicates that the alert is a warning.
	SeverityWarning
	// SeverityError indicates that the alert is an error.
	SeverityError
	// SeverityCritical indicates that the alert is critical.
	SeverityCritical
)

func (Severity) MarshalJSON

func (s Severity) MarshalJSON() ([]byte, error)

MarshalJSON implements the json.Marshaler interface.

func (Severity) String

func (s Severity) String() string

String implements the fmt.Stringer interface.

func (*Severity) UnmarshalJSON

func (s *Severity) UnmarshalJSON(b []byte) error

UnmarshalJSON implements the json.Unmarshaler interface.