Skip to content

Update the semantic conventions version to 1.44.0 - #549

Open
otelbot-semantic-conventions-java[bot] wants to merge 3 commits into
mainfrom
otelbot/update-semconv-to-1.44.0
Open

Update the semantic conventions version to 1.44.0#549
otelbot-semantic-conventions-java[bot] wants to merge 3 commits into
mainfrom
otelbot/update-semconv-to-1.44.0

Conversation

@otelbot-semantic-conventions-java

Copy link
Copy Markdown
Contributor

Update the semantic conventions version to 1.44.0.

Copilot AI lite review requested due to automatic review settings August 4, 2026 20:18

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot could not run the full agentic suite for this review because it was automatically requested on a bot-authored pull request. Request a review from Copilot under Reviewers to retry with the full agentic suite. Improved support for bot-authored pull requests is coming soon.

Updates the generated semantic convention constants and docs to align with semantic-conventions v1.44.0, including new schema URLs, new metrics/attributes, and various documentation wording tweaks.

Changes:

  • Bump semantic conventions generator input to v1.44.0 and add schema URL constant for 1.44.0.
  • Add newly introduced v1.44.0 metrics/attributes (e.g., browser web vitals, Kafka cluster ID, new process/system/k8s metrics).
  • Update/normalize many Javadoc strings (capitalization, terminology, links).

Reviewed changes

Copilot reviewed 43 out of 46 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
semconv/src/main/java/io/opentelemetry/semconv/TelemetryAttributes.java Updates SDK language value Javadocs with documentation links.
semconv/src/main/java/io/opentelemetry/semconv/ServerAttributes.java Javadoc wording normalization (“UNIX”).
semconv/src/main/java/io/opentelemetry/semconv/SchemaUrls.java Adds schema URL constant for v1.44.0.
semconv/src/main/java/io/opentelemetry/semconv/NetworkAttributes.java Javadoc wording normalization (“UNIX”).
semconv/src/main/java/io/opentelemetry/semconv/ContainerAttributes.java Javadoc wording clarification (“Repository digests”).
semconv/src/main/java/io/opentelemetry/semconv/CodeAttributes.java Javadoc wording normalization (“filename”).
semconv/src/main/java/io/opentelemetry/semconv/ClientAttributes.java Javadoc wording normalization (“UNIX”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/UrlIncubatingAttributes.java Javadoc wording normalization (URL/filename/hostname).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/TlsIncubatingAttributes.java Javadoc normalization for TLS protocol value labels.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/TelemetryIncubatingAttributes.java Updates SDK language value Javadocs with documentation links.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/SystemIncubatingMetrics.java Adds system.process.limit metric constants and updates UNIX wording.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/SourceIncubatingAttributes.java Javadoc wording normalization (“UNIX”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/SessionIncubatingAttributes.java Javadoc wording normalization (“ID”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/ServerIncubatingAttributes.java Javadoc wording normalization (“UNIX”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/RpcIncubatingAttributes.java Removes a portion of method fallback guidance from Javadoc.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/ProcessIncubatingMetrics.java Adds new process metrics and normalizes UNIX wording.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/PprofIncubatingAttributes.java Expands “regexp” to “regular expression” in Javadoc.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/OtelIncubatingAttributes.java Javadoc wording normalization (“built-in”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/OsIncubatingAttributes.java Javadoc wording normalization (“UNIX”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/OracleIncubatingAttributes.java Javadoc normalization (“SQL”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/NetworkIncubatingAttributes.java Javadoc normalization (Wi‑Fi/UNIX) and enum doc tweaks.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/NetIncubatingAttributes.java Javadoc wording normalization (“UNIX”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/MessagingIncubatingAttributes.java Adds Kafka cluster ID attribute; Javadoc wording edits.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/McpIncubatingAttributes.java Javadoc wording normalization (“URI”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/LogIncubatingAttributes.java Javadoc wording normalization (“ID”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/K8sIncubatingMetrics.java Adds inode + paging metrics and deprecates old paging metric names.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/HwIncubatingMetrics.java Adds/updates hw.* metric constants (but introduces duplicate field declarations).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/HostIncubatingAttributes.java Javadoc wording normalization (“UNIX”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/GenAiIncubatingEvents.java Javadoc wording normalization (“ID”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/FileIncubatingAttributes.java Javadoc wording normalization (“filename”, “internet”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/DestinationIncubatingAttributes.java Javadoc wording normalization (“UNIX”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/DeploymentIncubatingAttributes.java Javadoc wording normalization (“ID”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/DbIncubatingAttributes.java Adds privacy/sanitization guidance to Javadoc and improves deprecation note.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/ContainerIncubatingMetrics.java Adds container.paging.faults and deprecates old paging metric names.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/ContainerIncubatingAttributes.java Javadoc wording normalization (Docker/ID/Repository digests).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/CodeIncubatingAttributes.java Javadoc wording normalization (“filename”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/CloudfoundryIncubatingAttributes.java Javadoc wording normalization (“ID”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/CloudIncubatingAttributes.java Adds Scaleway provider/platform enum values.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/ClientIncubatingAttributes.java Javadoc wording normalization (“UNIX”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/BrowserIncubatingAttributes.java Adds browser web-vitals attributes, enums, and required doubleKey import.
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/ArtifactIncubatingAttributes.java Javadoc wording normalization (“ID”, “filename”).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/AppIncubatingAttributes.java Javadoc wording normalization (hyphenation).
semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/AndroidIncubatingAttributes.java Javadoc capitalization normalization (“Android”).
docs/apidiffs/current_vs_latest/opentelemetry-semconv.txt Updates API diff report for 1.44.0 snapshot vs 1.43.0.
build.gradle.kts Bumps semanticConventionsVersion to 1.44.0 and updates schema URL versions list.
CHANGELOG.md Notes the bump to semconv v1.44.0.
Suppressed comments (2)

semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/SystemIncubatingMetrics.java:1

  • SYSTEM_PROCESS_LIMIT_UNIT is set to "{thread}", but the metric name/description indicate it measures a process/task limit, not threads. Update the unit to match the measured entity (e.g., a "{process}"-style unit or a dimensionless count per the semconv spec) to avoid misleading metric metadata.
    semconv-incubating/src/main/java/io/opentelemetry/semconv/incubating/ProcessIncubatingMetrics.java:1
  • The unit for PROCESS_MEMORY_UTILIZATION is "1" (ratio), but the description calls it a "Percentage". Either adjust the description to describe a ratio/fraction, or change the unit to a percent-based unit if the value is intended to be 0–100. Keeping these consistent avoids confusion for metric consumers.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 2180ba88-b854-4f05-8c58-8e183cbd20b3
}) | map({
root_namespace: .root_namespace,
metrics: .metrics
metrics: [.metrics[] | select(.id == ("metric." + .metric_name))]

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.

cc @lmolkova is this expected that we need to filter out duplicates now due to refinements? (we got duplicate constants for the hw.errors metric)

@lmolkova lmolkova Aug 6, 2026

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 expected, looking

update: sent a fix open-telemetry/weaver#1676 - I'll try to get weaver released in the next few days, but if you're in hurry go ahead with the workaround - it looks good

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants