Skip to content

Add metrics api docs#3478

Merged
knative-prow-robot merged 5 commits into
knative:mainfrom
skonto:add_metrics_docs
Apr 21, 2021
Merged

Add metrics api docs#3478
knative-prow-robot merged 5 commits into
knative:mainfrom
skonto:add_metrics_docs

Conversation

@skonto
Copy link
Copy Markdown
Contributor

@skonto skonto commented Apr 19, 2021

Fixes #1792

Proposed Changes

  • Adds serving, eventing metrics api documentation
  • Each metric has a lifecycle status following the k8s approach
  • Adds some guidelines on how to use the metrics.

Screenshots bellow:
image
image

Note: tables can be improved with some custom table shortcode etc (goes beyond of this PR). Also in the future info could
be extracted from a cvs file (common practice with hugo).
/cc @matzew @markusthoemmes @evankanderson

@knative-prow-robot knative-prow-robot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Apr 19, 2021
@google-cla google-cla Bot added the cla: yes Indicates the PR's author has signed the CLA. label Apr 19, 2021
@knative-prow-robot knative-prow-robot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Apr 19, 2021
Copy link
Copy Markdown
Member

@evankanderson evankanderson left a comment

Choose a reason for hiding this comment

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

I'm assuming this is an interim step and we'll autogenerate the docs from something canonical that we can also test from in the future?

Comment thread docs/eventing/metrics.md
weight: 99
type: "docs"
---

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Add something here indicating that these are a snapshot of current metrics and may change in the future?

Comment thread docs/serving/metrics.md
weight: 99
type: "docs"
---

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

And here?

Comment thread docs/serving/metrics.md Outdated
| pending_pods | Number of pods that are pending currently | Gauge | configuration_name<br>namespace_name<br>revision_name<br>service_name | Dimensionless | Stable |
| terminating_pods | Number of pods that are terminating currently | Gauge | configuration_name<br>namespace_name<br>revision_name<br>service_name<br> | Dimensionless | Stable |

### QUEUE proxy
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Not sure we need to capitalize here?

Comment thread docs/eventing/metrics.md Outdated
| event_dispatch_latencies | The time spent dispatching an event from a in-memory Channel | Histogram | container_name<br>event_type<br>namespace_name=<br>response_code<br>response_code_class<br>unique_name | Milliseconds | Stable


Note: A number of metrics eg. controller, Go runtime and others are omitted here as they are common across most components. For more about these metrics check the [Serving metrics API section](../serving/metrics/).
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Use the #controller anchor on this ref?

@skonto
Copy link
Copy Markdown
Contributor Author

skonto commented Apr 20, 2021

I'm assuming this is an interim step and we'll autogenerate the docs from something canonical that we can also test from in the future?

Yes my idea is to use some file as input data but we dont need to decide this now. Also metrics dont change that often. Le't help users is my thinking here.

@skonto skonto changed the title [wip] Add metrics api docs Add metrics api docs Apr 21, 2021
@knative-prow-robot knative-prow-robot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Apr 21, 2021
@skonto
Copy link
Copy Markdown
Contributor Author

skonto commented Apr 21, 2021

@julz I separated the metrics in two categories admin, dev as discussed Pls review.

Copy link
Copy Markdown
Member

@evankanderson evankanderson left a comment

Choose a reason for hiding this comment

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

/lgtm
/approve

I expect we may move these docs around as we reorganize content to better serve different personas.

@knative-prow-robot knative-prow-robot added the lgtm Indicates that a PR is ready to be merged. label Apr 21, 2021
@knative-prow-robot
Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: evankanderson

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

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

@knative-prow-robot knative-prow-robot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Apr 21, 2021
@knative-prow-robot knative-prow-robot merged commit f52aea6 into knative:main Apr 21, 2021
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. cla: yes Indicates the PR's author has signed the CLA. lgtm Indicates that a PR is ready to be merged. 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.

Eventing metrics

3 participants