volcano-sh / volcano-sh/agentcube

feat: Add structured Kubernetes Events for sandbox lifecycle transitions

Open
#302 9 comments 0 reactions 1 assignee View on GitHub

@Maximus-08 is already working on this.

Since May 5, 2026.

kind/enhancement
Dominant language
Go
Stars
167
Forks
88
Avg merge
44m
Merged PRs (30d)
1

Description

What would you like to be added:
Emit Kubernetes Events via client-go/tools/record.EventRecorder at key sandbox lifecycle
points in the Workload Manager. Currently, sandbox creation, readiness, rollback, and garbage
collection are tracked only through internal Go channels and klog statements, no Events are
emitted on the parent AgentRuntime or CodeInterpreter resources.

Why is this needed:

Emitting Events is standard Kubernetes controller practice, every core controller does it.
Without Events, operators using kubectl describe agentruntime/<name> see no history of what
happened to their sandboxes. Debugging a slow or failed sandbox startup today requires tailing
workload-manager logs directly rather than using kubectl get events.

This also becomes critical for the upcoming multi-AgentCube orchestration feature, where
a single task spans multiple coordinated sandboxes. Operators and platform teams will need a
reliable, per-resource audit trail to monitor lifecycle transitions at scale.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.