'\"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 WEBPINGVIS 1 "" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3webpingvis\f1 \- بصری‌سازی زمان پاسخ‌دهی کارگزار وب
.\" literals use .B or \f3
.\" arguments use .I or \f2
.SH "خلاصه دستور (SYNOPSIS)"
\f3webpingvis\f1
[\f3\-CiVz\f1]
[\f3\-A\f1 \f2align\f1]
[\f3\-a\f1 \f2archive\f1]
[\f3\-h\f1 \f2host\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 \f2time\f1]
[\f3\-t\f1 \f2interval\f1]
[\f3\-x\f1 \f2version\f1]
[\f3\-Z\f1 \f2timezone\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B webpingvis
خلاصه‌ای از آمار زمان پاسخ‌دهی کارگزار وب را که از زیرساخت Performance Co-Pilot (PCP) جمع‌آوری شده است نمایش می‌دهد.
نمایش بر اساس مقادیر معیارهای کارایی دریافت‌شده از
.I host
هدف (که در حال اجرای
.BR pmcd (1)
و عامل دامنه معیارهای کارایی
.BR pmdawebping (1)
است) یا از گزارش بایگانی PCP مشخص‌شده توسط
.IR archive ،
تنظیم می‌شود. این نمایش در هر
.I interval
ثانیه (پیش‌فرض ۲ ثانیه) به‌روزرسانی می‌شود.
.PP
مانند تمام صحنه‌های
.BR pmview (1)،
هنگامی که موشواره روی یکی از ستون‌ها برده می‌شود،
مقدار فعلی و اطلاعات معیار مربوط به آن ستون
در کادر متنی نزدیک بالای صفحه نمایش داده خواهد شد.
ارتفاع ستون‌ها متناسب با مقادیر معیارهای کارایی نسبت به مقدار بیشینه است،
همان‌گونه که با اندازه URLهای دریافت شده توسط
.BR pmdawebping (1)
و گزینه
.B \-m
(به زیر مراجعه کنید) کنترل می‌شود.
.PP
ستون‌ها در صحنه
.B webpingvis
اطلاعات زیر را نشان می‌دهند:
.TP 4
.B Size
ستون‌های سبز اندازه نسبی نتایج بازگردانده‌شده برای هر URL را در بار کاری
.B pmdawebping
نشان می‌دهند.
.TP 4
.B Response
برای هر URL در بار کاری
.BR pmdawebping ،
اجزای زمان پاسخ‌دهی کارگزار وب (connect، head و body) و زمان کل پاسخ‌دهی نمایش داده می‌شود.
.RS +4n
.PP
در سمت راست، زمان‌های اجزا و زمان کل برای تمامی URLها در بار کاری
.B pmdawebping
جمع زده می‌شوند.
.RE
.TP 4
.B Errors
چهار ستون خطای قرمز تعداد خطاهای سوکت، HTTP، HTML یا سایر خطاهایی را نشان می‌دهند که در آخرین تکرار بار کاری
.B pmdawebping
رخ داده است.
هر یک از این خطاها درخواست برای یک URL را لغو می‌کند.
.PP
دستور
.B webpingvis
از
.BR pmview (1)
استفاده می‌کند، بنابراین واسط کاربری از موارد توصیف‌شده برای
.BR pmview (1)
پیروی می‌کند که به نوبه خود صحنه را درون یک نمایشگر ارزیاب Inventor نمایش می‌دهد.
برای کنترل عمومی نمایشگر،
.BR ivview (1)
را ببینید.
.PP
دستور
.B webpingvis
بیشتر گزینه‌های خط فرمان را به
.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)
شرح داده شده‌اند.
.PP
گزینه‌های مخصوص
.B webpingvis
عبارتند از:
.IP \f3\-i\f1
نام‌های URL به‌طور پیش‌فرض به‌عنوان برچسب در صحنه گنجانده نمی‌شوند.
گزینه
.B \-i
گنجاندن آن‌ها را اجباری می‌کند.
.TP
.BI \-m " max"
ضریب نرمال‌سازی ستون‌های زمان پاسخ‌دهی را تغییر می‌دهد.
مقدار
.I max
بر حسب میلی‌ثانیه است و باید بیشینه مقدار مورد انتظار برای کل زمان پاسخ‌دهی تجمیع‌شده در تمام URLها در بار کاری
.B pmdawebping
باشد. مقدار پیش‌فرض ۱۰۰۰ میلی‌ثانیه است.
.IP \f3\-V\f1
فایل پیکربندی مشتق‌شده برای
.BR pmview (1)
روی خروجی استاندارد نوشته می‌شود. این خروجی می‌تواند ذخیره شود و در صورتی که کاربر بخواهد نمایش را سفارشی‌سازی کرده یا برخی از پارامترهای نرمال‌سازی را اصلاح کند، مستقیماً با
.BR pmview (1)
استفاده شود.
.SH "هشدارها (CAVEATS)"
از آن‌جا که
.B webpingvis
URLهای پیکربندی‌شده را بر اساس اندازه مرتب می‌کند، اجرای
.B webpingvis
اندکی پس از راه‌اندازی
.BR pmdawebping (1)
ممکن است منجر به مرتب‌سازی نادرست URLها شود چرا که ممکن است هنوز دریافت نشده باشند.
.PP
نویسه
.B ~
ممکن است توسط
.BR pmview (1)
به‌درستی تجزیه نشود. بنابراین، اگر
.BR pmdawebping (1)
در حال دریافت هرگونه URL حاوی
.B ~
باشد، در این صورت
.B webpingvis
اجرا نخواهد شد.
.SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.IR $PCP_VAR_DIR/pmns/ *
فایل‌های پیش‌فرض مشخصات PMNS
.TP
.I $PCP_VAR_DIR/config/pmlogger/config.webpingvis
فایل پیکربندی
.BR pmlogger (1)
که می‌تواند برای ایجاد بایگانی PCP مناسب برای نمایش با
.B webpingvis
استفاده شود
.TP
.I $PCP_VAR_DIR/config/pmchart/Web.Response
فایل پیکربندی
.BR pmchart (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 pmdawebping (1)،
.BR pmdumplog (1)،
.BR pminfo (1)،
.BR pmlogger (1)،
.BR pmval (1)،
.BR pmview (1)،
.BR weblogvis (1)
و
.BR webvis (1).