Kubernetes Pod Logs
Introduced in GitLab Ultimate 11.0.
GitLab makes it easy to view the logs of running pods in connected Kubernetes clusters. By displaying the logs directly in GitLab, developers can avoid having to manage console tools or jump to a different interface.
Overview
Kubernetes pod logs can be viewed directly within GitLab.
Requirements
Deploying to a Kubernetes environment is required in order to be able to use Pod Logs.
Usage
To access pod logs, you must have the right permissions.
You can access them in two ways.
From the project sidebar
Introduced in GitLab 12.5.
Go to Operations > Pod logs on the sidebar menu.
From Deploy Boards
Logs can be displayed by clicking on a specific pod from Deploy Boards:
- Go to Operations > Environments and find the environment which contains the desired pod, like
production
. - On the Environments page, you should see the status of the environment’s pods with Deploy Boards.
- When mousing over the list of pods, a tooltip will appear with the exact pod name and status.
- Click on the desired pod to bring up the logs view.
Logs view
The logs view will contain the last 500 lines for a pod, and has control to filter via:
- Pods.
- From GitLab 12.4, environments.
- From GitLab 12.7, full text search.
Support for pods with multiple containers is coming in a future release.
Support for historical data is coming in a future release.
Full text search
Introduced in GitLab 12.7.
When you enable Elastic Stack on your cluster, you can search the content of your logs via a search bar.
The search is passed on to Elasticsearch using the simple_query_string Elasticsearch function, which supports the following operators:
+ signifies AND operation
| signifies OR operation
- negates a single token
" wraps a number of tokens to signify a phrase for searching
* at the end of a term signifies a prefix query
( and ) signify precedence
~N after a word signifies edit distance (fuzziness)
~N after a phrase signifies slop amount
Help and feedback
If there's something you don't like about this feature
To propose functionality that GitLab does not yet offer
To further help GitLab in shaping new features
If you didn't find what you were looking for
If you want help with something very specific to your use case, and can use some community support
POST ON GITLAB FORUM
If you have problems setting up or using this feature (depending on your GitLab subscription)
REQUEST SUPPORT
To view all GitLab tiers and features or to upgrade
If you want to try all features available in GitLab.com
If you want to try all features available in GitLab self-managed
If you spot an error or a need for improvement and would like to fix it yourself in a merge request
EDIT THIS PAGE
If you would like to suggest an improvement to this doc
If you want to give quick and simple feedback on this doc