Skip to content

refactor: enable JSON logging in mcs controller #6551

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: master
Choose a base branch
from

Conversation

CaesarTY
Copy link
Contributor

What type of PR is this?

JSON logging support. More details are highlighted in #6230.

Which issue(s) this PR fixes:
Fixes #
Partof #6230

Special notes for your reviewer:

Does this PR introduce a user-facing change?:

NONE

@karmada-bot
Copy link
Collaborator

[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 assign garrybest for approval. For more information see the Kubernetes Code Review Process.

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

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

@karmada-bot karmada-bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Jul 17, 2025
Copy link

@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.

Summary of Changes

Hello @CaesarTY, 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 refactors the logging mechanism within the Multi-Cluster Services (MCS) controllers to adopt structured logging. The primary goal is to standardize log output into a machine-readable JSON format, which greatly improves the ability to collect, parse, and analyze logs using external systems, ultimately enhancing the overall observability and debuggability of the MCS components.

Highlights

  • Structured Logging Adoption: I've migrated all klog.Infof, klog.Errorf, and klog.Warningf calls within the Multi-Cluster Services (MCS) controllers to their structured logging counterparts, klog.InfoS and klog.ErrorS.
  • Improved Observability: This change enables JSON-formatted logging, making it significantly easier for log aggregation and analysis tools to parse and process controller logs, enhancing overall system observability.
  • Enhanced Debugging: By providing key-value pairs instead of formatted strings, logs now offer more contextually rich information, which should aid in quicker debugging and troubleshooting.
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 in your pull request via creating an issue comment (i.e. comment on the pull request page) using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands.

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 issue 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 is currently in preview and 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 to provide feedback.

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.

Copy link

@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 refactors the mcs controller to use structured JSON logging. I've identified a few issues where the logging API is misused, which could lead to confusing logs, and I've provided suggestions for fixes.

Comment on lines +211 to +213
err := fmt.Errorf("invalid key")
klog.ErrorS(err, "Failed to sync serviceExport as invalid key", "key", key)
return err

Choose a reason for hiding this comment

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

medium

It's redundant to return an error and log it separately. The ErrorS function already logs the error, so returning it provides sufficient information. Returning fmt.Errorf("invalid key") doesn't provide any additional context since the error message is already present in the log.

return err

Copy link
Contributor Author

Choose a reason for hiding this comment

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

it is not redundant, we need log the error for observability and return the error to handle it properly

CaesarTY added 2 commits July 17, 2025 16:20
Signed-off-by: yteng35 <[email protected]>
Signed-off-by: yteng35 <[email protected]>
@CaesarTY
Copy link
Contributor Author

/retest

@karmada-bot
Copy link
Collaborator

@CaesarTY: Cannot trigger testing until a trusted user reviews the PR and leaves an /ok-to-test message.

In response to this:

/retest

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.

@jabellard
Copy link
Member

/assign

@jabellard
Copy link
Member

/retest

@codecov-commenter
Copy link

⚠️ Please install the 'codecov app svg image' to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

Attention: Patch coverage is 0% with 44 lines in your changes missing coverage. Please review.

Project coverage is 45.44%. Comparing base (f4919ab) to head (0e5b99a).

Files with missing lines Patch % Lines
pkg/controllers/mcs/service_export_controller.go 0.00% 31 Missing ⚠️
pkg/controllers/mcs/endpointslice_controller.go 0.00% 8 Missing ⚠️
pkg/controllers/mcs/service_import_controller.go 0.00% 5 Missing ⚠️

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #6551      +/-   ##
==========================================
+ Coverage   45.43%   45.44%   +0.01%     
==========================================
  Files         687      687              
  Lines       56335    56336       +1     
==========================================
+ Hits        25596    25604       +8     
+ Misses      29140    29134       -6     
+ Partials     1599     1598       -1     
Flag Coverage Δ
unittests 45.44% <0.00%> (+0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@zhzhuang-zju
Copy link
Contributor

/retest

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
size/M Denotes a PR that changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants