Chapter 4. PCP Metrics


Metrics are stored in a tree-like structure. For example, all network metrics are stored in a node named network. Each metric may be a single value, or a list of values, known as instances. For example, kernel load has three instances, a 1-minute, 5-minute, and 15-minute average.

For every metric entry, PCP stores both its data and metadata. This includes the metrics description, data type, units, and dimensions. For example, the metadata enables PCP to output multiple metrics with different dimensions.

The value of a counter metric only increases. For example, a count of disk write operations on a specific device only increases. When you query the value of a counter metric, PCP converts this into a rate value by default.

In addition to system metrics such as CPU, memory, kernel, XFS, disk, and network, the following metrics are configured:

Expand
MetricDescription

hotproc.*

Basic metrics of key Satellite processes

apache.*

Apache HTTP Server metrics

postgresql.*

Basic PostgreSQL statistics

mmv.fm_rails_*

Satellite metrics

4.1. Identifying Available Metrics

  • To list all metrics available via PCP, enter the following command:

    # pminfo
    Copy to Clipboard Toggle word wrap
  • To list all Satellite metrics and their descriptions, enter the following command:

    # foreman-rake telemetry:metrics
    Copy to Clipboard Toggle word wrap
  • To list the archived metrics, enter the following command:

    # less /var/log/pcp/pmlogger/$(hostname)/pmlogger.log
    Copy to Clipboard Toggle word wrap
  • The pmlogger daemon archives data as it is received, according to its configuration. To confirm the active archive file, enter the following command:

    # pcp | grep logger
    Copy to Clipboard Toggle word wrap

    The output includes the file name of the active archive file, for example:

    /var/log/pcp/pmlogger/satellite.example.com/20180814.00.10
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat