Skip to content

Add k8s.node.system_container.* metrics#3556

Merged
jsuereth merged 12 commits intoopen-telemetry:mainfrom
PlateauGao:feat/k8s-node-system-container-metrics
Apr 15, 2026
Merged

Add k8s.node.system_container.* metrics#3556
jsuereth merged 12 commits intoopen-telemetry:mainfrom
PlateauGao:feat/k8s-node-system-container-metrics

Conversation

@PlateauGao
Copy link
Copy Markdown
Contributor

@PlateauGao PlateauGao commented Mar 17, 2026

Fixes #3531

Changes

Add k8s.node.system_container.* metrics and a self describing attribute k8s.node.system_container.name to capture node-level system daemon metrics." Please refer to the issue for detailed proposal

Important

Pull requests acceptance are subject to the triage process as described in Issue and PR Triage Management.
PRs that do not follow the guidance above, may be automatically rejected and closed.

Merge requirement checklist

  • [x ] CONTRIBUTING.md guidelines followed.
  • [ x] Change log entry added, according to the guidelines in When to add a changelog entry.
    • If your PR does not need a change log, start the PR title with [chore]
  • [ x] Links to the prototypes or existing instrumentations (when adding or changing conventions)

@linux-foundation-easycla
Copy link
Copy Markdown

linux-foundation-easycla Bot commented Mar 17, 2026

CLA Signed

The committers listed above are authorized under a signed CLA.

@PlateauGao PlateauGao force-pushed the feat/k8s-node-system-container-metrics branch from 7f23391 to a53e042 Compare March 17, 2026 18:52
@PlateauGao PlateauGao force-pushed the feat/k8s-node-system-container-metrics branch from e5fc292 to fc8eddf Compare March 17, 2026 19:36
@PlateauGao PlateauGao marked this pull request as ready for review March 17, 2026 19:37
@PlateauGao PlateauGao requested review from a team as code owners March 17, 2026 19:37
Comment thread model/k8s/registry.yaml
Comment thread model/k8s/metrics.yaml Outdated
Comment thread model/k8s/metrics.yaml
@PlateauGao PlateauGao force-pushed the feat/k8s-node-system-container-metrics branch from 42ad719 to fc8eddf Compare March 18, 2026 14:30
Comment thread model/k8s/entities.yaml Outdated
Comment thread model/k8s/registry.yaml Outdated
Comment thread model/k8s/metrics.yaml
@PlateauGao
Copy link
Copy Markdown
Contributor Author

Hi @dashpole , I wonder if you could please take another look at this PR? Thanks!

Comment thread model/k8s/metrics.yaml Outdated
Comment thread model/k8s/metrics.yaml Outdated
Comment thread model/k8s/metrics.yaml
@PlateauGao
Copy link
Copy Markdown
Contributor Author

Hi @ChrsMark, I wonder what the process would be? I wonder if we need to wait for an approver and maintainer? Or I can try to reach out to one maintainer

@PlateauGao
Copy link
Copy Markdown
Contributor Author

Hi @jinja2, I wonder if you could please take another took and let me know if there is any other question? I think I need to have all comments resolved to get maintainer approval. Thanks!

@dashpole dashpole added the ready-to-merge Someone has identified that this PR has approvals, resolved conversations label Apr 9, 2026
Comment thread docs/registry/entities/k8s.md
@kamphaus kamphaus moved this to Ready to be Merged in Semantic Conventions Triage Apr 13, 2026
@github-project-automation github-project-automation Bot moved this from Ready to be Merged to Needs More Approval in Semantic Conventions Triage Apr 13, 2026
@PlateauGao
Copy link
Copy Markdown
Contributor Author

Looks we need one more approval from open-telemetry/specs-semconv-maintainers?

@jsuereth jsuereth added this pull request to the merge queue Apr 15, 2026
@jsuereth jsuereth moved this from Needs More Approval to Ready to be Merged in Semantic Conventions Triage Apr 15, 2026
Merged via the queue into open-telemetry:main with commit a21f24e Apr 15, 2026
18 checks passed
ChrsMark pushed a commit to open-telemetry/opentelemetry-collector-contrib that referenced this pull request Apr 30, 2026
…age`, `memory.working_set`) to the `kubeletstats` receiver (#47775)

#### Description
Adding a feature - Added 3 new optional metrics for system containers
(`cpu.time`, `cpu.usage`, `memory.working_set`) to the `kubeletstats`
receiver to capture node-level system daemon metrics as proposed in
semantic conventions. These metrics represent cgroup-level resource
trackers on the node that are not associated with any k8s Pod (e.g.,
kubelet, runtime).
#### Link to tracking issue
- Relates to Semantic Conventions Issue:
open-telemetry/semantic-conventions#3531
- Relates to Semantic Conventions PR:
open-telemetry/semantic-conventions#3556
#### Testing
- Added `TestScraperWithSystemContainerMetrics` in `scraper_test.go` to
verify the new metrics are collected correctly when enabled.
- Verified that all tests pass in the `kubeletstatsreceiver` directory.
- Updated golden files for existing tests to reflect the new default
state (metrics disabled).
#### Documentation
- Updated `metadata.yaml` and regenerated `documentation.md` using
`mdatagen`. The new metrics are listed in the "Optional Metrics"
section.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:k8s enhancement New feature or request ready-to-merge Someone has identified that this PR has approvals, resolved conversations

Projects

Status: Done
Archived in project

Development

Successfully merging this pull request may close these issues.

Proposal: Add new node-level system daemon metrics k8s.node.system_container.*

7 participants