Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

6.2. Enabling Debug Logging

This section describes how to enable debug logging to provide detailed debugging information for Satellite 6.2. Debug logging provides the most detailed log information and can help with troubleshooting issues that can arise with Satellite 6.2 and its components. It is also possible to enable or disable individual loggers for selective logging.
To enable debug logging, modify the /etc/foreman/settings.yaml file.

  1. Set the Logging Level to "debug"

    By default, the logging level is set to info, as in the following: 
    :logging:
  :level: info
    Alter these lines so that they look like this: 
    :logging:
  :level: debug

    Warning

    Until BZ#1325939 is resolved, setting the sql logging level to error is not recommended.

  2. Select Individual Logging Types

    By default, the end of /etc/foreman/settings.yaml looks like this: 
    # Individual logging types can be toggled on/off here
:loggers:
    Alter the /etc/foreman/settings.yaml file so that it looks like this: 
    :loggers:
  :ldap:
    :enabled: true
  :permissions:
    :enabled: true
  :sql:
    :enabled: true

  3. Restart Katello Services

    # katello-service restart
Complete List of Loggers with their Default Values

:app:
    :enabled: true
:ldap:
    :enabled: false
:permissions:
    :enabled: false
:sql:
    :enabled: false

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red HatBack to top