# ganglia2pcp

## NAME



           **ganglia2pcp** - import ganglia data and create a PCP archive
    


## SYNOPSIS



           **ganglia2pcp**[**-D** _debug_] [**-d** _outdir_] [**-e** _end_] [**-f** _outfile_] [**-h**
           _hostname_] [**-s** _start_] [**-V** _version_] [**-Z** _timezone_] _input_dir_
    


## DESCRIPTION



           **ganglia2pcp** is intended to read a set of ganglia files stored in
           the rrd format and translate them into a Performance Co-Pilot
           (PCP) archive with the basename _outfile_.
    
           The intent of this converter is to take all of the rrd files found
           in the input_dir and generate a single pcp archive file.  The
           mapping of ganglia metrics to pcp metrics is defined internally.
    
           The resultant PCP achive may be used with all the PCP client tools
           to graph subsets of the data using pmchart(1), perform data
           reduction and reporting, filter with the PCP inference engine
           pmie(1), etc.
    
           A series of physical files will be created with the prefix
           _outfile_.  These are _outfile_**.0**(the performance data), _outfile_**.meta**
           (the metadata that describes the performance data) and
           _outfile_**.index**(a temporal index to improve efficiency of replay
           operations for the archive).  If any of these files exists
           already, then **sar2pcp** will **not** overwrite them and will exit with
           an error message of the form
    
           __pmLogNewFile: ``blah.0'' already exists, not over-written
    
           **ganglia2pcp** is a Perl script that uses the PCP::LogImport Perl
           wrapper around the PCP _libpcp_import_ library, and as such could be
           used as an example to develop new tools to import other types of
           performance data and create PCP archives.  The RRDs Perl wrapper
           is used to parse the raw rrd format files.
    


## OPTIONS



           The available command line options are:
    
           **-d** _outdir_
                The _outdir_ argument specifies a output to write to.  The
                default is the current directory.
    
           **-e** _end_
                The _end_ argument specifies a end time in a format understood
                by str2time.  The default start time is current time.
    
           **-f** _outfile_
                The _outfile_ argument specifies a output file name.  The
                default name is in the standard pmlogger format based on the
                start time, e.g., 20150201.00.10.
    
           **-h** _hostname_
                The _hostname_ argument specifies a hostname to write to the
                archive.  The default is taken from the directory name that
                the rrd files reside in.
    
           **-s** _start_
                The _start_ argument specifies a start time in a format
                understood by str2time.  The default start time is 24 prior
                to current time.
    
           **-V** _version_
                The **-V** option specifies the version for the output PCP
                archive.  By default the archive version **$PCP_ARCHIVE_VERSION**
                (set to 3 in current PCP releases) is used, and the only
                values currently supported for _version_ are 2 or 3.
    
           **-Z** _timezone_
                The _timezone_ argument sets the source timezone in the PCP
                archive (the default is to use the local timezone).  The
                timezone must have the format +HHMM (for hours and minutes
                East of UTC) or -HHMM (for hours and minutes West of UTC) or
                UTC.  Note in particular that **neither** the **zoneinfo**(aka
                Olson) format, e.g. Europe/Paris, nor the Posix **TZ** format,
                e.g.  EST+5 is allowed.  Example: timezone=``+1100''.
    


## 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).
    


## 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 end-users.  _debug_ is a comma
           separated list of debugging options; use pmdbg(1) with the **-l**
           option to obtain a list of the available debugging options and
           their meaning.
    
           Debugging options specific to **ganglia2pcp** are as follows:
           ┌────────┬─────────────────────────────┐
           │ **Option** │ **Description** │
           ├────────┼─────────────────────────────┤
           │ **appl0** │ setup and metrics discovery │
           ├────────┼─────────────────────────────┤
           │ **appl1** │ metric-value generation     │
           └────────┴─────────────────────────────┘
    


* * *