Red Hat Insights のクライアント設定ガイド


Red Hat Insights 1-latest

Insights クライアントの設定オプションおよびユースケース

Red Hat Customer Content Services

概要

このガイドは、RHEL システムで Insights クライアント機能を設定したい Insights for Red Hat Enterprise Linux ユーザーを対象としています。システム上の Insights クライアント設定は、Insights for Red Hat Enterprise Linux との対話に影響します。
Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。この取り組みは膨大な作業を要するため、用語の置き換えは、今後の複数のリリースにわたって段階的に実施されます。詳細は、Red Hat CTO である Chris Wright のメッセージ をご覧ください。

第1章 Insights クライアントの概要

Insights クライアント (insights-client) は、Red Hat Insights for Red Hat Enterprise Linux のクライアントです。コマンドラインから insights-client を実行します。

1.1. Red Hat Insights クライアントディストリビューション

Insights クライアントは、Red Hat Enterprise Linux (RHEL) の次のリリースで利用できます。

RHEL リリースコメント

RHEL 9

Insights クライアントで配布される。

RHEL 8

RHEL 8 が最小インストールとしてインストールされていない限り、Insights クライアントがプリインストールされた状態で配布されます。

RHEL 7

Insights クライアント RPM パッケージはロードされていますが、インストールされていない状態で配布されます。

RHEL 6.10 以降

Insights クライアントの RPM パッケージをダウンロードし、インストールする必要があります。

注記

古いバージョンへの Insights クライアントのインストール

RHEL バージョン 6 および 7 に、Insights クライアントはプリインストールされていません。これらのバージョンのいずれかを使用している場合は、ターミナルで次のコマンドを実行します。

[root@server ~]# yum install insights-client

その後、Red Hat Insights for Red Hat Enterprise Linux にシステムを登録します。

[root@server ~]# insights-client --register

関連情報

第2章 insights-client のインストール

Red Hat Insights for Red Hat Enterprise Linux は、Red Hat インフラストラクチャーによって管理されている既存のシステムにインストールすることも、Red Hat Enterprise Linux の最小インストールにインストールすることもできます。

Insights クライアントをインストールしたら、システムを登録する必要があります。システムの登録の詳細は、認証の設定 を参照してください。

2.1. Red Hat Cloud Access が管理する既存のシステムへの Insights クライアントのインストール

以下の手順を使用して、Red Hat Cloud Access に接続された既存の Red Hat Enterprise Linux (RHEL) システムに Red Hat Insights for Red Hat Enterprise Linux をデプロイします。

前提条件

  • システムのルートレベルのアクセス。

手順

  • 以下のコマンドを実行し、現在のバージョンの Insights クライアントパッケージをインストールします。

    RHEL バージョン 6 および 7

    [root@server ~]# yum install insights-client

    RHEL バージョン 8 以降

    [root@server ~]# dnf install insights-client
注記

古いバージョンへの Insights クライアントのインストール

RHEL バージョン 6 および 7 に、Insights クライアントはプリインストールされていません。これらのバージョンのいずれかを使用している場合は、ターミナルで次のコマンドを実行します。

[root@server ~]# yum install insights-client

2.2. Red Hat Update Infrastructure によって管理される既存のシステムへの insights-client のインストール

これらの手順を使用して、Red Hat Update Infrastructure (RHUI) が管理するクラウドマーケットプレイスで購入した既存の Red Hat Enterprise Linux システムに Insights for Red Hat Enterprise Linux をデプロイします。

前提条件

  • システムのルートレベルのアクセス。

手順

  • 以下のコマンドを実行し、現在のバージョンの Insights クライアントパッケージをインストールします。

    RHEL バージョン 6 および 7

    [root@server ~]# yum install insights-client

    RHEL バージョン 8 以降

    [root@server ~]# dnf install insights-client

2.3. Insights クライアント CLI と設定ファイルの対話方法

Insights クライアントは、スケジューラーの設定に従って自動的に実行されます。デフォルトでは、24 時間ごとに実行されます。クライアントをインタラクティブに実行するには、insights-client コマンドを入力します。

insights-client を実行すると、次の値と設定によって結果が決まります。

  1. CLI から insights-client を実行するときに入力した値は、事前に設定された設定ファイルとシステム環境の設定を一時的にオーバーライドします。insights-client コマンドのオプションに入力した値は、Insights クライアントのそのインスタンスに対してのみ使用されます。
  2. 設定ファイル (/etc/insights-client/insights-client.conf の設定は、システム環境設定をオーバーライドします。
  3. システム環境変数 (printenv) の値は、CLI またはクライアント設定ファイルの影響を受けません。
注記

RHEL 6.9 以前を実行している場合は、redhat-access-insights を使用して Insights クライアントを実行します。

2.4. RHEL の最小インストールでの Insights クライアントのインストール

Insights クライアントは、Red Hat Enterprise Linux 8 の最小インストールを実行しているシステムに自動的にインストールされません。

最小インストールの詳細は、標準的な RHEL インストールの実行ソフトウェア選択の設定 を参照してください。

前提条件

  • システムへのルートレベルのアクセスがある。

手順

  1. Insights クライアントで最小インストールを作成するには、Anaconda インストーラーの RHEL ソフトウェア選択オプションから Minimal Installation を選択します。
  2. Additional Software for Selected Environment セクションで Standard チェックボックスを必ず選択してください。Standard オプションには、RHEL インストールに insights-client パッケージが含まれています。

Standard チェックボックスを選択しない場合、RHEL は insights-client パッケージなしでインストールされます。その場合は、後で dnf install を使用して Insights クライアントをインストールできます。

2.5. Insights クライアントのリアルタイムスケジューリング問題を解決する方法

Insights クライアントは、システム上のデータを収集する多数のコマンドを実行します。そのため、CPU 使用率を 30% 以下に制限する設定制限があります。この制限は、設定ファイルで定義します。

insights-client-boot.service: CPUQuota=30%

この設定により、Insights クライアントがシステムで CPU が急増しないようにします。CPU が急増すると、システムで実行している他のアプリケーションに干渉する可能性があります。具体的には、リアルタイムスケジューリングに依存するアプリケーションが起動しない場合があります。

リアルタイムスケジューリングを有効にする必要がある場合は、CPU クォータの制限を無効にできます。この設定を削除するリスクは最小限です。ただし、Insights クライアントの実行時に CPU 使用率が異常に高くなる可能性があります。この状況が発生し、システムの他のサービスに悪影響を与える場合は、Red Hat サポートにお問い合わせください。

How do I open and manage a support case on the Customer Portal?

第3章 認証の設定

重要

Basic 認証は非推奨になりました。Basic 認証を使用している場合は、現在サポートされている認証方法のいずれかに変更する必要があります。ユーザーアクセスのための Basic 認証から証明書ベースの認証への変更に関する詳細は、How to switch from Basic Auth to Certificate Authentication for Red Hat Insights を参照してください。

3.1. 認証方法

Red Hat Insights for Red Hat Enterprise Linux の使用方法に応じて、以下のいずれかの認証方法を使用する必要があります。

  • 証明書ベースの認証 (CERT)

    証明書ベースの認証は、デフォルトの認証方法です。証明書は、Red Hat Subscription Manager (RHSM)にシステムを登録するか、Red Hat Satellite システム管理でシステムを管理すると、生成されます。クライアント設定ファイルには、デフォルトで authmethod=CERT が含まれています。追加の設定変更の要件はありません。

  • アクティベーションキー

    推奨される認証方法では、アクティベーションキーと組織 ID を使用して、RHSM やリモートホスト設定 (RHC) などの Red Hat ホスト型サービスにシステムを登録します。

    組織のアクティベーションキーの一覧は、Red Hat Hybrid Cloud Console の Activation Keys ページにあります。アクティベーションキーを認証トークンとして使用して、システムを Red Hat Subscription Manager (RHSM)やリモートホスト設定(RHC)などの Red Hat がホストするサービスに登録できます。管理者は、組織のアクティベーションキーを作成、編集、および削除できます。

  • サービスアカウント

    サービスアカウントはアプリケーションとサービスを認証しますが、ユーザーアカウントは人間のユーザーを認証します。次の場合にサービスアカウント認証を使用します。

    • アプリケーションまたはサービスは特定のリソースへのアクセスを必要である。
    • アプリケーションまたはサービスは、人の介入を必要とせずにリソースにアクセスする必要がある。
    • アプリケーションまたはサービスは、複数の場所からリソースにアクセスする必要がある。

      サービスアカウントは、クラウドサービスへの API アクセスにトークンベースの認証モデルを採用します。CERT およびアクティベーションキーは、証明書ベースの認証を使用します。

      Basic 認証からサービスアカウントへの移行、および API アクセスに Basic 認証を使用するアカウントの更新手順の詳細は、Transition of Red Hat Hybrid Cloud Console APIs from basic authentication to token-based authentication via service accounts を参照してください。

      サービスアカウントの使用方法の詳細は、サービスアカウントの作成と管理 を参照してください。

3.2. 認証でのアクティベーションキーの使用

アクティベーションキーは、許可されたユーザーがシステムを登録および設定できるようにする事前共有認証トークンです。個人のユーザー名とパスワードの組み合わせを保存、使用、共有する必要がなくなるため、セキュリティーが向上し、自動化が促進されます。

アクティベーションキーと数値の組織識別子 (組織 ID) を使用して、Red Hat Subscription Manager (RHSM) やリモートホスト設定 (rhc) などの Red Hat ホスト型サービスにシステムを登録できます。組織のアクティベーションキーと組織 ID は、Hybrid Cloud Console の Activation Keys ページに表示されます。

システムのアクティベーションキーを作成および管理する方法の詳細は、Red Hat Hybrid Cloud Console でのアクティベーションキーの作成と管理 を参照してください。

3.3. Red Hat ホスト型サービスへのシステムの登録

Insights クライアントをインストールしたら、システムを登録する必要があります。これには、次の 2 つの手順が必要です。

  • Red Hat Subscription Manager (RHSM) やリモートホスト設定 (rhc) などの Red Hat ホスト型サービスへの登録
  • Insights クライアントへのシステムの登録

Insights クライアントにシステムを登録する方法は、以下を参照してください。

前提条件

  • 各システムへの管理者ログインアクセス
  • アクティベーションキー
  • 組織 ID

手順

RHEL 7 および 8

  1. Red Hat Enterprise Linux バージョン 7 または 8 を実行するシステムを登録するには、アクティベーションキーと組織 ID を使用して RHSM に登録します。

    # subscription-manager register --activationkey=_activation_key_name_ --org=_organization_ID_

RHEL 9

  1. RHEL 9 以降を実行するシステムを登録するには、アクティベーションキーを使用して rhc クライアントに登録します。システムで rhc 管理サービスを実行しない場合は、RHEL 7 または RHEL 8 の場合と同じコマンドを RHEL 9 システムに対して使用します。

    # rhc connect --activation-key example_key --organization your_org_ID

第4章 insights-client の設定

Insights クライアントをインストールした後、システムを Red Hat Insights for Red Hat Enterprise Linux に登録する必要があります。登録すると、Red Hat Insights for Red Hat Enterprise Linux サービスを使用できるようになります。

4.1. Red Hat Insights へのシステムの登録

insights-client コマンドを使用して、システムを Red Hat Insights に登録できます。

システムを登録するときに、コマンドに --display-name オプションを追加して、ホストに別の表示名を割り当てることができます。表示名は、Insights UI でシステムを識別します。システムを登録するときに表示名を割り当てないと、Insights はシステムのデフォルトのホスト名を使用します。

前提条件

お使いのシステムで次の手順を完了するようにしてください。

  • root レベルの権限でログインする。
  • Insights クライアントをインストールする。

手順

  1. CLI で次の subscription-manager コマンドを実行します。

    [root@insights]# subscription-manager register
    [root@insights]# subscription-manager status
  2. 次のように、insights-client 登録コマンドを実行します。

    [root@insights]# insights-client --register
    [root@insights]# insights-client --status

  • 次の例は、ホスト名とは異なる表示名でシステムを登録する方法を示しています。

    [root@insights01]# insights-client --register --display-name ITC-4
    • 結果の出力:

      Successfully registered host insights01-rhel9 as ITC-4 in group None
      Automatic scheduling for Insights has been enabled.
      Starting to collect Insights data for ITC-4
      Writing RHSM facts to /etc/rhsm/facts/insights-client.facts ...
      Uploading Insights data.
      Successfully uploaded report from ITC-4 to account 1234567.
      View the Red Hat Insights console at https://console.redhat.com/insights/
  • 以下の例は、Red Hat Insights にすでに登録されているシステムの表示名を変更する方法を示しています。

    [root@insights01]# insights-client --display-name ITC-5
    • 結果の出力:

      System display name changed from ITC-4 to ITC-5

insights-client コマンドオプションの詳細は、関連情報 セクションを参照してください。

結果

Red Hat Insights for Red Hat Enterprise Linux にアクセスできるようになりました。

重要
  • 新しく登録したシステムがコンソールの Red Hat Insights インベントリーページに表示されるまでに、最大 15 分かかる場合があります。
  • Red Hat Satellite ユーザー: Satellite システムを Insights に登録した後、新規インストールを実行して Satellite システムをアップグレードまたは再構築する場合は、システムを Insights に再登録する必要があります。方法の詳細は、Red Hat Insights へのシステムの再登録 を参照してください。

4.1.1. Satellite 登録中のホストテレメトリー有効化エラーの解決

この問題は Red Hat Satellite ユーザーに影響します。Red Hat Insights にホストを登録する Satellite ユーザーの場合、insights-client --register を実行すると、CLI に次の出力が表示されることがあります。

Telemetry is not enabled for this host

このエラーは、ホスト登録時に host_registration_insights パラメーターが false に設定されているために発生します。Satellite が Insights クライアントのアップロードを受け入れるには、これを true に設定する必要があります。このエラーメッセージを解決するには、次の手順を実行する必要があります。

  • host_registration_insights パラメーターを true に変更します
  • パラメーターが更新された後、コマンドラインで Insights-client --register コマンドを再度実行します。

関連情報

この問題とその解決方法の詳細は、以下を参照してください。

4.2. Red Hat Insights へのシステムの登録解除

Red Hat Insights for Red Hat Enterprise Linux を使用して、システムの登録を取り消すことができます。これを行うと、システム情報は Insights for Red Hat Enterprise Linux にアップロードされなくなります。

前提条件

  • システムへのルートレベルのアクセスがある。
  • システムは Insights for Red Hat Enterprise Linux に登録されています。

手順

  1. --unregister オプションを指定して insights-client コマンドを入力します。

    [root@insights]# insights-client --unregister
    Successfully unregistered from the Red Hat Insights Service

検証

  • --status オプションを指定して insights-client コマンドを入力します。

    [root@insights]# insights-client --status
    System is NOT registered locally via .registered file. Unregistered at 2021-03-12T10:36:39.257300
    Insights API says this machine was unregistered at 2021-03-12T00:36:39.000Z

4.3. Red Hat Insights へのシステムの再登録

Red Hat Enterprise Linux の Red Hat Insights にシステムを再登録する必要がある場合があります。

正しい手順を使用して Insights にシステムを再登録すると、Insights インベントリーサービスでの重複したホストエントリーを防止および修正するのに役立ちます。たとえば、Insights でシステムを再登録する理由の 1 つとして、以前に登録されていたシステムをクリーンインストールで再構築し、エントリーをクリーンアップすることが挙げられます。

重要

Red Hat Satellite ユーザーであり、新規インストールによって Satellite システムをアップグレードまたは再構築する予定の場合は、そのシステムを Insights に再登録する必要があります。アップグレードを開始する前に、Insights でシステムを登録解除してください。Satellite システムを再インストールしたら、Insights クライアントに再度登録します。そうしないと、重複したホストエントリーやその他の予期しない結果が表示される可能性があります。

Insights にシステムを再登録するには、次の 2 つのオプションを使用して insights-client コマンドを 2 回実行します。

  1. --unregister
  2. --register

前提条件

お使いのシステムで次の手順を完了するようにしてください。

  • root レベルの権限でログインする。
  • Insights クライアントをインストールする。

手順

  1. コマンドラインで、--unregister オプションを指定して insights-client コマンドを入力します。

    [root@insights]# insights-client --unregister
  2. --register オプションを指定して insights-client コマンドを入力します。

    [root@insights]# insights-client --register

検証

—-unregister オプションを指定して Insights-client コマンドを実行し、次に —-register オプションを指定して insights-client コマンドを実行することでシステムを正しく再登録したら、新しい Insights プロファイルが作成され、次の出力が表示されます。

[root@insights]# Successfully uploaded report for <machine name>
View the Red Hat Insights console at https://console.redhat.com/insights/

4.4. ホスト表示名の変更

GUI に表示されるホスト表示名を変更できます。Red Hat Insights for Red Hat Enterprise Linux にシステムの登録時、または登録後に、この変更を加えます。システムの登録時に表示名を割り当てないと、Red Hat Insights for Red Hat Enterprise Linux は /etc/hostname の値を使用します。

この手順はオプションです。デフォルトの hostname に加えて表示名を使用するかどうかを決定します。

注記

insights-client コマンドを使用して表示名を設定すると、すぐに適用されますが、Insights クライアントは実行されません。

注記

ホスト名を難読化すると、/etc/hostname に設定されている hostname も難読化されます。hostname が難読化されている場合でもホストを識別できるように、表示名 を割り当てます。

前提条件

  • システムへのルートレベルのアクセスがある。

手順

  • --display-name オプションを指定して insights-client コマンドを入力し、表示名を指定します。

    [root@insights]# insights-client --display-name ITC-4
    System display name changed from None to ITC-4
  • スペースを含む表示名を作成するには、二重引用符を使用します。

    [root@insights]# insights-client --display-name "ITC-4 B9 4th floor"
    System display name changed from None to ITC-4 B9 4th floor

4.5. クライアントバージョンの表示

クライアントバージョンとクライアントのコアバージョンを表示できます。

前提条件

  • システムへのルートレベルのアクセスがある。

手順

  • --version オプションを指定して insights-client コマンドを入力します。

    [root@insights]# insights-client --version
    Client: 3.0.6-0
    Core: 3.0.121-1

第5章 Insights クライアントデータの難読化

Red Hat Insights には、Red Hat に送信されるデータファイルから IP アドレスまたはホスト名を除外し、ユーザーインターフェイス内の値を難読化するためのオプションの制御機能があります。難読化されたホストを識別するためのカスタム表示名を設定することもできます。

5.1. 難読化の概要

Insights クライアントの難読化機能では、Python データクリーニングプロセスを使用して、Insights アーカイブを処理するときにホスト名と IP アドレスをプリセット値に置き換えます。難読化された値を含む処理済みのアーカイブファイルが、Red Hat Insights for Red Hat Enterprise Linux に送信されます。

難読化を有効にするには、/etc/insights-client/insights-client.conf ファイルで該当するオプションを設定します。システムの IP アドレスを難読化することも、IP アドレスとホスト名の両方を難読化することもできます。ホスト名のみを難読化することはできません。難読化はデフォルトで無効になっています。

注記
  • Python データクリーニングプロセスでは、マスクされた値が自動的に生成されます。難読化の値を選択することはできません。
  • Red Hat Insights for Red Hat Enterprise Linux コンプライアンスサービスは、OpenSCAP ツールを使用して、ホストシステムからの情報に基づいてコンプライアンスレポートを生成します。OpenSCAP との連携により、ホスト名や IP アドレスデータの完全な難読化またはリダクションを実行するコンプライアンスサービスの機能が制限されます。また、コンプライアンスデータ収集ジョブがホストシステムで起動されると、ホスト情報が Insights for Red Hat Enterprise Linux に送信されます。Red Hat Insights for Red Hat Enterprise Linux は、ホスト情報の難読化オプションの改善に取り組んでいます。

Red Hat Insights for Red Hat Enterprise Linux がデータ収集を処理する方法は、Red Hat Insights Data & Application Security を参照してください。

重要

Red Hat Satellite を使用してクライアントを管理し、console.redhat.com に登録する場合は、二重の難読化が必要です。つまり、insights-client.conf と Satellite Web UI の両方で難読化を有効にする必要があります。Satellite で難読化を有効にする方法の詳細は、Red Hat Satellite の管理 ガイドの Red Hat Cloud 設定 の章を参照してください。

5.2. IPv4 アドレスの難読化

難読化を有効にすると、アーカイブファイル内の IPv4 ホストアドレスを、Red Hat Insights for Red Hat Enterprise Linux に送信する前にマスクできます。

IP アドレスの難読化を選択すると、アーカイブファイル内のホストアドレスが Python データクリーニングファイルで指定された値に変更されます。難読化のために指定された値を設定することはできません。また、ホスト IP アドレスの一部を難読化したり、難読化する部分を選択したりすることもできません。

重要

Red Hat Insights は、IPv4 アドレスの IP アドレス難読化のみをサポートしています。

前提条件

  • Red Hat Satellite を使用してクライアントを管理し、console.redhat.com に登録する場合は、次の手順を実行する。

    • Satellite Web UI で、Red Hat Cloud 設定に移動し、Obfuscate host IPv4 addresses オプションを有効にします。

手順

  1. エディターで /etc/insights-client/insights-client.conf ファイルを開きます。
  2. 次のセクションを見つけます。

    # Obfuscate IP addresses
    #obfuscate=False
  3. 次のように先頭のハッシュ (#) 文字を削除し、FalseTrue に変更します。

    obfuscate=True
  4. /etc/insights-client/insights-client.conf ファイルを保存して閉じます。

結果

難読化が正常に有効化されると、次の例に示すように、コンソール UI、ログ、および Red Hat が収集するすべてのアーカイブデータファイルで元の IP アドレスがマスクされます。

重要

難読化を有効にした後も、一部の insights-client コマンドのコマンドライン出力には、元の IP アドレスが引き続き表示されます。

  • 元のホストシステムの IP アドレス:

    192.168.0.24
  • 難読化されたホスト IP アドレス:

    10.230.230.1
  • 次のスクリーンショットは、Red Hat Hybrid Cloud Console UI の難読化された IP アドレスの例を示しています。

    An example of an obfuscated IP address in the Red Hat Hybrid Cloud Console UI

注記

複数のシステムで難読化を有効にすると、同じ難読化された IP アドレスが生成されます。したがって、上記の事例では、Hybrid Cloud Console の Insights UI で IP アドレスで検索またはフィルタリングすると、10.230.230.1 が複数表示される場合があります。これは、Insights の難読化機能が使用する Python データクリーニングプロセスによって、アーカイブファイル内に同じ難読化された IP アドレスが生成される可能性があるためです。

5.3. ホスト名の難読化

Insights でシステムのホスト名を難読化すると、/etc/hostname に設定されているホスト名の値が、Red Hat に送信される前に、コンソール GUI とアーカイブファイルでマスクされます。

システムのホスト名を難読化するには、IP アドレスの難読化も有効にする必要があります。ホスト名のみを難読化することはできません。

Insights で難読化が有効になっている場合、/etc/hostnamehostname の値が、Python データクリーニングプロセスによって自動的に生成される 12 文字の UUID に変更されます。

ヒント

システムに 表示名 を割り当てると、難読化されたホストをより簡単に見つけて管理できるようになります。表示名は難読化されず、Insights コンソール UI に表示されます。/etc/hostname の値のみが難読化されます。

前提条件

  • IP アドレスを難読化した。詳細は、IPv4 アドレスの難読化 を参照してください。
  • Red Hat Satellite を使用してクライアントを管理し、console.redhat.com に登録する場合は、ホスト名の難読化を有効にする前に次の手順を実行する。

    • Satellite Web UI で、Red Hat Cloud 設定に移動し、Obfuscate host names オプションを有効にします。

手順

  1. エディターで /etc/insights-client/insights-client.conf ファイルを開きます。
  2. obfuscate_hostname がある行を見つけます。

    #obfuscate_hostname=False
  3. # を削除し、FalseTrue に変更します。

    obfuscate_hostname=True
  4. (オプション) Insights コンソール UI で難読化されたホストを見つけて管理できるように、次のように、insights-client.conf ファイルでシステムの表示名を設定します。

    display_name=example-display-name
    注記

    次のコマンドを使用して、コンソールで表示名を設定することもできます。

    [root@insights]# insights-client --display-name ITC-4
  5. /etc/insights-client/insights-client.conf ファイルを保存して閉じます。

結果

難読化が正常に有効化されると、ホスト名は Insights コンソール UI、ログ、および Red Hat が収集するすべてのアーカイブデータファイルでマスクされます。

注記
  • 複数のシステムでホスト名の難読化を設定すると、難読化の結果として、Red Hat Insights for Red Hat Enterprise Linux GUI にホスト名が同じシステムが複数表示されることがあります。表示名を設定すると、難読化されたホストをより簡単に識別できるようになります。
  • 難読化を有効にした後も、一部の insights-client コマンドのコマンドライン出力には、元のホスト名が表示される場合があります。

  • /etc/hostname 内にあるシステムの元のホスト名:

    RTP.data.center.01
  • Red Hat Insights for Red Hat Enterprise Linux に表示される難読化された /etc/hostname:

    90f4a9365ce0.example.com
  • 次の Red Hat Hybrid Cloud Console UI のスクリーンショットは、ホスト名と IP アドレスが難読化されたシステムの例を示しています。

    An example of an obfuscated hostname in the Red Hat Hybrid Cloud Console UI

第6章 Insights クライアントデータリダクション

Red Hat Insights は、Insights コアコレクションを使用してデータ収集を処理します。.cache.json、.uploader.json などの限定的な JSON ファイルやシェルスクリプトに代わって、リダクションを目的としてコアコレクションが使用されます。さらに、コアコレクションは以下の特徴があります。

  • Insights クライアント 3.0 以降と互換性があります。
  • YAML ファイルを使用して、編集するコマンドとファイルを決定します。
  • 堅牢な Python データクリーニングプロセスを使用します。
  • データソース を使用した複雑なデータ収集をサポートし、uploader.json やシェルスクリプトなどの JSON ファイルの使用に伴う制限を回避します。
  • より簡単に管理できるデータソースを使用して、どのデータソースが insights-core の一部であるかを知ることができます。

Red Hat Insights クライアントのコアコレクション、データソース、およびコレクションルールの詳細は、次のリソースを参照してください。

重要

Red Hat では .cache.json および uploader.json ファイルを使用したデータの編集をサポートしません。代わりに データソース を使用してください。

個人を特定できる情報 (PII) の収集を防止する

Red Hat Insights for Red Hat Enterprise Linux は、個人を特定できる情報 (PII) を含む可能性のあるデータを含め、最小限のデータを収集します。PII (またはその他の設定データ) が収集されないようにするには、データリダクションを適用します。

Red Hat Insights for Red Hat Enterprise Linux がデータ収集を処理する方法は、Red Hat Insights データおよびアプリケーションセキュリティー を参照してください。

6.1. 必要なリダクション YAML ファイルの作成と設定

Red Hat Insights でデータを編集するには、Insights クライアント 3.0 と、リダクションアクションを制御するための次の YAML 設定ファイルが必要です。

  • file-redaction.yaml
  • file-content-redaction.yaml

リダクションするコンテンツに合わせて、1 つまたは両方のファイルを使用できます。

編集する項目を見つけるために、Insights クライアントは、insights-client.conf 設定ファイルのデフォルト設定を使用して、file-redaction.yaml および file-content-redaction.yaml ファイルを呼び出します。次の例は insights-client.conf ファイル内のリダクションのデフォルト設定の例を示しています。

# Location of the redaction file for commands, files, and components
#redaction_file=/etc/insights-client/file-redaction.yaml

# Location of the redaction file for patterns and keywords
#content_redaction_file=/etc/insights-client/file-content-redaction.yaml

insights-client.conf ファイルの設定を変更する必要はありませんが、YAML ファイルを作成する必要があります。

重要

Red Hat は、データをリダクションする remove.conf 設定ファイルの使用をサポートしなくなりました。

YAML ファイルの仕組み

Insights クライアントの /etc/insights-client/file-redaction.yaml ファイルには、リダクションを適用するコマンドとファイルがリストされます。Python データクリーニングプロセスは file-redaction.yaml ファイルで実行され、リストされているコマンドとファイルにリダクションを適用します。

注記

Python データクリーニングプロセスが実行されると、指定されたコンテンツがアーカイブファイルに追加される前に、リダクションが適用されます。

/etc/insights-client/file-content-redaction.yaml は、パターンのリダクションとキーワードの置換を定義します。パターンリダクションの場合、プロセスは、YAML ファイルで指定されたものと一致するパターンまたは正規表現をリダクションします。キーワード置換の場合、プロセスは指定されたキーワードを汎用識別子に置き換えます。

6.1.1. コマンドとシステムファイルをリダクションするための file-redaction.yaml の設定

/etc/insights-client/file-redaction.yaml ファイルを作成し、リダクションを適用するコマンドとシステムファイルのリストを含めることができます。データのリダクションが行われると、Python データクリーニングプロセスが実行され、YAML ファイルの内容が分析されます。

注記

リストされたコマンドまたはファイルの出力は、アップロードされたアーカイブファイルに含まれません。

前提条件

  • YAML 構文の基本を理解している。YAML の詳細は、yaml.org を参照してください。
  • システムへのルートレベルのアクセスがある。

手順

  1. エディターを使用して /etc/insights-client/file-redaction.yaml ファイルを作成します。
  2. YAML ファイル内の別々の行に、文字列 files:commands: を入力します。

    files:
    
    
    commands:
  3. リダクションを適用するファイルおよびコマンドを指定します。

    1. files: の次の行に、リダクションするファイルを入力します。Datasources catalog の情報を使用して、指定するファイルとコマンドを識別します。たとえば、auditd.conf ファイルをリダクションする場合は、次のようになります。

      files:
        - /etc/audit/auditd.conf
    2. commands: の後の行に、リダクションするコマンドを入力します。Datasources catalog の情報を使用して、指定するコマンドを識別します。たとえば、ethtool -i コマンドをリダクションする場合は、次のようになります。

      commands:
        - ethtool_i
  4. YAML ファイルを /etc/insights-client/ に保存します。
  5. コマンドラインで ll file-redaction.yaml を root として実行して、file-redaction.yaml ファイルの権限が root 所有者のみであることを確認します。

    [root@insights]# ll file-redaction.yaml
    -rw-------. 1 root root 145 Sep 25 17:39 file-redaction.yaml

コメント付きの file-redaction.yaml ファイルの例

次の例は、リダクションを適用するコマンドとファイルを含むサンプルの file-redaction.yaml ファイルを示しています。コメント (行頭にハッシュ記号 (#) がある) も YAML ファイルの設定で便利なガイドとなります。

# file-redaction.yaml
---
# Redact the entire output of commands
# Specify commands by either full command or by the "symbolic_name" like “ethtool_i.”
# Refer to the “Datasource Catalog” and “General Datasources” at https://insights-core.readthedocs.io/en/latest/specs_catalog.html#general-datasource for a full list of available symbolic_names, and the commands and files they correspond to.

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

# Redact the entire output of files
# Specify files either by full filename or
by the "symbolic_name" for example, “cluster_conf.”
# Refer to the “Datasource Catalog” and “General Datasources” at https://insights-core.readthedocs.io/en/latest/specs_catalog.html#general-datasource for a full list of available symbolic_names, and the commands and files they correspond to.

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

検証手順

リダクションファイルが機能していることを確認するには、--no-upload オプションを指定して insights-client コマンドを実行し、コンソールまたはターミナルで出力メッセージを確認します。

  1. コマンドラインで、--no-upload オプションを指定して insights-client コマンドを入力し、Return を押します。

    [root@insights]# insights-client --no-upload
  2. コマンドが実行され、情報メッセージが表示されます。次の例は、dmesg コマンドと cluster.conf ファイルのリダクションを示しています。

    WARNING: Excluding data from files
    Starting to collect Insights data for I-HOST
    WARNING: Skipping command /bin/dmesg
    WARNING: Skipping file /etc/cluster/cluster.conf
    Archive saved at /var/tmp/qsINM9/insights-ITC-4-20190925180232.tar.gz

生成されたアーカイブファイルは /var/tmp に保存されますが、Red Hat にアップロードされません。

6.1.2. YAML パターンおよびキーワードリダクションの設定

/etc/insights-client/file-content-redaction.yaml ファイルは、パターンリダクションとキーワード置換の 2 つの方法を使用してファイルをリダクションします。パターンリダクションは、パターンマッチまたは正規表現マッチのいずれかを使用します。キーワード置換では、Python データクリーニングプロセスによってキーワードが汎用識別子に置き換えられます。

前提条件

  • YAML 構文の基本を理解している。YAML の説明は、この手順の範囲外です。
  • システムへのルートレベルのアクセスがある。

手順

  1. エディターを使用して /etc/insights-client/file-content-redaction.yaml ファイルを作成します。

    # 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"
    
    # Regular expression pattern redaction per line
    #  Use "regex:" to wrap patterns with regular expressions"
    # Example
    
    patterns:
     regex:
     - "abc.*def"
     - "localhost[[:digit:]]"
    
    
    # Keyword replacement redaction
    #  Replace keywords in files and command output with generic identifiers
    #  Keyword does not support regex
    # Example
    
    keywords:
    - "1.1.1.1"
    - "My Name"
    - "a_name"

  2. file-content-redaction.yaml ファイルのパーミッションが root 所有者にのみ設定されていることを確認してください。

    [root@insights]# ll file-content-redaction.yaml
    -rw-------. 1 root root 145 Sep 25 17:39 file-content-redaction.yaml

6.2. Insights クライアントアーカイブの確認

アーカイブファイルの内容を確認できます。アーカイブファイルを検証して、Red Hat に送信されるデータを確認できます。

難読化またはリダクションを使用すると、アップロードする前にアーカイブを検査できます。アーカイブファイルを保存する場合は、システムにそのまま保管できます。

6.2.1. アップロード前のアーカイブの検証

Python データクリーニングスクリプトがアーカイブを Red Hat Insights for Red Hat Enterprise Linux にアップロードする前にアーカイブを検査するには、--no-upload オプションを指定して insights-client コマンドを実行し、ファイルをアップロードせずに保存します。これにより、クライアントが Insights for Red Hat Enterprise Linux に送信する情報を表示し、難読化またはリダクションの設定を確認できます。

アーカイブファイルは /var/tmp/ ディレクトリーに保存されます。insights-client が完了すると、ファイル名が表示されます。

前提条件

  • /etc/insights-client/insights-client.conf ファイルが正しく設定されている。

手順

  1. --no-upload オプションを指定して insights-client コマンドを入力します。

    [root@insights]# insights-client --no-upload

    このコマンドでは、リダクションまたは難読化の適用時に、情報メッセージが表示されます。

    WARNING: Excluding data from files
    Starting to collect Insights data for ITC-4
    WARNING: Skipping patterns found in remove.conf
    WARNING: Skipping command /bin/dmesg
    WARNING: Skipping command /bin/hostname
    WARNING: Skipping file /etc/cluster/cluster.conf
    WARNING: Skipping file /etc/hosts
    Archive saved at /var/tmp/qsINM9/insights-ITC-4-20190925180232.tar.gz
  2. Archive saved at メッセージのように、一時ストレージディレクトリーに移動します。

    [root@insights]# cd /var/tmp/qsINM9/
  3. 圧縮された tar.gz ファイルをデプロイメントします。

    [root@insights]# tar -xzf insights-ITC-4-20190925180232.tar.gz

    スクリプトは、ファイルを含む新しいディレクトリーを作成します。

6.2.2. アップロード後の Insights クライアントアーカイブの検証

Python データクリーニングスクリプトによってアーカイブが Red Hat Insights for Red Hat Enterprise Linux にアップロードされた後も、検査用にアーカイブのコピーを保持するには、insights-client を実行してファイルを保存します。これにより、クライアントが Insights for Red Hat Enterprise Linux に送信する情報を確認し、難読化またはリダクションの設定を確認できます。

前提条件

  • /etc/insights-client/insights-client.conf ファイルが正しく設定されている。

手順

  1. --keep-archive オプションを指定して insights-client コマンドを入力します。

    [root@insights]# insights-client --keep-archive

    このコマンドでは、情報メッセージが表示されます。

    Starting to collect Insights data for ITC-4
    Uploading Insights data.
    Successfully uploaded report from ITC-4 to account 6229994.
    Insights archive retained in /var/tmp/ozM8bY/insights-ITC-4-20190925181622.tar.gz
  2. Insights archive retained in メッセージで表示されるように、一時ストレージディレクトリーに移動します。

    [root@insights]# cd /var/tmp/ozM8bY/
  3. 圧縮された tar.gz ファイルをデプロイメントします。

    [root@insights]# tar -xzf insights-ITC-4-20190925181622.tar.gz

    スクリプトは、ファイルを含む新しいディレクトリーを作成します。

第7章 システムのフィルタリングとグループ

Red Hat Insights for Red Hat Enterprise Linux を使用すると、個々のサービスだけでなく、インベントリーでシステムをフィルタリングできます。Insights for Red Hat Enterprise Linux では、次の 3 つの基準でシステムのグループをフィルタリングすることもできます。

  • SAP ワークロードを実行するグループ
  • Satellite ホストグループ
  • YAML ファイルで定義するカスタムフィルター
注記

2022 年春の時点で、インベントリー、アドバイザー、コンプライアンス、脆弱性、パッチ、およびポリシーで、グループとタグによるフィルタリングが有効になります。その他のサービスは後から続きます。

グローバルの Filter Results ボックスを使用して、SAP ワークロード、Satellite ホストグループ、または Insights クライアント設定に追加されたカスタムフィルター、および Insights クライアント設定ファイルに追加されたファイルフィルター別にフィルタリングします。

前提条件

お使いのシステムで次の手順を完了するようにしてください。

  • root レベルの権限でログインする。
  • Insights クライアントをインストールする。

7.1. SAP ワークロード

2025 年に Linux は SAP ERP ワークロードの必須オペレーティングシステムになるため、Red Hat Enterprise Linux および Red Hat Insights for Red Hat Enterprise Linux では、Insights for Red Hat Enterprise Linux が SAP 管理者に選ばれる管理ツールとなるように取り組んでいます。

この継続的な取り組みの一環として、Insights for Red Hat Enterprise Linux は、管理者によるカスタマイズを必要とせずに、SAP ワークロードを実行しているシステムに SAP ID (SID) によって自動的にタグを付けます。Insights for Red Hat Enterprise Linux アプリケーション全体でこれらのワークロードをフィルター処理するには、グローバルの Filter Results ドロップダウンメニューを使用します。

7.2. Satellite ホストグループ

Satellite ホストグループは Satellite で設定され、Insights for Red Hat Enterprise Linux で自動的に認識されます。

7.3. システムタグ付けのカスタム

システムにカスタムのグループ化とタグ付けを適用できます。これにより、コンテキストマーカーを個々のシステムに追加したり、Insights for Red Hat Enterprise Linux アプリケーションでこれらのタグでフィルター処理したり、関連するシステムに簡単に注目したりできます。この機能は、何百または何千ものシステムが管理されている環境で、Red Hat Enterprise Linux の Insights を大規模にデプロイメントする場合に特に価値があります。

複数の Insights for Red Hat Enterprise Linux サービスにカスタムタグを追加する機能に加えて、定義済みタグを追加できます。advisor サービスは、これらのタグを使用して、より高いレベルのセキュリティーを必要とするシステムなど、より注意が必要なシステムに的を絞った推奨事項を作成できます。

7.3.1. フィルター構造

フィルターは、namespace=value または key=value のペア構造を使用します。

  • 名前空間。名前空間は、取り込みポイントの名前である insights-client です。この値は変更できませんこの tags.yaml ファイルは名前空間から抽象化され、アップロード前にクライアントによってインジェクトされます。
  • キー。キーを作成するか、システムから事前定義されたキーを使用できます。大文字、文字、数字、記号、および空白文字の組み合わせを使用できます。
  • 値。独自の説明的な文字列値を定義できます。大文字、文字、数字、記号、および空白文字の組み合わせを使用できます。

7.3.2. カスタムグループおよび tags.yaml ファイルの作成

タグを作成して /etc/insights-client/tags.yaml に追加するには、insights-client--group=<name-you-choose> オプションとともに使用します。このコマンドオプションは、次のアクションを実行します。

  • etc/insights-client/tags.yaml ファイルを作成します。
  • group= キーおよび <name-you-choose> の値を tags.yaml に追加します。
  • システムから Insights for Red Hat Enterprise Linux アプリケーションに新規アーカイブをアップロードすることで、最新の結果とともに新しいタグがすぐに表示されます。

前提条件

  • システムへのルートレベルのアクセスがある。

手順

  1. 次のコマンドを root として実行し、<name-you-choose> の代わりにカスタムグループ名を追加します。

    [root@server ~]# insights-client --group=<name-you-choose>
  2. オプション:タグを追加するには、/etc/insights-client/tags.yaml ファイルを編集します。
  3. Inventory > Systems に移動し、必要に応じてログインします。
  4. Filter by tags ドロップダウンメニューをクリックします。検索ボックスを使用してタグ名のすべてまたは一部を入力すると、タグ内にそのテキストが含まれるシステムが自動的に表示されます。
  5. リストを下にスクロールしてタグを見つけます。
  6. タグをクリックしてフィルター処理を行います。
  7. システムが、アドバイザーシステムリストの結果に含まれていることを確認します。

    1. Inventory > Systems に移動し、必要に応じてログインします。
    2. Name フィルターをアクティブにし、システムが表示されるまでシステム名を入力してから選択します。
    3. タグの記号は濃い色で、その横の数字は実際に適用されたタグの数を示します。

7.3.3. タグの追加または変更を行うための tags.yaml の編集

group タグを作成したら、tags.yaml の内容を編集して、タグを追加または変更できます。

以下の手順では、/etc/insights-client/tags.yaml ファイルを編集し、Red Hat Insights > RHEL > Inventory にタグが存在することを確認する方法を説明します。

前提条件

  • システムへのルートレベルのアクセスがある。

手順

  1. タグ設定ファイル tags.yaml をエディターで開きます。

    [root@server ~]# vim /etc/insights-client/tags.yaml
  2. ファイルの内容を編集するか、key=value ペアを追加します。必要に応じて、追加の key=value ペアを追加します。大文字、文字、数字、記号、および空白文字の組み合わせを使用します。以下の例は、システムに複数のタグを追加するときに tags.yaml を整理する方法を示しています。

    # tags
    ---
    group: _group-name-value_
    location: _location-name-value_
    description:
    - RHEL8
    - SAP
    key 4: value
  3. 変更を保存してエディターを閉じます。
  4. Insights for Red Hat Enterprise Linux へのアップロードを生成します。

    [root@server ~]# insights-client
  5. Inventory > Systems に移動し、必要に応じてログインします。
  6. Filter Results ボックスで、下矢印をクリックし、フィルターの 1 つを選択するか、フィルターの名前を入力して選択します。

    注記

    タグキーまたはその値で検索できます。

  7. 結果でシステムを検索します。
  8. フィルターアイコンが禁止され、システムに適用されるフィルターの数を示す数字が表示されることを確認します。

7.4. 定義済みのシステムタグを使用した Red Hat Insights advisor サービスの推奨事項の精度とセキュリティーの向上

Red Hat Insights advisor サービスの推奨事項は、すべてのシステムを同等に扱います。ただし、システムによっては、他のシステムよりも高いレベルのセキュリティーが必要な場合や、異なるネットワークパフォーマンスレベルが必要な場合があります。カスタムタグを追加する機能に加えて、Red Hat Insights for Red Hat Enterprise Linux は定義済みタグを提供します。advisor サービスはこれを使用して、より注意が必要な可能性のあるシステムに的を絞った推奨事項を作成できます。

定義済みタグによって提供される拡張されたセキュリティー強化と強化された検出および修復機能をオプトインして取得するには、タグを設定する必要があります。設定後、advisor サービスは、調整された重大度レベルと、システムに適用されるネットワークパフォーマンス設定に基づいて推奨事項を提供します。

タグを設定するには、/etc/insights-client/tags.yaml ファイルを使用して、インベントリーサービスでシステムにタグを付ける場合と同様の方法で、定義済みタグを使用してシステムにタグを付けます。定義済みタグは、カスタムタグの作成に使用されるのと同じ key=value 構造を使用して設定されます。Red Hat の定義済みタグの詳細を次の表に示します。

表7.1 サポートされている定義済みタグのリスト
キー注記

security

normal (デフォルト) / strict

default を使用すると、advisor サービスは、システムのリスクプロファイルを、RHEL の最新バージョンのデフォルト設定および頻繁に使用される使用パターンから導出されたベースラインと比較します。これにより、推奨事項の焦点があっており、アクション可能で、数を減らすことができます。strict 値を使用すると、advisor サービスはセキュリティーが重要なシステムであると見なし、特定の推奨事項でより厳密なベースラインが使用されるようになり、新しい最新の RHEL インストールでも推奨事項が表示される可能性があります。

network_performance

null (デフォルト) / latency / throughput

ネットワークパフォーマンス設定 (ビジネス要件に応じたレイテンシーまたはスループット) は、システムに対する advisor サービスの推奨事項の重大度に影響します。

注記

定義済みタグのキー名は予約されています。定義済みの値とは異なる値を持つキー security をすでに使用している場合、推奨事項に変更は加えられません。既存の key=value がいずれかの定義済みのキーと同じ場合にのみ、推奨事項に変更が加えられます。たとえば、key=valuesecurity: high の場合、Red Hat の定義済みタグが原因で、推奨事項は変更されません。key=value ペアが security: strict である場合は、システムの推奨事項に変更が加えられます。

7.4.1. 定義済みタグの設定

Red Hat Insights for Red Hat Enterprise Linux advisor サービスの定義済みタグを使用すると、システムの推奨事項の動作を調整し、拡張されたセキュリティー強化と強化された検出および修復機能を得ることができます。以下の手順に従って、事前定義されたタグを設定できます。

前提条件

  • システムへのルートレベルのアクセスがある。
  • Insights クライアントがインストールされている。
  • Insights クライアント内にシステムが登録されている。
  • tags.yaml ファイルを作成している。tags.yaml ファイルの作成については、tags.yaml ファイルの作成とカスタムグループの追加 を参照してください。

手順

  1. コマンドラインと任意のエディターを使用して、/etc/insights-client/tags.yaml を開きます。(次の例では Vim を使用しています。)

    [root@server ~]# vi /etc/insights-client/tags.yaml
  2. /etc/insights-client/tags.yaml ファイルを編集して、タグの定義済みの key=value ペアを追加します。この例は、security: strict および network_performance: latency タグを追加する方法を示しています。

    # cat /etc/insights-client/tags.yaml
    group: redhat
    location: Brisbane/Australia
    description:
    - RHEL8
    - SAP
    security: strict
    network_performance: latency
  3. 変更を保存します。
  4. エディターを終了します。
  5. オプション: Insights-client コマンドを実行して、Red Hat Insights for Red Hat Enterprise Linux へのアップロードを生成するか、次のスケジュールされた Red Hat Insights アップロードまで待ちます。

    [root@server ~]# insights-client

定義済みタグが実稼働環境にあることの確認

Red Hat Insights へのアップロードを生成した後 (または、次の Insights アップロードのスケジュールを待った後)、Red Hat Insights > RHEL > Inventory にアクセスして、タグが実稼働環境にあるかどうかを確認できます。システムを見つけて、新たに作成されたタグを探します。次のことを示す表が表示されます。

  • 名前
  • タグソース (例: insights-client)。

次のイメージは、タグを作成した後にインベントリーに表示される内容の例を示しています。

現在の名前と値、タグソースを示す強調表示された情報

定義済みタグを適用した後の推奨事項の例

次の図では、advisor サービスは network_performance: latency タグが設定されたシステムを示しています。

合計リスクがより高い重要な推奨事項と、合計リスクが中程度の推奨事項を表示

システムは、総リスク (重要に分類) が高い推奨事項を表示します。network_performance: latency タグのないシステムの場合、総リスクは中程度に分類されます。総リスクの高さに基づいて、システムの優先順位付けに関する決定を行うことができます。

第8章 insights-client スケジュールの変更

Insights クライアントを実行するタイミングを制御するスケジュールを無効化、有効化、および変更できます。デフォルトでは、Insights クライアントは 24 時間ごとに実行します。全システムが同時にクライアントを実行しないように、デフォルトのタイマーのスケジューリングは異なります。

8.1. Insights クライアントスケジュールの無効化

デフォルトの Insights クライアント設定を変更して新しいスケジュールを作成する前に、クライアントスケジュールを無効にする必要があります。

insights-client スケジュールを無効にするために使用する手順は、Red Hat Enterprise Linux とクライアントのバージョンによって異なります。

8.1.1. クライアント 3.x を使用した RHEL 6、RHEL 7 以降のクライアントスケジュールの無効化

注記

--no-schedule オプションは、クライアント 3.x 以降で非推奨になりました。

前提条件

  • システムへのルートレベルのアクセスがある。

手順

  1. --version オプションを指定して insights-client コマンドを入力し、クライアントのバージョンを確認します。

    [root@insights]# insights-client --version
    Client: 3.0.6-0
    Core: 3.0.121-1
  2. --disable-schedule オプションを指定して insights-client コマンドを入力し、クライアントスケジュールを無効にします。

    [root@insights]# insights-client --disable-schedule

8.2. Insights クライアントスケジュールの有効化

クライアントスケジュールを最初に有効にすると、デフォルトの設定を使用して実行します。スケジュールを変更すると、それらの設定が優先されます。

コマンドラインから insights-client を実行すると、Insights クライアントは、そのセッションに対してのみ指定した設定を使用して実行します。次にスケジュールされた実行が行われるときは、デフォルト設定が使用されます。

8.2.1. RHEL 7 以降および Client 3.x での Insights クライアントスケジュールの有効化

クライアントスケジュールを有効にして、デフォルト設定で実行できます。デフォルトのスケジュール設定を変更すると、変更された設定が優先されます。

前提条件

  • システムへのルートレベルのアクセスがある。
  • クライアントスケジュールが無効になっている。
  • (オプション) デフォルトのスケジュールを変更している。

手順

  1. クライアントのバージョンを確認するには、insights-client コマンドに --version オプションを指定して入力します。

    [root@insights]# insights-client --version
    Client: 3.0.6-0
    Core: 3.0.121-1
  2. --enable-schedule オプションを指定して Insights -client コマンドを入力し、クライアントスケジュールを有効にします。

    [root@insights]# insights-client --enable-schedule

8.3. Insights クライアントスケジュールの変更

Insights クライアントがいつ実行するかを変更するには、スケジュールを変更します。使用する方法は、システムが実行している RHEL のリリースとクライアントのバージョンによって異なります。

RHEL のバージョンに合った手順を選択します。

  • Red Hat Enterprise Linux 7.4 以前の場合は、cron を使用してシステムスケジュールを変更します。
  • Red Hat Enterprise Linux 7.5 以降の場合は、systemd 設定と insights-client-timer ファイルを更新します。

8.3.1. systemd 設定を使用した insights-client のスケジューリング

注記

Client 3.x で RHEL 7.5 以降を実行しているシステムにこれを使用します。

システムの systemd 設定および insights-client.timer ファイルを更新して、デフォルトの insights-client 実行スケジュールを変更できます。

前提条件

  • システムへのルートレベルのアクセスがある。

手順

  1. insights-client.timer ファイルの設定を編集するには、systemctl edit コマンドとファイル名を入力します。

    [root@insights]# systemctl edit insights-client.timer

    この動作により、デフォルトのシステムエディターで空のファイルが開きます。

  2. 別の設定を入力してスケジュールを変更します。この例の値は、systemd のデフォルト設定です。

    [Timer]
    OnCalendar=daily
    RandomizedDelaySec=14400
  3. insights-client スケジュールを有効にします。

    [root@insights]# insights-client --enable-schedule

関連情報

  • systemctl(1)systemd.timer(5)、および systemd.time(7) のマニュアルページを確認して、systemd を理解してください。
  • cron およびその使用方法

8.3.2. Red Hat Satellite に管理されるシステムのパッケージキャッシュを更新する

Insights では、Satellite 管理システムに適用可能な更新に関する正確なレポートを提供するために、オプションの --build-packagecache コマンドが提供されるようになりました。このオプションは、insights-clientyum/dnf パッケージキャッシュを再構築し、システムに適用可能な更新の更新リストを作成します。

コマンドを手動で実行してパッケージキャッシュをすぐに再構築することも、クライアント設定ファイル (/etc/insights-client/insights-client.conf) を編集して、システムが Insights にチェックインするたびにパッケージキャッシュを自動的に再構築することもできます。

関連情報

第9章 Insights の自動ルール更新の有効化および無効化

デフォルトでは、Insights のコレクションルールの自動更新が有効になっています。クライアント設定ファイルを編集して、それらを無効にしたり、再度有効にしたりすることができます。

9.1. Insights の自動ルール更新の無効化

Red Hat Insights for Red Hat Enterprise Linux の自動コレクションルールの更新を無効にできます。これを実行する場合は、古いルール定義ファイルを使用し、最新の検証更新を取得しないリスクがあります。

前提条件

  • システムへのルートレベルのアクセスがある。
  • 自動ルール更新が有効になっています。

手順

  1. エディターで /etc/insights-client/insights-client.conf ファイルを開きます。
  2. 以下の内容が含まれる行を見つけます。

    #auto_update=True
  3. # を削除し、TrueFalse に変更します。

    auto_update=False
  4. /etc/insights-client/insights-client.conf ファイルを保存して閉じます。

9.2. Insights の自動ルール更新を有効にする

以前に更新を無効にしている場合は、Red Hat Insights for Red Hat Enterprise Linux のコレクションルールの自動更新を再度有効にできます。デフォルトでは、ルール自動更新は有効になっています。

前提条件

  • システムへのルートレベルのアクセスがある。
  • 自動ルール収集が無効になっています。

手順

  1. エディターで /etc/insights-client/insights-client.conf ファイルを開きます。
  2. 以下の内容が含まれる行を見つけます。

    auto_update=False
  3. FalseTrue に変更します。

    auto_update=True
  4. /etc/insights-client/insights-client.conf ファイルを保存して閉じます。

第10章 サポート用の診断ログの作成

Red Hat サポートチームのサポートが必要な場合は、診断ログファイルを作成して共有できます。このログファイルは、サポートチームが insights-client に関する問題のトラブルシューティングを行う際に役立ちます。

10.1. 診断ログの作成

サポートチームと共有する診断ログを作成できます。

前提条件

  • システムへのルートレベルのアクセスがある。

手順

  1. --support オプションを指定して insights-client コマンドを入力します。

    [root@insights]# insights-client --support

    このコマンドは、サポートファイルの作成時に情報メッセージを表示します。

    Collecting logs...
    Insights version: insights-core-3.0.121-1
    Registration check:
    status: True
    unreachable: False
    . . . .
    Copying Insights logs to archive...
    Support information collected in /var/tmp/H_Y43a/insights-client-logs-20190927144011.tar.gz
  2. メッセージで Support information collected in に表示されているコレクションディレクトリーに移動します。

    [root@insights]# cd /var/tmp/H_Y43a
  3. 圧縮された tar.gz ファイルをデプロイメントします。

    [root@insights]# tar -xzf insights-client-logs-20190927144011.tar.gz

    tar.gz ファイルを解凍すると、ログファイルを含む新しいディレクトリーが作成されます。依頼を受けた場合は、サポートチームと tar.gz ファイルを共有してください。

付録A insights-client のコマンドオプション

root 権限を持つシステム管理者は、insights-client コマンドとそのオプションを使用して、システムでの Insights クライアントの操作を制御できます。insights-client.rpm は Insights for Red Hat Enterprise Linux の個々のコンポーネントよりも更新頻度が低いため、man ページには insights-client コマンド操作に関する最新情報が含まれていない可能性があります。

insights-client コマンドを入力するたびに、クライアントはデータを収集し、それを Insights for Red Hat Enterprise Linux に送信します。

注記

insights-client --display-name コマンドを使用して表示名を設定すると表示名はすぐに有効になりますが、Insights クライアントは実行されません。

A.1. Insights クライアントのオプション

表A.1 insights-client ユーザーコマンドオプション
オプション説明

--help

-h

ヘルプ情報を表示します

--register

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

--unregister

Insights for Red Hat Enterprise Linux からホストを登録解除します。

--display-name=DISPLAY_NAME

GUI でホスト表示名を設定または変更します。/etc/hostname で指定された名前とは異なる名前を使用する場合は、ホストの登録時に --register と共に使用して display_name の値を設定します。登録後に --display-name オプションを使用して、Insights インベントリーでこのホストに表示される名前を上書きすることもできます。

--group=GROUP

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

--retry=RETRIES

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

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

--validate

/etc/insights-client/tags.yaml/etc/insights-client/file-redaction.yaml/etc/insights-client/file-content-redaction.yaml ファイルを検証します。

--quiet

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

--silent

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

--enable-schedule

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

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

--disable-schedule

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

--conf=CONF

-c=CONF

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

--no-upload

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

--offline

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

--logging-file=LOGFILE

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

--diagnosis

API から診断情報を取得します。--diagnosis を使用する前に、システムが少なくとも 1 回は登録され、アップロードされていることを確認する必要があります。

--compliance

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

--compliance-policies

システムに割り当てることができるすべてのポリシーをリスト表示し、次のカテゴリーについて出力テーブルに役立つ情報を提供します。

  • Assigned: ポリシーのステータスを False (システムにポリシーが割り当てられていない) または True (システムにポリシーが割り当てられている) として表示します。
  • ID: ポリシーの一意の ID (UUID) をリスト表示します。
  • Title: システムを追加できる Security Content Automation Protocol (SCAP) ポリシーの名前をリスト表示します。

--compliance-assign

insights-client --compliance-policies から出力される ID を使用して、システムをポリシーに割り当てます。

--compliance-unassign

insights-client --compliance-policies から出力される ID を使用して、ポリシーからのシステムの割り当て解除します。

--payload=PAYLOAD

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

--content-type=TYPE

PAYLOAD のコンテンツタイプを設定します。タイプは、gzbz2xz、または none になります。TYPE の値は、ペイロードファイルで使用される --compressor と一致させる必要があります。

--show-results

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

--output-dir=DIR

アップロードする代わりに、コレクションを指定されたディレクトリーに書き込みます。

--output-file=FILE

コレクションをアップロードする代わりに、指定されたアーカイブに書き込みます。

--ansible-host=ANSIBLE_HOST

Red Hat Insights インベントリーで Ansible ホスト名を設定または変更します。/etc/hostname または設定ファイルで指定された名前とは異なる名前を設定する場合は、登録時にこのオプションを使用します。このオプションを使用して、Red Hat Insights 修復によって生成された、このホストを対象とする Playbook に挿入されたホスト名を上書きすることもできます。

--list-specs

insights-client コレクションの仕様を表示します。

--build-packagecache

システムパッケージマネージャーのキャッシュを更新します。

--manifest=MANIFEST

Insights Core が収集する内容を定義する指定されたマニフェスト YAML ファイル。

--checkin

完全なアップロードではなく、軽量のチェックインを実行します。

--collector=APP

指定されたアプリケーションを実行し、その結果のアーカイブをアップロードします。

たとえば、次のように指定します。

  • --collector malware-detection は、Red Hat Insights を使用してマルウェアの存在を検出します。詳細は、関連情報 セクションを参照してください。
  • --collector compliance は、Red Hat Insights に OpenSCAP を使用してシステムをスキャンし、レポートをアップロードするように指示します。このアクションは、代わりに `--compliance` オプションを使用することによっても実行できます。

さらに、Insights クライアント操作をデバッグする必要がある場合は、次の insights-client コマンドオプションを使用します。

表A.2 insights-client デバッグオプション
オプション説明

--version

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

--test-connection

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

--verbose

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

--no-upload

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

--keep-archive

アップロード後、アーカイブを /var/cache/insights-client/ ディレクトリーに保存します。

--support

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

--status

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

--net-debug

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

付録B insights-client のコマンドオプション

/etc/insights-client/insights-client.conf 設定ファイルの設定を使用して、システムでの Insights クライアントの動作を変更できます。

B.1. Insights クライアント設定ファイルのオプション

設定ファイルと CLI に同様のオプションがある場合は、insights-client コマンドを入力すると CLI オプションが実行されます。スケジューラーがクライアントを実行すると、設定ファイルのオプションが実行します。

注記

選択肢は、示されているとおりに正確に入力する必要があります。TrueFalse は、最初の文字を大文字にします。

オプションによって開始された変更は、スケジュールされた次回実行時、または insights-client コマンド入力時に有効になります。オプションは、key=value のペアとしてフォーマットする必要があります。

表B.1 insights-client.conf 設定オプション
オプション説明

ansible_host

Ansible Playbook の実行時に別のホスト名が必要な場合は、このオプションを使用します。

authmethod=CERT

認証方法を設定します。有効なオプションは CERT です。デフォルト値は CERT です。

auto_config=True

Satellite Server での自動設定に使用します。使用できる値は True (デフォルト) または False です。

注記: auto_config=True (デフォルト) の場合、使用する認証方法は CERT です。

auto_update=True

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

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

API のベース URL です。

cmd_timeout=120

収集中に実行されるコマンド用であり、秒単位で測定されます。タイムアウト値に達すると、コマンドプロセスは終了します。

content_redaction_file

コアコレクション内のファイルおよびコマンドから行またはキーワードを省略するために使用します。コアコレクションは、より包括的な結果セットです。

デフォルト設定を変更する必要はありません。content_redaction_file オプションは、デフォルトで /etc/insights-client/file-content-redaction.yaml ファイルを使用します。

display_name

登録時の表示名として使用します。デフォルトは /etc/hostname を使用します。

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

http_timeout=120

HTTP 呼び出し用であり、秒単位で測定されます。タイムアウト値に達すると、コマンドプロセスは終了します。

[insights-client]

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

loglevel=DEBUG

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

obfuscate=False

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

obfuscate_hostname=False

ホスト名を難読化するために使用します。ホスト名を難読化するには、obfuscate=True を設定する必要があります。これにより、IPv4 アドレスの難読化が有効になります。ホスト名のみを難読化することはできません。

proxy

プロキシーの URL に使用します。例: http://user:pass@192.168.100.50:8080

redaction_file

コアコレクションからファイルまたはコマンドを省略するために使用します。コアコレクションは、より包括的な結果セットです。

デフォルト設定を変更する必要はありません。redaction_file オプションは、デフォルトで /etc/insights-client/file-redaction.yaml を使用します。

Red Hat ドキュメントへのフィードバック (英語のみ)

Red Hat ドキュメントに関するフィードバックをお寄せください。いただいたご要望に迅速に対応できるよう、できるだけ詳細にご記入ください。

前提条件

  • Red Hat カスタマーポータルにログインしている。

手順

フィードバックを送信するには、以下の手順を実施します。

  1. Create Issue にアクセスします。
  2. Summary テキストボックスに、問題または機能拡張に関する説明を入力します。
  3. Description テキストボックスに、問題または機能拡張のご要望に関する詳細を入力します。
  4. Reporter テキストボックスに、お客様のお名前を入力します。
  5. Create ボタンをクリックします。

これによりドキュメントに関するチケットが作成され、適切なドキュメントチームに転送されます。フィードバックをご提供いただきありがとうございました。

法律上の通知

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

© 2024 Red Hat, Inc.