Add disclaimers regarding `Event` lifetime by dabico · Pull Request #5531 · kubernetes-sigs/headlamp

dabico · 2026-05-10T12:21:41Z

Summary

Add a small disclaimer tooltip next to the title of "Events" tables regarding Event resource lifetime in Kubernetes. Helpful to teach newbie users about Event retention, and a good reminder even for more veteran users.

Changes

Updated "Events" section in resource details to include the disclaimer.
Updated "Events" section in "Cluster" page to include the disclaimer.
Added translations.

Steps to Test

Launch locally with Minikube:

$ minikube start \
  --container-runtime=containerd \
  --docker-opt containerd=/var/run/containerd/containerd.sock \
  --kubernetes-version=v1.35.0
$ tmux new-session -d -s frontend 'make frontend-install run-frontend'
$ tmux new-session -d -s backend 'make backend run-backend'

Open Headlamp UI in the browser.
Navigate to the Clusters page and hover over the information icon to view.
Under Workloads, select any resource to view its details, hover over the information icon to view.

Screenshots

Notes for the Reviewer

Translations were only added for languages that I know and could verify the authenticity of the translation.

k8s-ci-robot · 2026-05-10T12:21:49Z

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: dabico
Once this PR has been reviewed and has the lgtm label, please assign yolossn for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

Copilot

Pull request overview

Adds a brief “events are ephemeral” disclaimer under Kubernetes Events tables to help users understand Event retention behavior across the UI.

Changes:

Add an info-note below the object details Events table (ObjectEventList) and the Cluster Overview Events section.
Introduce a new i18n string for the disclaimer and update locale files.
Update Storybook storyshot snapshots across affected details views.

Reviewed changes

Copilot reviewed 68 out of 68 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
frontend/src/components/common/ObjectEventList.tsx	Renders an info disclaimer under the per-object Events table.
frontend/src/components/cluster/Overview.tsx	Renders an info disclaimer under the Cluster Overview Events table.
frontend/src/i18n/locales/en/translation.json	Adds the new disclaimer string in English.
frontend/src/i18n/locales/de/translation.json	Adds German translation entry for the new disclaimer string.
frontend/src/i18n/locales/it/translation.json	Adds Italian translation entry for the new disclaimer string.
frontend/src/i18n/locales/es/translation.json	Adds placeholder entry for the new disclaimer string.
frontend/src/i18n/locales/fr/translation.json	Adds placeholder entry for the new disclaimer string.
frontend/src/i18n/locales/hi/translation.json	Adds placeholder entry for the new disclaimer string.
frontend/src/i18n/locales/ja/translation.json	Adds placeholder entry for the new disclaimer string.
frontend/src/i18n/locales/ko/translation.json	Adds placeholder entry for the new disclaimer string.
frontend/src/i18n/locales/pt/translation.json	Adds placeholder entry for the new disclaimer string.
frontend/src/i18n/locales/ta/translation.json	Adds placeholder entry for the new disclaimer string.
frontend/src/i18n/locales/zh/translation.json	Adds placeholder entry for the new disclaimer string.
frontend/src/i18n/locales/zh-tw/translation.json	Adds placeholder entry for the new disclaimer string.
frontend/src/components/common/snapshots/ObjectEventList.WithEvents.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/common/snapshots/ObjectEventList.NoEventsForObject.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/common/snapshots/ObjectEventList.ErrorFetching.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/cluster/snapshots/Overview.Events.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/cluster/snapshots/Overview.ErrorState.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/cluster/snapshots/Overview.EmptyState.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/webhookconfiguration/snapshots/ValidatingWebhookConfigDetails.WithURL.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/webhookconfiguration/snapshots/ValidatingWebhookConfigDetails.WithService.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/webhookconfiguration/snapshots/MutatingWebhookConfigDetails.WithURL.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/webhookconfiguration/snapshots/MutatingWebhookConfigDetails.WithService.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/verticalPodAutoscaler/snapshots/VPADetails.Default.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/storage/snapshots/VolumeDetails.Base.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/storage/snapshots/ClassDetails.Base.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/storage/snapshots/ClaimDetails.Base.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/statefulset/snapshots/Details.WithOnDeleteStrategy.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/statefulset/snapshots/Details.WithMultipleContainers.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/statefulset/snapshots/Details.WithComplexSelector.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/statefulset/snapshots/Details.Default.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/service/snapshots/ServiceDetails.WithA8ROwnerOnly.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/service/snapshots/ServiceDetails.WithA8RAnnotations.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/service/snapshots/ServiceDetails.ErrorWithEndpoints.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/service/snapshots/ServiceDetails.Default.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/secret/snapshots/Details.WithBase.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/secret/snapshots/Details.Empty.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/runtimeClass/snapshots/Details.Base.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/resourceQuota/snapshots/resourceQuotaDetails.Default.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/priorityClass/snapshots/priorityClassDetails.Default.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/podDisruptionBudget/snapshots/pdbDetails.Default.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/networkpolicy/snapshots/Details.Default.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/namespace/snapshots/NamespaceDetails.Active.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/limitRange/snapshots/Details.LimitRangeDetail.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/lease/snapshots/Details.LeaseDetail.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/ingress/snapshots/Details.WithWildcardTLS.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/ingress/snapshots/Details.WithTLS.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/ingress/snapshots/Details.WithResource.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/ingress/snapshots/ClassDetails.WithDefault.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/ingress/snapshots/ClassDetails.Basic.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/horizontalPodAutoscaler/snapshots/HPADetails.Default.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/gateway/snapshots/ReferenceGrantDetails.Basic.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/gateway/snapshots/HTTPRouteDetails.Empty.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/gateway/snapshots/HTTPRouteDetails.Basic.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/gateway/snapshots/GRPCRouteDetails.Basic.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/gateway/snapshots/GatewayDetails.Basic.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/gateway/snapshots/ClassDetails.Basic.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/gateway/snapshots/BackendTrafficPolicyDetails.Basic.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/gateway/snapshots/BackendTLSPolicyDetails.Basic.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/endpointSlices/snapshots/EndpointSliceDetails.Default.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/endpoints/snapshots/EndpointDetails.Default.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/cronjob/snapshots/CronJobDetails.EveryMinute.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/cronjob/snapshots/CronJobDetails.EveryAst.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/crd/snapshots/CustomResourceDetails.NoError.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/crd/snapshots/CustomResourceDefinition.Details.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/configmap/snapshots/Details.WithBase.stories.storyshot	Updates snapshot to include the disclaimer.
frontend/src/components/configmap/snapshots/Details.Empty.stories.storyshot	Updates snapshot to include the disclaimer.

dabico · 2026-05-10T18:00:59Z

@copilot's comments are technically correct, but one should keep the following in mind: most managed Kubernetes services (AKS, EKS, GKE, etc.) don't offer options for configuring the kube-apiserver on the control plane (probably has something to do with them all providing more performant and robust log storage). The wording in my changes is indeed absolute, but its suggestions don't look that much better to me. At the same time, I wonder how many users run self-managed clusters, let alone change the event retention. If you have any suggestions about the wording, please let me know, and I'll change it.

yolossn · 2026-05-11T04:58:31Z

@dabico I think having a ℹ️ icon next to events Header and showing the text as tooltip on hover will be a better UX. I think its better to mention that the 1hr timelimit can vary based on Users Cluster config.

illume

Thanks for this PR.

The open review comments from Copilot still need attention — can you have a look? Once addressed, please mark them as resolved.

illume

Thanks for the contribution.

This PR has git conflicts — could you resolve them?

How to resolve conflicts

Rebase or merge the latest main into your branch, resolve the conflicts, and push the updated branch.

linux-foundation-easycla · 2026-05-17T22:32:33Z

The committers listed above are authorized under a signed CLA.

✅ login: dabico / name: Ozren Dabić (05b8637, c59f1ff, cf9faac)

dabico · 2026-05-18T00:26:28Z

@dabico I think having a ℹ️ icon next to events Header and showing the text as tooltip on hover will be a better UX. I think its better to mention that the 1hr timelimit can vary based on Users Cluster config.

@yolossn I've implemented the suggestions. You can see what it looks like in the updated issue description. @illume I've rebased off of main. Please let me know what you both think.

Copilot

Pull request overview

Copilot reviewed 69 out of 69 changed files in this pull request and generated 3 comments.

+    <SectionBox
+      title={t('glossary|Events')}
+      headerProps={{
+        noPadding: false,
+        headerStyle: 'subsection',
+        titleSideActions: [
+          <LightTooltip
+            key="event-lifetime-info"
+            title={t(
+              "translation|Kubernetes events have a lifetime of 1 hour by default. This duration may vary depending on your cluster's configuration."
+            )}
+            interactive
+          >
+            <Box
+              component="span"
+              sx={{
+                display: 'inline-flex',
+                alignItems: 'center',
+                verticalAlign: 'middle',
+                fontSize: '1.75rem',
+                lineHeight: 0,
+                mr: 1,
+              }}
+            >
+              <Icon icon="mdi:information-outline" />
+            </Box>
+          </LightTooltip>,
+        ],
+      }}
+    >


+          <LightTooltip
+            key="event-lifetime-info"
+            title={t(
+              "translation|Kubernetes events have a lifetime of 1 hour by default. This duration may vary depending on your cluster's configuration."
+            )}
+            interactive
+          >
+            <Box
+              component="span"
+              sx={{
+                display: 'inline-flex',
+                alignItems: 'center',
+                verticalAlign: 'middle',
+                fontSize: '1.75rem',
+                lineHeight: 0,
+                mr: 1,
+              }}
+            >
+              <Icon icon="mdi:information-outline" />
+            </Box>
+          </LightTooltip>,


  "Reason": "Reason",
  "Count": "Count",
  "Last Seen": "Last Seen",
+  "Kubernetes events have a lifetime of 1 hour by default. This duration may vary depending on your cluster's configuration.": "Kubernetes events have a lifetime of 1 hour by default. This duration may vary depending on your cluster's configuration.",


illume

Thanks for the contribution.

There are some open Copilot review comments — could you take a look at them? Please mark each one as resolved once you've addressed it.

k8s-ci-robot · 2026-05-20T12:22:52Z

PR needs rebase.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label May 10, 2026

k8s-ci-robot requested review from joaquimrocha and yolossn May 10, 2026 12:21

k8s-ci-robot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label May 10, 2026

dabico force-pushed the events branch from 42ec4f5 to c0a1f4f Compare May 10, 2026 15:15

k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels May 10, 2026

dabico force-pushed the events branch from c0a1f4f to 9006529 Compare May 10, 2026 16:03

illume requested a review from Copilot May 10, 2026 17:38

Copilot started reviewing on behalf of illume May 10, 2026 17:39 View session

Copilot AI reviewed May 10, 2026

View reviewed changes

Comment thread frontend/src/components/common/ObjectEventList.tsx Outdated

Comment thread frontend/src/components/cluster/Overview.tsx Outdated

illume requested changes May 11, 2026

View reviewed changes

k8s-ci-robot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label May 15, 2026

illume requested changes May 16, 2026

View reviewed changes

dabico force-pushed the events branch from 9006529 to dd54939 Compare May 17, 2026 22:07

k8s-ci-robot removed the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label May 17, 2026

dabico force-pushed the events branch from dd54939 to 52d14f1 Compare May 17, 2026 22:32

k8s-ci-robot added cncf-cla: no Indicates the PR's author has not signed the CNCF CLA. and removed cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels May 17, 2026

dabico force-pushed the events branch from 52d14f1 to 05b8637 Compare May 17, 2026 22:36

k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. and removed cncf-cla: no Indicates the PR's author has not signed the CNCF CLA. labels May 17, 2026

dabico force-pushed the events branch from 05b8637 to 62b4d0d Compare May 17, 2026 23:25

dabico added 3 commits May 18, 2026 02:19

frontend: Overview: Add disclaimer regarding Event lifetime

299faa7

frontend: ObjectEventList: Add disclaimer regarding Event lifetime

727ef6e

frontend: i18n: Add translations for Event disclaimer

1c30998

dabico force-pushed the events branch from 62b4d0d to 1c30998 Compare May 18, 2026 00:19

dabico requested a review from illume May 18, 2026 00:23

illume requested a review from Copilot May 18, 2026 07:09

Copilot AI reviewed May 18, 2026

View reviewed changes

illume requested changes May 18, 2026

View reviewed changes

k8s-ci-robot added the needs-rebase Indicates a PR cannot be merged because it has merge conflicts with HEAD. label May 20, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add disclaimers regarding `Event` lifetime#5531

Add disclaimers regarding `Event` lifetime#5531
dabico wants to merge 3 commits into
kubernetes-sigs:mainfrom
dabico:events

dabico commented May 10, 2026 •

edited

Loading

Uh oh!

k8s-ci-robot commented May 10, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

dabico commented May 10, 2026 •

edited

Loading

Uh oh!

yolossn commented May 11, 2026

Uh oh!

illume left a comment

Uh oh!

illume left a comment

Uh oh!

linux-foundation-easycla Bot commented May 17, 2026 •

edited

Loading

Uh oh!

dabico commented May 18, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

illume left a comment

Uh oh!

k8s-ci-robot commented May 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

Conversation

dabico commented May 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Steps to Test

Screenshots

Notes for the Reviewer

Uh oh!

k8s-ci-robot commented May 10, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

dabico commented May 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

yolossn commented May 11, 2026

Uh oh!

illume left a comment

Choose a reason for hiding this comment

Uh oh!

illume left a comment

Choose a reason for hiding this comment

Uh oh!

linux-foundation-easycla Bot commented May 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dabico commented May 18, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

illume left a comment

Choose a reason for hiding this comment

Uh oh!

k8s-ci-robot commented May 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

dabico commented May 10, 2026 •

edited

Loading

dabico commented May 10, 2026 •

edited

Loading

linux-foundation-easycla Bot commented May 17, 2026 •

edited

Loading