.TH "OPENSHIFT ADMIN TOP" "1" " Openshift CLI User Manuals" "Openshift" "June 2016"  ""


.SH NAME
.PP
openshift admin top pod \- Display Resource (CPU/Memory/Storage) usage of pods


.SH SYNOPSIS
.PP
\fBopenshift admin top pod\fP [OPTIONS]


.SH DESCRIPTION
.PP
Display Resource (CPU/Memory/Storage) usage of pods.

.PP
The 'top pod' command allows you to see the resource consumption of pods.

.PP
Due to the metrics pipeline delay, they may be unavailable for a few minutes since pod creation.


.SH OPTIONS
.PP
\fB\-\-all\-namespaces\fP=false
    If present, list the requested object(s) across all namespaces. Namespace in current context is ignored even if specified with \-\-namespace.

.PP
\fB\-\-containers\fP=false
    If present, print usage of containers within a pod.

.PP
\fB\-\-heapster\-namespace\fP="kube\-system"
    Namespace Heapster service is located in

.PP
\fB\-\-heapster\-port\fP=""
    Port name in service to use

.PP
\fB\-\-heapster\-scheme\fP="http"
    Scheme (http or https) to connect to Heapster as

.PP
\fB\-\-heapster\-service\fP="heapster"
    Name of Heapster service

.PP
\fB\-l\fP, \fB\-\-selector\fP=""
    Selector (label query) to filter on


.SH OPTIONS INHERITED FROM PARENT COMMANDS
.PP
\fB\-\-api\-version\fP=""
    DEPRECATED: The API version to use when talking to the server

.PP
\fB\-\-as\fP=""
    Username to impersonate for the operation

.PP
\fB\-\-certificate\-authority\fP=""
    Path to a cert. file for the certificate authority

.PP
\fB\-\-client\-certificate\fP=""
    Path to a client certificate file for TLS

.PP
\fB\-\-client\-key\fP=""
    Path to a client key file for TLS

.PP
\fB\-\-cluster\fP=""
    The name of the kubeconfig cluster to use

.PP
\fB\-\-config\fP=""
    Path to the config file to use for CLI requests.

.PP
\fB\-\-context\fP=""
    The name of the kubeconfig context to use

.PP
\fB\-\-google\-json\-key\fP=""
    The Google Cloud Platform Service Account JSON Key to use for authentication.

.PP
\fB\-\-insecure\-skip\-tls\-verify\fP=false
    If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure

.PP
\fB\-\-log\-flush\-frequency\fP=0
    Maximum number of seconds between log flushes

.PP
\fB\-\-match\-server\-version\fP=false
    Require server version to match client version

.PP
\fB\-n\fP, \fB\-\-namespace\fP=""
    If present, the namespace scope for this CLI request

.PP
\fB\-\-request\-timeout\fP="0"
    The length of time to wait before giving up on a single server request. Non\-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests.

.PP
\fB\-\-server\fP=""
    The address and port of the Kubernetes API server

.PP
\fB\-\-token\fP=""
    Bearer token for authentication to the API server

.PP
\fB\-\-user\fP=""
    The name of the kubeconfig user to use


.SH EXAMPLE
.PP
.RS

.nf
  # Show metrics for all pods in the default namespace
  kubectl top pod
  
  # Show metrics for all pods in the given namespace
  kubectl top pod \-\-namespace=NAMESPACE
  
  # Show metrics for a given pod and its containers
  kubectl top pod POD\_NAME \-\-containers
  
  # Show metrics for the pods defined by label name=myLabel
  kubectl top pod \-l name=myLabel

.fi
.RE


.SH SEE ALSO
.PP
\fBopenshift\-admin\-top(1)\fP,


.SH HISTORY
.PP
June 2016, Ported from the Kubernetes man\-doc generator