Merge branch 'main' into gcp_opt_dep_2

Author: emdneto

CHANGELOG.md

@@ -17,7 +17,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - build: bump ruff to 0.14.1
   ([#4782](https://github.com/open-telemetry/opentelemetry-python/pull/4782))
 - Add `opentelemetry-exporter-credential-provider-gcp` as an optional dependency to `opentelemetry-exporter-otlp-proto-grpc` 
-  and `opentelemetry-exporter-otlp-proto-http` ([#4760](https://github.com/open-telemetry/opentelemetry-python/pull/4760)).
+  and `opentelemetry-exporter-otlp-proto-http` 
+  ([#4760](https://github.com/open-telemetry/opentelemetry-python/pull/4760))
+- semantic-conventions: Bump to 1.38.0
+  ([#4791](https://github.com/open-telemetry/opentelemetry-python/pull/4791))
 
 ## Version 1.38.0/0.59b0 (2025-10-16)
 

opentelemetry-semantic-conventions/src/opentelemetry/semconv/_incubating/attributes/app_attributes.py

@@ -67,6 +67,18 @@
 The y (vertical) component of a screen coordinate, in screen pixels.
 """
 
+APP_SCREEN_ID: Final = "app.screen.id"
+"""
+An identifier that uniquely differentiates this screen from other screens in the same application.
+Note: A screen represents only the part of the device display drawn by the app. It typically contains multiple widgets or UI components and is larger in scope than individual widgets. Multiple screens can coexist on the same display simultaneously (e.g., split view on tablets).
+"""
+
+APP_SCREEN_NAME: Final = "app.screen.name"
+"""
+The name of an application screen.
+Note: A screen represents only the part of the device display drawn by the app. It typically contains multiple widgets or UI components and is larger in scope than individual widgets. Multiple screens can coexist on the same display simultaneously (e.g., split view on tablets).
+"""
+
 APP_WIDGET_ID: Final = "app.widget.id"
 """
 An identifier that uniquely differentiates this widget from other widgets in the same application.

opentelemetry-semantic-conventions/src/opentelemetry/semconv/_incubating/attributes/azure_attributes.py

@@ -35,7 +35,7 @@
 )
 """
 List of regions contacted during operation in the order that they were contacted. If there is more than one region listed, it indicates that the operation was performed on multiple regions i.e. cross-regional call.
-Note: Region name matches the format of `displayName` in [Azure Location API](https://learn.microsoft.com/rest/api/subscription/subscriptions/list-locations?view=rest-subscription-2021-10-01&tabs=HTTP#location).
+Note: Region name matches the format of `displayName` in [Azure Location API](https://learn.microsoft.com/rest/api/resources/subscriptions/list-locations).
 """
 
 AZURE_COSMOSDB_OPERATION_REQUEST_CHARGE: Final = (

opentelemetry-semantic-conventions/src/opentelemetry/semconv/_incubating/attributes/container_attributes.py

@@ -58,7 +58,7 @@
 CONTAINER_IMAGE_ID: Final = "container.image.id"
 """
 Runtime specific image identifier. Usually a hash algorithm followed by a UUID.
-Note: Docker defines a sha256 of the image id; `container.image.id` corresponds to the `Image` field from the Docker container inspect [API](https://docs.docker.com/engine/api/v1.43/#tag/Container/operation/ContainerInspect) endpoint.
+Note: Docker defines a sha256 of the image id; `container.image.id` corresponds to the `Image` field from the Docker container inspect [API](https://docs.docker.com/reference/api/engine/version/v1.43/#tag/Container/operation/ContainerInspect) endpoint.
 K8s defines a link to the container registry repository with digest `"imageID": "registry.azurecr.io /namespace/service/dockerfile@sha256:bdeabd40c3a8a492eaf9e8e44d0ebbb84bac7ee25ac0cf8a7159d25f62555625"`.
 The ID is assigned by the container runtime and can vary in different environments. Consider using `oci.manifest.digest` if it is important to identify the same image in different environments/runtimes.
 """
@@ -71,12 +71,12 @@
 CONTAINER_IMAGE_REPO_DIGESTS: Final = "container.image.repo_digests"
 """
 Repo digests of the container image as provided by the container runtime.
-Note: [Docker](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageInspect) and [CRI](https://github.com/kubernetes/cri-api/blob/c75ef5b473bbe2d0a4fc92f82235efd665ea8e9f/pkg/apis/runtime/v1/api.proto#L1237-L1238) report those under the `RepoDigests` field.
+Note: [Docker](https://docs.docker.com/reference/api/engine/version/v1.43/#tag/Image/operation/ImageInspect) and [CRI](https://github.com/kubernetes/cri-api/blob/c75ef5b473bbe2d0a4fc92f82235efd665ea8e9f/pkg/apis/runtime/v1/api.proto#L1237-L1238) report those under the `RepoDigests` field.
 """
 
 CONTAINER_IMAGE_TAGS: Final = "container.image.tags"
 """
-Container image tags. An example can be found in [Docker Image Inspect](https://docs.docker.com/engine/api/v1.43/#tag/Image/operation/ImageInspect). Should be only the `<tag>` section of the full name for example from `registry.example.com/my-org/my-image:<tag>`.
+Container image tags. An example can be found in [Docker Image Inspect](https://docs.docker.com/reference/api/engine/version/v1.43/#tag/Image/operation/ImageInspect). Should be only the `<tag>` section of the full name for example from `registry.example.com/my-org/my-image:<tag>`.
 """
 
 CONTAINER_LABEL_TEMPLATE: Final = "container.label"

opentelemetry-semantic-conventions/src/opentelemetry/semconv/_incubating/attributes/db_attributes.py

@@ -128,7 +128,7 @@
 
 DB_COSMOSDB_STATUS_CODE: Final = "db.cosmosdb.status_code"
 """
-Deprecated: Replaced by `db.response.status_code`.
+Deprecated: Use `db.response.status_code` instead.
 """
 
 DB_COSMOSDB_SUB_STATUS_CODE: Final = "db.cosmosdb.sub_status_code"
@@ -215,15 +215,18 @@
 `db.query.parameter.<key>` SHOULD match
 up with the parameterized placeholders present in `db.query.text`.
 
+It is RECOMMENDED to capture the value as provided by the application
+without attempting to do any case normalization.
+
 `db.query.parameter.<key>` SHOULD NOT be captured on batch operations.
 
 Examples:
 
 - For a query `SELECT * FROM users where username =  %s` with the parameter `"jdoe"`,
   the attribute `db.query.parameter.0` SHOULD be set to `"jdoe"`.
 
-- For a query `"SELECT * FROM users WHERE username = %(username)s;` with parameter
-  `username = "jdoe"`, the attribute `db.query.parameter.username` SHOULD be set to `"jdoe"`.
+- For a query `"SELECT * FROM users WHERE username = %(userName)s;` with parameter
+  `userName = "jdoe"`, the attribute `db.query.parameter.userName` SHOULD be set to `"jdoe"`.
 """
 
 DB_QUERY_SUMMARY: Final = "db.query.summary"
@@ -238,7 +241,7 @@
 
 DB_REDIS_DATABASE_INDEX: Final = "db.redis.database_index"
 """
-Deprecated: Replaced by `db.namespace`.
+Deprecated: Uncategorized.
 """
 
 DB_RESPONSE_RETURNED_ROWS: Final = "db.response.returned_rows"

opentelemetry-semantic-conventions/src/opentelemetry/semconv/_incubating/attributes/dns_attributes.py

@@ -22,5 +22,5 @@
 DNS_QUESTION_NAME: Final = "dns.question.name"
 """
 The name being queried.
-Note: If the name field contains non-printable characters (below 32 or above 126), those characters should be represented as escaped base 10 integers (\\DDD). Back slashes and quotes should be escaped. Tabs, carriage returns, and line feeds should be converted to \\t, \\r, and \\n respectively.
+Note: The name represents the queried domain name as it appears in the DNS query without any additional normalization.
 """

opentelemetry-semantic-conventions/src/opentelemetry/semconv/_incubating/attributes/enduser_attributes.py

@@ -34,7 +34,7 @@
 
 ENDUSER_ROLE: Final = "enduser.role"
 """
-Deprecated: Replaced by `user.roles`.
+Deprecated: Use `user.roles` instead.
 """
 
 ENDUSER_SCOPE: Final = "enduser.scope"

opentelemetry-semantic-conventions/src/opentelemetry/semconv/_incubating/attributes/event_attributes.py

@@ -16,5 +16,5 @@
 
 EVENT_NAME: Final = "event.name"
 """
-Deprecated: Replaced by EventName top-level field on the LogRecord.
+Deprecated: The value of this attribute MUST now be set as the value of the EventName field on the LogRecord to indicate that the LogRecord represents an Event.
 """

opentelemetry-semantic-conventions/src/opentelemetry/semconv/_incubating/attributes/faas_attributes.py

@@ -121,7 +121,7 @@
 - **Google Cloud Run (Services):** The [revision](https://cloud.google.com/run/docs/managing/revisions)
   (i.e., the function name plus the revision suffix).
 - **Google Cloud Functions:** The value of the
-  [`K_REVISION` environment variable](https://cloud.google.com/functions/docs/env-var#runtime_environment_variables_set_automatically).
+  [`K_REVISION` environment variable](https://cloud.google.com/run/docs/container-contract#services-env-vars).
 - **Azure Functions:** Not applicable. Do not set this attribute.
 """
 

opentelemetry-semantic-conventions/src/opentelemetry/semconv/_incubating/attributes/gcp_attributes.py

@@ -72,6 +72,67 @@
 The name of the workload as configured in AppHub.
 """
 
+GCP_APPHUB_DESTINATION_APPLICATION_CONTAINER: Final = (
+    "gcp.apphub_destination.application.container"
+)
+"""
+The container within GCP where the AppHub destination application is defined.
+"""
+
+GCP_APPHUB_DESTINATION_APPLICATION_ID: Final = (
+    "gcp.apphub_destination.application.id"
+)
+"""
+The name of the destination application as configured in AppHub.
+"""
+
+GCP_APPHUB_DESTINATION_APPLICATION_LOCATION: Final = (
+    "gcp.apphub_destination.application.location"
+)
+"""
+The GCP zone or region where the destination application is defined.
+"""
+
+GCP_APPHUB_DESTINATION_SERVICE_CRITICALITY_TYPE: Final = (
+    "gcp.apphub_destination.service.criticality_type"
+)
+"""
+Criticality of a destination workload indicates its importance to the business as specified in [AppHub type enum](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type).
+"""
+
+GCP_APPHUB_DESTINATION_SERVICE_ENVIRONMENT_TYPE: Final = (
+    "gcp.apphub_destination.service.environment_type"
+)
+"""
+Software lifecycle stage of a destination service as defined [AppHub environment type](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type_1).
+"""
+
+GCP_APPHUB_DESTINATION_SERVICE_ID: Final = "gcp.apphub_destination.service.id"
+"""
+The name of the destination service as configured in AppHub.
+"""
+
+GCP_APPHUB_DESTINATION_WORKLOAD_CRITICALITY_TYPE: Final = (
+    "gcp.apphub_destination.workload.criticality_type"
+)
+"""
+Criticality of a destination workload indicates its importance to the business as specified in [AppHub type enum](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type).
+"""
+
+GCP_APPHUB_DESTINATION_WORKLOAD_ENVIRONMENT_TYPE: Final = (
+    "gcp.apphub_destination.workload.environment_type"
+)
+"""
+Environment of a destination workload is the stage of a software lifecycle as provided in the [AppHub environment type](https://cloud.google.com/app-hub/docs/reference/rest/v1/Attributes#type_1).
+"""
+
+GCP_APPHUB_DESTINATION_WORKLOAD_ID: Final = (
+    "gcp.apphub_destination.workload.id"
+)
+"""
+The name of the destination workload as configured in AppHub.
+"""
+
 GCP_CLIENT_SERVICE: Final = "gcp.client.service"
 """
 Identifies the Google Cloud service for which the official client library is intended.
@@ -141,3 +202,47 @@ class GcpApphubWorkloadEnvironmentTypeValues(Enum):
     """Test environment."""
     DEVELOPMENT = "DEVELOPMENT"
     """Development environment."""
+
+
+class GcpApphubDestinationServiceCriticalityTypeValues(Enum):
+    MISSION_CRITICAL = "MISSION_CRITICAL"
+    """Mission critical service."""
+    HIGH = "HIGH"
+    """High impact."""
+    MEDIUM = "MEDIUM"
+    """Medium impact."""
+    LOW = "LOW"
+    """Low impact."""
+
+
+class GcpApphubDestinationServiceEnvironmentTypeValues(Enum):
+    PRODUCTION = "PRODUCTION"
+    """Production environment."""
+    STAGING = "STAGING"
+    """Staging environment."""
+    TEST = "TEST"
+    """Test environment."""
+    DEVELOPMENT = "DEVELOPMENT"
+    """Development environment."""
+
+
+class GcpApphubDestinationWorkloadCriticalityTypeValues(Enum):
+    MISSION_CRITICAL = "MISSION_CRITICAL"
+    """Mission critical service."""
+    HIGH = "HIGH"
+    """High impact."""
+    MEDIUM = "MEDIUM"
+    """Medium impact."""
+    LOW = "LOW"
+    """Low impact."""
+
+
+class GcpApphubDestinationWorkloadEnvironmentTypeValues(Enum):
+    PRODUCTION = "PRODUCTION"
+    """Production environment."""
+    STAGING = "STAGING"
+    """Staging environment."""
+    TEST = "TEST"
+    """Test environment."""
+    DEVELOPMENT = "DEVELOPMENT"
+    """Development environment."""