'\"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 WEBVIS 1 "" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3webvis\f1 \- مصورسازی فعالیت وب‌سرور در سطح سیستم
.\" literals use .B or \f3
.\" arguments use .I or \f2
.SH "خلاصه دستور (SYNOPSIS)"
\f3webvis\f1
[\f3\-CVz\f1]
[\f3\-A\f1 \f2align\f1]
[\f3\-a\f1 \f2archive\f1]
[\f3\-b\f1 \f2maxbusy\f1]
[\f3\-h\f1 \f2host\f1]
[\f3\-i\f1 \f2maxio\f1]
[\f3\-m\f1 \f2max\f1]
[\f3\-n\f1 \f2pmnsfile\f1]
[\f3\-O\f1 \f2time\f1]
[\f3\-p\f1 \f2port\f1]
[\f3\-r\f1 \f2maxreq\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]
[\f2interface\f1 ...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B webvis
نمایی کلی از آمارهای کارایی وب‌سرور در سطح سیستم را که از زیرساخت Performance Co-Pilot (PCP) جمع‌آوری شده است نمایش می‌دهد.
این نمایش با مقادیر معیارهای کارایی دریافت‌شده از
.I host
هدف (که
.BR pmcd (1)
و عامل دامنه معیارهای کارایی
.BR pmdaweblog (1)
را اجرا می‌کند) یا از گزارش آرشیو PCP مشخص‌شده با
.IR archive
تنظیم و هدایت می‌شود.
صفحه نمایش در هر
.I interval
ثانیه به‌روزرسانی می‌شود (پیش‌فرض ۲ ثانیه است).
.PP
همانند تمامی صحنه‌های
.BR pmview (1)،
هنگامی که موشواره روی یکی از میله‌ها برده شود،
مقدار فعلی و اطلاعات معیار مربوط به آن میله
در کادر متنی نزدیک بالای صفحه نمایش نشان داده خواهد شد.
.PP
ارتفاع میله‌های درخواست‌های وب و فعالیت شبکه با مقادیر معیارهای کارایی نسبت به بیشینهٔ فعالیت مورد انتظار متناسب است،
که توسط گزینه‌های
.B \-m
و
.B \-r
کنترل می‌شود (به زیر مراجعه کنید).
به همین ترتیب، گزینه‌های
.B \-b
و
.B \-i
مقیاس‌بندی میله‌های فعالیت دیسک را کنترل می‌کنند.
.PP
میله‌ها در صحنهٔ
.B webvis
نشان‌دهندهٔ اطلاعات زیر هستند:
.TP 4
.B "Requests by Size"
در جلوی صحنه، ردیف میله‌های "Requests by Size" نرخ درخواست‌ها را برای درخواست‌هایی با اندازه‌های مختلف نشان می‌دهد (نمودارهای هیستوگرام با این مقادیر بایت تعریف شده‌اند: 0، 3 کیلوبایت، 10 کیلوبایت، 30 کیلوبایت، 100 کیلوبایت، 300 کیلوبایت، 1 مگابایت، 3 مگابایت و بزرگ‌تر از 3 مگابایت).
توجه داشته باشید که تقسیم‌بندی‌های اندازه به‌طور یکنواخت توزیع نشده‌اند. منظور از «اندازه» (size)، بخش داده‌ای پاسخ به هر درخواست وب‌سرور است. این نرخ‌ها در تمام وب‌سرورهای تحت نظارت تجمیع شده‌اند.
.TP 4
.B "Requests by Type"
این ردیف از میله‌ها نرخ درخواست را برای هر نوع درخواست HTTP (مانند get، post، head و غیره) که در تمامی وب‌سرورهای تحت نظارت تجمیع شده است نشان می‌دهد.
برای یک نمایش دقیق که تفکیک درخواست‌ها را
.IR "per Web server"
(به ازای هر وب‌سرور) نشان دهد،
.BR weblogvis (1)
را ببینید.
.TP 4
.B "Network"
برای هر رابط شبکه دو میلهٔ پشته‌ای وجود دارد.
یکی از میله‌ها ترافیک ورودی را نشان می‌دهد، در حالی که میلهٔ دیگر
ترافیک خروجی را نمایش می‌دهد. پشته‌ها از
تعداد خطاها (قرمز)، تعداد بسته‌های دور انداخته‌شده (نارنجی)
و تعداد بسته‌ها (سبز) تشکیل شده‌اند. به‌طور کلی، اگر
«بسته‌های ورودی دور انداخته‌شده» وجود داشته باشد، رابط شبکهٔ مربوطه
اشباع شده است یا منابع شبکهٔ کافی در هسته برای سرویس‌دهیِ
مناسب به بار درخواست‌های ورودی در دسترس نیست. در این صورت، ردیف‌های
.B "Alarm Conditions"
(به زیر مراجعه کنید) ممکن است جزئیات بیشتری دربارهٔ منبع مشکل ارائه دهند.
.TP 4
.B "Alarm Conditions"
ردیف میله‌های قرمز مجموعه‌ای از وضعیت‌های خطای TCP را نشان می‌دهد
(تجمیع‌شده برای همهٔ رابط‌های شبکه)، میله‌های نارنجی مشکلات بحرانیِ
تخصیص بافر هسته را نشان می‌دهند، و میلهٔ زرد شرایط وخیم صفحه‌بندی حافظه (paging) را
نمایش می‌دهد. اگر هر یک از این میله‌ها ارتفاع غیرصفر داشته باشند،
ممکن است سامانهٔ تحت نظارت به تنظیم پارامترهای هسته، پیکربندی مجدد نرم‌افزار
یا منابع سخت‌افزاری بیشتری نیاز داشته باشد.
معیارهای کارایی نهفته در پس این میله‌ها عبارتند از:
.RS +4n
.TP 15
.B network.tcp.drops
\- نرخ اتصال‌های دور انداخته‌شده (dropped)
.TP 15
.B network.tcp.conndrops
\- نرخ اتصال‌های ناقص (embryonic) دور انداخته‌شده
.TP 15
.B network.tcp.timeoutdrop
\- نرخ اتصال‌های دور انداخته‌شده به‌دلیل اتمام مهلت ارسال مجدد (rexmit timeout)
.TP 15
.B network.tcp.rcvbadsum
\- نرخ بسته‌های دور ریخته‌شده به‌دلیل چکسام نادرست (bad checksums)
.TP 15
.B network.tcp.rexmttimeo
\- نرخ اتمام مهلت ارسال‌های مجدد (retransmit timeouts)
.TP 15
.B network.tcp.sndrexmitpack
\- نرخ بسته‌های داده‌ایِ مجدداً ارسال‌شده (retransmitted)
.TP 15
.B swap.pagesout
\- نرخ خروج صفحات به فضای معاوضه (swap out) (نشان‌دهندهٔ کمبود حافظه)
.TP 15
.B network.mbuf.failed
\- نرخ مواردی که هسته در یافتن فضای mbuf ناموفق بوده است
.TP 15
.B network.mbuf.waited
\- نرخ مواردی که هسته برای یافتن فضای mbuf منتظر مانده است
.RE
.TP 4
.B CPU
این ستون میزان استفاده از CPU را که در تمامی CPUها تجمیع شده است نشان می‌دهد.
(زمان بیکاری پردازنده در این ستون لحاظ نمی‌شود).
.TP 4
.B Disk
.RS
دو استوانه وجود دارند که معیارهای دیسک را نشان می‌دهند. استوانهٔ نخست
نرخ عملیات خواندن (زرد) و نوشتن (بنفش) را نشان می‌دهد که
در تمام دوک‌های دیسک تجمیع شده است. استوانهٔ دوم میانگین
(روی تمام دیسک‌ها) درصد زمانی را نشان می‌دهد که دیسک مشغول
یا فعال است.
این
معیار در نسخه‌های PCP1.x در دسترس نیست؛ بنابراین اگر از
.B webvis
برای نظارت بر میزبانی که PCP1.x را اجرا می‌کند استفاده شود، این استوانه
نمایش داده نخواهد شد.
.P
برای تنظیم مقیاس این اشیاء، به گزینه‌های
.B \-b
و
.B \-i
توضیح داده شده در زیر مراجعه کنید.
.RE
.TP 4
.B Mem
دو میله وجود دارند که معیارهای حافظه را نشان می‌دهند. میلهٔ نخست،
حافظهٔ مصرف‌شده را نمایش می‌دهد و رنگ‌های مختلف نشان‌دهندهٔ انواع
مختلف مصرف (هسته، کاربر و غیره) هستند، در حالی که میلهٔ دوم
میزان حافظهٔ آزاد را نشان می‌دهد. اگر از
.B webvis
برای نظارت بر میزبانی که PCP1.x را اجرا می‌کند استفاده شود، تنها
میله‌ای که حافظهٔ آزاد را نشان می‌دهد به نمایش درخواهد آمد..PP
اگر هر آرگومان اختیاری
.I interface
در خط فرمان مشخص شود، تنها رابط‌های شبکه‌ای که با آرگومان‌های
.I interface
مطابقت دارند در بخش
.B Network
نمایش داده خواهند شد. به‌طور پیش‌فرض،
.B همهٔ
رابط‌ها استفاده خواهند شد.
آرگومان‌های
.I interface
به‌عنوان الگوهایی برای تطبیق
.BR egrep (1)
با نام رابط‌ها استفاده می‌شوند، بنابراین
.B ec
همهٔ رابط‌های اترنت خارجی را برای یک Challenge S انتخاب خواهد کرد.
.PP
.B webvis
از
.BR pmview (1)
استفاده می‌کند، و بنابراین رابط کاربری از آنچه برای
.BR pmview (1)
شرح داده شده پیروی می‌کند، که به نوبهٔ خود صحنه را درون یک نمایشگر
Inventor examiner
نمایش می‌دهد.
.PP
.B webvis
بیشتر گزینه‌های خط فرمان را به
.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 webvis
عبارتند از:
.TP
.BI \-b " maxbusy"
مقدار بیشینه (نرمال‌سازی) را برای میانگین درصد زمان فعال بودن در تمام دیسک‌ها کنترل می‌کند.
مقدار پیش‌فرض ۳۰٪ فعال است.
.TP
.BI \-i " maxio"
مقدار بیشینه (نرمال‌سازی) را برای مجموع نرخ‌های تجمیعی خواندن و نوشتن دیسک کنترل می‌کند.
مقدار پیش‌فرض ۱۰۰ I/O در ثانیه است.
.TP
.BI \-m " max"
مقدار بیشینه (نرمال‌سازی) را برای نرخ‌های ورود بسته و خروج بسته کنترل می‌کند.
مقدار پیش‌فرض ۷۵۰ بسته در ثانیه است.
.TP
.BI \-r " maxreq"
بیشینهٔ نرخ درخواست وب را کنترل می‌کند. مقدار پیش‌فرض ۵٪ از بیشینهٔ نرخ بسته است
(یعنی به‌طور پیش‌فرض ۳۸ درخواست در ثانیه). بیشینهٔ نرخ خطای وب روی ۲۰٪ از بیشینهٔ
نرخ درخواست وب ثابت شده است (یعنی به‌طور پیش‌فرض ۷ خطا در ثانیه).
.IP \f3\-V\f1
فایل پیکربندی مشتق‌شده برای
.BR pmview (1)
در خروجی استاندارد نوشته می‌شود. چنانچه کاربر مایل به سفارشی‌سازی نمایش یا تغییر
برخی از پارامترهای نرمال‌سازی باشد، این فایل می‌تواند ذخیره شده و مستقیماً با
.B pmview
استفاده شود..SH "فایل‌ها (FILES)"
.PD 0
.TP 10
.IR $PCP_VAR_DIR/pmns/ *
فایل‌های مشخصات پیش‌فرض PMNS
.TP
.I $PCP_VAR_DIR/config/pmlogger/config.web
فایل پیکربندی
.BR pmlogger (1)
که می‌تواند برای ایجاد یک بایگانی PCP مناسب جهت نمایش با
.B webvis
استفاده شود
.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 pmdawebping (1),
.BR pmdumplog (1),
.BR pminfo (1),
.BR pmlogger (1),
.BR pmval (1),
.BR pmview (1),
.BR weblogvis (1),
.BR webpingvis (1),
.BR pcp.conf (4)
و
.BR pcp.env (4).