# weblogvis

## NAME



           **weblogvis** - visualize activity and performance from Web server
           logs
    


## SYNOPSIS



           **weblogvis**[**-bCfiVz**] [**-A** _align_] [**-a** _archive_] [**-h** _host_] [**-I** _time_]
           [**-m** _max_] [**-n** _pmnsfile_] [**-O** _time_] [**-p** _port_] [**-S** _time_] [**-t** _interval_]
           [**-T** _time_] [**-x** _version_] [**-Z** _timezone_] [_server_ ...]
    


## DESCRIPTION



           **weblogvis** displays Web server activity as extracted from the Web
           server access logs by the Performance Co-Pilot (PCP) agent
           pmdaweblog(1).  The display is modulated by the values of the
           performance metrics retrieved from the target _host_ which is
           running pmcd(1) and the pmdaweblog(1) Performance Metrics Domain
           Agent (PMDA(3)), or from the PCP archive log identified by
           _archive_.  The display is updated every _interval_ seconds (default 2
           seconds).
    
           The default display mode shows the request rate classified by
           request response size, for all Web server logs being monitored by
           pmdaweblog(1).  The top of the display includes the idle time and
           the total request rate of each Web server.  The list of servers
           can be restricted by specifying _server_ names.  The possible
           _servers_ are listed in the pmdaweblog(1) configuration file.
    
           **weblogvis** uses pmview(1), and so the user interface follows that
           described for pmview(1), which in turn displays the scene within
           an Inventor examiner viewer.
    
           **weblogvis** passes most command line options to pmview(1).
           Therefore, the command line options **-A** , **-a** , **-C** , **-h** , **-n** , **-O** , **-p** ,
           **-S** , **-t** , **-T** , **-x** , **-Z** and **-z** , and the user interface are described in
           the pmview(1) man page.
    


## COMMAND LINE OPTIONS



           The **weblogvis** specific options are:
    
           **-b** Change the display mode to report bytes per second, rather
                  than requests per second.
    
           **-f** Change the classification of activity to use HTTP functions
                  (Get, Post, Head and Other), rather than the default
                  classification by request result size.  With this
                  classification, the error rates from the logs for each Web
                  server are also displayed.
    
           **-i** Label each column with the name of the Web server.
    
           **-I** _time_
                  Change the dafult expected idle time for the Web servers
                  from 3600 seconds (1 hour) to _time_.
    
           **-m** _max_ Change the default normalization maximum to _max_
                  bytes/second or requests/second, depending on the display
                  mode.  The defaults are 500000 bytes per second or 100
                  requests per second.
    
           **-V** Verbose mode - output the generated pmview(1) configuration
                  file.
    


## FILES



           _$PCP_VAR_DIR/config/pmlogger/config.web_
                  pmlogger(1) configuration file that can be used to create a
                  PCP archive suitable for display with **weblogvis**
           _$PCP_VAR_DIR/config/pmchart/Web.Alarms_
                  pmchart(1) configuration file for monitoring Web server
                  alarm conditions
           _$PCP_VAR_DIR/config/pmchart/Web.Requests_
                  pmchart(1) configuration file for monitoring Web server
                  requests
           _$PCP_VAR_DIR/config/pmchart/Web.Volume_
                  pmchart(1) configuration file for monitoring the volume of
                  Web server transactions
           _$PCP_PMDAS_DIR/weblog_
                  installation directory of pmdaweblog(1)
    


## 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**(4).
    


* * *