Skip to main content

Datometry Documentation

Configure Hyper-Q Logs

You can configure the directory log files are written, enable the legacy logging service, and specify the severity levels of log messages to display.

Log File Configuration Options

You configure the Hyper-Q log service using the Hyper-Q configuration file (/opt/datometry/config/dtm.ini). The log configuration settings are in the [general_settings] section of the dtm.ini file, which specifies basic configuration settings for the Hyper-Q deployment.

Table 10. Hyper-Q Log File Configuration Options

Parameter

Type

Description

log_dir

String

(Optional) Specifies a directory other than the default that log files are written to. Note that the CLI option -logdir takes precedence over this setting. If -logdir and the dtm.ini option are both specified, the directory specified with -logdir is the one that Hyper-Q will use.

enable_legacy_logger

Boolean

(Optional) Specify true to enable the log naming, formatting, and rotation behavior of earlier versions of Hyper-Q. If set to false, the legacy behaviors are disabled. The default setting is false.

In addition to the different logging behaviors, setting this to false enables a log overload protection system to help maintain system stability. In situations where very high system load causes large numbers of log messages to be written simultaneously, the overload protection system may drop messages if it becomes necessary to maintain system stability. If this occurs, notice of the dropped messages is written separately to the error log.

default_tracer_verbosity_level

String

Specifies the verbosity level of tracer log messages, with lower settings causing some events to be suppressed from the logs, and higher settings resulting in more events being written. If the verbosity level of an event is less than or equal to the specified logging level, it is logged. Otherwise, the message is suppressed and will not appear in the tracer log.



The following examples illustrate log file configuration options in the [general_settings] section of the dtm.ini file.

"general_setting".log_dir = /opt/datometry/logs 
"general_setting".enable_legacy_logger = false
"general_setting".default_tracer_verbosity_level = ALERT