Skip to content
background-image background-image

Log hub rules

Log hub rules provide an engine that defines the level of logging task execution and other various system, agent, task, or job messages. The default settings are available in the Administration screen > Log hub rules. These settings are generally applied for the log writers across all existing companies in the platform.

It is important to mention, that Log hub rules can be set on the Company level as well. You can't set up completely different settings on the company level compared to the settings on the general level. On the company level, you only can add more settings to the general level.

Log hub rules list

The log hub rules list initially contains only the system rules grouped in the System rules folder.

You can add your own new log rules. Those will be added to the list. You will need to create new a group(s) to organize your custom log rules.

HELP Log hub rules list

The list view provides you with information about the group, name, selected log levels, configured conditions, and assigned writers.

The header of the Log hub rules allows you to:

  • search in the list (if extensive)

  • switch between active and inactive rules view,

  • select modification of existing log rules from Templates

  • Apply directly the changes made on the specific log rules configuration.

Apply

Apply action publishes the changes on log hub rules, log hub writers, and conditions for logs. It is of importance, from where you execute the Apply action. If you do the Apply action from the Administration > Log setup > Log hub rules, the update applies only to the content defined there. Analogically, Apply action works if executed from the > Log setup > Log hub rules.

  • + Add new log hub rule configuration and,

  • Close the Log hub rules list.

HELP Log hub rules header

Log hub rules settings

General

In the section General, you define the log rule name and you organize it into the relevant group.

HELP Log hub rules general

The most important part is setting the log levels you would like to have enabled for your log.

Log levels

Log level Description
Trace In-depth details, decision sections, cycles, etc are logged here. Log usage for debugging by developers.
Debug Technical details, partial steps, or logical parts are logged here. Log usage for debugging by developers and admins. Fewer details compared to Trace.
Info Information providing detail of the Agents' activities are logged here. Useful and comprehensive information for the end user.
Warning Warnings on minor or occurrences of repairable errors are logged here. Warnings do not fail the process and tasks can continue further.
Error Major unrepairable errors are logged here. The tasks and the process does fail and is unable to continue.
Fatal Serious system issues, and init failures are logged here. Not recommended to select.

HELP Log hub rules general

Differentiate the log-level settings for various environments

Example: Test and Production 2 different environments, represented by 2 companies. - You may want to use more detailed logs for Development compared to Production. Differentiate the log hub rules for the environments using different settings of log hub rules on the company level.

Conditions

The conditions help to specify more precisely what exactly to write into the log. In this section, you can specify the conditions applied to the rule.

HELP Log hub rules Conditions

The condition settings include:

  • Type (operator) - Exists, Equals, In, Not exists, Not equals, Not in.

  • Key - Reference to key from the log message.

  • Value - Dependent on the selected type, an additional value field is available where the Key needs to be compared against one or more values.

You can add more than one condition. The logical operator used among the conditions is AND.

Writers

This section serves you for easy assignment of the configured log rule to desired existing log writer.

System rules

The platform has four system-defined log writers:

  • Agent log writer - table DXAgentLog

  • Job log writer - table DXJobLog

  • System log writer - table DXSystemLog

  • Task run log writer - table DXTaskRunLog

As for the system log writers, there are predefined rules, which can be only partially modified. You can modify the log levels, but you can't modify the conditions or the assigned writers.

Templates

When creating your own log rule, you can use the available templates with predefined log levels, conditions, and writers.

The templates will facilitate the creation of meaningful log rules without detailed knowledge of the message keys.

HELP Log hub rules Templates

You can select from the templates list containing several templates enabling logging information about:

  • Agents

  • Tasks

  • Task steps

  • Connectors

  • Endpoints

  • Jobs

  • Taskruns

  • Errors

Load the selected template to configured log rules and modify it if the template does not fit your specific purpose. Custom log rules can be modified in any section.