Updating docs by running update-imported-docs.sh

2016-09-02 16:09:21 -07:00
parent 2cbb016810
commit caa3d8c8e3
106 changed files with 101651 additions and 10362 deletions
@@ -0,0 +1,87 @@
+---
+---
+
+## kubectl top pod
+
+Display Resource (CPU/Memory/Storage) usage of pods
+
+### Synopsis
+
+
+
+Display Resource (CPU/Memory/Storage) usage of pods.
+
+The 'top pod' command allows you to see the resource consumption of pods.
+
+Due to the metrics pipeline delay, they may be unavailable for a few minutes
+since pod creation.
+
+```
+kubectl top pod [NAME | -l label]
+```
+
+### Examples
+
+```
+
+# 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
+```
+
+### Options
+
+```
+      --all-namespaces    If present, list the requested object(s) across all namespaces. Namespace in current context is ignored even if specified with --namespace.
+      --containers        If present, print usage of containers within a pod.
+  -l, --selector string   Selector (label query) to filter on
+```
+
+### Options inherited from parent commands
+
+```
+      --alsologtostderr value          log to standard error as well as files
+      --as string                      Username to impersonate for the operation
+      --certificate-authority string   Path to a cert. file for the certificate authority
+      --client-certificate string      Path to a client certificate file for TLS
+      --client-key string              Path to a client key file for TLS
+      --cluster string                 The name of the kubeconfig cluster to use
+      --context string                 The name of the kubeconfig context to use
+      --insecure-skip-tls-verify       If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
+      --kubeconfig string              Path to the kubeconfig file to use for CLI requests.
+      --log-backtrace-at value         when logging hits line file:N, emit a stack trace (default :0)
+      --log-dir value                  If non-empty, write log files in this directory
+      --logtostderr value              log to standard error instead of files
+      --match-server-version           Require server version to match client version
+  -n, --namespace string               If present, the namespace scope for this CLI request
+      --password string                Password for basic authentication to the API server
+  -s, --server string                  The address and port of the Kubernetes API server
+      --stderrthreshold value          logs at or above this threshold go to stderr (default 2)
+      --token string                   Bearer token for authentication to the API server
+      --user string                    The name of the kubeconfig user to use
+      --username string                Username for basic authentication to the API server
+  -v, --v value                        log level for V logs
+      --vmodule value                  comma-separated list of pattern=N settings for file-filtered logging
+```
+
+### SEE ALSO
+
+* [kubectl top](kubectl_top.md)	 - Display Resource (CPU/Memory/Storage) usage
+
+###### Auto generated by spf13/cobra on 2-Sep-2016
+
+
+
+
+
+<!-- BEGIN MUNGE: GENERATED_ANALYTICS -->
+[![Analytics](https://kubernetes-site.appspot.com/UA-36037335-10/GitHub/docs/user-guide/kubectl/kubectl_top_pod.md?pixel)]()
+<!-- END MUNGE: GENERATED_ANALYTICS -->