Semconv 1.27

CHANGELOG.md

@@ -16,6 +16,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Update log export example to not use root logger ([#4090](https://github.com/open-telemetry/opentelemetry-python/pull/4090))
 - sdk: Add OS resource detector
   ([#3992](https://github.com/open-telemetry/opentelemetry-python/pull/3992))
+- Update semantic conventions to version 1.27.0
+  ([#4104](https://github.com/open-telemetry/opentelemetry-python/pull/4104))
 
 ## Version 1.26.0/0.47b0 (2024-07-25)
 

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

@@ -0,0 +1,62 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import Final
+
+ARTIFACT_ATTESTATION_FILENAME: Final = "artifact.attestation.filename"
+"""
+The provenance filename of the built attestation which directly relates to the build artifact filename. This filename SHOULD accompany the artifact at publish time. See the [SLSA Relationship](https://slsa.dev/spec/v1.0/distributing-provenance#relationship-between-artifacts-and-attestations) specification for more information.
+"""
+
+ARTIFACT_ATTESTATION_HASH: Final = "artifact.attestation.hash"
+"""
+The full [hash value (see glossary)](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf), of the built attestation. Some envelopes in the software attestation space also refer to this as the [digest](https://github.com/in-toto/attestation/blob/main/spec/README.md#in-toto-attestation-framework-spec).
+"""
+
+ARTIFACT_ATTESTATION_ID: Final = "artifact.attestation.id"
+"""
+The id of the build [software attestation](https://slsa.dev/attestation-model).
+"""
+
+ARTIFACT_FILENAME: Final = "artifact.filename"
+"""
+The human readable file name of the artifact, typically generated during build and release processes. Often includes the package name and version in the file name.
+Note: This file name can also act as the [Package Name](https://slsa.dev/spec/v1.0/terminology#package-model)
+in cases where the package ecosystem maps accordingly.
+Additionally, the artifact [can be published](https://slsa.dev/spec/v1.0/terminology#software-supply-chain)
+for others, but that is not a guarantee.
+"""
+
+ARTIFACT_HASH: Final = "artifact.hash"
+"""
+The full [hash value (see glossary)](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.186-5.pdf), often found in checksum.txt on a release of the artifact and used to verify package integrity.
+Note: The specific algorithm used to create the cryptographic hash value is
+not defined. In situations where an artifact has multiple
+cryptographic hashes, it is up to the implementer to choose which
+hash value to set here; this should be the most secure hash algorithm
+that is suitable for the situation and consistent with the
+corresponding attestation. The implementer can then provide the other
+hash values through an additional set of attribute extensions as they
+deem necessary.
+"""
+
+ARTIFACT_PURL: Final = "artifact.purl"
+"""
+The [Package URL](https://github.com/package-url/purl-spec) of the [package artifact](https://slsa.dev/spec/v1.0/terminology#package-model) provides a standard way to identify and locate the packaged artifact.
+"""
+
+ARTIFACT_VERSION: Final = "artifact.version"
+"""
+The version of the artifact.
+"""

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

@@ -0,0 +1,20 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from typing import Final
+
+AZ_SERVICE_REQUEST_ID: Final = "az.service_request_id"
+"""
+The unique identifier of the service request. It's generated by the Azure service and returned with the response.
+"""

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

@@ -0,0 +1,55 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from enum import Enum
+from typing import Final
+
+CICD_PIPELINE_NAME: Final = "cicd.pipeline.name"
+"""
+The human readable name of the pipeline within a CI/CD system.
+"""
+
+CICD_PIPELINE_RUN_ID: Final = "cicd.pipeline.run.id"
+"""
+The unique identifier of a pipeline run within a CI/CD system.
+"""
+
+CICD_PIPELINE_TASK_NAME: Final = "cicd.pipeline.task.name"
+"""
+The human readable name of a task within a pipeline. Task here most closely aligns with a [computing process](https://en.wikipedia.org/wiki/Pipeline_(computing)) in a pipeline. Other terms for tasks include commands, steps, and procedures.
+"""
+
+CICD_PIPELINE_TASK_RUN_ID: Final = "cicd.pipeline.task.run.id"
+"""
+The unique identifier of a task run within a pipeline.
+"""
+
+CICD_PIPELINE_TASK_RUN_URL_FULL: Final = "cicd.pipeline.task.run.url.full"
+"""
+The [URL](https://en.wikipedia.org/wiki/URL) of the pipeline run providing the complete address in order to locate and identify the pipeline run.
+"""
+
+CICD_PIPELINE_TASK_TYPE: Final = "cicd.pipeline.task.type"
+"""
+The type of the task within a pipeline.
+"""
+
+
+class CicdPipelineTaskTypeValues(Enum):
+    BUILD = "build"
+    """build."""
+    TEST = "test"
+    """test."""
+    DEPLOY = "deploy"
+    """deploy."""

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

@@ -55,7 +55,7 @@
 * **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).
   Take care not to use the "invoked ARN" directly but replace any
   [alias suffix](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)
-  with the resolved function version, as the same runtime instance may be invokable with
+  with the resolved function version, as the same runtime instance may be invocable with
   multiple different aliases.
 * **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
 * **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,

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

@@ -15,6 +15,8 @@
 from enum import Enum
 from typing import Final
 
+from deprecated import deprecated
+
 CONTAINER_COMMAND: Final = "container.command"
 """
 The command used to run the container (i.e. the command name).
@@ -33,7 +35,7 @@
 
 CONTAINER_CPU_STATE: Final = "container.cpu.state"
 """
-The CPU state for this data point.
+Deprecated: Replaced by `cpu.mode`.
 """
 
 CONTAINER_ID: Final = "container.id"
@@ -86,6 +88,7 @@
 """
 
 
+@deprecated(reason="The attribute container.cpu.state is deprecated - Replaced by `cpu.mode`")  # type: ignore
 class ContainerCpuStateValues(Enum):
     USER = "user"
     """When tasks of the cgroup are in user mode (Linux). When all container processes are in user mode (Windows)."""

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

@@ -0,0 +1,40 @@
+# Copyright The OpenTelemetry Authors
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from enum import Enum
+from typing import Final
+
+CPU_MODE: Final = "cpu.mode"
+"""
+The mode of the CPU.
+"""
+
+
+class CpuModeValues(Enum):
+    USER = "user"
+    """user."""
+    SYSTEM = "system"
+    """system."""
+    NICE = "nice"
+    """nice."""
+    IDLE = "idle"
+    """idle."""
+    IOWAIT = "iowait"
+    """iowait."""
+    INTERRUPT = "interrupt"
+    """interrupt."""
+    STEAL = "steal"
+    """steal."""
+    KERNEL = "kernel"
+    """kernel."""