第12章 問題のログとレポート
本章では、関連するログファイルに関する情報、デバッグロギングを有効にする方法、サポートケースを開き、関連するログ tar ファイルを添付する方法、Satellite Web UI 内でサポートケースにアクセスする方法など、Red Hat Satellite Server における問題のログおよびレポート方法について説明します。
本章で説明されたログファイルと他の情報を使用して独自にトラブルシューティングを行ったり、サポートが必要な場合は、これらの情報と他の多くのファイルとともに診断および設定情報を取得して Red Hat サポートに送信することができます。
Satellite のロギング設定の詳細は、satellite-installer
を使用し、--full-help
オプションを指定します。
# satellite-installer --full-help | grep logging
12.1. デバッグロギングの有効化
デバッグロギングでは、最も詳細にわたるログ情報が提供され、Satellite 6.6 とそのコンポーネントで発生する可能性がある問題のトラブルシューティングが簡単になります。
Satellite CLI で、デバッグロギングを有効にして、Satellite 6.6 の詳細なデバッグ情報をログに記録します。
手順
デバッグロギングを有効にするには、Satellite Server で次の手順を実行します。
デバッグロギングを有効にするには、次のコマンドを入力します。
# satellite-installer --foreman-logging-level debug
デバッグが完了したら、ロギングレベルをデフォルト値にリセットします。
# satellite-installer --reset-foreman-logging-level
12.2. 個別のロガーの有効化
個別のロガーを有効にして、一部のロギングを選択的に有効にできます。Satellite では、以下のロガーを使用します。
app
- Web 要求とアプリケーションの一般的なメッセージをすべてロギングします。デフォルト値: true
audit
- 追加のファクト統計、追加、更新、削除されたファクトの数をロギングします。デフォルト値: true
ldap
- ハイレベルの LDAP クエリーと LDAP オペレーションをロギングします。デフォルト値: false
permissions
- ページを読み込む時にユーザーのロール、フィルター、パーミッションへのクエリーをロギングします。デフォルト値: false
sql
- Rails ActiveRecord を使用した SQL クエリーをロギングします。デフォルト値: false
手順
個別のロガーを有効にするには、次の手順を実行します。
任意の個別ロガーを有効化します。たとえば、
sql
とldap
のロガーを有効にするには、以下のコマンドを入力します。# satellite-installer --foreman-loggers sql:true --foreman-loggers ldap:true
オプション: デフォルト値にロガーをリセットするには、以下のコマンドを入力します。
# satellite-installer --reset-foreman-loggers
12.3. ジャーナルへのロギングの設定
Satellite がジャーナルを使用したロギングを管理するように設定します。ジャーナルは、ログメッセージを rsyslog
に転送し、rsyslog
はログメッセージを /var/log/messages
に記述します。この変更を加えた後は、ログメッセージが /var/log/foreman/production.log
または /var/log/foreman-proxy.log
には表示されません。
ジャーナルに関する詳細は、『Red Hat Enterprise Linux 7 システム管理者のガイド』の「Journal の使用」を参照してください。
手順
ジャーナルを使用した Satellite Server のロギングを設定するには、次の手順を実行します。
以下の
satellite-installer
コマンドを入力して、ロギングをjournald
に設定します。# satellite-installer --foreman-logging-level info \ --foreman-logging-type journald \ --foreman-logging-layout pattern --foreman-proxy-log JOURNAL
Apache デーモンを再起動します。
# satellite-maintain service restart --only httpd
12.4. Satellite が提供するログファイルディレクトリー
Red Hat Satellite は、システム情報を通知とログファイルの形式で提供します。
ログファイルディレクトリー | ログファイルの内容の説明 |
---|---|
|
サブスクリプションの管理 |
|
Foreman |
|
Foreman プロキシー |
|
Apache HTTP サーバー |
|
Satellite インストーラー |
|
Capsule Server インストーラー |
|
仮想化 API |
|
Satellite データベース |
|
Foreman |
|
Celerybeat および Celery 起動要求メッセージ。起動が完了したら、メッセージは |
|
設定管理 |
|
サブスクリプションの管理 |
|
それぞれ Red Hat Enterprise Linux 6 と Red Hat Enterprise Linux 7 向けの Apache Web サーバーメッセージ |
|
pulp、rhsm、および goferd に関連する他のさまざまなログメッセージ |
foreman-tail
コマンドを使用して、Satellite に関連する多くのログファイルを追跡することもできます。foreman-tail -l
を実行すると、追跡するプロセスとサービスがリストされます。
12.5. ログ情報の収集ユーティリティー
ログファイルから情報を収集するユーティリティーは、2 つあります。
コマンド | 説明 |
---|---|
|
また、
詳細情報については、 このコマンドの実行時にはタイムアウトがありません。 |
|
デフォルトでは、出力 tar ファイルは
|
foreman-debug
と sosreport
では、情報を収集する間にパスワード、トークン、キーなどのセキュリティー情報が削除されます。ただし、tar ファイルには依然として Red Hat Satellite Server についての機密情報が含まれる可能性があります。Red Hat では、この情報をパブリックではなく特定の受信者に直接送信することを推奨します。