Logging

CLI logging options

If additional logging detail is needed there are multiple logging options that can be enabled via the CLI.

  • -v - verbose logging

  • -d - debug logging

  • -D - database debug logging

Config file logging options

Verbose level logging can also be enabled via the global config file. To update the global config, see General settings for more details.

verbose: false

Logging settings

Logs are written to /var/log/corelight-update.d/corelight-update.log with the following user configurable settings:

logging:
    color_terminal_enable: true  # enable color highlights in the terminal output
    color_file_enable: false     # enable color highlights in the log output
    max_log_size_MB: 7           # maximum size in MB of a single log file
    max_log_backups: 5           # maximum number of backups
    max_log_age_days: 7          # maximum age of logs
    compress_log_backups: true   # enable compression on log backups

Color word settings

Color words are users configurable. To highlight any word that appears in a log, list the word and the desired color. If color_terminal_enable or color_file_enable are enabled, the specified word will be highlighted in the respective output. See below for a complete list of color options.

word_colors:
    - word: info
      color: Bright Green
    - word: error
      color: Bright Red
    - word: warning
      color: Bright Yellow
    - word: critical
      color: Bright Red
    - word: debug
      color: Bright Blue
    - word: verbose
      color: Bright Magenta
    - word: fatal
      color: Bright Magenta
    - word: notice
      color: Bright Yellow
    - word: start
      color: Bright Green
    - word: finished
      color: Bright Green
    - word: cache
      color: Yellow
    - word: auto-updating policies
      color: Bright Green

Color options

  • Black

  • Red

  • Green

  • Yellow

  • Blue

  • Magenta

  • Cyan

  • White

  • Bright Black

  • Bright Red

  • Bright Green

  • Bright Yellow

  • Bright Blue

  • Bright Magenta

  • Bright Cyan

  • Bright White