Bump semconv to 1.41.1 (open-telemetry#5200)

* semconv: use spdx headers

* Bump scripts

* WIP build 1.41.0 semconv

* Add exclusion list for metrics and rebuild

* Add changelog

* Bump to 1.41.1 so we can drop our own metrics filtering

* Use changelog fragment

---------

Co-authored-by: Emídio Neto <9735060+emdneto@users.noreply.github.com>

Author: xrmx

.changelog/5200.changed

@@ -0,0 +1 @@
+`opentelemetry-semantic-conventions`: Bump semantic conventions to 1.41.1, this changes the metrics name of `K8S_CONTAINER_CPU_LIMIT_UTILIZATION` and `K8S_CONTAINER_CPU_REQUEST_UTILIZATION`.

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

@@ -198,7 +198,7 @@
 
 AWS_LAMBDA_RESOURCE_MAPPING_ID: Final = "aws.lambda.resource_mapping.id"
 """
-The UUID of the [AWS Lambda EvenSource Mapping](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html). An event source is mapped to a lambda function. It's contents are read by Lambda and used to trigger a function. This isn't available in the lambda execution context or the lambda runtime environtment. This is going to be populated by the AWS SDK for each language when that UUID is present. Some of these operations are Create/Delete/Get/List/Update EventSourceMapping.
+The UUID of the [AWS Lambda EvenSource Mapping](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-eventsourcemapping.html). An event source is mapped to a lambda function. It's contents are read by Lambda and used to trigger a function. This isn't available in the lambda execution context or the lambda runtime environment. This is going to be populated by the AWS SDK for each language when that UUID is present. Some of these operations are Create/Delete/Get/List/Update EventSourceMapping.
 """
 
 AWS_LOG_GROUP_ARNS: Final = "aws.log.group.arns"
@@ -301,7 +301,7 @@
 
 AWS_SECRETSMANAGER_SECRET_ARN: Final = "aws.secretsmanager.secret.arn"
 """
-The ARN of the Secret stored in the Secrets Mangger.
+The ARN of the Secret stored in the Secrets Manager.
 """
 
 AWS_SNS_TOPIC_ARN: Final = "aws.sns.topic.arn"

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

@@ -42,6 +42,7 @@
 CICD_PIPELINE_TASK_RUN_ID: Final = "cicd.pipeline.task.run.id"
 """
 The unique identifier of a task run within a pipeline.
+Note: For a given pipeline run and task, the `cicd.pipeline.task.run.id` MUST be unique within that run. For the same task across different runs of the same pipeline, the `cicd.pipeline.task.run.id` MAY remain the same, enabling correlation of `cicd.pipeline.task.run.result` values across multiple pipeline runs.
 """
 
 CICD_PIPELINE_TASK_RUN_RESULT: Final = "cicd.pipeline.task.run.result"

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

@@ -91,7 +91,7 @@
 
 CONTAINER_RUNTIME_DESCRIPTION: Final = "container.runtime.description"
 """
-A description about the runtime which could include, for example details about the CRI/API version being used or other customisations.
+A description about the runtime which could include, for example details about the CRI/API version being used or other customizations.
 """
 
 CONTAINER_RUNTIME_NAME: Final = "container.runtime.name"

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

@@ -4,21 +4,16 @@
 from enum import Enum
 from typing import Final
 
+from typing_extensions import deprecated
+
 DEPLOYMENT_ENVIRONMENT: Final = "deployment.environment"
 """
 Deprecated: Replaced by `deployment.environment.name`.
 """
 
 DEPLOYMENT_ENVIRONMENT_NAME: Final = "deployment.environment.name"
 """
-Name of the [deployment environment](https://wikipedia.org/wiki/Deployment_environment) (aka deployment tier).
-Note: `deployment.environment.name` does not affect the uniqueness constraints defined through
-the `service.namespace`, `service.name` and `service.instance.id` resource attributes.
-This implies that resources carrying the following attribute combinations MUST be
-considered to be identifying the same service:
-
-- `service.name=frontend`, `deployment.environment.name=production`
-- `service.name=frontend`, `deployment.environment.name=staging`.
+Deprecated in favor of stable :py:const:`opentelemetry.semconv.attributes.deployment_attributes.DEPLOYMENT_ENVIRONMENT_NAME`.
 """
 
 DEPLOYMENT_ID: Final = "deployment.id"
@@ -37,6 +32,20 @@
 """
 
 
+@deprecated(
+    "Deprecated in favor of stable :py:const:`opentelemetry.semconv.attributes.deployment_attributes.DeploymentEnvironmentNameValues`."
+)
+class DeploymentEnvironmentNameValues(Enum):
+    PRODUCTION = "production"
+    """Deprecated in favor of stable :py:const:`opentelemetry.semconv.attributes.deployment_attributes.DeploymentEnvironmentNameValues.PRODUCTION`."""
+    STAGING = "staging"
+    """Deprecated in favor of stable :py:const:`opentelemetry.semconv.attributes.deployment_attributes.DeploymentEnvironmentNameValues.STAGING`."""
+    TEST = "test"
+    """Deprecated in favor of stable :py:const:`opentelemetry.semconv.attributes.deployment_attributes.DeploymentEnvironmentNameValues.TEST`."""
+    DEVELOPMENT = "development"
+    """Deprecated in favor of stable :py:const:`opentelemetry.semconv.attributes.deployment_attributes.DeploymentEnvironmentNameValues.DEVELOPMENT`."""
+
+
 class DeploymentStatusValues(Enum):
     FAILED = "failed"
     """failed."""

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

@@ -232,6 +232,11 @@
 List of sequences that the model will use to stop generating further tokens.
 """
 
+GEN_AI_REQUEST_STREAM: Final = "gen_ai.request.stream"
+"""
+Indicates whether the GenAI request was made in streaming mode.
+"""
+
 GEN_AI_REQUEST_TEMPERATURE: Final = "gen_ai.request.temperature"
 """
 The temperature setting for the GenAI request.
@@ -262,6 +267,13 @@
 The name of the model that generated the response.
 """
 
+GEN_AI_RESPONSE_TIME_TO_FIRST_CHUNK: Final = (
+    "gen_ai.response.time_to_first_chunk"
+)
+"""
+Time to first chunk in a streaming response, measured from request issuance, in seconds. The value is measured from when the client issues the generation request to when the first chunk is received in the response stream.
+"""
+
 GEN_AI_RETRIEVAL_DOCUMENTS: Final = "gen_ai.retrieval.documents"
 """
 The documents retrieved.
@@ -345,16 +357,16 @@
 
 GEN_AI_TOOL_DEFINITIONS: Final = "gen_ai.tool.definitions"
 """
-The list of source system tool definitions available to the GenAI agent or model.
-Note: The value of this attribute matches source system tool definition format.
+The list of tool definitions available to the GenAI agent or model.
+Note: Instrumentations MUST follow [Tool Definitions JSON Schema](/docs/gen-ai/gen-ai-tool-definitions.json).
 
-It's expected to be an array of objects where each object represents a tool definition. In case a serialized string is available
-to the instrumentation, the instrumentation SHOULD do the best effort to
-deserialize it to an array. When recorded on spans, it MAY be recorded as a JSON string if structured format is not supported and SHOULD be recorded in structured form otherwise.
+When the attribute is recorded on events, it MUST be recorded in structured
+form. When recorded on spans, it MAY be recorded as a JSON string if structured
+format is not supported and SHOULD be recorded in structured form otherwise.
 
 Since this attribute could be large, it's NOT RECOMMENDED to populate
-it by default. Instrumentations MAY provide a way to enable
-populating this attribute.
+non-required properties by default. Instrumentations MAY provide a way
+to enable populating optional properties.
 """
 
 GEN_AI_TOOL_DESCRIPTION: Final = "gen_ai.tool.description"
@@ -417,6 +429,20 @@
 Deprecated: Replaced by `gen_ai.usage.input_tokens`.
 """
 
+GEN_AI_USAGE_REASONING_OUTPUT_TOKENS: Final = (
+    "gen_ai.usage.reasoning.output_tokens"
+)
+"""
+The number of output tokens used for reasoning (e.g. chain-of-thought, extended thinking).
+Note: The value SHOULD be included in `gen_ai.usage.output_tokens`.
+"""
+
+GEN_AI_WORKFLOW_NAME: Final = "gen_ai.workflow.name"
+"""
+Human-readable name of the GenAI workflow provided by the application.
+Note: This attribute can be populated in different frameworks eg: name of the first chain in LangChain OR name of the crew in CrewAI.
+"""
+
 
 @deprecated(
     "The attribute gen_ai.openai.request.response_format is deprecated - Replaced by `gen_ai.output.type`"
@@ -457,6 +483,8 @@ class GenAiOperationNameValues(Enum):
     """Invoke GenAI agent."""
     EXECUTE_TOOL = "execute_tool"
     """Execute a tool."""
+    INVOKE_WORKFLOW = "invoke_workflow"
+    """Invoke GenAI workflow."""
 
 
 class GenAiOutputTypeValues(Enum):
@@ -486,7 +514,7 @@ class GenAiProviderNameValues(Enum):
     AZURE_AI_INFERENCE = "azure.ai.inference"
     """Azure AI Inference."""
     AZURE_AI_OPENAI = "azure.ai.openai"
-    """[Azure OpenAI](https://azure.microsoft.com/products/ai-services/openai-service/)."""
+    """[Azure OpenAI](https://learn.microsoft.com/en-us/azure/ai-services/openai/overview)."""
     IBM_WATSONX_AI = "ibm.watsonx.ai"
     """[IBM Watsonx AI](https://www.ibm.com/products/watsonx-ai)."""
     AWS_BEDROCK = "aws.bedrock"

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

@@ -7,7 +7,7 @@
 GRAPHQL_DOCUMENT: Final = "graphql.document"
 """
 The GraphQL document being executed.
-Note: The value may be sanitized to exclude sensitive information.
+Note: If instrumentation can reliably identify and redact sensitive information it SHOULD do it.
 """
 
 GRAPHQL_OPERATION_NAME: Final = "graphql.operation.name"

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

@@ -6,7 +6,7 @@
 
 HW_BATTERY_CAPACITY: Final = "hw.battery.capacity"
 """
-Design capacity in Watts-hours or Amper-hours.
+Design capacity in Watts-hours or Ampere-hours.
 """
 
 HW_BATTERY_CHEMISTRY: Final = "hw.battery.chemistry"

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

@@ -314,11 +314,111 @@
 The name of the Node.
 """
 
+K8S_NODE_SYSTEM_CONTAINER_NAME: Final = "k8s.node.system_container.name"
+"""
+The name of the system container running on the K8s Node.
+"""
+
 K8S_NODE_UID: Final = "k8s.node.uid"
 """
 The UID of the Node.
 """
 
+K8S_PERSISTENTVOLUME_ANNOTATION_TEMPLATE: Final = (
+    "k8s.persistentvolume.annotation"
+)
+"""
+The annotation placed on the PersistentVolume, the `<key>` being the annotation name, the value being the annotation value, even if the value is empty.
+Note: Examples:
+
+- An annotation `pv.kubernetes.io/provisioned-by` with value `kubernetes.io/aws-ebs` SHOULD be recorded as
+  the `k8s.persistentvolume.annotation.pv.kubernetes.io/provisioned-by` attribute with value `"kubernetes.io/aws-ebs"`.
+- An annotation `data` with empty string value SHOULD be recorded as
+  the `k8s.persistentvolume.annotation.data` attribute with value `""`.
+"""
+
+K8S_PERSISTENTVOLUME_LABEL_TEMPLATE: Final = "k8s.persistentvolume.label"
+"""
+The label placed on the PersistentVolume, the `<key>` being the label name, the value being the label value, even if the value is empty.
+Note: Examples:
+
+- A label `type` with value `ssd` SHOULD be recorded as
+  the `k8s.persistentvolume.label.type` attribute with value `"ssd"`.
+- A label `data` with empty string value SHOULD be recorded as
+  the `k8s.persistentvolume.label.data` attribute with value `""`.
+"""
+
+K8S_PERSISTENTVOLUME_NAME: Final = "k8s.persistentvolume.name"
+"""
+The name of the PersistentVolume.
+"""
+
+K8S_PERSISTENTVOLUME_RECLAIM_POLICY: Final = (
+    "k8s.persistentvolume.reclaim_policy"
+)
+"""
+The reclaim policy of the PersistentVolume.
+Note: This attribute aligns with the `persistentVolumeReclaimPolicy` field of the
+[K8s PersistentVolumeSpec](https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-v1/#PersistentVolumeSpec).
+"""
+
+K8S_PERSISTENTVOLUME_STATUS_PHASE: Final = "k8s.persistentvolume.status.phase"
+"""
+The phase of the PersistentVolume.
+Note: This attribute aligns with the `phase` field of the
+[K8s PersistentVolumeStatus](https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-v1/#PersistentVolumeStatus).
+"""
+
+K8S_PERSISTENTVOLUME_UID: Final = "k8s.persistentvolume.uid"
+"""
+The UID of the PersistentVolume.
+"""
+
+K8S_PERSISTENTVOLUMECLAIM_ANNOTATION_TEMPLATE: Final = (
+    "k8s.persistentvolumeclaim.annotation"
+)
+"""
+The annotation placed on the PersistentVolumeClaim, the `<key>` being the annotation name, the value being the annotation value, even if the value is empty.
+Note: Examples:
+
+- An annotation `volume.beta.kubernetes.io/storage-provisioner` with value `kubernetes.io/aws-ebs` SHOULD be recorded as
+  the `k8s.persistentvolumeclaim.annotation.volume.beta.kubernetes.io/storage-provisioner` attribute with value `"kubernetes.io/aws-ebs"`.
+- An annotation `data` with empty string value SHOULD be recorded as
+  the `k8s.persistentvolumeclaim.annotation.data` attribute with value `""`.
+"""
+
+K8S_PERSISTENTVOLUMECLAIM_LABEL_TEMPLATE: Final = (
+    "k8s.persistentvolumeclaim.label"
+)
+"""
+The label placed on the PersistentVolumeClaim, the `<key>` being the label name, the value being the label value, even if the value is empty.
+Note: Examples:
+
+- A label `app` with value `my-app` SHOULD be recorded as
+  the `k8s.persistentvolumeclaim.label.app` attribute with value `"my-app"`.
+- A label `data` with empty string value SHOULD be recorded as
+  the `k8s.persistentvolumeclaim.label.data` attribute with value `""`.
+"""
+
+K8S_PERSISTENTVOLUMECLAIM_NAME: Final = "k8s.persistentvolumeclaim.name"
+"""
+The name of the PersistentVolumeClaim.
+"""
+
+K8S_PERSISTENTVOLUMECLAIM_STATUS_PHASE: Final = (
+    "k8s.persistentvolumeclaim.status.phase"
+)
+"""
+The phase of the PersistentVolumeClaim.
+Note: This attribute aligns with the `phase` field of the
+[K8s PersistentVolumeClaimStatus](https://kubernetes.io/docs/reference/kubernetes-api/config-and-storage-resources/persistent-volume-claim-v1/#PersistentVolumeClaimStatus).
+"""
+
+K8S_PERSISTENTVOLUMECLAIM_UID: Final = "k8s.persistentvolumeclaim.uid"
+"""
+The UID of the PersistentVolumeClaim.
+"""
+
 K8S_POD_ANNOTATION_TEMPLATE: Final = "k8s.pod.annotation"
 """
 The annotation placed on the Pod, the `<key>` being the annotation name, the value being the annotation value.
@@ -671,6 +771,37 @@ class K8sNodeConditionTypeValues(Enum):
     """The network for the node is not correctly configured."""
 
 
+class K8sPersistentvolumeReclaimPolicyValues(Enum):
+    DELETE = "Delete"
+    """The volume will be deleted when released from its claim."""
+    RECYCLE = "Recycle"
+    """The volume will be recycled (basic scrub) when released from its claim."""
+    RETAIN = "Retain"
+    """The volume will be retained when released from its claim."""
+
+
+class K8sPersistentvolumeStatusPhaseValues(Enum):
+    AVAILABLE = "Available"
+    """The volume is available and not yet bound to a claim."""
+    BOUND = "Bound"
+    """The volume is bound to a claim."""
+    FAILED = "Failed"
+    """The volume has failed its automatic reclamation."""
+    PENDING = "Pending"
+    """The volume is being provisioned."""
+    RELEASED = "Released"
+    """The claim has been deleted but the volume is not yet available."""
+
+
+class K8sPersistentvolumeclaimStatusPhaseValues(Enum):
+    BOUND = "Bound"
+    """The claim is bound to a volume."""
+    LOST = "Lost"
+    """The claim has lost its underlying volume (the volume does not exist anymore)."""
+    PENDING = "Pending"
+    """The claim has not yet been bound to a volume."""
+
+
 class K8sPodStatusPhaseValues(Enum):
     PENDING = "Pending"
     """The pod has been accepted by the system, but one or more of the containers has not been started. This includes time before being bound to a node, as well as time spent pulling images onto the host."""

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

@@ -33,8 +33,7 @@
 
 OTEL_EVENT_NAME: Final = "otel.event.name"
 """
-Identifies the class / type of event.
-Note: This attribute SHOULD be used by non-OTLP exporters when destination does not support `EventName` or equivalent field. This attribute MAY be used by applications using existing logging libraries so that it can be used to set the `EventName` field by Collector or SDK components.
+Deprecated in favor of stable :py:const:`opentelemetry.semconv.attributes.otel_attributes.OTEL_EVENT_NAME`.
 """
 
 OTEL_LIBRARY_NAME: Final = "otel.library.name"