第17章 問題のログとレポート
次のセクションでは、Satellite で使用できる最も一般的なログファイルとデバッグツールについて説明します。
17.1. デバッグに役立つログレベルの引き上げ
Satellite のトラブルシューティングを行うために、Satellite コンポーネントのログレベルを上げることができます。ログレベルを debug
に上げると、最も詳細な情報を取得できます。デフォルトのログレベルは info
です。
17.1.1. Foreman アプリケーションのログレベルを上げる
Foreman アプリケーションのロギングレベルを上げるには、以下を実行します。
ログレベルを
debug
に設定します。satellite-installer --foreman-logging-level debug
# satellite-installer --foreman-logging-level debug
Copy to Clipboard Copied! デバッグが完了したら、ログレベルをデフォルト値にリセットします。
satellite-installer --reset-foreman-logging-level
# satellite-installer --reset-foreman-logging-level
Copy to Clipboard Copied!
Satellite のロギング設定の詳細は、satellite-installer
を使用し、--full-help
オプションを指定します。
satellite-installer --full-help | grep logging
# satellite-installer --full-help | grep logging
17.1.2. Hammer のログレベルを上げる
ログは ~/.hammer/log/hammer.log
にあります。
Hammer のロギングレベルを上げるには、以下を実行します。
-
/etc/hammer/cli_config.yml
で、:log_level:
オプションをdebug
に設定します。
:log_level: 'debug'
:log_level: 'debug'
17.1.3. Capsule のログレベルを上げる
ログは /var/log/foreman-proxy/proxy.log
にあります。
Capsule のロギングレベルを上げるには、以下を実行します。
ログレベルを
debug
に設定します。satellite-installer --foreman-proxy-log-level DEBUG
# satellite-installer --foreman-proxy-log-level DEBUG
Copy to Clipboard Copied! デバッグが完了したら、ログレベルをデフォルト値にリセットします。
satellite-installer --reset-foreman-proxy-log-level
# satellite-installer --reset-foreman-proxy-log-level
Copy to Clipboard Copied!
satellite-installer を実行すると、設定がデフォルトに戻ります。
17.1.4. Candlepin のログレベルを上げる
ログは /var/log/candlepin/candlepin.log
および /var/log/candlepin/error.log
にあります。
Candlepin のロギングレベルを上げるには、以下を実行します。
/etc/candlepin/candlepin.conf
で、ログレベルをDEBUG
に設定します。log4j.logger.org.candlepin=DEBUG
log4j.logger.org.candlepin=DEBUG
Copy to Clipboard Copied! tomcat
サービスを起動します。systemctl restart tomcat
# systemctl restart tomcat
Copy to Clipboard Copied!
candlepin ログファイルが冗長すぎる場合は、デフォルトのデバッグレベルを下げることができます。
log4j.logger.org.candlepin.resource.ConsumerResource=WARN log4j.logger.org.candlepin.resource.HypervisorResource=WARN
log4j.logger.org.candlepin.resource.ConsumerResource=WARN
log4j.logger.org.candlepin.resource.HypervisorResource=WARN
17.1.5. Qpid Dispatch Router のログレベルを上げる
Qpid は syslog
にログを記録します。ログは /var/log/messages
に表示されます。または journalctl
を使用して表示できます。
Qpid Dispatch Router のログレベルを上げるには、以下を実行します。
/etc/qpid-dispatch/qdrouterd.conf
で、ログレベルをdebug
に設定します。enable: debug+
enable: debug+
Copy to Clipboard Copied! Qpid Dispatch Router を再起動します。
systemctl restart qdrouterd
# systemctl restart qdrouterd
Copy to Clipboard Copied!
satellite-installer を実行すると、設定がデフォルトに戻ります。
17.1.6. Qpid Broker のログレベルの引き上げ
Qpid は syslog
にログを記録します。ログは /var/log/messages
に表示されます。または journalctl
を使用して表示できます。
Qpid Broker のログレベルを上げるには、以下を実行します。
/etc/qpid/qpidd.conf
で、ログレベルをdebug
に設定します。log-enable=debug+
log-enable=debug+
Copy to Clipboard Copied! Qpid Broker を再起動します。
systemctl restart qpidd
# systemctl restart qpidd
Copy to Clipboard Copied!
satellite-installer を実行すると、設定がデフォルトに戻ります。
17.1.7. Redis のログレベルの引き上げ
Redis のログは /var/log/redis/redis.log
にあります。
Redis のログレベルを上げるには、以下を実行します。
/etc/redis.conf
で、ログレベルをdebug
に設定します。loglevel debug
loglevel debug
Copy to Clipboard Copied! Redis サービスを再起動します。
systemctl restart redis
# systemctl restart redis
Copy to Clipboard Copied!
satellite-installer を実行すると、設定がデフォルトに戻ります。
17.1.8. Satellite インストーラーのログレベルの増加
ログファイルは /var/log/foreman-installer/
にあります。
Satellite インストーラーのログレベルを上げるには、インストール時に --verbose-log-level debug
オプションを追加します。
satellite-installer --verbose-log-level debug
# satellite-installer --verbose-log-level debug
17.1.9. Pulp のログレベルの引き上げ
デフォルトでは、Pulp は syslog
にログを記録します。ログは /var/log/messages
に表示されます。または journalctl
を使用して表示できます。
Pulp のログレベルを上げるには、以下を実行します。
/etc/pulp/settings.py
で、ログレベルをDEBUG
に設定します。LOGGING = {"dynaconf_merge": True, "loggers": {'': {'handlers': ['console'], 'level': 'DEBUG'}}}
LOGGING = {"dynaconf_merge": True, "loggers": {'': {'handlers': ['console'], 'level': 'DEBUG'}}}
Copy to Clipboard Copied! Pulp サービスを再起動します。
systemctl restart \ pulpcore-api \ pulpcore-content \ pulpcore-resource-manager \ pulpcore-worker@1 \ pulpcore-worker@2 \ redis
# systemctl restart \ pulpcore-api \ pulpcore-content \ pulpcore-resource-manager \ pulpcore-worker@1 \ pulpcore-worker@2 \ redis
Copy to Clipboard Copied!
17.1.10. Puppet Agent のログレベルの引き上げ
ログは /var/log/puppetlabs/puppet/
にあります。
Puppet エージェントのログレベルを上げるには、以下を実行します。
- Satellite で Puppet が有効になっていることを確認します。詳細は、Red Hat Satellite で Puppet インテグレーションを使用して設定を管理する の Satellite で Puppet インテグレーションを有効にする を参照してください。
ログレベルを
debug
に設定します。satellite-installer --puppet-agent-additional-settings log_level:debug
# satellite-installer --puppet-agent-additional-settings log_level:debug
Copy to Clipboard Copied!
17.1.11. Puppet サーバーのログレベルの引き上げ
ログは /var/log/puppetlabs/puppetserver/
にあります。
Puppet サーバーのログレベルを上げるには、以下を実行します。
- Satellite で Puppet が有効になっていることを確認します。詳細は、Red Hat Satellite で Puppet インテグレーションを使用して設定を管理する の Satellite で Puppet インテグレーションを有効にする を参照してください。
ログレベルを
debug
に設定します。satellite-installer --puppet-server-additional-settings log_level:debug
# satellite-installer --puppet-server-additional-settings log_level:debug
Copy to Clipboard Copied! Puppet サーバーを再起動します。
satellite-maintain service restart --only puppetserver
# satellite-maintain service restart --only puppetserver
Copy to Clipboard Copied!