Global settings

appsettings.json is read once at startup. Changes need a restart.

{
  "Trignis": { "AdminApiKey": "change-me" },
  "Health":  { "Enabled": true, "Port": 2455, "Host": "*", "CacheDurationSeconds": 120 },
  "WebHost": { "Enabled": true, "Host": "*" },
  "Windows": { "UseEventLog": false },
  "ChangeTracking": {
    "StateDbPath": "state.db",
    "GlobalSettings": {
      "PollingIntervalSeconds": 30,
      "ExportToFile": false,
      "FilePath": "exports/{environment}/{object}/{database}/changes-{timestamp}.json",
      "FilePathSizeLimit": 500,
      "ExportToApi": false,
      "RetryCount": 3,
      "RetryDelaySeconds": 5,
      "DeadletterRetentionDays": 30,
      "DeadLetterThreshold": 100,
      "DeadLetterCheckIntervalMinutes": 30,
      "DeadLetterMonitorEnabled": true,
      "HealthCheckEnabled": true,
      "HealthCheckIntervalMinutes": 15,
      "MaxPayloadSizeBytes": 5242880,
      "MaxRecordsPerBatch": 1000,
      "EnablePayloadBatching": true
    }
  }
}

ChangeTracking:GlobalSettings ​

Defaults for every environment. Six can be overridden per environment; the rest are global.

Polling and export ​

Below 5 seconds or above 3600 logs a warning; neither is rejected.

Retries ​

The delay is fixed, not exponential. Retries cover transport errors, IO errors and SQL errors. A payload over MaxPayloadSizeBytes is not retried, since a retry cannot shrink it.

Payload size ​

Measured after compression. Over the limit fails to a dead letter rather than sending.

Dead letters ​

Purge runs at startup and every 24 hours.

Connection health ​

First probe runs 10 seconds after startup so the dashboard has data on first load.

ChangeTracking:StateDbPath ​

Where last processed versions are stored. Default state.db relative to the working directory. Deleting it re-initialises every object per its InitialSyncMode.

Health ​

/health opens a real connection per database, so caching stops a polling monitor from generating load.

WebHost ​

Unset, SecureCookies follows the request scheme. Set true behind a TLS-terminating proxy where the app sees plain HTTP.

Trignis:AdminApiKey ​

The dashboard credential. Empty means the UI is unauthenticated.

Windows:UseEventLog ​

Windows only. Writes to the Application event log as source Trignis alongside the file log.

Serilog ​

Standard Serilog configuration. Default is console plus a daily rolling file in log/, five files retained.