Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

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

...

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:

Code Block
"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.

...

LogDirectory

...

The path to the directory where the log files

...

DaysToKeepLogFiles

...

How many days to keep log files before deleting them

...

MaxLogFileCount

...

How many files to keep per service at the most.

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

...

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

...

LogStorageType

...

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

...

CleanupStrategy

...

What cleanup strategy to use. Either Duration or Count. Duration will keep all log files in a certain period, no matter the count. Count will only ever keep a certain amount of log files, no matter the period.

...

OldLogFileCount

...

Determines how many old log files can be at the same time, if using the Count strategy

...

KeepDuration

...

How long the log files will be kept, if using the Duration strategy. Use the C# TimeSpan format.

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

Integration Service

The Integration Service debounces messages before sending updates to subscribing integration endpoints. The debounce interval can be configured by adding a “Debouncing” section to the appsettings.json file for the Integration Service. This section has the following configuration options:

...

Option name

...

Description

...

Type

...

Default value

...

Interval

...

The debouncing interval to use when debouncing messages before sending them to subscribing integration endpoints.

...

Timespan

...

00:00:07” (7 seconds)

Internal Debouncing

A lot of services are debouncing messages using the Debouncing Service. The Debouncing Service can be configured by adding a “InternalDebouncing” section to the appsettings.json file for the Debouncing Service. This section has the following configuration options:

...

Option name

...

Description

...

Type

...

Default value

...

SleepInterval

...

The Debouncing Service periodically checks if it has any messages that have been debounced and should be sent back to the origin. This parameter configures the sleep time between each check.

...

Timespan

...

00:00:00.200” (200 milliseconds)

...

ReturnLimit

...

The maximum number of messages returned at each of the periodical checks.

...

Integer

...

10000

Note that all parameters above are optional. It is possible to configure one parameter without configuring the other.

Workflows

The Business Workflow Service can be configured by adding a “BusinessWorkflow” section to the appsettings.json file for the Business Workflow Service. This section has the following configuration options:

...

Option name

...

Description

...

Type

...

Default value

...

MigrationInstanceLimit

...

When an existing workflow is updated, the existing workflow instances for this workflow are migrated to the new version. This parameter sets the maximum number of instances to migrate at a time.

Note that all instances using the previous version of the workflow are always migrated. Thus, this parameter can primarily be used to tweak performance.

...

Integer

...

1000

FileService

The FileService handles storing and retrieving files used with the “File Input” constraint.

...

Option name

...

Description

...

Type

...

Default value

...

StoragePath

...

Where should the FileService put and collect uploaded files.

...

Path

...

Each service in Digizuite exposes a set of configuration options. These can be controlled under General settings/Service configuration.

...

Each tab configures the following

  • Logging: Log level

    • Log level to include in stacktrace - configures the level of information to include when something fails

    • Log level - Configures the general log level

    • Log level: Transcode service - Configures the log level for the transcode service

    • Log level: Transcode execution engine - Configures the log level for the transcode execution engine

    • Log level: Rebus - configures the log level for Rebus. Rebus is used to control RabbitMq and Nats

    • Log level: Entity framwork core - configures the log level for all database interactions

    • Log level: default - configures the default log level

    • Log level: Dedicated Transcode service - Configures the log level for the dedicated transcode service

  • Job Status

    • Batch Gather Duration - Configures the interval in which status messages in Digibatch and automations updated

  • Computer vision details

    • Faces person group - configures the name of the group that is setup in the Azure facial detection setup

    • ocr extract from image - Enables OCR in images

    • ocr extract from pdf - enables OCR in text files (Pdf, word, etc).

    • Ocr task delay lentgh - configures the delay in the task that is started for ocr

    • Video indexer watcher interval - configures the time interval in which the Azure video indexer is polled for status

  • Internal debouncing

    • Data folder - configures the folder in which the debounced messages are saved

    • Message between garbage collection - configures when garbage collection should be run

    • return limit - configures the maximum amount of messages that can be returned after they are debounced

    • Sleep interval - configures the interval in which the service sleeps before checking more messages

  • Status cleanup

    • Delay between checks - configures how often we should check for messages that should be deleted

    • Keep old status updates - configures retention period for status messages

  • Business workflow

    • Migration instance limit - configures how many instances can be migrated at a time when a workflow is changed

  • Timed transitions

    • Sleep interval - configures how often Timed transitions in workflows should be checked if they have parsed.

  • Youtube cleanup

    • Time between checks - configures how often the cleanup should be run

  • Configuration management

    • Default member password - configures the default password for members that are being created

    • max concurrent requests - configures the maximum allowed number of actions to be executed in parallel

  • Configuration management: Template source

    • Template Source: Github Branch Name - configures the branch name from which default layers should be fetched

    • Template Source: Git Hub Organization - configures the Github organization from which the default layers should be fetched

    • Template Source: Git Hub Repository Name - configures the Github repository from which the default layers should be fetched

    • Template Source: Type - configures the type from which the default layers should be fetched

  • Check in out details

    • Default Check Out Duration - configures the default time a check out last

  • Asset streamer settings

    • Cache Duration - configures for how long asset entries should be cached - day:hour:minute format (00:00:00)

  • Asset streamer settings: format

    • Format: Audio Preview Format Id - configures default audio preview format

    • Format: Large Thumb Format Id - configures default Large Thumb Format Id

    • Format: Pdf Format Id - configures default Pdf Format Id

    • Format: Thumb Format Id - configures default Thumb Format Id

    • Format: Video Preview Format Id - configures default Video Preview Format

  • Asset indexing settings

    • Asset Load Bulk Size - Configures the number of assets indexed at a time when re-indexing everything

  • Cryptography

    • Work factor - configures the work factor for password hashing strength

  • SMTP Settings

    • Fallback From Address - Configures the e-mail address used for e-mail sending

    • Host - configures the smtp host

    • Password - configures the smtp user password

    • Port - configures the smtp port

    • Username - configures the smtp username

  • Login service

    • Work factor - configures the work factor for password hashing strength. This must be the same as Crypography

    • Config version id - Deprecated property needed for backwards compatibility. Used to be unique identifier for Media manager portal

    • Time between cleanup - configures how often expired accesskeys should be cleaned up.

    • Access Key Valid Duration - configures for how long an accesskey is valid

    • Refresh Token Valid Duration - configures for how long the refresh token is valid

    • Automatically Extend Session on Refresh - configures if the accesskey should be refreshed when expired

  • User management

    • Detect And Add Missing Md5 Hash - If true will allow plain text password resets. This should be handled by UI.

    • Password Validation Regex - configures a regex to enforce password strength

    • Timeout - configures the timeout for password reset codes.