Chapter 7. Configuring pmda-openmetrics

Procedure

1. Install the pmda-openmetrics PMDA.

   # dnf -y install pcp-pmda-openmetrics
   # cd /var/lib/pcp/pmdas/openmetrics/
   # ./Install

2. Create a sample OpenMetrics file.

   # echo 'var1 {var2="var3"} 42' > /tmp/example.txt

   Replace example.txt with the desired file name.

3. Verify that the file is created correctly.

   # cat /tmp/example.txt

4. Register the metric file path with the OpenMetrics agent.

   # echo "file:///tmp/example.txt" > /etc/pcp/openmetrics/example.url

5. Verify that the configuration is created correctly.

   # cat /etc/pcp/openmetrics/example.url

6. Configure systemd-tmpfiles to create the necessary symlinks.

   # 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

7. Verify that the symlinks are configured correctly.

   # cat /usr/lib/tmpfiles.d/pcp-pmda-openmetrics-cust.conf

8. Create the symlinks by applying the tmpfiles configuration.

   # systemd-tmpfiles --create --remove /usr/lib/tmpfiles.d/pcp-pmda-openmetrics-cust.conf

9. Verify that the symlinks are created correctly.

   # ls -al /var/lib/pcp/pmdas/openmetrics/config.d/

10. Verify that the metric is correctly reported.

    # pminfo -f openmetrics.example.var1
        inst [0 or "0 var2:var3"] value 42