How To Get Helm Logs Of Changed Helm Releases

April 22, 2021

Introduction

Being able to access information about a Helm release is important for maintaining a Kubernetes cluster. Helm does not feature a command that displays release logs. However, similar results can be achieved using two other commands.

This tutorial will teach you how to use helm history and helm list to obtain information about your Helm releases.

How to Get Helm Logs of Changed Helm Releases

Prerequisites

Using helm history to Display Changes Made to a Release

The helm history command displays historical revisions of a release. To see the history for any release, type:

helm history [release-name]

The output of this command is a table, as in the image below.

Using helm history to see changes within a release


The table features revision numbers, the date and time of the revision, its status, the name of the release chart, the version of the app, and a description. The description column contains information about installation, upgrades, and rollbacks.

The default maximum of releases shown is 256. To limit the number of releases to a smaller number, use the --max argument:

helm history [release-name] --max [integer]
Limiting the number of entries shown by helm history


With the --max argument, Helm displays only the specified number of latest revisions.

Note: To print the output in a format other than the table, use the -o option followed by the format type. Other allowed formats are yaml and json.

Using helm list to Filter Release Information

The helm list command lists all the releases in the current namespace unless a different namespace is specified with the -n option. To search for a particular release, use the --filter option followed by a Pearl compatible regular expression:

helm list --filter '[expression]'

The output of the command is by default a table, but yaml and json formats are also available via the -o option:

Using helm list with filters to find a particular release
The command displays only deployed and failed releases. Use flags to see other types. For example, to see superseded releases, type:

helm list --filter '[expression]' --superseded

Using helm list to list superseded releases
Other flags that you can use to filter releases include:

  • --all – Shows all releases without applying any filters.
  • --deployed – This is the default option, applied if no other options are specified. It displays the releases that are currently deployed.
  • --failed – Shows failed releases.
  • --pending – Shows the releases pending deployment.
  • --uninstalled – Displays releases uninstalled with the --keep-history flag enabled during the uninstallation process.
  • --uninstalling – Shows releases that are currently being uninstalled.

The flags can also be combined for a more detailed search.

Finally, the helm list output is sorted alphabetically. To sort the entries by date, use the -d (--date) argument:

Using the -d option to sort the output of helm list by date

Note: Sometimes, upgrading your release can produce the “helm has no deployed releases” error. Learn how to fix it.

Conclusion

While Helm does not have a dedicated logs command, you can combine helm history and helm list features to obtain the necessary information about a release.

For more useful Helm commands, check Helm Command Cheat Sheet.

Was this article helpful?
YesNo
Marko Aleksic
Marko Aleksić is a Technical Writer at phoenixNAP. His innate curiosity regarding all things IT, combined with over a decade long background in writing, teaching and working in IT-related fields, led him to technical writing, where he has an opportunity to employ his skills and make technology less daunting to everyone.
Next you should read
Helm Commands Cheat Sheet
March 25, 2021

Helm is a package manager that features all the necessary commands for easy app management in a Kubernetes…
Read more
How To Delete Helm Deployment And Namespace
March 11, 2021

This step-by-step tutorial teaches you how to delete a Helm deployment from a specific namespace and how to…
Read more
What Is Helm? Helm And Helm Charts Explained
March 11, 2021

Helm automates application deployment to Kubernetes clusters. Helm provides a templating approach to…
Read more
How to Create a Helm Chart
February 3, 2021

Helm charts are application packages that use Kubernetes resources. They provide a template structure for app…
Read more