'\"macro stdmacro
.\"
.\" Copyright (c) 1997 Silicon Graphics, Inc.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.TH WEBLOGVIS 1 "" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3weblogvis\f1 \- مصورسازی فعالیت و کارایی برگرفته از لاگ‌های وب‌سرور
.\" literals use .B or \f3
.\" arguments use .I or \f2
.SH "خلاصه دستور (SYNOPSIS)"
\f3weblogvis\f1
[\f3\-bCfiVz\f1]
[\f3\-A\f1 \f2align\f1]
[\f3\-a\f1 \f2archive\f1]
[\f3\-h\f1 \f2host\f1]
[\f3\-I\f1 \f2time\f1]
[\f3\-m\f1 \f2max\f1]
[\f3\-n\f1 \f2pmnsfile\f1]
[\f3\-O\f1 \f2time\f1]
[\f3\-p\f1 \f2port\f1]
[\f3\-S\f1 \f2time\f1]
[\f3\-t\f1 \f2interval\f1]
[\f3\-T\f1 \f2time\f1]
[\f3\-x\f1 \f2version\f1]
[\f3\-Z\f1 \f2timezone\f1]
[\f2server\f1 ...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B weblogvis
فعالیت وب‌سرور را همان‌طور که توسط عاملِ
.BR pmdaweblog (1)
در Performance Co-Pilot (PCP) از لاگ‌های دسترسی وب‌سرور استخراج شده است، نمایش می‌دهد.
این نمایش بر اساس مقادیر معیارهای کارایی دریافت‌شده از
.I host
هدف (که در حال اجرای
.BR pmcd (1)
و عامل دامنه معیارهای کارایی
.BR pmdaweblog (1)
.RB ( PMDA (3))
است) یا از لاگ بایگانی PCP مشخص‌شده توسط
.I archive
تنظیم می‌شود.
صفحهٔ نمایش در هر
.I interval
ثانیه (پیش‌فرض ۲ ثانیه) به‌روزرسانی می‌شود.
.PP
حالت نمایش پیش‌فرض، نرخ درخواست‌ها را بر اساس اندازهٔ پاسخ، برای تمام لاگ‌های وب‌سرور که توسط
.BR pmdaweblog (1)
پایش می‌شوند، دسته‌بندی کرده و نشان می‌دهد.
بخش بالایی تصویر، زمان بیکاری و نرخ کل درخواست‌های هر وب‌سرور را شامل می‌شود.
فهرست کارسازها را می‌توان با مشخص کردن نام‌های
.I server
محدود کرد.
موارد ممکن برای
.I server
در فایل پیکربندی
.BR pmdaweblog (1)
فهرست شده‌اند.
.PP
دستور
.B weblogvis
از
.BR pmview (1)
استفاده می‌کند، بنابراین رابط کاربری آن از آنچه برای
.BR pmview (1)
توصیف شده پیروی می‌نماید، که خود صحنه را درون یک نمایشگر بررسی‌کنندهٔ Inventor (یا همان Inventor examiner viewer) نمایش می‌دهد.
.PP
دستور
.B weblogvis
بیشتر گزینه‌های خط فرمان را به
.BR pmview (1)
ارسال می‌کند.
از این رو، گزینه‌های خط فرمان
.BR \-A ،
.BR \-a ،
.BR \-C ،
.BR \-h ،
.BR \-n ،
.BR \-O ،
.BR \-p ،
.BR \-S ،
.BR \-t ،
.BR \-T ،
.BR \-x ،
.BR \-Z
و
.BR \-z ،
و همچنین رابط کاربری در صفحهٔ راهنمای
.BR pmview (1)
توضیح داده شده‌اند.
.SH "گزینه‌های خط فرمان (COMMAND LINE OPTIONS)"
گزینه‌های اختصاصی
.B weblogvis
عبارت‌اند از:
.IP \f3\-b\f1
تغییر حالت نمایش به گزارش بایت در ثانیه، به جای درخواست در ثانیه.
.IP \f3\-f\f1
تغییر دسته‌بندی فعالیت‌ها به استفاده از توابع HTTP (شامل Get، Post، Head و Other)، به جای دسته‌بندی پیش‌فرض بر اساس اندازهٔ نتیجهٔ درخواست.
با این دسته‌بندی، نرخ خطاهای ثبت‌شده در لاگ‌ها برای هر وب‌سرور نیز نمایش داده می‌شود.
.IP \f3\-i\f1
برچسب‌گذاری هر ستون با نام وب‌سرور مربوطه.
.TP
.BI \-I " time"
تغییر زمان پیش‌فرض مورد انتظار برای بیکاری وب‌سرورها از ۳۶۰۰ ثانیه (۱ ساعت) به
.IR time .
.TP
.BI \-m " max"
تغییر مقدار بیشینهٔ نرمال‌سازی پیش‌فرض، بسته به حالت نمایش، به
.I max
بایت در ثانیه یا درخواست در ثانیه.
مقادیر پیش‌فرض، ۵۰۰۰۰۰ بایت در ثانیه یا ۱۰۰ درخواست در ثانیه است.
.IP \f3\-V\f1
حالت پرگو (Verbose) \- خروجی دادن فایل پیکربندی ایجادشده برای
.BR pmview (1).
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.I $PCP_VAR_DIR/config/pmlogger/config.web
فایل پیکربندی
.BR pmlogger (1)
که می‌تواند برای ایجاد یک بایگانی PCP مناسب جهت نمایش با
.B weblogvis
استفاده شود.
.TP
.I $PCP_VAR_DIR/config/pmchart/Web.Alarms
فایل پیکربندی
.BR pmchart (1)
برای پایش شرایط هشدار وب‌سرور.
.TP
.I $PCP_VAR_DIR/config/pmchart/Web.Requests
فایل پیکربندی
.BR pmchart (1)
برای پایش درخواست‌های وب‌سرور.
.TP
.I $PCP_VAR_DIR/config/pmchart/Web.Volume
فایل پیکربندی
.BR pmchart (1)
برای پایش حجم تراکنش‌های وب‌سرور.
.TP
.I $PCP_PMDAS_DIR/weblog
دایرکتوری نصب
.BR pmdaweblog (1).
.PD
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند
.B PCP_
برای مقداردهی پارامترهای نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل
.I /etc/pcp.conf
شامل مقادیر محلی برای این متغیرها است.
متغیر
.B $PCP_CONF
می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین، مطابق با آنچه در
.BR pcp.conf (4)
شرح داده شده است، استفاده شود.
.SH "همچنین ببینید (SEE ALSO)"
.BR pmcd (1)،
.BR pmchart (1)،
.BR pmdaweblog (1)،
.BR pmlogger (1)،
.BR pmview (1)،
.BR webpingvis (1)،
.BR webvis (1)،
.BR pcp.conf (4)
و
.BR pcp.env (4).