Files
cgrates/services/guardian.go
2025-10-13 09:57:41 +02:00

90 lines
2.7 KiB
Go

/*
Real-time Online/Offline Charging System (OCS) for Telecom & ISP environments
Copyright (C) ITsysCOM GmbH
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>
*/
package services
import (
"github.com/cgrates/cgrates/config"
"github.com/cgrates/cgrates/servmanager"
"github.com/cgrates/cgrates/utils"
"github.com/cgrates/guardian"
)
// NewGuardianService instantiates a new GuardianService.
func NewGuardianService(cfg *config.CGRConfig) *GuardianService {
return &GuardianService{
cfg: cfg,
stateDeps: NewStateDependencies([]string{utils.StateServiceUP, utils.StateServiceDOWN}),
}
}
// GuardianService implements Service interface.
type GuardianService struct {
cfg *config.CGRConfig
stateDeps *StateDependencies // channel subscriptions for state changes
}
// Start handles the service start.
func (s *GuardianService) Start(_ *utils.SyncedChan, registry *servmanager.ServiceRegistry) error {
_, err := WaitForServicesToReachState(utils.StateServiceUP,
[]string{
utils.LoggerS,
},
registry, s.cfg.GeneralCfg().ConnectTimeout)
if err != nil {
return err
}
// TODO: Replace global guardian.Guardian with local instance that should
// be passed around where needed.
// Currently only logger option is used, but other options (e.g. for
// timeout) could be added later.
opts := make([]guardian.Option, 0, 1)
if s.cfg.LoggerCfg().Level >= 0 {
opts = append(opts, guardian.WithLogger(utils.Logger))
}
guardian.Guardian = guardian.New(opts...)
return nil
}
// Reload handles the config changes.
func (s *GuardianService) Reload(_ *utils.SyncedChan, _ *servmanager.ServiceRegistry) error {
return nil
}
// Shutdown stops the service.
func (s *GuardianService) Shutdown(registry *servmanager.ServiceRegistry) error {
return nil
}
// ServiceName returns the service name
func (s *GuardianService) ServiceName() string {
return utils.GuardianS
}
// ShouldRun returns if the service should be running.
func (s *GuardianService) ShouldRun() bool {
return true
}
// StateChan returns signaling channel of specific state
func (s *GuardianService) StateChan(stateID string) chan struct{} {
return s.stateDeps.StateChan(stateID)
}