15.2. デバッグに役立つログレベルの増加

デフォルトでは、Satellite には :INFO レベルのロギングが有効になっています。Satellite のログレベルを増減できます。

すべてのコンポーネントでデバッグレベルのログを有効にする

# hammer admin logging --all --level-debug
# satellite-maintain service restart

特定のコンポーネントのデバッグレベルのログを有効にする

# hammer admin logging --components "Component" --level-debug

デバッグレベルのログを INFO に戻す

# hammer admin logging --all --level-production
# satellite-maintain service restart

すべてのコンポーネントと変更された設定ファイルのリスト表示

# hammer admin logging --list
-----------|-------------------------------------|-------------------------------------
COMPONENT  | AUTO-DETECTED BY EXISTENCE OF       | DESTINATIONS
-----------|-------------------------------------|-------------------------------------
dhcpd      | /etc/dhcp/dhcpd.conf                | syslog /var/log/dhcpd-debug.log
postgresql | /var/lib/pgsql/data/postgresql.conf | syslog /var/lib/pgsql/data/pg_log/
proxy      | /etc/foreman-proxy/settings.yml     | /var/log/foreman-proxy/proxy.log
qpidd      | /etc/qpid/qpidd.conf                | syslog
rails      | /etc/foreman/settings.yaml          | /var/log/foreman/production.log
tomcat     | /etc/candlepin/candlepin.conf       | /var/log/candlepin/ /var/log/tomcat/
virt-who   | /etc/sysconfig/virt-who             | syslog
-----------|-------------------------------------|-------------------------------------

15.2.1. Hammer のログレベルの引き上げ

Hammer のログは ~/.hammer/log/hammer.log にあります。/etc/hammer/cli_config.yml を編集し、:log_level: を設定します。

:log_level: 'debug'

15.2.2. Capsule のログレベルの引き上げ

Capsule のログは、/var/log/foreman-proxy/proxy.log にあります。/etc/foreman-proxy/settings.ymlDEBUG 行のコメントを解除します。

:log_level: DEBUG

その後、必ず foreman-proxy サービスを再起動してください。

# systemctl restart foreman-proxy
注意

インストーラーを実行すると、この変更が元に戻ります。

15.2.3. Candlepin のログレベルの引き上げ

Candlepin のログは /var/log/candlepin/candlepin.log にあります。/var/log/candlepin/error.log のデバッグを容易にするために、エラーも別のファイルに記録されます。

/etc/candlepin/candlepin.conf を拡張します:

log4j.logger.org.candlepin=DEBUG

その後、必ず tomcat サービスを再起動してください。

# systemctl restart tomcat

candlepin ログファイルが冗長すぎる場合は、デフォルトのデバッグレベルを下げることができます。

log4j.logger.org.candlepin.resource.ConsumerResource=WARN
log4j.logger.org.candlepin.resource.HypervisorResource=WARN

15.2.4. Satellite のログレベルの引き上げ

Satellite のログは /var/log/foreman/production.log にあります。

Satellite は Apache のログを次の場所に保存します。

  • /var/log/httpd/foreman_error.log
  • /var/log/httpd/foreman_access.log
  • /var/log/httpd/foreman_ssl_error.log
  • /var/log/httpd/foreman_ssl_access.log

手順

  1. /etc/foreman/settings.yaml でログレベルを設定します:

    :logging:
      :production:
        :type: file
        :layout: pattern
        :level: debug
  2. /etc/foreman/settings.yaml で選択したロガーを有効にします:

    :loggers:
      :ldap:
        :enabled: true
      :permissions:
        :enabled: true
      :sql:
        :enabled: true

    一部の領域からのログを表示するには、デバッグログを設定する必要があることに注意してください。

  3. Satellite サービスを再起動します。

    # satellite-maintain service restart

デフォルト値を持つロガーの完全なリストは、Foreman::Logging.add_loggers コマンドの /usr/share/foreman/config/application.rb にあります。

15.2.5. Qpid ディスパッチルーターのログレベルの引き上げ

Qpid は syslog にログを記録し、/var/log/messages または journalctl で表示できます。/etc/qpid-dispatch/qdrouterd.conf でデバッグログを有効にします。

enable: debug+

その後、必ず Qpid Dispatch Router を再起動してください。

# systemctl restart qdrouterd
注意

インストーラーを実行すると、この変更が元に戻ります。

15.2.6. Qpid Broker のログレベルの引き上げ

Qpid は syslog にログを記録し、/var/log/messages または journalctl で表示できます。/etc/qpid/qpidd.conf でログレベルを設定します。

log-enable=debug+

その後、必ず Qpid Broker を再起動してください。

# systemctl restart qpidd
注意

インストーラーを実行すると、この変更が元に戻ります。

15.2.7. Redis のログレベルの引き上げ

Redis のログは /var/log/redis/redis.log にあります。/etc/opt/rh/rh-redis5/redis.conf でログレベルを設定します。

loglevel debug

その後、必ず Redis サービスを再起動してください。

# systemctl restart rh-redis5-redis

15.2.8. Postgres のログレベルの引き上げ

Postgres のログは /var/lib/pgsql/data/log にあります。/var/lib/pgsql/data/postgresql.conflog_statement のコメントを外します。

log_statement = 'all'

後で必ず Satellite サービスを再起動してください。

# satellite-maintain service restart
注意

Satellite インストールのサイズに基づいて、これによりディスクスペースがすぐにいっぱいになる可能性があります。どうしても必要な場合にのみこれをオンにしてください。

デバッグログ設定の詳細は、Postgresql のドキュメント を参照してください。

15.2.9. Satellite インストーラーのログレベルの増加

ログファイルは /var/log/foreman-installer/ にあります。インストール中に Satellite Installer のログレベルを上げるには:

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

15.2.10. Pulp のログレベルの引き上げ

デフォルトでは、Pulp は syslog にログを記録し、/var/log/messages または journalctl で表示できます。次の設定を /etc/pulp/settings.py ファイルに追加します。

LOGGING = {"dynaconf_merge": True, "loggers": {'': {'handlers': ['console'], 'level': 'DEBUG'}}}

その後、必ず Pulp サービスを再起動してください。

# systemctl restart \
pulpcore-api \
pulpcore-content \
pulpcore-resource-manager \
pulpcore-worker@1 \
pulpcore-worker@2 \
rh-redis5-redis

15.2.11. Puppet Agent のログレベルの引き上げ

Satellite Server の Puppet エージェントのログレベルを上げることができます。

手順

  1. /etc/puppetlabs/puppet/puppet.conf ファイルの [agent] ブロックに次の行を追加します。

    [agent]
        log_level = debug

ログは /var/log/puppetlabs/puppet/ にあります。

15.2.12. Puppet サーバーのログレベルの引き上げ

Satellite Server の Puppet サーバーのログレベルを上げることができます。

前提条件

手順

  1. /etc/puppetlabs/puppet/puppet.conf ファイルの [master] ブロックに次の行を追加します。

    [master]
        log_level = debug
  2. Puppet サーバーを再起動します。

    # satellite-maintain service restart --only puppetserver

ログは /var/log/puppetlabs/puppetserver/ にあります。