Skip to content

stats: Improved sequencing documentation for server-side stats events and added tests. #7885

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

Merged
merged 32 commits into from
Mar 19, 2025

Conversation

RyanBlaney
Copy link
Contributor

Response to Issue #7824

RELEASE NOTES:

  • Documentation Clarification: Clarified the expected sequencing of stats events in the server-side stats.Handler.
  • New Test Cases: Added tests to verify the event sequencing for various RPC types, ensuring consistency and accuracy in server-side stats handling.

…s to verify the order of server-side events.
@RyanBlaney RyanBlaney changed the title Documentation, Test: Improved sequencing documentation for server-side stats events and added tests. *: Improved sequencing documentation for server-side stats events and added tests. Dec 2, 2024
Copy link

codecov bot commented Dec 2, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 82.01%. Comparing base (4c07bca) to head (2046d6f).
Report is 142 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #7885      +/-   ##
==========================================
+ Coverage   81.84%   82.01%   +0.16%     
==========================================
  Files         377      410      +33     
  Lines       38120    40251    +2131     
==========================================
+ Hits        31201    33013    +1812     
- Misses       5603     5877     +274     
- Partials     1316     1361      +45     
Files with missing lines Coverage Δ
stats/stats.go 68.42% <ø> (ø)

... and 153 files with indirect coverage changes

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

@RyanBlaney RyanBlaney marked this pull request as ready for review December 2, 2024 03:13
@arjan-bal arjan-bal changed the title *: Improved sequencing documentation for server-side stats events and added tests. stats: Improved sequencing documentation for server-side stats events and added tests. Dec 2, 2024
@arjan-bal arjan-bal self-requested a review December 2, 2024 09:25
@arjan-bal arjan-bal self-assigned this Dec 2, 2024
@arjan-bal arjan-bal added the Type: Documentation Documentation or examples label Dec 2, 2024
@arjan-bal arjan-bal added this to the 1.69 Release milestone Dec 2, 2024
Comment on lines 153 to 156
func (s *testServer) UnaryCall(
ctx context.Context,
in *testpb.SimpleRequest,
) (*testpb.SimpleResponse, error) {
Copy link
Contributor

Choose a reason for hiding this comment

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

grpc-go follows the Google style guide. Based on this section in the style guide:

The signature of a function or method declaration should remain on a single line to avoid indentation confusion.

Please revert the changes made to wrap function definationations and calls throughout the PR.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Got it! I'll disable my autoformatter going forward or reconfigure it to follow the Google style guide.

@@ -786,8 +884,14 @@ func checkConnEnd(t *testing.T, d *gotData) {
st.IsClient() // TODO remove this.
}

type event struct {
eventType string
timestamp time.Time
Copy link
Contributor

Choose a reason for hiding this comment

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

What is the use of storing a timestamp? I believe we're only interested in the ordering of the events and not the absolute times they were emitted.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The timestamp was included for debugging purposes in case of test failures, since it could help identify delays or other issues. If you feel this isn’t valuable, I can to remove it for simplicity.

@RyanBlaney
Copy link
Contributor Author

I have fixed the wrapping errors for formatting and I removed the timestamps from the event structs. Thank you for your feedback @arjan-bal, is there anything else you need me to do?

…. Added a server stats Server Stream RPC test.
@arjan-bal arjan-bal assigned arjan-bal and unassigned RyanBlaney Dec 3, 2024
@purnesh42H purnesh42H assigned purnesh42H and unassigned arjan-bal Dec 3, 2024
@arjan-bal arjan-bal requested review from purnesh42H and arjan-bal and removed request for arjan-bal December 3, 2024 08:01
@purnesh42H purnesh42H modified the milestones: 1.69 Release, 1.70 Release Dec 5, 2024
@@ -81,6 +83,55 @@ var (
}
// The id for which the service handler should return error.
errorID int32 = 32202

// Server Stats
Copy link
Contributor

Choose a reason for hiding this comment

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

Please fix the documentation everywhere. Remove extra spaces at start and end etc.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Everything should be resolved now. Thank you for your help!

Copy link

This PR is labeled as requiring an update from the reporter, and no update has been received after 6 days. If no update is provided in the next 7 days, this issue will be automatically closed.

Copy link
Member

@dfawley dfawley left a comment

Choose a reason for hiding this comment

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

Thank you!

Copy link
Member

Choose a reason for hiding this comment

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

Could we just revert this file now? It mostly looks like churn which makes the blame history harder to navigate.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Yeah fair enough. Since I removed the tests anyway.

@dfawley dfawley assigned purnesh42H and unassigned RyanBlaney Mar 17, 2025
@dfawley
Copy link
Member

dfawley commented Mar 17, 2025

Thanks! Over to @purnesh42H for a quick second pass.

Copy link
Contributor

@purnesh42H purnesh42H left a comment

Choose a reason for hiding this comment

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

@RyanBlaney 1 more nit else looks good.

stats/stats.go Outdated
// Begin contains stats when an RPC attempt begins.
// Begin contains stats for the start of an RPC attempt.
//
// - Server-side: Triggered after `InHeader`, as headers are processed before the RPC lifecycle begins.
Copy link
Contributor

Choose a reason for hiding this comment

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

nit: restrict comments to 80 cols per line

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Got it! Thanks!

@purnesh42H purnesh42H assigned RyanBlaney and unassigned purnesh42H Mar 18, 2025
@purnesh42H purnesh42H merged commit 8d8571e into grpc:master Mar 19, 2025
15 checks passed
janardhanvissa pushed a commit to janardhanvissa/grpc-go that referenced this pull request Mar 24, 2025
@arjan-bal arjan-bal linked an issue May 22, 2025 that may be closed by this pull request
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Type: Documentation Documentation or examples
Projects
None yet
Development

Successfully merging this pull request may close these issues.

stats: document server-side stats event ordering and add tests
5 participants