2.3.21　Linuxのコンテナを使用した仮想化システムで収集できるデータ

(a)　Dockerホスト環境での注意事項

PFM - Agent for PlatformをDockerホスト環境にインストールしてプロセスの情報を収集する場合，Dockerコンテナ上で稼働しているプロセスの情報を取得するために，Docker Engine APIを使用します。

ここでは，Docker Engine APIの注意事項について説明します。

• PFM - Agent for Platformは，Docker Engine APIを使用し，デフォルトのUNIXドメインソケットの設定でDocker Engineとの通信を行うため，Docker Engine APIのUNIXドメインソケットの設定を変更しないでください。UNIXドメインソケットをデフォルトから変更すると，Docker Engineとの通信に失敗し，PDレコード，PD_APSIレコード，PD_APSレコードで取得するすべてのプロセスのVirtual Env IDフィールドの値が「N/A」となります。

• PFM - Agent for Platformのレコード情報収集時に，Docker Engineとの通信中にエラーが発生した場合，または，Docker Engineとの通信中にDockerコンテナの起動または停止が行われた場合，一部のプロセスについて，Dockerホスト上で動作しているのか，Dockerコンテナ上で動作しているのかが判断できないことがあります。この場合，動作環境を判断できなかったプロセスについて，PDレコード，PD_APSIレコード，およびPD_APSレコードのVirtual Env IDフィールドの値が「N/A」となります。

(b)　Podmanホスト環境での注意事項

PFM - Agent for PlatformをPodmanホスト環境にインストールしてプロセスの情報を収集する場合，PFM - Agent for Platformでは，Podmanコンテナ上で稼働しているプロセスの情報を取得するために，podmanコマンドを使用します。

ここでは，podmanコマンドの注意事項について説明します。

• PFM - Agent for Platformのレコード情報収集時に，podmanコマンドがエラー終了したり，所定時間内に処理が完了しなかったりすると，Podmanホスト環境とPodmanコンテナ環境のどちらで動作しているプロセスであるかを判別できないことがあります。この場合，該当するプロセスについて，PDレコード，PD_APSIレコード，およびPD_APSレコードのVirtual Env IDフィールドの値は「N/A」となります。

• PFM - Agent for Platformでは，次のコマンドを実行してコンテナ一覧を取得します。取得対象となるコンテナはステータスが「Up」のコンテナだけです。ステータスが「Up」でないコンテナ上で動作するプロセスは，ホスト環境のプロセスとして扱います。

  podman ps --all --filter status=running

• Podmanコンテナ内で動作しているプロセスのうち，podman topコマンドでHPID項目が取得できないプロセスは，Podmanホスト環境とPodmanコンテナ環境のどちらで動作しているプロセスであるかを判別できません。この場合，コマンドラインが同じプロセスのPDレコード，PD_APSIレコード，およびPD_APSレコードのVirtual Env IDフィールドの値は常に「N/A」となります。

  また，podman topコマンドがエラー終了し，Podmanホスト環境とPodmanコンテナ環境のどちらで動作しているプロセスであるかを判別できない場合，該当するプロセスについて，PDレコード，PD_APSIレコード，およびPD_APSレコードのVirtual Env IDフィールドの値は「N/A」となります。

• PFM - Agent for Platformでは，ルートレスコンテナ（root以外のユーザーが起動したコンテナ）上で稼働しているプロセスの情報を収集できますが，該当するプロセスをホスト環境のプロセスとして扱います。

• PFM - Agent for Platformで監視するPodmanコンテナの数は30個未満，Podmanコンテナ上のプロセスの数は10個程度を目安としてください。

• PFM - Agent for Platformがプロセス情報を収集しているタイミングでPodmanコンテナを停止すると，Podmanホスト環境のプロセス，および停止したPodmanコンテナ上のプロセスのVirtual Env IDフィールドの値が「N/A」となることがあります。

• Linux 8またはCentOS 8で，PFM - Agent for Platformを12-00から12-50以降にバージョンアップインストールする場合，ALL Container Collection for Processプロパティを「No」に設定していると，次のようにPodmanコンテナ環境のプロセス情報が収集できなくなります。PFM - Agent for Platform 12-50以降でもPodmanコンテナ環境のプロセス情報を継続して収集する場合は，ALL Container Collection for Processプロパティの設定内容を「Yes」に変更する必要があります。

  ALL Container Collection for Processプロパティを「No」に設定している場合のプロセス情報の収集内容

  バージョンアップインストール前

  Podmanホスト環境およびすべてのPodmanコンテナ環境のプロセス情報を収集する

  バージョンアップインストール後

  Podmanホスト環境のプロセス情報だけを収集する

• Linux 8またはCentOS 8で，PFM - Agent for Platformを12-00から12-50以降にバージョンアップインストールする場合，次のようにプロセス情報の収集内容が変わります。PFM - Agent for Platform 12-50以降で該当するプロセス情報を収集する場合は，プロセス監視の設定を見直す必要があります。

  プロセス情報の収集内容

  バージョンアップインストール前

  PDレコード，PD_APSIレコード，およびPD_APSレコードのVirtual Env IDフィールドに「N/A」が格納される

  バージョンアップインストール後

  PDレコード，PD_APSIレコード，およびPD_APSレコードのVirtual Env IDフィールドに「0」やコンテナIDが格納される

(a)　Podmanコンテナ環境での注意事項

ルートレスコンテナ上には，PFM - Agent for Platformをインストールできません。