Skip to content

Commit

Permalink
[NET-4107][Supportability] Log Level set to TRACE and duration set to…
Browse files Browse the repository at this point in the history
… 5m for consul-debug (#17596)

* changed duration to 5 mins and log level to trace

* documentation update

* change log
  • Loading branch information
absolutelightning authored Jun 13, 2023
1 parent 4b843ae commit d54d5fb
Show file tree
Hide file tree
Showing 3 changed files with 8 additions and 5 deletions.
3 changes: 3 additions & 0 deletions .changelog/17596.txt
Original file line number Diff line number Diff line change
@@ -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'
```
4 changes: 2 additions & 2 deletions command/debug/debug.go
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
}
Expand Down
6 changes: 3 additions & 3 deletions website/content/commands/debug.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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
Expand Down

0 comments on commit d54d5fb

Please sign in to comment.