Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

第12章 問題のログとレポート

本章では、関連するログファイルに関する情報、デバッグロギングを有効にする方法、サポートケースを開き、関連するログ tar ファイルを添付する方法、Satellite Web UI 内でサポートケースにアクセスする方法など、Red Hat Satellite Server における問題のログおよびレポート方法について説明します。

本章で説明されたログファイルと他の情報を使用して独自にトラブルシューティングを行ったり、サポートが必要な場合は、これらの情報と他の多くのファイルとともに診断および設定情報を取得して Red Hat サポートに送信することができます。

Satellite のロギング設定の詳細は、satellite-installer を使用し、--full-help オプションを指定します。 

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

12.1. デバッグロギングの有効化
リンクのコピー

デバッグロギングでは、最も詳細にわたるログ情報が提供され、Satellite 6.6 とそのコンポーネントで発生する可能性がある問題のトラブルシューティングが簡単になります。

Satellite CLI で、デバッグロギングを有効にして、Satellite 6.6 の詳細なデバッグ情報をログに記録します。

手順

デバッグロギングを有効にするには、Satellite Server で次の手順を実行します。

  1. デバッグロギングを有効にするには、次のコマンドを入力します。 

    # 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

12.2. 個別のロガーの有効化
リンクのコピー

個別のロガーを有効にして、一部のロギングを選択的に有効にできます。Satellite では、以下のロガーを使用します。

app
Web 要求とアプリケーションの一般的なメッセージをすべてロギングします。デフォルト値: true
audit
追加のファクト統計、追加、更新、削除されたファクトの数をロギングします。デフォルト値: true
ldap
ハイレベルの LDAP クエリーと LDAP オペレーションをロギングします。デフォルト値: false
permissions
ページを読み込む時にユーザーのロール、フィルター、パーミッションへのクエリーをロギングします。デフォルト値: false
sql
Rails ActiveRecord を使用した SQL クエリーをロギングします。デフォルト値: false

手順

個別のロガーを有効にするには、次の手順を実行します。

  1. 任意の個別ロガーを有効化します。たとえば、sql と ldap のロガーを有効にするには、以下のコマンドを入力します。 

    # satellite-installer --foreman-loggers sql:true --foreman-loggers ldap:true
    Copy to Clipboard Toggle word wrap

  2. オプション: デフォルト値にロガーをリセットするには、以下のコマンドを入力します。 

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

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 のロギングを設定するには、次の手順を実行します。

  1. 以下の satellite-installer コマンドを入力して、ロギングを journald に設定します。 

    # satellite-installer --foreman-logging-level info \
--foreman-logging-type journald \
--foreman-logging-layout pattern --foreman-proxy-log JOURNAL
    Copy to Clipboard Toggle word wrap

  2. Apache デーモンを再起動します。 

    # satellite-maintain service restart --only httpd
    Copy to Clipboard Toggle word wrap

12.4. Satellite が提供するログファイルディレクトリー
リンクのコピー

Red Hat Satellite は、システム情報を通知とログファイルの形式で提供します。

Expand
表12.1 レポートおよびトラブルシューティングのログファイルディレクトリー
ログファイルディレクトリーログファイルの内容の説明

/var/log/candlepin

サブスクリプションの管理

/var/log/foreman

Foreman

/var/log/foreman-proxy

Foreman プロキシー

/var/log/httpd

Apache HTTP サーバー

/var/log/foreman-installer/satellite

Satellite インストーラー

/var/log/foreman-installer/capsule

Capsule Server インストーラー

/var/log/libvirt

仮想化 API

/var/log/mongodb

Satellite データベース

/var/log/production

Foreman

/var/log/pulp

Celerybeat および Celery 起動要求メッセージ。起動が完了したら、メッセージは /var/log/messages に記録されます。

/var/log/puppet

設定管理

/var/log/rhsm

サブスクリプションの管理

/var/log/tomcat6 および /var/log/tomcat

それぞれ Red Hat Enterprise Linux 6 と Red Hat Enterprise Linux 7 向けの Apache Web サーバーメッセージ

/var/log/messages

pulp、rhsm、および goferd に関連する他のさまざまなログメッセージ

foreman-tail コマンドを使用して、Satellite に関連する多くのログファイルを追跡することもできます。foreman-tail -l を実行すると、追跡するプロセスとサービスがリストされます。

12.5. ログ情報の収集ユーティリティー
リンクのコピー

ログファイルから情報を収集するユーティリティーは、2 つあります。

Expand
表12.2 ログ収集ユーティリティー
コマンド説明

foreman-debug

foreman-debug コマンドは、Red Hat Satellite とそのバックエンドサービスの設定およびログファイルデータとシステム情報を収集します。この情報は収集され、tar ファイルに書き込まれます。デフォルトでは、出力される tar ファイルは、/tmp/foreman-debug-xxx.tar.xz に格納されます。

また、foreman-debug コマンドは、過去 60 日間に実行されたタスクをエクスポートします。デフォルトでは、出力される tar ファイルは、/tmp/task-export-xxx.tar.xz に格納されます。このファイルが見当たらない場合は、/tmp/task-export.log ファイルで、タスクのエクスポートが失敗した理由を確認できます。

詳細情報については、foreman-debug --help を実行してください。

このコマンドの実行時にはタイムアウトがありません。

sosreport

sosreport コマンドは、Red Hat Enterprise Linux システムから設定および診断情報 (実行中のカーネルバージョン、ロードされたモジュール、システムおよびサービス設定ファイルなど) を収集するツールです。また、このコマンドは外部プログラムを実行して (たとえば、foreman-debug -g)、Satellite 固有の情報を収集し、この出力を tar ファイルに格納します。

デフォルトでは、出力 tar ファイルは /var/tmp/sosreport-XXX-20171002230919.tar.xz にあります。詳細については、sosreport --help を実行するか、「What is a sosreport and how can I create one?」を参照してください。

sosreport コマンドは foreman-debug -g を呼び出し、500 秒後にタイムアウトします。Satellite Server のログファイルが大きい場合や多くの Satellite タスクがある場合、サポートエンジニアはサポートケース作成時に sosreport と foreman-debug の出力を必要とすることがあります。

重要

foreman-debug と sosreport では、情報を収集する間にパスワード、トークン、キーなどのセキュリティー情報が削除されます。ただし、tar ファイルには依然として Red Hat Satellite Server についての機密情報が含まれる可能性があります。Red Hat では、この情報をパブリックではなく特定の受信者に直接送信することを推奨します。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat