Appendix B. Increasing logging levels of Satellite components


You can set logging levels for individual Satellite components. The default logging level is info. You can increase the logging level of Satellite components to troubleshoot Satellite. Increasing the logging level to debug provides the most detailed information.

B.1. Increasing the logging level for Foreman

By default, you can find the log in /var/log/foreman/production.log. For more information, see Section A.2, “Configuring logging type and layout”.

Note

For more information about Satellite logging settings, use satellite-installer with the --full-help option:

# satellite-installer --full-help | grep logging

Procedure

  1. Set the logging level to debug:

    # satellite-installer --foreman-logging-level debug
  2. After you complete debugging, reset the logging level to the default value:

    # satellite-installer --reset-foreman-logging-level

You can increase the logging levels for Red Hat Lightspeed in Satellite to DEBUG to get more detailed logs. You can find the logs in /var/log/messages.

Example B.1. Log entries of Red Hat Lightspeed in Satellite

Feb  3 10:39:54 satellite.example.com iop-core-engine[213708]: INFO:insights.core.dr:Trying telemetry.rules.plugins.sap.sap_hana_loose_sudo.check_group_members
Feb  3 10:39:54 satellite.example.com iop-core-engine[213708]: INFO:insights.core.dr:Trying telemetry.rules.plugins.sap.sap_hana_loose_sudo.report
Feb  3 10:39:54 satellite.example.com iop-core-engine[213708]: INFO:insights.core.dr:Trying telemetry.rules.plugins.ros.ros_instance_evaluation.find_solution
Feb  3 10:39:54 satellite.example.com iop-core-engine[213708]: INFO:insights.core.dr:Trying telemetry.rules.plugins.ros.ros_instance_evaluation.report
Feb  3 10:39:54 satellite.example.com iop-core-engine[213708]: INFO:insights_kafka_service.consumer:Completed processing request id 4be0099772a23aad477e493990247876
Feb  3 10:39:54 satellite.example.com iop-core-engine[213708]: INFO:insights_messaging.consumers.kafka:Completed one payload

The default logging levels for Red Hat Lightspeed in Satellite are as follows:

loggers:
  insights.core.dr:
    level: "ERROR"
  insights_messaging:
    level: "INFO"
  insights_kafka_service:
    level: "INFO"
  "":
    level: "INFO"

Prerequisites

Procedure

  • Increase the logging levels to DEBUG:

    # satellite-installer \
    --iop-core-engine-log-level-insights-core-dr DEBUG \
    --iop-core-engine-log-level-insights-kafka-service DEBUG \
    --iop-core-engine-log-level-insights-messaging DEBUG \
    --iop-core-engine-log-level-root DEBUG

Verification

  • Check the logging levels of Red Hat Lightspeed in Satellite:

    # podman exec iop-core-engine cat /var/config.yml | grep -A15 "logging:"

B.3. Increasing the logging level for Hammer

You can find the log in ~/.hammer/log/hammer.log.

Procedure

  • In /etc/hammer/cli_config.yml, set the :log_level: option to debug:

    :log_level: 'debug'

B.4. Increasing the logging level for Capsule

By default, you can find the log in /var/log/foreman-proxy/proxy.log. For more information, see Section A.2, “Configuring logging type and layout”.

Procedure

  1. Set the logging level to debug:

    # satellite-installer --foreman-proxy-log-level DEBUG
  2. After you complete debugging, reset the logging level to the default value:

    # satellite-installer --reset-foreman-proxy-log-level

B.5. Increasing the logging level for Candlepin

You can find the logs in /var/log/candlepin/candlepin.log and /var/log/candlepin/error.log.

Procedure

  1. Set the logging level to DEBUG:

    # satellite-installer --katello-candlepin-loggers log4j.logger.org.candlepin:DEBUG

    If the candlepin log files are too verbose, you can decrease the default debug level:

    # satellite-installer \
    --katello-candlepin-loggers log4j.logger.org.candlepin:DEBUG \
    --katello-candlepin-loggers log4j.logger.org.candlepin.resource.ConsumerResource:WARN \
    --katello-candlepin-loggers log4j.logger.org.candlepin.resource.HypervisorResource:WARN
  2. After you complete debugging, reset the logging level to the default value:

    # satellite-installer --reset-katello-candlepin-loggers

B.6. Increasing the logging level for Redis

You can find the log for Redis in /var/log/redis/redis.log.

Procedure

  1. In /etc/redis/redis.conf, set the logging level to debug:

    loglevel debug
  2. Restart the Redis service:

    # systemctl restart redis
    Note

    Running satellite-installer will revert the setting to default.

satellite-installer writes logs to /var/log/foreman-installer/.

Procedure

  • Increase the logging level of the satellite-installer utility:

    # satellite-installer --verbose-log-level debug

    Note that this only affects standard output but not any log files written to disk.

B.8. Increasing the logging level for Pulp

Pulp logs to the systemd journal. You can view the logs using journalctl --unit 'pulpcore*'.

Procedure

  1. In /etc/pulp/settings.py, set the logging level to DEBUG:

    LOGGING = {"dynaconf_merge": True, "loggers": {'': {'handlers': ['console'], 'level': 'DEBUG'}}}
  2. Restart the Pulp services:

    # systemctl restart \
    pulpcore-api \
    pulpcore-content \
    pulpcore-resource-manager \
    pulpcore-worker@\*
    Note

    Running satellite-installer will revert the setting to default.

You can find the logs in /var/log/puppetlabs/puppet/.

Prerequisites

Procedure

  • Set the logging level to debug:

    # satellite-installer --puppet-agent-additional-settings log_level:debug

You can find the logs in /var/log/puppetlabs/puppetserver/.

Prerequisites

Procedure

  • Set the logging level to debug:

    # satellite-installer --puppet-server-additional-settings log_level:debug
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

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.

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 Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top