---
name: "weblogvis"
section: "1"
platform: "linux"
package: "pcp"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/weblogvis"
---

# weblogvis(1)

visualize activity and performance from Web server logs

## 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)](/pmdaweblog/1.md). The display is modulated by the values of the performance metrics retrieved from the target *host* which is running [**pmcd**(1)](/pmcd/1.md) and the [**pmdaweblog**(1)](/pmdaweblog/1.md) Performance Metrics Domain Agent ([**PMDA**(3)](/PMDA/3.md)), 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)](/pmdaweblog/1.md). 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)](/pmdaweblog/1.md) configuration file.

**weblogvis** uses [**pmview**(1)](/pmview/1.md), and so the user interface follows that described for [**pmview**(1)](/pmview/1.md), which in turn displays the scene within an Inventor examiner viewer.

**weblogvis** passes most command line options to [**pmview**(1)](/pmview/1.md). 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)](/pmview/1.md) 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)](/pmview/1.md) configuration file.

## FILES

- *$PCP\_VAR\_DIR/config/pmlogger/config.web*

  [**pmlogger**(1)](/pmlogger/1.md) 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)](/pmchart/1.md) configuration file for monitoring Web server alarm conditions

- *$PCP\_VAR\_DIR/config/pmchart/Web.Requests*

  [**pmchart**(1)](/pmchart/1.md) configuration file for monitoring Web server requests

- *$PCP\_VAR\_DIR/config/pmchart/Web.Volume*

  [**pmchart**(1)](/pmchart/1.md) configuration file for monitoring the volume of Web server transactions

- *$PCP\_PMDAS\_DIR/weblog*

  installation directory of [**pmdaweblog**(1)](/pmdaweblog/1.md)

## 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)](/pcp.conf/4.md).

## SEE ALSO

[**pmcd**(1)](/pmcd/1.md), [**pmchart**(1)](/pmchart/1.md), [**pmdaweblog**(1)](/pmdaweblog/1.md), [**pmlogger**(1)](/pmlogger/1.md), [**pmview**(1)](/pmview/1.md), [**webpingvis**(1)](/webpingvis/1.md), [**webvis**(1)](/webvis/1.md), [**pcp.conf**(4)](/pcp.conf/4.md) and [**pcp.env**(4)](/pcp.env/4.md).