Update the semantic conventions version to 1.44.0 - #549
Update the semantic conventions version to 1.44.0#549otelbot-semantic-conventions-java[bot] wants to merge 3 commits into
Conversation
There was a problem hiding this comment.
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))] |
There was a problem hiding this comment.
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)
There was a problem hiding this comment.
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
Update the semantic conventions version to
1.44.0.