diff --git a/.changelog/17596.txt b/.changelog/17596.txt new file mode 100644 index 0000000000..1058df1ea3 --- /dev/null +++ b/.changelog/17596.txt @@ -0,0 +1,3 @@ +```release-note:improvement + debug: change default setting of consul debug command. now default duration is 5ms and default log level is 'TRACE' + ``` \ No newline at end of file diff --git a/command/debug/debug.go b/command/debug/debug.go index 38a02c2602..0c3fcca57a 100644 --- a/command/debug/debug.go +++ b/command/debug/debug.go @@ -35,7 +35,7 @@ const ( // debugDuration is the total duration that debug runs before being // shut down - debugDuration = 2 * time.Minute + debugDuration = 5 * time.Minute // debugDurationGrace is a period of time added to the specified // duration to allow intervals to capture within that time @@ -503,7 +503,7 @@ func (c *cmd) captureHeap(outputDir string) error { } func (c *cmd) captureLogs(ctx context.Context) error { - logCh, err := c.client.Agent().Monitor("DEBUG", ctx.Done(), nil) + logCh, err := c.client.Agent().Monitor("TRACE", ctx.Done(), nil) if err != nil { return err } diff --git a/website/content/commands/debug.mdx b/website/content/commands/debug.mdx index 3fea57f43e..bebbe955a2 100644 --- a/website/content/commands/debug.mdx +++ b/website/content/commands/debug.mdx @@ -45,12 +45,12 @@ or otherwise. `Usage: consul debug [options]` By default, the debug command will capture an archive at the current path for -all targets for 2 minutes. +all targets for 5 minutes. #### Command Options - `-duration` - Optional, the total time to capture data for from the target agent. Must - be greater than the interval and longer than 10 seconds. Defaults to 2 minutes. + be greater than the interval and longer than 10 seconds. Defaults to 5 minutes. - `-interval` - Optional, the interval at which to capture dynamic data, such as heap and metrics. Must be longer than 5 seconds. Defaults to 30 seconds. @@ -79,7 +79,7 @@ information when `debug` is running. By default, it captures all information. | `host` | Information about resources on the host running the target agent such as CPU, memory, and disk. | | `members` | A list of all the WAN and LAN members in the cluster. | | `metrics` | Metrics from the in-memory metrics endpoint in the target, captured at the interval. | -| `logs` | `DEBUG` level logs for the target agent, captured for the duration. | +| `logs` | `TRACE` level logs for the target agent, captured for the duration. | | `pprof` | Golang heap, CPU, goroutine, and trace profiling. CPU and traces are captured for `duration` in a single file while heap and goroutine are separate snapshots for each `interval`. This information is not retrieved unless [`enable_debug`](/consul/docs/agent/config/config-files#enable_debug) is set to `true` on the target agent or ACLs are enable and an ACL token with `operator:read` is provided. | ## Examples