LOGIMPORT — introduction to the library for importing data and creating a PCP archive

C Synopsis

#include <pcp/pmapi.h>
#include <pcp/import.h>

cc ... -lpcp_import -lpcp

Perl SYNOPSIS

use PCP::LogImport;

Python SYNOPSIS

from pcp import pmi

Description

The Performance Co-Pilot Log Import (LOGIMPORT) API is a library (with Perl and Python wrappers) that supports the creation of PCP archives from external sources of performance data, either in the form of historical logs and spreadsheets or from real-time sources that are not integrated as a Performance Metrics Domain Agent (PMDA) under the control of pmcd(1).

The typical usage for LOGIMPORT would involve:

If new metrics and/or instances are discovered during the data injestion, these can be added by subsequent calls to pmiAddMetric(3) and/or pmiAddInstance(3), provided all the metrics and instances have been defined before a call to pmiGetHandle(3), pmiPutValue(3)or pmiPutResult(3) that references those metrics and instances.

See Also

pmcd(1), pmlogger(1), pmiGetHandle(3), pmiAddInstance(3), pmiAddMetric(3), pmiEnd(3), pmiErrStr(3), pmiPutMark(3), pmiPutResult(3), pmiPutValue(3), pmiPutValueHandle(3), pmiPutText(3), pmiPutLabel(3), pmiSetHostname(3), pmiSetTimezone(3), pmiStart(3) and pmiWrite(3).

Referenced By

collectl2pcp(1), ganglia2pcp(1), iostat2pcp(1), LOGARCHIVE(5), mrtg2pcp(1), PCPIntro(1), pmiAddInstance(3), pmiAddMetric(3), pmiEnd(3), pmiErrStr(3), pmiGetHandle(3), pmiID(3), pmiPutLabel(3), pmiPutMark(3), pmiPutResult(3), pmiPutText(3), pmiPutValue(3), pmiPutValueHandle(3), pmiSetHostname(3), pmiSetTimezone(3), pmiStart(3), pmiUseContext(3), pmiWrite(3), sar2pcp(1).

The man page logimport(3) is an alias of LOGIMPORT(3).

Performance Co-Pilot