---

   pmseries    ( 1 )

---

TIMESERIES METADATA

Using command line options, pmseries can be requested to provide metadata (metric names, instance names, labels, descriptors) associated with either individual timeseries or a group of timeseries, for example:

$ pmseries -a dcb2a032a308b5717bf605ba8f8737e9c6e1ed19

dcb2a032a308b5717bf605ba8f8737e9c6e1ed19 PMID: 60.0.21 Data Type: 64-bit unsigned int InDom: PM_INDOM_NULL 0xffffffff Semantics: counter Units: millisec Source: f5ca7481da8c038325d15612bb1c6473ce1ef16f Metric: kernel.all.cpu.nice labels {"agent":"linux","domainname":"localdomain",\ "groupid":1000,"hostname":"shard",\ "latitude":-25.28496,"longitude":152.87886,\ "machineid":"295b16e3b6074cc8bdbda8bf96f6930a",\ "userid":1000}

The complete set of pmseries metadata reporting options are:

-a, --all Convenience option to report all metadata for the given timeseries, equivalent to -deilms.

-d, --desc Metric descriptions detailing the PMID, data type, data semantics, units, scale and associated instance domain. This option has a direct pminfo(1) equivalent.

-F, --fast Query or load series metadata only, not values.

-g pattern, --glob=pattern Provide a glob(7) pattern to restrict the report provided by the -i, -l, -m, and -S.

-i, --instances Metric descriptions detailing the PMID, data type, data semantics, units, scale and associated instance domain.

-I, --fullindom Print the InDom in verbose mode. This option has a direct pminfo(1) equivalent.

-l, --labels Print label sets associated with metrics and instances. Labels are optional metric metadata described in detail in pmLookupLabels(3). This option has a direct pminfo(1) equivalent.

-m, --metrics Print metric names.

-M, --fullpmid Print the PMID in verbose mode. This option has a direct pminfo(1) equivalent.

-n, --names Print comma-separated label names only (not values) for the labels associated with metrics and instances.

-s, --series Print timeseries identifiers associated with metrics, instances and sources. These unique identifiers are calculated from intrinsic (non-optional) labels and other metric metadata associated with each PMAPI context (sources), metrics and instances. Archive, local context or pmcd(1) connections for the same host all produce the same source identifier. This option has a direct pminfo(1) equivalent. See also pmLookupLabels(3) and the -l/--labels option.