Appendix C. Increasing logging levels of Satellite components
Satellite components use configurable logging levels to record operational events. Increase the level to debug when you need detailed output to troubleshoot a specific service.
C.1. Increasing the logging level for Foreman
Increase Foreman logging to debug to capture detailed Satellite activity when diagnosing application or API issues. Reset the level when debugging is complete to avoid excessive log volume.
By default, Foreman writes logs to /var/log/foreman/production.log. For more information, see Section B.2, “Configuring logging type and layout”.
For more information about Satellite logging settings, use satellite-installer with the --full-help option:
# satellite-installer --full-help | grep loggingProcedure
Set the logging level to
debug:# satellite-installer --foreman-logging-level debugAfter you complete debugging, reset the logging level to the default value:
# satellite-installer --reset-foreman-logging-level
C.2. Increasing the logging level for Red Hat Lightspeed in Satellite
Increase Red Hat Lightspeed in Satellite logging to DEBUG to capture detailed diagnostic output when troubleshooting Red Hat Lightspeed operations on your Satellite Server.
Example C.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 payloadThe 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
You have installed Red Hat Lightspeed in Satellite on your Satellite Server. For more information, see the following resources:
- Installing and configuring Red Hat Lightspeed in Satellite in Installing Satellite Server in a connected network environment
- Installing and configuring Red Hat Lightspeed in Satellite in Installing Satellite Server in a disconnected network environment
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:"
C.3. Increasing the logging level for Hammer
Increase Hammer logging to debug to capture detailed CLI activity when troubleshooting command-line errors or API responses.
Hammer writes logs to ~/.hammer/log/hammer.log.
Procedure
In
/etc/hammer/cli_config.yml, set the:log_level:option todebug::log_level: 'debug'
C.4. Increasing the logging level for Capsule
Increase Capsule logging to debug to capture detailed Capsule activity when troubleshooting communication between Satellite and hosts. Reset the level when debugging is complete to avoid excessive log volume.
By default, Capsule writes logs to /var/log/foreman-proxy/proxy.log. For more information, see Section B.2, “Configuring logging type and layout”.
Procedure
Set the logging level to
debug:# satellite-installer --foreman-proxy-log-level DEBUGAfter you complete debugging, reset the logging level to the default value:
# satellite-installer --reset-foreman-proxy-log-level
C.5. Increasing the logging level for Candlepin
Increase Candlepin logging to DEBUG when you need detailed subscription and content management diagnostics on your Red Hat Satellite.
Candlepin writes logs to /var/log/candlepin/candlepin.log and /var/log/candlepin/error.log.
Procedure
Set the logging level to
DEBUG:# satellite-installer --katello-candlepin-loggers log4j.logger.org.candlepin:DEBUGIf 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:WARNAfter you complete debugging, reset the logging level to the default value:
# satellite-installer --reset-katello-candlepin-loggers
C.6. Increasing the logging level for Redis
Increase Redis logging to debug to capture detailed cache activity when troubleshooting performance or connectivity issues.
Redis writes logs to /var/log/redis/redis.log.
Procedure
In
/etc/redis/redis.conf, set the logging level todebug:loglevel debugRestart the Redis service:
# systemctl restart redisNoteRunning
satellite-installerwill revert the setting to default.
C.7. Increasing the logging level for satellite-installer
Increase satellite-installer verbose output to debug when you need detailed installation and configuration diagnostics during setup or upgrades.
Procedure
Increase the logging level of the
satellite-installerutility:# satellite-installer --verbose-log-level debugNote that this only affects standard output but not any log files written to disk.
C.8. Increasing the logging level for Pulp
Increase Pulp logging to DEBUG when you need detailed content repository diagnostics.
Pulp writes logs to the systemd journal. You can view them with journalctl --unit 'pulpcore*'.
Procedure
In
/etc/pulp/settings.py, set the logging level toDEBUG:LOGGING = {"dynaconf_merge": True, "loggers": {'': {'handlers': ['console'], 'level': 'DEBUG'}}}Restart the Pulp services:
# systemctl restart \ pulpcore-api \ pulpcore-content \ pulpcore-resource-manager \ pulpcore-worker@\*NoteRunning
satellite-installerwill revert the setting to default.
C.9. Increasing the logging level for OpenVox agent
Increase OpenVox agent logging to debug when you need detailed configuration application diagnostics on hosts.
OpenVox agent writes logs to /var/log/puppetlabs/puppet/.
Prerequisites
- You have enabled Puppet on your Satellite. For more information, see Enabling Puppet integration with Satellite in Managing configurations by using Puppet integration.
Procedure
Set the logging level to
debug:# satellite-installer --puppet-agent-additional-settings log_level:debug
C.10. Increasing the logging level for OpenVox server
Increase OpenVox server logging to debug when you need detailed catalog compilation and agent communication diagnostics.
OpenVox server writes logs to /var/log/puppetlabs/puppetserver/.
Prerequisites
- You have enabled Puppet on your Satellite. For more information, see Enabling Puppet integration with Satellite in Managing configurations by using Puppet integration.
Procedure
Set the logging level to
debug:# satellite-installer --puppet-server-additional-settings log_level:debug
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}