Skip to main content

Scheduler API Settings

The Scheduler API controls how OLAP and Distribution jobs are scheduled, triggered, and run. Its settings live in the appsettings.json file, located at:

  • C:\Program Files\Nectari\Nectari Server\Scheduler\appsettings.json
  • C:\Program Files\SEI\SEI Server\Scheduler\appsettings.json

Each setting controls a specific part of the scheduler's behavior, such as central point resolution, scheduler intervals, retry logic, external API calls, module activation, or logging levels. Some settings support hot reload, meaning a change takes effect immediately without restarting the Scheduler service. Others require a restart before they take effect. The tables below list every setting, what it controls, whether it supports hot reload, and the values it accepts.

Central Points

SettingPurposeReloadValues
AllowedHostsList of allowed host names. Use * to allow all.
CentralPoints.ProviderSource used to load Central Point definitions.Remote,
Local
CentralPoints.ApiHostNameWeb Server host name when CentralPoints.Provider is set to Remote. Must match the server host.
CentralPoints.RemoteFetchIntervalInterval for synchronizing Central Points from the Configurator when CentralPoints.Provider is set to Remote.> 0
CentralPoints.LocalList[]Local Central Points when CentralPoints.Provider is set to Local.
CentralPoints.LocalList[].NameDisplay name for the local Central Point.
CentralPoints.LocalList[].PathLocal or UNC path to the Central Point.
CentralPoints.LocalList[].WebAppUrlWeb Server URL used for distribution.
CentralPoints.LocalList[].IsSageModeIndicates whether the Web Server uses Sage branding.true,
false

Distribution Scheduler

SettingPurposeReloadValues
DistributionScheduler.MisfireThresholdGrace period (ms) during which a missed trigger can still run.> 0
DistributionScheduler.IterationsIntervalInterval (s) between scheduler cycles.> 0
DistributionScheduler.MaxParallelizationMaximum number of parallel tasks the scheduler can run.> 0

External APIs

SettingPurposeReloadValues
ExternalApis.*.BaseUrlBase URL of the external API.
ExternalApis.*.ApiKeyAPI key used to authenticate with the external API.
ExternalApis.*.MedianFirstRetryDelayTemporarily deactivated
ExternalApis.*.RetryCountTemporarily deactivated
ExternalApis.*.CircuitBreakerDelayTemporarily deactivated
ExternalApis.*.TimeoutDelayMaximum request duration before timeout.> 0

OLAP Scheduler

SettingPurposeReloadValues
Quartz."quartz.jobStore.misfireThreshold"Grace period (ms) during which a missed OLAP trigger can still run.> 0

Module Scheduling

SettingPurposeReloadValues
Schedules.*.EnabledIndicates whether the module is active.true,
false
Schedules.*.SchedulerScheduler used for the module.Quartz,
Distribution
Schedules.*.NectariApiDefinitionWorker API definition associated with the module.NectariOlapWorker,
NectariDistributionWorker
Schedules.*.ManagerIterationsIntervalInterval (s) between initializer cycles.> 0
Schedules.*.
ManagerMaxInactiveIterationBeforeSleep
Maximum number of inactive cycles before the initializer enters sleep mode.> 0
Schedules.*.ManagerMaxParallelizationMaximum number of parallel tasks the initializer can run.> 0

Logging (Serilog)

SettingPurposeReloadValues
Serilog.MinimumLevel.DefaultDefault logging level for the application.Verbose, Debug,
Information,
Warning,
Error
Serilog.MinimumLevel.Override.*Logging level override for a specific namespace.Verbose, Debug,
Information,
Warning,
Error
Serilog.WriteToSerilog sinks that define where logs are written.
Serilog.EnrichSerilog enrichers that add contextual properties to logs.
Serilog.PropertiesStatic properties added to all log entries.

note

Setting the level to Verbose does not support hot reload. Changing to or from Verbose requires a restart.