第 17 章 日志记录和报告问题


以下小节描述了 Satellite 中最常用的日志文件和调试工具。

17.1. Satellite 组件的日志记录级别

您可以为单独的 Satellite 组件设置日志记录级别。默认日志级别为 info。您可以提高 Satellite 组件的日志记录级别,以对 Satellite 进行故障排除。将日志记录级别增加到 debug 提供了更详细的信息。

17.1.1. 增加 Foreman 的日志记录级别

默认情况下,您可以在 /var/log/foreman/production.log 中找到日志。如需更多信息,请参阅 第 17.3 节 “配置日志记录类型和布局”

流程

  1. 将日志记录级别设置为 debug

    # satellite-installer --foreman-logging-level debug
    Copy to Clipboard Toggle word wrap
  2. 完成调试后,将日志级别重置为默认值:

    # satellite-installer --reset-foreman-logging-level
    Copy to Clipboard Toggle word wrap

其他资源

如需有关 Satellite 日志记录设置的更多信息,请使用 satellite-installer with -full-help 选项:

# satellite-installer --full-help | grep logging
Copy to Clipboard Toggle word wrap

17.1.2. 增加 Hammer 的日志记录级别

您可以在 ~/.hammer/log/hammer.log 中找到日志。

流程

  • /etc/hammer/cli_config.yml 中,将 :log_level: 选项设置为 debug

    :log_level: 'debug'
    Copy to Clipboard Toggle word wrap

17.1.3. 增加 Capsule 的日志记录级别

默认情况下,您可以在 /var/log/foreman-proxy/proxy.log 中查找日志。如需更多信息,请参阅 第 17.3 节 “配置日志记录类型和布局”

流程

  1. 将日志记录级别设置为 debug

    # satellite-installer --foreman-proxy-log-level DEBUG
    Copy to Clipboard Toggle word wrap
  2. 完成调试后,将日志级别重置为默认值:

    # satellite-installer --reset-foreman-proxy-log-level
    Copy to Clipboard Toggle word wrap

17.1.4. 增加 Candlepin 的日志记录级别

您可以在 /var/log/candlepin/candlepin.log/var/log/candlepin/error.log 中找到日志。

流程

  1. 将日志记录级别设置为 DEBUG

    # satellite-installer --katello-candlepin-loggers log4j.logger.org.candlepin:DEBUG
    Copy to Clipboard Toggle word wrap

    如果 candlepin 日志文件太详细,您可以减少默认的调试级别:

    # 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
    Copy to Clipboard Toggle word wrap
  2. 完成调试后,将日志级别重置为默认值:

    # satellite-installer --reset-katello-candlepin-loggers
    Copy to Clipboard Toggle word wrap

17.1.5. 增加 Redis 的日志记录级别

您可以在 /var/log/redis/redis.log 中找到 Redis 的日志。

流程

  1. /etc/redis/redis.conf 中,将日志级别设置为 debug

    loglevel debug
    Copy to Clipboard Toggle word wrap
  2. 重启 Redis 服务:

    # systemctl restart redis
    Copy to Clipboard Toggle word wrap
注意

运行 satellite-installer 会将设置恢复到默认值。

17.1.6. 增加 satellite-installer 的日志记录级别

satellite-installer 将日志写入 /var/log/foreman-installer/

流程

  • 提高 satellite-installer 工具的日志记录级别:

    # satellite-installer --verbose-log-level debug
    Copy to Clipboard Toggle word wrap

    请注意,这只会影响标准输出,而不影响写入到磁盘的任何日志文件。

17.1.7. 增加 Pulp 的日志记录级别

Pulp 日志记录到 systemd 日志。您可以使用 journalctl --unit 'pulpcore*' 来查看日志。

流程

  1. /etc/pulp/settings.py 中,将日志级别设置为 DEBUG

    LOGGING = {"dynaconf_merge": True, "loggers": {'': {'handlers': ['console'], 'level': 'DEBUG'}}}
    Copy to Clipboard Toggle word wrap
  2. 重启 Pulp 服务:

    # systemctl restart \
    pulpcore-api \
    pulpcore-content \
    pulpcore-resource-manager \
    pulpcore-worker@\*
    Copy to Clipboard Toggle word wrap
注意

运行 satellite-installer 会将设置恢复到默认值。

17.1.8. 增加 Puppet 代理的日志级别

您可以在 /var/log/puppetlabs/puppet/ 中找到日志。

先决条件

流程

  • 将日志记录级别设置为 debug

    # satellite-installer --puppet-agent-additional-settings log_level:debug
    Copy to Clipboard Toggle word wrap

17.1.9. 增加 Puppet 服务器的日志记录级别

您可以在 /var/log/puppetlabs/puppetserver/ 中找到日志。

先决条件

流程

  • 将日志记录级别设置为 debug

    # satellite-installer --puppet-server-additional-settings log_level:debug
    Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat