Promote attributes used by hostmetrics system metrics to RC by osullivandonal · Pull Request #4055 · open-telemetry/semantic-conventions

osullivandonal · 2026-08-31T13:05:28Z

Works towards #1804

Changes

Promotes to release candidate all attributes referenced by the system metrics that are emitted by the hostmetrics receiver. A follow-on PR will promote the corresponding system metrics to release candidate.

Some of the attributes here are not referenced directly by the hostmetrics receiver's configuration, the reason they have been moved to RC is that the metric that uses the attribute is being used by hostmetrics receiver.

Note: this work also touches the cpu and network registries, since some attributes used by system metrics live in those namespaces.

These attributes have been promoted to RC:

- system.device
- system.memory.state
- system.memory.linux.hugepages.state
- system.paging.state
- system.paging.direction
- system.filesystem.state
- system.filesystem.type
- system.filesystem.mode
- system.filesystem.mountpoint
- cpu.logical_number
- network.connection.state

system.device (device)
- pagingscraper/metadata.yaml
  (https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/pagingscraper/metadata.yaml)
- filesystemscraper/metadata.yaml
  (https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/filesystemscraper/metadata.yaml)
- networkscraper/metadata.yaml
  (https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/networkscraper/metadata.yaml)
system.memory.state (state) — memoryscraper/metadata.yaml
(https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/memoryscraper/metadata.yaml)
system.memory.linux.hugepages.state (system.memory.linux.hugepages.state) — memoryscraper/metadata.yaml
(https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/memoryscraper/metadata.yaml)
system.paging.state (state) — pagingscraper/metadata.yaml
(https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/pagingscraper/metadata.yaml)
system.paging.direction (direction) — pagingscraper/metadata.yaml
(https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/pagingscraper/metadata.yaml)
system.filesystem.state (state) — filesystemscraper/metadata.yaml
(https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/filesystemscraper/metadata.yaml)
system.filesystem.type (type) — filesystemscraper/metadata.yaml
(https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/filesystemscraper/metadata.yaml)
system.filesystem.mode (mode) — filesystemscraper/metadata.yaml
(https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/filesystemscraper/metadata.yaml)
system.filesystem.mountpoint (mountpoint) — filesystemscraper/metadata.yaml
(https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/filesystemscraper/metadata.yaml)
cpu.logical_number (cpu) — cpuscraper/metadata.yaml
(https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/cpuscraper/metadata.yaml)
network.connection.state (state) — networkscraper/metadata.yaml
(https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/hostmetricsreceiver/internal/scraper/networkscraper/metadata.yaml)

Important

Pull request acceptance is 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

CONTRIBUTING.md guidelines followed.
Links to prototypes or existing instrumentations (when adding or changing conventions)
Disclose AI usage, see OTel GenAI policy:
- no AI used
- AI-assisted
- bulk AI-generated
I have the experience and knowledge necessary to understand, review, and validate all content in this PR.¹

Yes, I can answer maintainer questions about the content of this PR without using AI. ↩

Copilot

Pull request overview

Promotes several attribute definitions (primarily in the system namespace, plus related cpu and network attributes used by system metrics) from development to release_candidate, and updates the generated registry/docs surfaces and changelog accordingly as part of the broader effort to stabilize system semantic conventions (#1804).

Changes:

Updated attribute stability to release_candidate for system.device, several system.memory.*/system.paging.* enums, and system.filesystem.* attributes.
Promoted related attributes in other namespaces used by system metrics (cpu.logical_number, network.connection.state) to release_candidate.
Refreshed the generated attribute registry docs and added a .chloggen entry.

Reviewed changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
model/system/registry.yaml	Promotes multiple `system.*` attributes/enums to release candidate.
model/network/registry.yaml	Promotes `network.connection.state` enum members and attribute to release candidate.
model/cpu/registry.yaml	Promotes `cpu.logical_number` to release candidate.
docs/system/container-metrics.md	Updates rendered stability badge for `system.device` in system container metrics docs.
docs/registry/attributes/system.md	Updates generated registry page stability badges for affected `system.*` attributes/enums.
docs/registry/attributes/network.md	Updates generated registry page stability badges for `network.connection.state`.
docs/registry/attributes/cpu.md	Updates generated registry page stability badge for `cpu.logical_number`.
.chloggen/promote-system-attributes-used-in-hostmetrics.yaml	Adds changelog entry describing the promotion.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

osullivandonal · 2026-08-31T13:31:46Z

+              stability: release_candidate
              deprecated:
                reason: uncategorized
                note: "Removed, report shared memory usage with `metric.system.memory.linux.shared` metric"


Good spot, the attribute shared should not be promoted to RC as its deprecated. This has been removed.

-        stability: development
+        stability: release_candidate
        brief: "The filesystem mode"
        examples: ["rw, ro"]


opentelemetry-pr-dashboard · 2026-08-31T13:54:08Z

Pull request dashboard status

Waiting on reviewers · refreshed 2026-09-22 15:48 UTC

Review the latest changes.

Status above doesn't look right?

Just replied or pushed? Anything around or after the refresh time above may not be picked up yet — give it a few minutes.
Anything look wrong? Report it with what you expected; it helps us improve the dashboard.

ChrsMark

Overall looks good to me. Left one question about the linux slab state attribute.

lmolkova · 2026-09-06T03:17:10Z


 # A brief description of the change. Surround your text with quotes ("") if it needs to start with a backtick (`).
-note: Promote `jvm.file_descriptor.count` and `jvm.file_descriptor.limit` metrics to `release_candidate`
+note: Promote attributes used by hostmetrics system metrics to RC


it seems there are some outstanding issues affecting some of these attributes. They maybe out-of-date and maybe SIG decided on them long time ago, but please, can you go through and resolve them? Thanks

[#1474](system.device vs device.id vs hw.id #1474) - system.device - Could rename it to system.device.id, merge it with hw.id, or turn system.device into a namespace. This directly changes the attribute name or meaning.

[#3826](Mark system.filesystem.* attributes as release candidate #3826) - system.filesystem.state, system.filesystem.mode, system.filesystem.mountpoint, system.filesystem.type - Could rename state, revise value meanings, or change definitions to cover non-Unix systems consistently.

[#3986]([k8s][system] Reconcile k8s/container filesystem metrics with system.filesystem.* #3986) - system.filesystem.state - A different model could replace the state attribute with separate usage and available metrics. Recent discussion favors keeping the current model, so this risk is lower.

[#2934](Inform reader cpu logical number refers to core number #2934) - cpu.logical_number - Could clarify or change whether the value identifies a logical processor, hardware thread, or core. Existing producers may then have the wrong interpretation.

[#3659](Clarification needed between CPU-related namespaces #3659) - cpu.logical_number - Could change the scope of cpu.* attributes or move CPU identification into an entity-based model.

[#2991](Align cpu hw metrics with system cpu metrics #2991) - cpu.logical_number - Could deprecate the system.cpu.* metrics that currently use this attribute, potentially leaving it without those consumers.

This list is generated with AI, feel free to push back on relevance.

Will take this back to SIG to discuss.

PR created to rename system.device to system.device.name: #4119

Promotes to release candidate all attributes referenced by the system metrics that are emitted by the hostmetrics receiver. A follow-on PR will promote the corresponding system metrics to release candidate.

Copilot AI lite review requested due to automatic review settings August 31, 2026 13:05

osullivandonal requested review from a team as code owners August 31, 2026 13:05

github-project-automation Bot added this to Semantic Conventions Triage Aug 31, 2026

github-project-automation Bot moved this to Untriaged in Semantic Conventions Triage Aug 31, 2026

github-actions Bot added enhancement New feature or request area:system labels Aug 31, 2026

Copilot started reviewing on behalf of osullivandonal August 31, 2026 13:08 View session

Copilot AI reviewed Aug 31, 2026

View reviewed changes

osullivandonal force-pushed the promote-system-attributes-used-in-hostmetrics branch 2 times, most recently from dc06045 to c82d5bf Compare August 31, 2026 13:31

opentelemetry-pr-dashboard Bot mentioned this pull request Aug 31, 2026

Pull Request Dashboard #3912

Open

Dipanshusinghh approved these changes Sep 2, 2026

View reviewed changes

ChrsMark reviewed Sep 2, 2026

View reviewed changes

Comment thread model/system/registry.yaml Outdated

osullivandonal force-pushed the promote-system-attributes-used-in-hostmetrics branch from c82d5bf to e06b025 Compare September 2, 2026 08:42

ChrsMark approved these changes Sep 3, 2026

View reviewed changes

dmitryax approved these changes Sep 3, 2026

View reviewed changes

rogercoll approved these changes Sep 4, 2026

View reviewed changes

mx-psi approved these changes Sep 4, 2026

View reviewed changes

lmolkova reviewed Sep 6, 2026

View reviewed changes

Comment thread .chloggen/promote-system-attributes-used-in-hostmetrics.yaml

lmolkova moved this from Untriaged to Needs More Approval in Semantic Conventions Triage Sep 16, 2026

Promote attributes used by hostmetrics system metrics to RC

47f90e6

Promotes to release candidate all attributes referenced by the system metrics that are emitted by the hostmetrics receiver. A follow-on PR will promote the corresponding system metrics to release candidate.

osullivandonal force-pushed the promote-system-attributes-used-in-hostmetrics branch from e06b025 to 47f90e6 Compare September 22, 2026 15:46

osullivandonal requested a review from a team as a code owner September 22, 2026 15:46

Navigation Menu

Promote attributes used by hostmetrics system metrics to RC - #4055

Promote attributes used by hostmetrics system metrics to RC#4055
osullivandonal wants to merge 1 commit into
open-telemetry:mainfrom
osullivandonal:promote-system-attributes-used-in-hostmetrics

osullivandonal commented Aug 31, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

osullivandonal Aug 31, 2026

Uh oh!

opentelemetry-pr-dashboard Bot commented Aug 31, 2026 •

edited

Loading

Uh oh!

ChrsMark left a comment

Uh oh!

Uh oh!

lmolkova Sep 6, 2026

Uh oh!

osullivandonal Sep 9, 2026

Uh oh!

osullivandonal Sep 17, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

Conversation

osullivandonal commented Aug 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Merge requirement checklist

Footnotes

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

osullivandonal Aug 31, 2026

Choose a reason for hiding this comment

Uh oh!

opentelemetry-pr-dashboard Bot commented Aug 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Pull request dashboard status

Uh oh!

ChrsMark left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

lmolkova Sep 6, 2026

Choose a reason for hiding this comment

Uh oh!

osullivandonal Sep 9, 2026

Choose a reason for hiding this comment

Uh oh!

osullivandonal Sep 17, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

8 participants

osullivandonal commented Aug 31, 2026 •

edited

Loading

opentelemetry-pr-dashboard Bot commented Aug 31, 2026 •

edited

Loading