RHEL 6.9、7.8、8.2 以前

設定ファイル

remove.conf

RHEL 6.10、7.9、8.3 以降

YAM ファイル

file-redaction.yaml

file-content-redaction.yaml

--help

-h

ヘルプ情報を表示します

--register

/etc/hostname の情報を使用して、ホストを Insights for RHEL に登録します。--disable-schedule が設定されていない限り、cron ジョブを毎晩、自動的に有効にします。

--unregister

Insights for RHEL からホストの登録を解除します。

--display-name=DISPLAY_NAME

GUI でホスト表示名を設定または変更します。/etc/hostname のホスト名とは別のものを指定するには、--register を使用して、ホストの登録時に display_name を設定します。

--group=GROUP

登録時にホストを GROUP に追加します。グループ名は /etc/insights-client/tags.yaml で定義されます。

--retry=RETRIES

アップロードを再試行する回数を設定します。デフォルトでは 1 回です。再試行の間隔は 180 秒で、これは Insights クライアントがアップロードを再試行するまで待機する時間です。

注記: スケジューラーでは、再試行回数は 3 回です。

--validate

/etc/insights-client/remove.conf ファイルの構造を検証します。

--quiet

エラーメッセージのみをコンソールに記録します。

--silent

コンソールに何もログを記録しません。

--enable-schedule

ジョブスケジュールを有効にします。デフォルトでは、Insights クライアントは毎日午前 0 時ごろに実行されます。

注記: クライアント 1.x を使用している場合は、--register オプションを使用してスケジュールを有効にします。

--disable-schedule

毎晩のジョブスケジュールを無効にします。

--conf=CONF

-c=CONF

デフォルトの /etc/insights-client/insights-client.conf ファイルの代わりに、カスタム設定ファイル CONF を使用します。

--compressor

アーカイブの作成時に使用する圧縮を選択します。利用可能なオプションは gz、bz2、xz、none です。デフォルトは gz です。none オプションは、圧縮なしで tar ファイルを作成します。

--no-upload

クライアントを実行しますが、Insights for Red Hat Enterprise Linux または CMSfR Web アプリケーションにアーカイブをアップロードしません。アーカイブは /var/tmp/ ディレクトリーに保存されます。ファイル名は、insights-client の処理が完了すると表示されます。

--offline

ネットワーク機能を使用せずにクライアントを実行します。--no-upload を意味します。

--logging-file=LOGFILE

指定の LOGFILE にログデータを出力します。デフォルトのログファイルは /var/log/insights-client/insights-client.log です。

--diagnosis

API から診断情報を取得します。システムは、--diagnosis を使用する前に、登録してアップロードする必要があります。

--compliance

OpenSCAP でシステムをスキャンし、レポートをアップロードします。

--payload=PAYLOAD

特定のアーカイブの PAYLOAD ファイルを Insights for Red Hat Enterprise Linux にアップロードします。--content-type が必要です。

--content-type=TYPE

PAYLOAD ファイルの content-type を設定します。タイプには gz、bz2、xz、および none を指定できます。TYPE は PAYLOAD で使用される --compressor と一致する必要があります。

--check-results

Insights for Red Hat Enterprise Linux から分析結果を取得します。

--show-results

--check-results が取得した分析結果を表示します。

--output-dir=DIR

コレクションは、アップロードせずに、指定したディレクトリーに書き込みます。

--output-file=FILE

コレクションを、アップロードせずに、指定したアーカイブに書き込みます。

--version

insights-client クライアントおよびコアのバージョンを出力します。

--test-connection

Insights for Red Hat Enterprise Linux サービスへの接続をチェックします。

--force-reregister

Insights for RHEL でシステムを再登録し、新しい ID を使用します。このアクションは、すでに登録済みのシステムを複製するものです。

--verbose

すべてのデバッグ出力をコンソールに記録します。

--no-upload

クライアントは実行しますが、アーカイブはアップロードされません。アーカイブは /var/tmp/ ディレクトリーに保存されます。ファイル名は、insights-client の処理が完了すると表示されます。

--keep-archive

アップロード後もアーカイブを保持します。

--support

サポート用の診断ログを生成します。

--status

ホスト登録のステータスを表示します。

--net-debug

コンソールにネットワーク呼び出しのログを記録します。

[remove]

これは、remove.conf ファイルの最初の行に配置する必要があります。

files=

記載のファイルは、データ収集から除外されます。

commands=

ここに記載のコマンドの出力は、データ収集から除外されます。コマンド名は、コレクションルール のコマンド名と完全一致する必要があります。

patterns=

パターン に完全一致または部分一致するアーカイブファイルの行はすべて削除されます。

keywords=

キーワードは、keyword の実際の値と数字に置き換えられます。

たとえば、keywords=host,domain のようにキーワードを 2 つ定義した場合には、host が出現すると文字列 keyword0 に、domain が出現すると keyword1 に置き換えられます。それ以外に定義したキーワードはそれぞれ、 keywordn (n の数字は 1 つずつ漸増) に置き換えられます。

# file-redaction.yaml
---

ファイル名を含むコメント (任意)。

# Exclude the entire output of commands
#   Specify the full command path or the symbolic name in .cache.json

 commands:
- /bin/rpm -qa
- /bin/ls
- ethtool_i

/bin/rpm -qa および bin/ls からの全出力がアーカイブファイルから除外されます。

.cache.json ファイルで /sbin/ethtool -i の全コマンドがシンボリック名 ethtool_i にマッピングされます。

# Exclude the entire output of files
#  Specify the full filename path or the symbolic name in .cache.json

files:
- /etc/audit/auditd.conf
- cluster_conf

指定されたファイルは、ファイル名とファイルの内容がアーカイブファイルから除外されます。

.cache.json ファイルで /etc/cluster/cluster.conf の完全ファイルパスがシンボリック名 cluster_conf にマッピングされます。

# file-content-redaction.yaml
---

ファイル名を含むコメント (任意)。

# Pattern redaction per matching line
#  Lines that match a pattern are excluded from files and command output.
#  Patterns are processed in the order that they are listed.
# Example

patterns:
 - "a_string_1"
 - "a_string_2"

パターンが a_string_1 または a_string_2 を含む行に完全一致する場合には、そのパターンがコマンドの出力やファイルから除外されます。パターンの文字列を引用符で囲みます。

#
# Regular expression pattern redaction per line
#  Patterns with regular expressions (regex) are wrapped with "regex:"
# Example

patterns:
 regex:
 - "abc.*def"
 - "localhost[[:digit:]]"
 #

正規表現は regex でラップされます。egrep コマンドで認識される正規表現 (regex) を使用できます。正規表現を引用符で囲みます。

# Lines matching these regular expressions are excluded
# from output.
patterns:
  regex:
  - "*\.conf"
  - "^include"

egrep 式は引用符で囲み、正規表現が正しく認識されるようにします。

この例では、文字列に .conf が含まれる場合、行が include で始まる場合に、行がアーカイブファイルからリダクションされます。

# Replace keywords in files and command output with generic identifiers by the Python soscleaner module
keywords:
- "1.1.1.1"
- "My Name"
- "a_name"

keywords: 配列の文字列は、keyword の実際の値と数字に置き換えられます。

たとえば、1.1.1.1 の文字列は keyword0 に置き換えられます。文字列 My Name が出現するたびに、keyword1 に置き換えられます。a_name は keyword3 に置き換えられます。他に定義したキーワードは、keywordn (n は 1 ずつ漸増) に置き換えられます。置き換えられた keywordn の値は、Python SoS プロセスで決定されるので変更できません。

keywords: 配列で定義する文字列は、大文字と小文字が区別されます。

[insights-client]

クライアント設定ファイルに別の場所や名前を指定した場合は、設定ファイルの最初の行が必要です。

#loglevel=DEBUG

ログレベルを変更します。オプション: DEBUG、INFO、WARNING、ERROR、CRITICALデフォルトは DEBUG です。デフォルトのログファイルの場所は /var/log/insights-client/insights-client.log です。

#auto_config=True

Satellite Server で自動設定を試みます。値は True (デフォルト) または False です。

#authmethod=BASIC

認証方法を設定します。有効なオプションは BASIC、CERT です。auto_config=True が設定されていて CERT が使用されている場合でも、デフォルト値は BASIC です。

#username=

認証方法が BASIC の場合に使用する ユーザー名。ユーザー名 はクリアテキストで保存されます。

#password=

認証方法が BASIC の場合に使用するパスワード。パスワード はクリアテキストで保存されます。

#base_url=cert-api.access.redhat.com:443/r/insights

API のベース URL。

#proxy=

プロキシーの URL。例: http://user:pass@192.168.100.50:8080

#auto_update=True

動的設定を自動更新します。デフォルトは True です。自動的に更新しない場合は、False に変更します。

#obfuscate=False

IPv4 アドレスを難読化します。デフォルトは False です。アドレスの難読化を有効にするには、True に変更します。

#obfuscate_hostname=False

ホスト名を難読化します。ホスト名を難読化するには obfuscate=True と設定する必要があり、この設定で IPv4 アドレスの難読化が可能になります。ホスト名のみを難読化することはできません。

#display_name=

登録の表示名。デフォルトは /etc/hostname を使用します。注記: この値は、insights-client --display-name コマンドと対話します。CLI を使用して表示名を変更したにも拘らず、設定ファイルで別の表示名が有効な場合には、スケジューラーが Insights クライアントを実行すると、表示名は設定ファイルの値に戻ります。

#cmd_timeout=120

コレクション時に実行されるコマンドのタイムアウト (秒単位)。タイムアウト値に達すると、コマンドプロセスが終了します。

#http_timeout=120

HTTP 呼び出しのタイムアウト (秒単位)。

#remove_file=/etc/insights-client/remove.conf

リダクションファイルの場所