< img height="1" width="1" style="display:none;" alt="" src="https://px.ads.linkedin.com/collect/?pid=3131724&fmt=gif" />

Event Query

Kubernetes events provide insight into what is happening inside a cluster, based on which KubeSphere adds longer historical query and aggregation capabilities, and also supports event query for tenant isolation.

This guide demonstrates how you can do multi-level, fine-grained event queries to track the status of your components.


KubeSphere Events needs to be enabled.

Query Events

  1. The event query function is available for all users. Log in to the console with any account, hover over icon in the lower-right corner and select Resource Event Search.

  2. In the displayed dialog box, you can view the number of events that the user has permission to view.


    • KubeSphere supports event queries on each cluster separately if you have enabled the multi-cluster feature. You can click icon on the left of the search box and select a target cluster.

    • KubeSphere stores events for the last seven days by default.

  3. You can click the search box and enter a condition to search for events by message, workspace, project, resource type, resource name, reason, category, or time range (for example, use Time Range:Last 10 minutes to search for events within the last 10 minutes).

  4. Click any one of the results from the list, and you can see raw information of it. It is convenient for developers in terms of debugging and analysis.


The event query interface supports dynamic refreshing every 5s, 10s or 15s.

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.

What’s on this Page