kubernetes/docs
Kubernetes Submit Queue 9c3d539313 Merge pull request #28844 from mksalawa/kubectltop
Automatic merge from submit-queue

Implement 'kubectl top' command

```release-note
Added 'kubectl top' command showing the resource usage metrics.
```

Sample output:

Nodes:
```
$ kubectl top node

NAME                           CPU       MEMORY    STORAGE   TIMESTAMP                         
kubernetes-minion-group-xxxx   76m       1468 Mi   0 Mi      Tue, 12 Jul 2016 17:37:00 +0200   
kubernetes-minion-group-yyyy   73m       1511 Mi   0 Mi      Tue, 12 Jul 2016 17:37:00 +0200   
kubernetes-minion-group-zzzz   46m       1506 Mi   0 Mi      Tue, 12 Jul 2016 17:37:00 +0200   
kubernetes-master              76m       2059 Mi   0 Mi      Tue, 12 Jul 2016 17:37:00 +0200   
```

Pods in all namespaces:
```
$ kubectl top pod --all-namespaces

NAMESPACE     NAME                                                 CPU       MEMORY    STORAGE   TIMESTAMP                         
default       nginx-1111111111-zzzzz                               0m        1 Mi      0 Mi      Tue, 12 Jul 2016 17:49:00 +0200   
kube-system   etcd-server-kubernetes-master                        4m        116 Mi    0 Mi      Tue, 12 Jul 2016 17:49:00 +0200   
kube-system   fluentd-cloud-logging-kubernetes-minion-group-xxxx   14m       110 Mi    0 Mi      Tue, 12 Jul 2016 17:49:00 +0200   
kube-system   kube-dns-v18-zzzzz                                   1m        6 Mi      0 Mi      Tue, 12 Jul 2016 17:49:00 +0200   
...
```

Pod with containers:
```
$ kubectl top pod heapster-v1.1.0-1111111111-miail --namespace=kube-system --containers

NAMESPACE     NAME                               CPU       MEMORY    STORAGE   TIMESTAMP                         
kube-system   heapster-v1.1.0-1111111111-miail   1m        42 Mi     0 Mi      Tue, 12 Jul 2016 17:52:00 +0200   
              heapster                           1m        26 Mi     0 Mi                                        
              eventer                            0m        3 Mi      0 Mi                                        
              heapster-nanny                     0m        6 Mi      0 Mi                                        
              eventer-nanny                      0m        6 Mi      0 Mi                                        
```

ref #11382

[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/.github/PULL_REQUEST_TEMPLATE.md?pixel)]()

<!-- Reviewable:start -->
---
This change is [<img src="https://reviewable.kubernetes.io/review_button.svg" height="34" align="absmiddle" alt="Reviewable"/>](https://reviewable.kubernetes.io/reviews/kubernetes/kubernetes/28844)
<!-- Reviewable:end -->
2016-08-12 06:50:43 -07:00
..
admin Fix broken warning image link in docs 2016-07-15 10:44:58 +01:00
api-reference Marked NodePhase deprecated. 2016-08-10 17:55:58 -07:00
design Merge pull request #29609 from lixiaobing10051267/masterHtmlToMd 2016-08-11 17:05:15 -07:00
devel Merge pull request #28778 from ivan4th/support-custom-fedora-repos-in-vagrant-provider 2016-08-10 16:33:54 -07:00
getting-started-guides coreos/azure: Move into a separate repo 2016-07-30 12:56:46 +01:00
images Updated for v1.2.0. 2016-03-18 14:20:56 -07:00
man/man1 Implement kubectl top command with subcommands. 2016-08-11 17:25:18 +02:00
proposals Merge pull request #30003 from jlowdermilk/config-proposal 2016-08-11 10:39:01 -07:00
user-guide Implement kubectl top command with subcommands. 2016-08-11 17:25:18 +02:00
yaml/kubectl Implement kubectl top command with subcommands. 2016-08-11 17:25:18 +02:00
api.md Fix broken warning image link in docs 2016-07-15 10:44:58 +01:00
OWNERS Move blunderbuss assignees into tree 2016-03-02 20:46:32 -05:00
README.md Fix broken warning image link in docs 2016-07-15 10:44:58 +01:00
reporting-security-issues.md Fix broken warning image link in docs 2016-07-15 10:44:58 +01:00
roadmap.md Fix broken warning image link in docs 2016-07-15 10:44:58 +01:00
troubleshooting.md Fix broken warning image link in docs 2016-07-15 10:44:58 +01:00
warning.png Add an image to unversioned warnings 2015-07-14 15:28:59 -07:00
whatisk8s.md Fix broken warning image link in docs 2016-07-15 10:44:58 +01:00

WARNING WARNING WARNING WARNING WARNING

PLEASE NOTE: This document applies to the HEAD of the source tree

If you are using a released version of Kubernetes, you should refer to the docs that go with that version.

The latest release of this document can be found [here](http://releases.k8s.io/release-1.3/docs/README.md).

Documentation for other releases can be found at releases.k8s.io.

Kubernetes Documentation: releases.k8s.io/HEAD

Analytics