5.2. pmda-openmetrics のインストールと設定
使用を開始する前に、pmda-openmetrics
をインストールして設定する必要があります。次の例は、pmda-openmetrics
を使用して、テキストファイルから単一の数値を PCP メトリクスとして公開する方法を示しています。
前提条件
-
PCP がインストールされており、
pmcd
が実行されている。詳細は、pcp-zeroconf を使用した PCP の設定 を参照してください。
手順
pmda-openmetrics
PMDA をインストールします。dnf -y install pcp-pmda-openmetrics cd /var/lib/pcp/pmdas/openmetrics/ ./Install
# dnf -y install pcp-pmda-openmetrics # cd /var/lib/pcp/pmdas/openmetrics/ # ./Install
Copy to Clipboard Copied! Toggle word wrap Toggle overflow サンプルの OpenMetrics ファイルを作成します。
echo 'var1 {var2="var3"} 42' > /tmp/example.txt
# echo 'var1 {var2="var3"} 42' > /tmp/example.txt
Copy to Clipboard Copied! Toggle word wrap Toggle overflow example.txt を目的のファイル名に置き換えます。
ファイルが正しく作成されていることを確認します。
cat /tmp/example.txt
# cat /tmp/example.txt
Copy to Clipboard Copied! Toggle word wrap Toggle overflow メトリクスファイルパスを OpenMetrics エージェントに登録します。
echo "file:///tmp/example.txt" > /etc/pcp/openmetrics/example.url
# echo "file:///tmp/example.txt" > /etc/pcp/openmetrics/example.url
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 設定が正しく作成されていることを確認します。
cat /etc/pcp/openmetrics/example.url
# cat /etc/pcp/openmetrics/example.url
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 必要なシンボリックリンクを作成するために
systemd-tmpfiles
を設定します。echo 'L+ /var/lib/pcp/pmdas/openmetrics/config.d/example.url - - - - ../../../../../../etc/pcp/openmetrics/example.url' \ > /usr/lib/tmpfiles.d/pcp-pmda-openmetrics-cust.conf
# echo 'L+ /var/lib/pcp/pmdas/openmetrics/config.d/example.url - - - - ../../../../../../etc/pcp/openmetrics/example.url' \ > /usr/lib/tmpfiles.d/pcp-pmda-openmetrics-cust.conf
Copy to Clipboard Copied! Toggle word wrap Toggle overflow シンボリックリンクが正しく設定されていることを確認します。
cat /usr/lib/tmpfiles.d/pcp-pmda-openmetrics-cust.conf
# cat /usr/lib/tmpfiles.d/pcp-pmda-openmetrics-cust.conf
Copy to Clipboard Copied! Toggle word wrap Toggle overflow tmpfiles 設定を適用してシンボリックリンクを作成します。
systemd-tmpfiles --create --remove /usr/lib/tmpfiles.d/pcp-pmda-openmetrics-cust.conf
# systemd-tmpfiles --create --remove /usr/lib/tmpfiles.d/pcp-pmda-openmetrics-cust.conf
Copy to Clipboard Copied! Toggle word wrap Toggle overflow シンボリックリンクが正しく作成されていることを確認します。
ls -al /var/lib/pcp/pmdas/openmetrics/config.d/
# ls -al /var/lib/pcp/pmdas/openmetrics/config.d/
Copy to Clipboard Copied! Toggle word wrap Toggle overflow メトリクスが正しく報告されていることを確認します。
pminfo -f openmetrics.example.var1
# pminfo -f openmetrics.example.var1 inst [0 or "0 var2:var3"] value 42
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
-
pcp
を実行し、openmetrics
がリストされていることを確認します。 -
systemd-analyze cat-config tmpfiles.d
を実行し、出力にexample.url
が表示されることを確認します。 -
pminfo
を使用して、メトリクスが存在することと、その値を確認します。