Skip to content
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

Allow customizing spam filtering in event client library #103918

Merged
merged 1 commit into from
Aug 11, 2021

Conversation

olagacek
Copy link
Contributor

What type of PR is this?

/kind feature

What this PR does / why we need it:

Current implementation
Event client library has aggregation and spam filtering implemented. While aggregation can be fully customized, spam filtering functionality doesn't allow overriding spamKey func - function that is responsible for creating a key (based on an event) which is used to detect "spam" events. Currently used getSpamKey() function takes into account Source and InvolvedObject of an event. Per each such key BurstSize events can be sent.

Changes in PR
Allow customizing spamKey func in CorrelatorOptions of EventCorrelator.

Why allow customizing spamKey func?
For some use cases it can be useful to also include for example Reason field of an event in spamKey. For example, if we have n normal events for a specific Object with the same reason and n+1-th event is e.g warning with a different reason we would like to have it emitted, while filtering n-1 normal events.

This PR does not change default behavior and doesn't introduce any breaking change. Current users of client library won't experience any change, unless they explicitly modify CorrelatorOptions.

Which issue(s) this PR fixes:

None

Does this PR introduce a user-facing change?

Client-go event library allows customizing spam filtering function. 
It is now possible to override `SpamKeyFunc`, which is used by event filtering to detect spam in the events.

/cc @serathius @dashpole @logicalhan
/sig instrumentation

@k8s-ci-robot k8s-ci-robot added release-note Denotes a PR that will be considered when it comes time to generate release notes. kind/feature Categorizes issue or PR as related to a new feature. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. sig/instrumentation Categorizes an issue or PR as relevant to SIG Instrumentation. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. needs-triage Indicates an issue or PR lacks a `triage/foo` label and requires one. needs-priority Indicates a PR lacks a `priority/foo` label and requires one. needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels Jul 26, 2021
@k8s-ci-robot
Copy link
Contributor

Hi @olagacek. Thanks for your PR.

I'm waiting for a kubernetes member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work. Regular contributors should join the org to skip this step.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

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/test-infra repository.

@k8s-ci-robot k8s-ci-robot added the sig/api-machinery Categorizes an issue or PR as relevant to SIG API Machinery. label Jul 26, 2021
duplicateEvent := makeEvent("duplicate", "me again", makeObjectReference("Pod", "my-pod", "my-ns"))
similarEvent := makeEvent("first", "me again", makeObjectReference("Pod", "my-pod", "my-ns"))
testCases := map[string]struct {
previousEvents []v1.Event
Copy link
Contributor

Choose a reason for hiding this comment

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

Nit, looks like previous event is always the same, it might be more readable to not include previousEvents field in the test case

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Removed previousEvents field

newEvent v1.Event
expectedEvent v1.Event
intervalSeconds int
burstSize int
Copy link
Contributor

@serathius serathius Jul 26, 2021

Choose a reason for hiding this comment

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

ditto for burstSize and expected Skip. Not need to include in test case if they don't change between tests.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

burstSize is not included in test case anymore, but expectedSkip actually changes between the test cases :)

"")
}
firstEvent := makeEvent("first", "i am first", makeObjectReference("Pod", "my-pod", "my-ns"))
duplicateEvent := makeEvent("duplicate", "me again", makeObjectReference("Pod", "my-pod", "my-ns"))
Copy link
Contributor

Choose a reason for hiding this comment

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

For me those names are reversed. Duplicate event should be exactly the same as the original and similar can differ. Can we make it more clearer in names or in test arguments what are differences?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Renamed the variables, hope they are more descriptive now

@fedebongio
Copy link
Contributor

/assign @serathius
/triage accepted

@k8s-ci-robot k8s-ci-robot added triage/accepted Indicates an issue or PR is ready to be actively worked on. and removed needs-triage Indicates an issue or PR lacks a `triage/foo` label and requires one. labels Jul 27, 2021
@serathius
Copy link
Contributor

/ok-to-test

@k8s-ci-robot k8s-ci-robot added ok-to-test Indicates a non-member PR verified by an org member that is safe to test. and removed needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels Aug 10, 2021
@serathius
Copy link
Contributor

/lgtm
/approve

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 11, 2021
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: olagacek, serathius

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

The pull request process is described 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

@k8s-ci-robot k8s-ci-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Aug 11, 2021
@k8s-ci-robot k8s-ci-robot merged commit 582c6f6 into kubernetes:master Aug 11, 2021
@k8s-ci-robot k8s-ci-robot added this to the v1.23 milestone Aug 11, 2021
huww98 added a commit to huww98/kubernetes that referenced this pull request May 23, 2024
kubernetes#47367 introduced client side event spam filtering to reduce the API server/etcd pressure of processing repeated events.
However, it use only Source and InvolvedObject as key, so it can also drop important and unique events. Slowing down the diagnosing significantly.

kubernetes#103918 try to resolve this by adding a new SpamKeyFunc to customize the key used. But this is still not ideal, because every user needs to dig into the code of client-go to figure out why his event does not appear. If the EventBroadcaster is initialized in a library, it may be even harder to set the SpamKeyFunc.

I propose to only drop PATCH events, which is the intent of the original proposal.
This patch deprecates SpamKeyFunc, and effectively fixed it to the return value of EventAggregate().

For the users who don't set SpamKeyFunc, they should get exactly more events
then before, so this is not breaking for them. Other users are likely just adding Reason to the key. We already do this now.
huww98 added a commit to huww98/kubernetes that referenced this pull request May 26, 2024
PR kubernetes#47367 introduced client side event spam filtering to reduce the API
server/etcd pressure of processing repeated events.  However, it use only
Source and InvolvedObject as key, so it can also drop important and unique
events. Slowing down the diagnosing significantly.

PR kubernetes#103918 try to resolve this by adding a new SpamKeyFunc to customize the key
used. But this is still not ideal, because every user needs to dig into the
code of client-go to figure out why his event does not appear. If the
EventBroadcaster is initialized in a library, it may be even harder to set the
SpamKeyFunc.

I propose to only drop PATCH events by default, which is the intent of the
original proposal.  For the users who don't set SpamKeyFunc, they should get
exactly more events.
huww98 added a commit to huww98/kubernetes that referenced this pull request Jun 1, 2024
PR kubernetes#47367 introduced client side event spam filtering to reduce the API
server/etcd pressure of processing repeated events.  However, it use only
Source and InvolvedObject as key, so it can also drop important and unique
events. Slowing down the diagnosing significantly.

PR kubernetes#103918 try to resolve this by adding a new SpamKeyFunc to customize the key
used. But this is still not ideal, because every user needs to dig into the
code of client-go to figure out why his event does not appear. If the
EventBroadcaster is initialized in a library, it may be even harder to set the
SpamKeyFunc.

I propose to only drop PATCH events by default, which is the intent of the
original proposal.  For the users who don't set SpamKeyFunc, they should get
exactly more events.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. kind/feature Categorizes issue or PR as related to a new feature. lgtm "Looks good to me", indicates that a PR is ready to be merged. needs-priority Indicates a PR lacks a `priority/foo` label and requires one. ok-to-test Indicates a non-member PR verified by an org member that is safe to test. release-note Denotes a PR that will be considered when it comes time to generate release notes. sig/api-machinery Categorizes an issue or PR as relevant to SIG API Machinery. sig/instrumentation Categorizes an issue or PR as relevant to SIG Instrumentation. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. triage/accepted Indicates an issue or PR is ready to be actively worked on.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants