pmdalogger(1)

NAME

   pmdalogger - log file performance metrics domain agent (PMDA)

SYNOPSIS

   $PCP_PMDAS_DIR/logger/pmdalogger  [-d  domain] [-l logfile] [-m memory]
   [-s interval] [-U username] [configfile]

DESCRIPTION

   pmdalogger is a configurable log file  monitoring  Performance  Metrics
   Domain  Agent  (PMDA).  It can be seen as analogous to the -f option to
   tail(1) and converts each new log line into a  performance  event.   It
   was the first PMDA to make extensive use of event metrics, which can be
   consumed by client tools like pmevent(1).

   The logger PMDA exports both event-style metrics reflecting timestamped
   event records for text logged to a file (or set of files or output from
   a process), as well as the more orthodox sample-style metrics  such  as
   event counts and throughput size values.

   The  PMDA  is  configured  via a configfile which contains one line for
   each source of events (file or process).  This file  is  setup  by  the
   Install  script  described  in the later section on ``INSTALLATION'' of
   the PMDA.

   A brief description of the pmdalogger command line options follows:

   -d   It is absolutely  crucial  that  the  performance  metrics  domain
        number  specified  here is unique and consistent.  That is, domain
        should be different for every PMDA on the one host, and  the  same
        domain number should be used for the same PMDA on all hosts.

   -l   Location of the log file.  By default, a log file named logger.log
        is written in the current directory of pmcd(1) when pmdalogger  is
        started,  i.e.   $PCP_LOG_DIR/pmcd.   If  the  log  file cannot be
        created or is not writable, output  is  written  to  the  standard
        error instead.

   -m   Limit the physical memory used by the PMDA to buffer event records
        to maxsize bytes.  As log events arrive at the PMDA, they must  be
        buffered  until  individual  client  tools  request the next batch
        since their previous batch of events.  The default  maximum  is  2
        megabytes.

   -s   Sets  the  polling interval for detecting newly arrived log lines.
        Mirrors the same option from the tail(1) command.

   -U   User account under which to run the agent.   The  default  is  the
        unprivileged  "pcp"  account  in  current  versions of PCP, but in
        older versions the superuser account ("root") was used by default.

INSTALLATION

   If you want access to the names, help text and values  for  the  logger
   performance metrics, do the following as root:

        # cd $PCP_PMDAS_DIR/logger
        # ./Install

   This  is an interactive installation process which prompts for each log
   file path to be monitored (or command to be  run),  a  metric  instance
   name  to identify it, and whether access should be restricted (refer to
   the -x option to pmevent(1) for further details).

   If you want to undo the installation, do the following as root:

        # cd $PCP_PMDAS_DIR/logger
        # ./Remove

   pmdalogger  is  launched  by  pmcd(1)  and  should  never  be  executed
   directly.  The Install and Remove scripts notify pmcd(1) when the agent
   is installed or removed.

FILES

   $PCP_PMCDCONF_PATH
             command line options used to launch pmdalogger
   $PCP_PMDAS_DIR/logger/logger.conf
             default configuration file for the logger metrics
   $PCP_PMDAS_DIR/logger/help
             default help text file for the logger metrics
   $PCP_PMDAS_DIR/logger/Install
             installation script for the pmdalogger agent
   $PCP_PMDAS_DIR/logger/Remove
             undo installation script for the pmdalogger agent
   $PCP_LOG_DIR/pmcd/logger.log
             default log file for error  messages  and  other  information
             from pmdalogger

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

SEE ALSO

   PCPIntro(1), pmevent(1), pmcd(1), tail(1), pcp.conf(5) and pcp.env(5).

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.