Skip to content

v1.24.0

Compare
Choose a tag to compare
@github-actions github-actions released this 12 Mar 07:01
· 30 commits to master since this release
68305a0

⚡ Nortable Changes

Add a short format for timestamps

--timestamps flag now accepts a format, one of default or short.

  • default: the original format 2006-01-02T15:04:05.000000000Z07:00 (RFC3339Nano with trailing zeros)
  • short: the new format 01-02 15:04:05 (time.DateTime without year).

If --timestamps is specified but without value, default is used to maintain backward compatibility.

$ stern --timestamps=short -n kube-system ds/kindnet --no-follow --tail 1 --only-log-lines
kindnet-hqn2k kindnet-cni 03-12 09:29:53 I0312 00:29:53.620499       1 main.go:250] Node kind-worker3 has CIDR [10.244.1.0/24]
kindnet-5f4ms kindnet-cni 03-12 09:29:53 I0312 00:29:53.374482       1 main.go:250] Node kind-worker3 has CIDR [10.244.1.0/24]

Add --node flag to filter on a specific node

New --node flag allows you to filter pods on a specific node. This flag will be helpful when we debug pods on the specific node.

# Print a DaemonSet pod on the specific node
stern --node <NODE_NAME> daemonsets/<DS_NAME>

# Print all pods on the specific node
stern --node <NODE_NAME> --all-namespaces --no-follow --max-log-requests 1 .

Highlight matched strings in the log lines with the include option

--include flag now highlight matched strings in the log lines.

image

Add all option to --container-state flag

--container-state flag now accepts all that is the same with specifying running,waiting,terminated. This change is helpful when we debug CrashLoopBackoff containers.

# Before
stern --container-state running,waiting,terminated <QUERY>

# After
stern --container-state all <QUERY>`

⚠️ Breaking Changes

Add --max-log-requests flag to limit concurrent requests

New --max-log-requests flag allows you to limit concurrent requests to prevent unintentional load to a cluster. The behavior and the default are different depending on the presence of the --no-follow flag.

--no-follow default behavior
specified 5 limits the number of concurrent logs to request
not specified 50 exits with an error when if it reaches the concurrent limit

If you want to change to the same behavior as before, specify a sufficiently large value for --max-log-requests.

Change the default of --container-state flag to all

The default value of --container-state has been changed to all from running. With this change, stern will now show logs of completed (terminated) and CrashLoopBackoff (waiting) pods in addition to running pods by default.

If you want to change to the same behavior as before, explicitly specify --container-state to running.

Changes

  • Upgrade golang.org/x/net to fix a dependabot alert (#250) e26d049 (Kazuki Suda)
  • Add a short format for timestamps (#249) 43ab3f1 (Takashi Kusumi)
  • Bump golangci-lint to v1.51.2 (#248) 079d158 (Takashi Kusumi)
  • Add dynamic completion for --node flag (#244) 59d4453 (Takashi Kusumi)
  • Add --node flag to filter on a specific node (#243) f90f70f (Takashi Kusumi)
  • allow flexible log parsing and formatting (#239) 12a55fa (Dmytro Milinevskyi)
  • Documenting how to get Bash completion in Krew mode (#240) 24c8716 (Jesse Glick)
  • Add CI for skipped files (#241) 7131af2 (Takashi Kusumi)
  • Replace actions/cache with setup-go's cache (#238) 74952fd (Takashi Kusumi)
  • Make CI jobs faster (#237) 4bb340d (Kazuki Suda)
  • Refactor options.sternConfig() (#236) 2315b23 (Takashi Kusumi)
  • Return error when output option is invalid (#235) 1c5aa2b (Takashi Kusumi)
  • Refactor template logic (#233) 371daf1 (Takashi Kusumi)
  • Revert "add support to parse JSON logs (#228)" (#232) 202f7e8 (Dmytro Milinevskyi)
  • Change the default of --container-state to all (#225) 2502c91 (Takashi Kusumi)
  • Highlight matched strings in the log lines with the include option (#231) 9fbaa18 (Kazuki Suda)
  • Support resuming from the last log when retrying (#230) 52894f8 (Takashi Kusumi)
  • add support to parse JSON logs (#228) 72a5854 (Dmytro Milinevskyi)
  • Show initContainers first when --no-follow and --max-log-requests 1 (#226) ef753f1 (Takashi Kusumi)
  • Add --max-log-requests flag to limit concurrent requests (#224) 0b939c5 (Takashi Kusumi)
  • Improve handling of container termination (#221) 8312782 (Takashi Kusumi)
  • Allow pods without labels to be selected in the resource query (#223) fc51906 (Takashi Kusumi)
  • Add all option to --container-state flag (#222) 6e0d5fc (Takashi Kusumi)