DC 5.3.0 4.12 Core Service configuration

This page documents the available options for the services the DAM Center has in Dotnet Core. The services are in the “DigizuiteCore” and “AutomationWorkflows” folders.

Logging

All settings are reloaded on-the-fly when the appsettings.json file is changed. I.e there is no need to restart the processes. You need, however, to have the entire path to the log file (sans the log file) pre-created upon load. This typically is only an issue for when you change the log path.

The following keys are available in the “Logging” section of the appsettings.json.

Some of these settings might not be visible by default, regardless of this, they may all be used.

Option name

Description

Option name

Description

LogLevel

The amount of logging to be included. Valid values are:

  1. None ← Least

  2. Critical

  3. Error

  4. Warning

  5. Information

  6. Debug

  7. Trace ← Most

With each log level has more info than the former (including the former).

Overrides

A dictionary that can be used to change the log level of certain namespaces. Usually not something you need to change.

For example - the following:

"Overrides": { "Microsoft.EntityFrameworkCore": "Warning" },

reduces the LogLevel of Entity Framework to Warning, rather than the normal log level set for the rest of the service. Multiple keys can be set at the same time.

EnabledCentralizedLogger

By enabling this, you give access for people to look at the logs though MM

LocalLogPath

(Requires EnableLocalLogging=trueto work)

The path provided here will be used for local logging.

Please note that: This does not clean up after itself, so this should only be enabled for the sake of debugging, and should be turned off once finished.

Setting this to a folder that doesn’t exist upon load, will make both Centralized+local logging not work (the logs will be blank both places)

EnableLocalLogging

If you haveEnableLocalLogging=truethen this is enabled. Please note that this too does not clean up after itself - i.e. the above warning also applies here.

Both this and LocalLogPath have to be set, for local logging to occur.

Note

There may be times when one or more applications fail to fully start. This is usually due to an issue with the environment. In case of this happening, it may be useful to access the failing services' Web.Config files, and enable stdout logging. Please be very cautious when enabling this, as it doesn’t clean up after itself. Once the service is up and running anew, there’s a real threat of it filling the disk entirely if not disabled again.

Log server configuration

The log server has the following configuration options:

Option name

Description

Option name

Description

LogPath

The location of the log files on disk (Can be either a relative or absolute path)

LogFileSizeCutoff

The size in MB that determines (roughly) how big each log file should be allowed to become

OldLogFileCount

Determines how many old log files can be at the same time

ErrorLogsKeepPeriod

Determines how long we should keep error logs

TimeBetweenErrorLogCheck

Determines how often the cleanup of error logs is run

LogStorageType

Determines what kind of storage to use. Currently, only “Local” is supported.

LogMessagesToKeepInMemory

The number of log messages to keep in memory when looking for related log lines when an error is logged. Decreases memory usage. The default setting determines it to keep around 100 MB of logs in memory (With some variance for the specific logs)

All these settings can be changed on-the-fly, without requiring a restart of the LogServer process.