package notifiers import ( "context" "time" "github.com/grafana/grafana/pkg/infra/log" "github.com/grafana/grafana/pkg/models" "github.com/grafana/grafana/pkg/services/alerting" ) const ( triggMetrString = "Triggered metrics:\n\n" ) // NotifierBase is the base implementation of a notifier. type NotifierBase struct { Name string Type string UID string IsDefault bool UploadImage bool SendReminder bool DisableResolveMessage bool Frequency time.Duration log log.Logger } // NewNotifierBase returns a new `NotifierBase`. func NewNotifierBase(model *models.AlertNotification) NotifierBase { uploadImage := true value, exist := model.Settings.CheckGet("uploadImage") if exist { uploadImage = value.MustBool() } return NotifierBase{ UID: model.Uid, Name: model.Name, IsDefault: model.IsDefault, Type: model.Type, UploadImage: uploadImage, SendReminder: model.SendReminder, DisableResolveMessage: model.DisableResolveMessage, Frequency: model.Frequency, log: log.New("alerting.notifier." + model.Name), } } // ShouldNotify checks this evaluation should send an alert notification func (n *NotifierBase) ShouldNotify(ctx context.Context, context *alerting.EvalContext, notifierState *models.AlertNotificationState) bool { prevState := context.PrevAlertState newState := context.Rule.State // Only notify on state change. if prevState == newState && !n.SendReminder { return false } if prevState == newState && n.SendReminder { // Do not notify if interval has not elapsed lastNotify := time.Unix(notifierState.UpdatedAt, 0) if notifierState.UpdatedAt != 0 && lastNotify.Add(n.Frequency).After(time.Now()) { return false } // Do not notify if alert state is OK or pending even on repeated notify if newState == models.AlertStateOK || newState == models.AlertStatePending { return false } } okOrPending := newState == models.AlertStatePending || newState == models.AlertStateOK // Do not notify when new state is ok/pending when previous is unknown if prevState == models.AlertStateUnknown && okOrPending { return false } // Do not notify when we become Pending for the first if prevState == models.AlertStateNoData && newState == models.AlertStatePending { return false } // Do not notify when we become OK from pending if prevState == models.AlertStatePending && newState == models.AlertStateOK { return false } // Do not notify when we OK -> Pending if prevState == models.AlertStateOK && newState == models.AlertStatePending { return false } // Do not notify if state pending and it have been updated last minute if notifierState.State == models.AlertNotificationStatePending { lastUpdated := time.Unix(notifierState.UpdatedAt, 0) if lastUpdated.Add(1 * time.Minute).After(time.Now()) { return false } } // Do not notify when state is OK if DisableResolveMessage is set to true if newState == models.AlertStateOK && n.DisableResolveMessage { return false } return true } // GetType returns the notifier type. func (n *NotifierBase) GetType() string { return n.Type } // NeedsImage returns true if an image is expected in the notification. func (n *NotifierBase) NeedsImage() bool { return n.UploadImage } // GetNotifierUID returns the notifier `uid`. func (n *NotifierBase) GetNotifierUID() string { return n.UID } // GetIsDefault returns true if the notifiers should // be used for all alerts. func (n *NotifierBase) GetIsDefault() bool { return n.IsDefault } // GetSendReminder returns true if reminders should be sent. func (n *NotifierBase) GetSendReminder() bool { return n.SendReminder } // GetDisableResolveMessage returns true if ok alert notifications // should be skipped. func (n *NotifierBase) GetDisableResolveMessage() bool { return n.DisableResolveMessage } // GetFrequency returns the frequency for how often // alerts should be evaluated. func (n *NotifierBase) GetFrequency() time.Duration { return n.Frequency }