WEBLOGVIS(1)

🌸 weblogvis — the manual, but make it cute 🌸

ok so like, welcome to weblogvis(1) bestie 💖 this is a General Commands Manual page and we're gonna get you all the way together on it, no cap.

✨ 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 ✨

okay so here's the whole vibe 👑 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). literally so fast ⏱️

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. it's giving layers on layers 💅

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. iykyk 📖

✨ COMMAND LINE OPTIONS ✨

The weblogvis specific options are — like, these ones are the ones that are uniquely ours, bestie:

• -b — Change the display mode to report bytes per second, rather than requests per second. glow-up for your units 📏
• -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. so you get the tea AND the receipts 😭
• -i — Label each column with the name of the Web server. name it and claim it ✨
• -I time — Change the dafult expected idle time for the Web servers from 3600 seconds (1 hour) to time. > (yes bestie, the original page literally says "dafult" — we are NOT fixing it, we preserve the lore 🎀)
• -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. pick your scale, main character 🌈
• -V — Verbose mode — output the generated pmview(1) configuration file. show us the receipts 💜

✨ FILES ✨

the sacred texts, if you will 📜

• $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). 🌎 so many little knobs, obsessed

✨ SEE ALSO ✨

go read these next, bestie, they're iconic 👑:

pmcd(1), pmchart(1), pmdaweblog(1), pmlogger(1), pmview(1), webpingvis(1), webvis(1), pcp.conf(4) and pcp.env(4).

and that's the whole page fr fr 💖 this came from Performance Co-Pilot and the page itself is version/titled WEBLOGVIS(1) — thanks for reading bestie, you ate 🎀✨🦋