From 46e52915c96b02f7a151979130ff77f40ebd574e Mon Sep 17 00:00:00 2001 From: Ian Chakeres Date: Sun, 25 Jun 2017 10:22:07 -0700 Subject: [PATCH] Added a section to kubectl cheatsheet about verbosity levels --- docs/user-guide/kubectl-cheatsheet.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/user-guide/kubectl-cheatsheet.md b/docs/user-guide/kubectl-cheatsheet.md index 56db33e3c4..55dbfc0a89 100644 --- a/docs/user-guide/kubectl-cheatsheet.md +++ b/docs/user-guide/kubectl-cheatsheet.md @@ -279,3 +279,19 @@ Output format | Description `-o=name` | Print only the resource name and nothing else `-o=wide` | Output in the plain-text format with any additional information, and for pods, the node name is included `-o=yaml` | Output a YAML formatted API object + +### Kubectl output verbosity and debugging + +Kubectl verbosity is controlled with the `-v` or `--v` flags followed by an integer representing the log level. General Kubernetes logging conventions and the associated log levels are described [here](https://github.com/kubernetes/community/blob/master/contributors/devel/logging.md). + +Verbosity | Description +--------------| ----------- +`--v=0` | Generally useful for this to ALWAYS be visible to an operator. +`--v=1` | A reasonable default log level if you don't want verbosity. +`--v=2` | Useful steady state information about the service and important log messages that may correlate to significant changes in the system. This is the recommended default log level for most systems. +`--v=3` | Extended information about changes. +`--v=4` | Debug level verbosity. +`--v=6` | Display requested resources. +`--v=7` | Display HTTP request headers. +`--v=8` | Display HTTP request contents. +