debian-mirror-gitlab/doc/user/project/clusters/kubernetes_pod_logs.md

50 lines
2.1 KiB
Markdown
Raw Normal View History

2019-09-30 21:07:59 +05:30
# Kubernetes Pod Logs **(ULTIMATE)**
2019-07-31 22:56:46 +05:30
2019-12-04 20:38:33 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab/issues/4752) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 11.0.
2019-07-31 22:56:46 +05:30
GitLab makes it easy to view the logs of running pods in [connected Kubernetes clusters](index.md).
By displaying the logs directly in GitLab, developers can avoid having to manage console tools or jump to a different interface.
2019-10-12 21:52:04 +05:30
NOTE: **Kubernetes + GitLab**
Everything you need to build, test, deploy, and run your app at scale.
[Learn more](https://about.gitlab.com/solutions/kubernetes/).
2019-07-31 22:56:46 +05:30
## Overview
2019-12-26 22:10:19 +05:30
[Kubernetes](https://kubernetes.io) pod logs can be viewed directly within GitLab.
![Pod logs](img/kubernetes_pod_logs_v12_5.png)
## Requirements
[Deploying to a Kubernetes environment](../deploy_boards.md#enabling-deploy-boards) is required in order to be able to use Pod Logs.
## Usage
To access pod logs, you must have the right [permissions](../../permissions.md#project-members-permissions).
You can access them in two ways.
### From the project sidebar
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/merge_requests/22011) in GitLab 12.5.
Go to **Operations > Pod logs** on the sidebar menu.
![Sidebar menu](img/sidebar_menu_pod_logs_v12_5.png)
### From Deploy Boards
Logs can be displayed by clicking on a specific pod from [Deploy Boards](../deploy_boards.md):
2019-07-31 22:56:46 +05:30
1. Go to **Operations > Environments** and find the environment which contains the desired pod, like `production`.
2019-09-04 21:01:54 +05:30
1. On the **Environments** page, you should see the status of the environment's pods with [Deploy Boards](../deploy_boards.md).
2019-07-31 22:56:46 +05:30
1. When mousing over the list of pods, a tooltip will appear with the exact pod name and status.
2019-09-30 21:07:59 +05:30
![Deploy Boards pod list](img/pod_logs_deploy_board.png)
2019-12-21 20:55:43 +05:30
1. Click on the desired pod to bring up the logs view, which will contain the last 500 lines for that pod.
You may switch between the following in this view:
- Pods.
- [From GitLab 12.4](https://gitlab.com/gitlab-org/gitlab/issues/5769), environments.
Support for pods with multiple containers is coming [in a future release](https://gitlab.com/gitlab-org/gitlab/issues/6502).