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

Extend the API priority and fairness KEP with observed request details #1218

Merged
merged 1 commit into from
Aug 26, 2019

Conversation

MikeSpreitzer
Copy link
Member

@MikeSpreitzer MikeSpreitzer commented Aug 21, 2019

The purpose of this PR is to add to the KEP some supporting details of observed requests, so that we can understand the traffic we are trying to classify.

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Aug 21, 2019
@k8s-ci-robot k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. kind/kep Categorizes KEP tracking issues and PRs modifying the KEP directory sig/api-machinery Categorizes an issue or PR as relevant to SIG API Machinery. labels Aug 21, 2019
@MikeSpreitzer MikeSpreitzer force-pushed the add-request-evidence branch 5 times, most recently from 0619cce to 80249f1 Compare August 21, 2019 22:38
@MikeSpreitzer
Copy link
Member Author

/cc @yue9944882
/cc @aaron-prindle
/cc @yliaog

user.Info=&user.DefaultInfo{Name:"system:kube-scheduler", UID:"",
Groups:[]string{"system:authenticated"},
Extra:map[string][]string(nil)}
as longrunning
Copy link

Choose a reason for hiding this comment

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

there are other long running requests, like exec, port-forward, log, ... are they checked?

Copy link
Member Author

Choose a reason for hiding this comment

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

The point of this KEP update is not to prove that the implementation is doing a good job of classification, so do not pay attention to the classification results shown here. The point of this update is only to provide some input to the process of designing the classification.

The existing implementation is identifying longrunning requests the same way that the max-in-flight filter does. Do you have reason to doubt that this is good?

Copy link

Choose a reason for hiding this comment

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

ok, that makes sense.

i don't have reason to doubt it, just figured they are very different than WATCH.

@yliaog
Copy link

yliaog commented Aug 22, 2019

/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 22, 2019
@k8s-ci-robot k8s-ci-robot removed the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Aug 23, 2019
@MikeSpreitzer
Copy link
Member Author

I just revised slightly to emphasize the point I made in #1218 (comment)

implementation of this KEP, because that is the only easy source of
the relevant request details. Do not pay attention to the
classification results evident in these log messages, they are not
what is important here; what is important is the `requestInfo` and the
Copy link
Contributor

Choose a reason for hiding this comment

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

Thanks for calling out what you're trying to represent. Because these are simple %v statements, you can only interpret the values if you know exactly which level of code they came from. This makes sense for debugging purposes (you know which version you are), but doesn't make as much sense for a doc like this that needs to span multiple releases.

Perhaps you could render them as json or yaml or something that is self-identifying for fields in the future. Future us will want more detail than true for instance.

@MikeSpreitzer MikeSpreitzer force-pushed the add-request-evidence branch 2 times, most recently from 1eb770c to a4f96b6 Compare August 24, 2019 05:58
@MikeSpreitzer
Copy link
Member Author

My latest revision replaces the cryptic %v formatting with the much easier to understand %#+v. I also trimmed irrelevant junk, and added some cases.

@deads2k
Copy link
Contributor

deads2k commented Aug 26, 2019

Thanks, that helps.

/lgtm

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

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: deads2k, MikeSpreitzer, yliaog

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 26, 2019
@k8s-ci-robot k8s-ci-robot merged commit dd946a8 into kubernetes:master Aug 26, 2019
@k8s-ci-robot k8s-ci-robot added this to the v1.17 milestone Aug 26, 2019
@MikeSpreitzer MikeSpreitzer deleted the add-request-evidence branch August 26, 2019 14:34
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/kep Categorizes KEP tracking issues and PRs modifying the KEP directory lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/api-machinery Categorizes an issue or PR as relevant to SIG API Machinery. 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.

None yet

4 participants