Skip to content

docs: add proposal for GlobalControl topology visualization#466

Open
SunsetB612 wants to merge 1 commit intokarmada-io:mainfrom
SunsetB612:lfx-proposal
Open

docs: add proposal for GlobalControl topology visualization#466
SunsetB612 wants to merge 1 commit intokarmada-io:mainfrom
SunsetB612:lfx-proposal

Conversation

@SunsetB612
Copy link
Copy Markdown
Contributor

No description provided.

@karmada-bot karmada-bot requested review from samzong and warjiang March 9, 2026 12:03
@gemini-code-assist
Copy link
Copy Markdown

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces a comprehensive proposal for "OmniControl," a new feature designed to significantly enhance the Karmada Dashboard. The core objective is to provide users with an intuitive, end-to-end topology visualization of multi-cluster resources, addressing the current fragmentation in resource management. By unifying the view of resource propagation from policies to distributed workloads, OmniControl aims to simplify fault diagnosis, reduce cognitive overhead, and improve overall operational efficiency for Karmada users.

Highlights

  • Introduced OmniControl Proposal: A new proposal document was added detailing 'OmniControl' for the Karmada Dashboard, aiming to enhance multi-cluster resource management.
  • Enhanced Resource Visualization: The proposal outlines an end-to-end topology view of multi-cluster resources, unifying the display of ResourceTemplate, PropagationPolicy, ResourceBinding, Work, and member cluster workloads.
  • Improved User Experience: User stories highlight benefits such as simplified resource management and faster fault diagnosis through interactive topology views with status coloring.
  • Proposed Technical Design: A design utilizing SharedInformerFactory with custom Indexers is proposed for efficient O(1) lookup of resource propagation chains.
  • Frontend Integration: The plan includes integrating ReactFlow for interactive Directed Acyclic Graph (DAG) visualization in the Karmada Dashboard frontend.
  • Alternative Solutions Explored: The document compares the proposed Informer + Indexer solution with annotation-based tracing and naming convention GETs, detailing their performance, startup cost, memory usage, and reliability.
Changelog
  • docs/proposal/omnicontrol-for-karmada-dashboard/README.md
    • Added a new proposal document for OmniControl topology visualization in Karmada Dashboard.
    • Detailed the summary, motivation, goals, and non-goals of the OmniControl feature.
    • Included user stories illustrating enhanced resource management and fault diagnosis.
    • Outlined design details for resource propagation chain tracing using Informer + Indexer.
    • Described frontend topology visualization using ReactFlow with interactive features.
    • Presented and compared alternative solutions for resource tracing.
Activity
  • No review activity or comments have been recorded for this pull request yet.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

@karmada-bot karmada-bot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Mar 9, 2026
Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a design proposal for 'OmniControl for Karmada Dashboard', which aims to provide a topology visualization for resources. The proposal is well-structured and detailed, covering the motivation, goals, design, and alternative solutions.

My review focuses on improving the completeness of the proposal. I've left a few comments suggesting to fill in the 'Risks and Mitigations' and 'Test Plan' sections, which are crucial for a comprehensive design document. I also pointed out a minor typo in the creation date.

Overall, this is a great proposal that will significantly improve the user experience of Karmada Dashboard. Addressing the suggested points will make the proposal more robust.

Note: Security Review has been skipped due to the limited scope of the PR.


| title | authors | reviewers | approvers | creation-date |
| --- |-----------| --- | --- |---------------|
| OmniControl for Karmada Dashboard | @SunsetB612 | @ | @ | 2026-03-08 |
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The creation date 2026-03-08 is in the future. This appears to be a typo. Please correct it to the actual creation date.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update the name of OmniControl

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've updated the name from OmniControl to GlobalControl .🙌


### Notes/Constraints/Caveats (Optional)

### Risks and Mitigations
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The 'Risks and Mitigations' section is currently empty. It's crucial for a design proposal to identify potential risks (e.g., performance issues with a large number of resources, scalability concerns, potential breaking changes) and outline mitigation strategies. Please fill out this section.

* **Status Coloring:** Nodes are colored according to resource status (green = healthy, yellow = in progress, red = abnormal), helping users quickly locate faulty nodes.
* **Auto Layout:** The topology graph uses automatic layout algorithms such as Dagre to ensure that nodes do not overlap and connections remain clear in multi-cluster scenarios.

### Test Plan
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The 'Test Plan' section is empty. A comprehensive test plan is essential for ensuring the quality and correctness of the new feature. Please detail the testing strategy, including unit tests for the new backend logic, integration tests for the API endpoints, and end-to-end tests for the frontend visualization and user interactions.

@warjiang
Copy link
Copy Markdown
Contributor

/assign
cc @RainbowMango

@RainbowMango
Copy link
Copy Markdown
Member

Thanks, I will take a look, but I also suggest having a chat at the community meeting.

@warjiang
Copy link
Copy Markdown
Contributor

add figma design for more details

@karmada-bot
Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please ask for approval from warjiang. 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:

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

Signed-off-by: SunsetB612 <10235101575@stu.ecnu.edu.cn>
@SunsetB612 SunsetB612 changed the title docs: add proposal for OmniControl topology visualization docs: add proposal for GlobalControl topology visualization Mar 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants