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

[receiver/kubeletstats] Add note about metrics deprecation on specific release #34602

Conversation

ChrsMark
Copy link
Member

Description:

Addresses #27885 (comment).

Link to tracking Issue:

Testing:

Documentation:

@ChrsMark ChrsMark requested a review from a team August 12, 2024 07:30
@ChrsMark ChrsMark added the chore label Aug 12, 2024
@ChrsMark ChrsMark force-pushed the advertise_more_the_utilization_deprecation branch from 469324e to c087824 Compare August 12, 2024 07:35
@ChrsMark ChrsMark added the Skip Changelog PRs that do not require a CHANGELOG.md entry label Aug 12, 2024
@ChrsMark
Copy link
Member Author

Note this is just my suggestion for the target release. We should wait for confirmation at #27885 (comment).

…c release

Signed-off-by: ChrsMark <chrismarkou92@gmail.com>
@ChrsMark ChrsMark force-pushed the advertise_more_the_utilization_deprecation branch from c087824 to 49accc7 Compare August 12, 2024 08:26
Comment on lines 296 to 299
Users can use the following metrics instead:
- `k8s.node.usage`
- `k8s.pod.usage`
- `container.usage`
Copy link
Member

Choose a reason for hiding this comment

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

Out of ignorance, what's the relevance of this section? The comment above shares which metrics are being removed, and what metric they're being replaced by. This appears to be somewhat duplicating the "replaced by" message, but with different metrics. (I very well may be missing something, just want to check.)

Copy link
Member Author

Choose a reason for hiding this comment

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

Good catch! Actually there was a *.cpu.* part missing by mistake there. Thank's for spotting this!

Signed-off-by: ChrsMark <chrismarkou92@gmail.com>
Comment on lines +289 to +302
### Warning about metrics' deprecation

The following metrics will be removed in `v0.111.0` version:
- `k8s.node.cpu.utilization` (replaced by `k8s.node.cpu.usage`)
- `k8s.pod.cpu.utilization` (replaced by `k8s.pod.cpu.usage`)
- `container.cpu.utilization` (replaced by `container.cpu.usage`)

Users can use the following metrics instead:
- `k8s.node.cpu.usage`
- `k8s.pod.cpu.usage`
- `container.cpu.usage`

More information about the deprecation plan and
the background reasoning can be found at https://github.com/open-telemetry/opentelemetry-collector-contrib/issues/27885.
Copy link
Member

Choose a reason for hiding this comment

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

I like the idea of adding something that explicitly stated "this is a rename, the values are exactly the same as before, only the metric name has changed to be in alignment with the OpenTelemetry specification".

@ChrsMark ChrsMark marked this pull request as draft August 13, 2024 06:45
@ChrsMark
Copy link
Member Author

Marked it as draft while we wait for a decision at #27885.

Copy link
Contributor

This PR was marked stale due to lack of activity. It will be closed in 14 days.

@github-actions github-actions bot added the Stale label Aug 28, 2024
Copy link
Contributor

Closed as inactive. Feel free to reopen if this PR is still being worked on.

@github-actions github-actions bot closed this Sep 11, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
chore receiver/kubeletstats Skip Changelog PRs that do not require a CHANGELOG.md entry Stale
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants