Log Collection
KubeSphere supports multiple log collection methods so that Ops teams can collect, manage, and analyze logs in a unified and flexible way.
This tutorial demonstrates how to collect logs for an example app.
Prerequisites
- You need to create a workspace, a project and a user (
project-admin
). The user must be invited to the project with the role ofadmin
at the project level. For more information, see Create Workspaces, Projects, Users and Roles. - You need to enable the KubeSphere Logging System.
Enable Log Collection
-
Log in to the web console of KubeSphere as
project-admin
and go to your project. -
From the left navigation bar, click Log Collection in Project Settings, and then click to enable the feature.
Create a Deployment
-
From the left navigation bar, select Workloads in Application Workloads. Under the Deployments tab, click Create.
-
In the dialog that appears, set a name for the Deployment (for example,
demo-deployment
) and click Next. -
Under Containers, click Add Container.
-
Enter
alpine
in the search bar to use the image (tag:latest
) as an example. -
Scroll down to Start Command and select the checkbox. Enter the following values for Command and Parameters respectively, click โ, and then click Next.
Command
/bin/sh
Parameters
-c,if [ ! -d /data/log ];then mkdir -p /data/log;fi; while true; do date >> /data/log/app-test.log; sleep 30;done
Note
The command and parameters above mean that the date information will be exported toapp-test.log
in/data/log
every 30 seconds. -
On the Storage Settings tab, click to enable Collect Logs on Volumes and click Mount Volume.
-
On the Temporary Volume tab, enter a name for the volume (for example,
demo-disk-log-collection
) and set the access mode and path.Click โ, and then click Next.
-
Click Create in Advanced Settings to finish the process.
Note
For more information, see Deployments.
View Logs
-
Under the Deployments tab, click the Deployment just created to go to its detail page.
-
In Resource Status, you can click to view container details, and then click of
logsidecar-container
(filebeat container) to view logs. -
Alternatively, you can also click in the lower-right corner and select Log Search to view stdout logs. For example, use the Pod name of the Deployment for a fuzzy query.
Feedback
Was this page Helpful?
Receive the latest news, articles and updates from KubeSphere
Thanks for the feedback. If you have a specific question about how to use KubeSphere, ask it on Slack. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.