---
name: "pmlogsize"
section: "1"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pmlogsize"
---

# pmlogsize(1)

report sizes for parts of PCP archive(s)

## NAME

**pmlogsize** - report sizes for parts of PCP archive(s)

## SYNOPSIS

**pmlogsize** \[**-drv?**\] \[**-D** *debug*\] \[**-x** *threshold*\] *archive* \[...\]

## DESCRIPTION

**pmlogsize** prints information about the size of the index, metadata and data sections of a Performance Co-Pilot (PCP) archive. The output is intended to guide improvements in archive encoding format for PCP developers and to help trim [**pmlogger**(1)](/pmlogger/1.md) configuration files to remove metrics that are bloating the PCP archives with low-value data in production environments.

The *archive* arguments can be any mixture of the names of the physical files of a PCP archive or the basename that is common to all the component physical files in a single archive. In the latter case *archive* is replaced by a list of all of the matching component file names.

Note the semantics is a little different to other PCP tools in that **foo.meta** means **just** the file **foo.meta**, not **foo.index**, **foo.meta**, **foo.0**, etc.

## OPTIONS

The available command line options are:

- **-d**, **--detail**

  Enable detailed reporting. This means space per instance domain in a metadata file and space per metric (for values) in a data file.

- **-r**, **--replication**

  Display additional information about possible replicated values in the data file and replicated instances in the metadata file. This option implies **-d**.

- **-x** *threshold*, **--threshold**=*threshold*

  With **-d** (or **-r**), cut off the report after at least *threshold* percent of the associated space (metric values or instance domains) has been reported. The default behaviour is equivalent to *threshold* being set to **100**.

- **-v**, **--verbose**

  Enable verbose mode. This option can be provided more than once for additional verbosity.

- **-?**, **--help**

  Display usage message and exit.

## DEBUGGING OPTIONS

The **-D** or **--debug** option enables the output of additional diagnostics on *stderr* to help triage problems, although the information is sometimes cryptic and primarily intended to provide guidance for developers rather than for end-users. *debug* is a comma separated list of debugging options; use [**pmdbg**(1)](/pmdbg/1.md) with the **-l** option to obtain a list of the available debugging options and their meaning.

## PCP ENVIRONMENT

Environment variables with the prefix **PCP\_** are used to parameterize the file and directory names used by PCP. On each installation, the file */etc/pcp.conf* contains the local values for these variables. The **$PCP\_CONF** variable may be used to specify an alternative configuration file, as described in [**pcp.conf**(5)](/pcp.conf/5.md).

## SEE ALSO

[**PCPIntro**(1)](/PCPIntro/1.md), [**pmlogcheck**(1)](/pmlogcheck/1.md), [**pmlogdump**(1)](/pmlogdump/1.md) and [**pmlogger**(1)](/pmlogger/1.md).