Red Hat SummitEste conteúdo não está disponível no idioma selecionado.
Chapter 5. Retrieving Metrics
You can retrieve metrics from PCP using the CLI or the web UI interfaces. A number of CLI tools are provided with PCP, which can either output live data, or data from archived sources. The web UI interfaces are provided by the Grafana and Vector web applications. Vector connects directly to the PCP daemon, and can only display live data. Grafana reads from PCP archive files and can display data to up to 1 year old.
5.1. Retrieving Metrics via the CLI
Using the CLI tools provided with PCP, you can retrieve metrics either live, or from an archive file.
5.1.1. Retrieving Live Metrics using CLI
To output metrics on disk partition write instances, enter the following command:
pmval -f 1 disk.partitions.write
# pmval -f 1 disk.partitions.write
In this example, PCP converts the number of writes to disk partitions from a counter value, to a rate value. The -f 1 specifies that the value be abbreviated to one decimal place.
Example output
To monitor system metrics with a two second interval:
pmstat -t 2sec
# pmstat -t 2sec5.1.2. Retrieving Archived Metrics using CLI
You can use the PCP CLI tools to retrieve metrics from an archive file. To do that, add the --archive parameter and specify the archive file.
To list all metrics which were enabled when the archive file was created, enter the following command:
pminfo --archive archive_file
pminfo --archive archive_fileCopy to Clipboard Copied! Toggle word wrap Toggle overflow To confirm the host and time period covered by an archive file, enter the following command:
pmdumplog -l archive_file
# pmdumplog -l archive_fileCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Examples
To list disk writes for each partition, over the time period covered by the archive file:
pmval --archive /var/log/pcp/pmlogger/satellite.example.com/20180816.00.10 \ -f 1 disk.partitions.write
# pmval --archive /var/log/pcp/pmlogger/satellite.example.com/20180816.00.10 \ -f 1 disk.partitions.writeCopy to Clipboard Copied! Toggle word wrap Toggle overflow To list disk write operations per partition, with a two second interval, between the time period 14:00 and 14:15:
pmval --archive /var/log/pcp/pmlogger/satellite.example.com/20180816.00.10 \ -d -t 2sec \ -f 3 disk.partitions.write \ -S @14:00 -T @14:15
# pmval --archive /var/log/pcp/pmlogger/satellite.example.com/20180816.00.10 \ -d -t 2sec \ -f 3 disk.partitions.write \ -S @14:00 -T @14:15Copy to Clipboard Copied! Toggle word wrap Toggle overflow To list average values of all performance metrics, including the time of minimum/maximum value and the actual minimum/maximum value, between the time period 14:00 and 14:30. To output the values in tabular formatting:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow To list system metrics stored in an archive, starting from 14:00. The metrics are displayed in a format similar to the
toptool.pcp --archive /var/log/pcp/pmlogger/satellite.example.com/20180816.00.10 \ -S @14:00 \ atop
# pcp --archive /var/log/pcp/pmlogger/satellite.example.com/20180816.00.10 \ -S @14:00 \ atopCopy to Clipboard Copied! Toggle word wrap Toggle overflow
5.2. Retrieving Metrics via the Web UI
To access the web UI interfaces to PCP metrics, open the URL of either the following web applications:
- Vector
- http://satellite.example.com:44323/vector
- Grafana
- http://satellite.example.com:44323/grafana
Both applications provide a dashboard-style view, with default widgets displaying the values of metrics. You can add and remove metrics to suit your requirements. Also, you can select the time span shown for each widget. Only Grafana provides the option of selecting a custom time range from the archived metrics.
For more details on using Grafana, see the Grafana Labs web site. For more details on using Vector, see the Vector web site.
Figure 5.1. Example Grafana dashboard
Figure 5.2. Example Vector dashboard
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}