5.3. レポートの作成方法

スキャン中、各ソースに含まれるシステムごとにファクトのコレクションが収集されます。ファクト とは、オペレーティングシステムのバージョン、CP U コアの数、Red Hat 製品の消費されたエンタイトルメントなど、システムに関する単一のデータです。

ファクトは、各システム用に要約された一連のデータ (フィンガープリントとして知られているデータ) を作成するために処理されます。フィンガープリント とは、アーキテクチャー、オペレーティングシステム、そのシステムにインストールされているさまざまな製品とそのバージョン、そのシステムで使用されるエンタイトルメントなど、一意のシステムとその特性を特定する一連のファクトです。

スキャンジョブを実行すると、フィンガープリントデータが生成されますが、データは 1 種類のレポートのみを作成するために使用されます。詳細レポートを要求すると、フィンガープリントがないスキャンの未加工のファクトが表示されます。デプロイメントレポートを要求すると、重複排除、マージ、処理後のプロセスからの結果を含むフィンガープリントデータを受け取ります。これらのプロセスには、未加工のファクトからインストールされた製品とバージョンの特定、使用されたエンタイトルメントの検索、さまざまなソースからの製品の重複インスタンスの検索とマージ、デフォルト以外の場所にインストールされた製品の検索などが含まれます。

単一のシステムは、スキャン中に複数のソースを確認できます。たとえば、vCenter Server 上の仮想マシンは、Satellite にも管理される Red Hat Enterprise Linux オペレーティングシステムのインストールを実行できます。各タイプの source、vCenter、satellite、および network が含まれるスキャンを作成すると、その 1 つのシステムは、スキャン時に 3 つのソースすべてにより報告されます。

この問題を解決して正確なフィンガープリントを作成するには、スキャンから未処理のシステムのファクトをフィンガーエンジンに提供します。フィンガープリントエンジンは、重複排除とマージプロセスを使用して、複数のソースにあるシステムのデータを照合し、マージします。

システムの重複排除プロセスは、システムに関する特定のファクトを使用して、重複システムを特定します。このプロセスは、これらのファクトを使用して複数のフェーズに移動し、連続して詳細なデータセットで重複したシステムを組み合わせます。

重複排除とマージが完了したら、派生したシステムファクトを作成する処理後のフェーズがあります。派生したシステムファクト は、複数のシステムファクトの評価から生成されたファクトです。派生したシステムファクトの大半は、特定の製品とそのバージョンの存在など、製品識別データに関連します。

以下の例は、派生したシステムファクト system_creation_date の作成方法を示しています。

system_creation_date ファクトは、実際のシステム作成時間が含まれる派生システムファクトです。このファクトの値は、以下のファクトの評価によって決まります。各ファクトの値は、次の優先順位で検査されます。優先順位は、実際のシステム作成時間との一致の精度により決まります。system_creation_date ファクトの値を判断するために、空でない最大値が使用されます。

レポートデータの処理が完了すると、レポート作成プロセスは、JSON (JavaScript Object Notation) およびコンマ区切り変数 (CSV) の 2 つの異なる形式でレポートを作成します。各フォーマットの 詳細 レポートには、未処理で未加工なファクトが含まれ、各形式の デプロイメント レポートには、フィンガープリント、重複排除、マージ、および処理後のプロセスで未処理のファクトが渡された後の出力が含まれます。

このレポート形式は、Red Hat Subscription Education and Awareness Program (SEAP) チームが顧客とのエンゲージメントやその他の Red Hat 社内プロセスで使用するように設計されています。

フィンガープリントは、システム上の製品、エンタイトルメント、ソース、メタデータに加えて、1 つのシステムに関するファクトのセットで構成されています。以下の例は、フィンガープリントデータを示しています。Red Hat 製品がほとんどインストールされていない場合でも、1 台システムのフィンガープリント行は多くなる可能性があります。したがって、この例では部分的なフィンガープリントのみが使用されます。

{
    "os_release": "Red Hat Enterprise Linux Atomic Host 7.4",
    "cpu_count": 4,
    "products": [
        {
            "name": "JBoss EAP",
            "version": null,
            "presence": "absent",
            "metadata": {
                "source_id": 5,
                "source_name": "S62Source",
                "source_type": "satellite",
                "raw_fact_key": null
            }
        }
    ],
    "entitlements": [
        {
            "name": "Satellite Tools 6.3",
            "entitlement_id": 54,
            "metadata": {
                "source_id": 5,
                "source_name": "S62Source",
                "source_type": "satellite",
                "raw_fact_key": "entitlements"
            }
        }
    ],
    "metadata": {
        "os_release": {
            "source_id": 5,
            "source_name": "S62Source",
            "source_type": "satellite",
            "raw_fact_key": "os_release"
        },
        "cpu_count": {
            "source_id": 4,
            "source_name": "NetworkSource",
            "source_type": "network",
            "raw_fact_key": "os_release"
        }
    },
    "sources": [
        {
            "id": 4,
            "source_type": "network",
            "name": "NetworkSource"
        },
        {
            "id": 5,
            "source_type": "satellite",
            "name": "S62Source"
        }
    ]
}

{
    "os_release": "Red Hat Enterprise Linux Atomic Host 7.4",
    "cpu_count": 4,
    "products": [
        {
            "name": "JBoss EAP",
            "version": null,
            "presence": "absent",
            "metadata": {
                "source_id": 5,
                "source_name": "S62Source",
                "source_type": "satellite",
                "raw_fact_key": null
            }
        }
    ],
    "entitlements": [
        {
            "name": "Satellite Tools 6.3",
            "entitlement_id": 54,
            "metadata": {
                "source_id": 5,
                "source_name": "S62Source",
                "source_type": "satellite",
                "raw_fact_key": "entitlements"
            }
        }
    ],
    "metadata": {
        "os_release": {
            "source_id": 5,
            "source_name": "S62Source",
            "source_type": "satellite",
            "raw_fact_key": "os_release"
        },
        "cpu_count": {
            "source_id": 4,
            "source_name": "NetworkSource",
            "source_type": "network",
            "raw_fact_key": "os_release"
        }
    },
    "sources": [
        {
            "id": 4,
            "source_type": "network",
            "name": "NetworkSource"
        },
        {
            "id": 5,
            "source_type": "satellite",
            "name": "S62Source"
        }
    ]
}

フィンガープリントの最初の数行は、オペレーティングシステムや CPU に関するファクトを含む、システムに関するファクトを示しています。この例では、os_release ファクトで、インストールされているオペレーティングシステムとリリースが Red Hat Enterprise Linux Atomic Host 7.4 として説明されています。

次に、フィンガープリントは、products セクションにインストールされている製品をリスト表示します。製品には、name、version、presence、および metadata フィールドがあります。JBoss EAP セクションでは、presence フィールドの値が absent と表示されるため、この例のシステムには Red Hat JBoss Enterprise Application Platform がインストールされていません。

また、フィンガープリントには、entitlements セクションで、そのシステムの消費済みエンタイトルメントも表示されます。リストの各エンタイトルメントには、そのファクトの元のソースを記述する名前、ID、メタデータがあります。フィンガープリントのサンプルでは、システムに Satellite Tools 6.3 のエンタイトルメントがあります。

products セクションおよび entitlements セクションにあるメタデータフィールドに加えて、フィンガープリントには、システムファクトメタデータに使用される metadata セクションが含まれます。システムファクトごとに、フィンガープリントの metadata セクションに対応するエントリーがあります。そのエントリーは、そのシステムファクトの元のソースを識別します。この例では、Satellite Server で os_release ファクトがサテライトソースのスキャンで検出されました。

最後に、フィンガープリントは、sources セクションにこのシステムを含むソースをリスト表示します。システムは、複数のソースに含めることができます。たとえば、スキャンに network ソースと Satellite ソースの両方が含まれていると、スキャンの両方の部分で 1 台のシステムが見つかる可能性があります。