Disk 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 disk logs for an example app.


Enable Disk Log Collection

  1. Log in to the web console of KubeSphere as project-admin and go to your project.

  2. From the left navigation bar, select Advanced Settings in Project Settings. Under Disk Log Collection, click to enable the feature.

Create a Deployment

  1. From the left navigation bar, select Workloads in Application Workloads. Under the Deployments tab, click Create.

  2. In the dialog that appears, set a name for the Deployment (for example, demo-deployment) and click Next.

  3. Under Container Image, click Add Container Image.

  4. Enter alpine in the search bar to use the image (tag: latest) as an example.


  5. Scroll down to Start Command and select the checkbox. Enter the following values for Run Command and Parameters respectively, click , and then click Next.

    Run Command



    -c,if [ ! -d /data/log ];then mkdir -p /data/log;fi; while true; do date >> /data/log/app-test.log; sleep 30;done


    The command and parameters above mean that the date information will be exported to app-test.log in /data/log every 30 seconds.


  6. On the Mount Volumes tab, click to enable Disk Log Collection and click Add Volume.

  7. On the Temporary Volume tab, enter a name for the volume (for example, demo-disk-log-collection) and set the access mode and path. Refer to the image below as an example.


    Click , and then click Next to continue.

  8. Click Create in Advanced Settings to finish the process.


    For more information, see Deployments.

View Logs

  1. Under the Deployments tab, click the Deployment just created to go to its detail page.

  2. In Resource Status, you can click to view container details, and then click of logsidecar-container (filebeat container) to view disk logs.

  3. 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:


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.