KUBERNETES(1) راهنمای کاربر kubernetes KUBERNETES(1)

kubectl-top-pod - نمایش میزان مصرف منابع (CPU/حافظه) پادها

kubectl top pod [OPTIONS]

نمایش میزان مصرف منابع (CPU/حافظه) پادها.

دستور 'top pod' به شما امکان می‌دهد میزان مصرف منابع توسط پادها را مشاهده کنید.

به دلیل تاخیر در خط لوله متریک‌ها (metrics pipeline)، ممکن است این اطلاعات برای چند دقیقه پس از ایجاد پاد در دسترس نباشند.

-A, --all-namespaces=false در صورت وجود، شیء یا اشیاء درخواستی را در تمام namespaceها فهرست می‌کند. namespace موجود در کانتکست فعلی نادیده گرفته می‌شود، حتی اگر با --namespace مشخص شده باشد.

--containers=false در صورت وجود، میزان مصرف کانتینرهای درون یک پاد را چاپ می‌کند.

--field-selector="" انتخاب‌گر (پرس‌وجوی فیلد) برای فیلتر کردن، از '='، '==' و '!=' پشتیبانی می‌کند (مانند ‎--field-selector key1=value1,key2=value2‎). سرور تنها از تعداد محدودی پرس‌وجوی فیلد به ازای هر نوع پشتیبانی می‌کند.

--no-headers=false در صورت وجود، خروجی را بدون هدر چاپ می‌کند.

-l, --selector="" انتخاب‌گر (پرس‌وجوی برچسب) برای فیلتر کردن، از '='، '=='، '!='، 'in' و 'notin' پشتیبانی می‌کند (مانند ‎-l key1=value1,key2=value2,key3 in (value3)‎). اشیاء منطبق باید تمام قیود برچسب مشخص‌شده را برآورده کنند.

--show-swap=false چاپ منابع پاد مربوط به حافظه مبادله (swap).

--sort-by="" در صورت خالی نبودن، فهرست پادها را بر اساس فیلد مشخص‌شده مرتب می‌کند. این فیلد می‌تواند 'cpu' یا 'memory' باشد.

--sum=false چاپ مجموع میزان مصرف منابع

--use-protocol-buffers=true استفاده از protocol-buffers را برای دسترسی به Metrics API فعال می‌کند.

--as="" نام کاربری برای جعل هویت (impersonate) در این عملیات. کاربر می‌تواند یک کاربر معمولی یا یک حساب خدمت (service account) در یک namespace باشد.

--as-group=[] گروه برای جعل هویت در این عملیات؛ این فلگ می‌تواند برای تعیین چندین گروه تکرار شود.

--as-uid="" شناسه UID برای جعل هویت در این عملیات.

--as-user-extra=[] اطلاعات اضافی کاربر برای جعل هویت در این عملیات؛ این فلگ می‌تواند برای مشخص کردن چندین مقدار برای یک کلید یکسان تکرار شود.

--cache-dir="/home/username/.kube/cache" دایرکتوری پیش‌فرض کش

--certificate-authority="" مسیر فایل گواهی برای مرجع صدور گواهی (certificate authority)

--client-certificate="" مسیر فایل گواهی کلاینت برای TLS

--client-key="" مسیر فایل کلید کلاینت برای TLS

--cluster="" نام کلاستر kubeconfig برای استفاده

--context="" نام کانتکست kubeconfig برای استفاده

--disable-compression=false در صورت true بودن، انصراف از فشرده‌سازی پاسخ‌ها برای تمام درخواست‌ها به سرور

--insecure-skip-tls-verify=false در صورت true بودن، اعتبار گواهی سرور بررسی نخواهد شد. این کار اتصالات HTTPS شما را ناامن می‌کند

--kubeconfig="" مسیر فایل kubeconfig برای استفاده در درخواست‌های CLI.

--kuberc="" مسیر فایل kuberc برای استفاده در ترجیحات (preferences). این قابلیت می‌تواند با export کردن feature gate به صورت KUBECTL_KUBERC=false یا خاموش کردن ویژگی با KUBERC=off غیرفعال شود.

--match-server-version=false الزام به تطابق نسخه سرور با نسخه کلاینت

-n, --namespace="" در صورت وجود، حوزه namespace برای این درخواست CLI

--password="" رمز عبور برای احراز هویت پایه (basic authentication) در سرور API

--profile="none" نام پروفایل برای ثبت. یکی از (none|cpu|heap|goroutine|threadcreate|block|mutex|trace)

--profile-output="profile.pprof" نام فایلی که پروفایل در آن ذخیره می‌شود

--request-timeout="0" مدت زمان انتظار پیش از انصراف از یک درخواست به سرور. مقادیر غیر صفر باید شامل واحد زمانی متناظر باشند (مانند 1s، 2m، 3h). مقدار صفر یعنی درخواست‌ها هرگز منقضی نشوند (بدون timeout).

-s, --server="" آدرس و پورت سرور Kubernetes API

--tls-server-name="" نام سرور برای اعتبارسنجی گواهی سرور. در صورت عدم ارائه، از hostname استفاده‌شده برای برقراری ارتباط با سرور استفاده می‌شود

--token="" توکن Bearer برای احراز هویت در سرور API

--user="" نام کاربر kubeconfig برای استفاده

--username="" نام کاربری برای احراز هویت پایه در سرور API

--version=false گزینه --version یا --version=raw اطلاعات نسخه را چاپ کرده و خارج می‌شود؛ --version=vX.Y.Z... نسخه گزارش‌شده را تنظیم می‌کند

--warnings-as-errors=false در نظر گرفتن هشدارهای دریافتی از سرور به عنوان خطا و خروج با کد وضعیت غیر صفر

# نمایش متریک‌ها برای تمام پادها در namespace پیش‌فرض
kubectl top pod
# نمایش متریک‌ها برای تمام پادها در namespace داده‌شده
kubectl top pod --namespace=NAMESPACE
# نمایش متریک‌ها برای یک پاد مشخص و کانتینرهای آن
kubectl top pod POD_NAME --containers
# نمایش متریک‌ها برای پادهای مشخص‌شده با برچسب name=myLabel
kubectl top pod -l name=myLabel

kubectl-top(1),

ژانویه ۲۰۱۵، در ابتدا توسط Eric Paris (eparis at redhat dot com) بر پایه محتوای منبع kubernetes گردآوری شد، اما امید است که از آن زمان به بعد به طور خودکار تولید شده باشند!

Jan 2015 Eric Paris