Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit e3d39db

Browse files
lmolkovaxrmx
andauthored
Generate semconv 1.30.0 (open-telemetry#4397)
* Generate upcoming semconv (dry run) * update * released * changelog * up --------- Co-authored-by: Riccardo Magliocchetti <[email protected]>
1 parent 7ff2f51 commit e3d39db

31 files changed

+1310
-96
lines changed

CHANGELOG.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
2020
- [BREAKING] semantic-conventions: Remove `opentelemetry.semconv.attributes.network_attributes.NETWORK_INTERFACE_NAME`
2121
introduced by mistake in the wrong module.
2222
([#4391](https://github.com/open-telemetry/opentelemetry-python/pull/4391))
23+
- semantic-conventions: Bump to 1.30.0
24+
([#4337](https://github.com/open-telemetry/opentelemetry-python/pull/4397))
2325

2426
## Version 1.29.0/0.50b0 (2024-12-11)
2527

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121

2222
ARTIFACT_ATTESTATION_HASH: Final = "artifact.attestation.hash"
2323
"""
24-
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).
24+
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](https://github.com/in-toto/attestation/tree/main/spec) also refer to this as the **digest**.
2525
"""
2626

2727
ARTIFACT_ATTESTATION_ID: Final = "artifact.attestation.id"

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

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -181,6 +181,11 @@
181181
The ARN of an EKS cluster.
182182
"""
183183

184+
AWS_EXTENDED_REQUEST_ID: Final = "aws.extended_request_id"
185+
"""
186+
The AWS extended request ID as returned in the response header `x-amz-id-2`.
187+
"""
188+
184189
AWS_LAMBDA_INVOKED_ARN: Final = "aws.lambda.invoked_arn"
185190
"""
186191
The full invoked ARN as provided on the `Context` passed to the function (`Lambda-Runtime-Invoked-Function-Arn` header on the `/runtime/invocation/next` applicable).
@@ -212,7 +217,7 @@
212217

213218
AWS_REQUEST_ID: Final = "aws.request_id"
214219
"""
215-
The AWS request ID as returned in the response headers `x-amz-request-id` or `x-amz-requestid`.
220+
The AWS request ID as returned in the response headers `x-amzn-requestid`, `x-amzn-request-id` or `x-amz-request-id`.
216221
"""
217222

218223
AWS_S3_BUCKET: Final = "aws.s3.bucket"
Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
# Copyright The OpenTelemetry Authors
2+
#
3+
# Licensed under the Apache License, Version 2.0 (the "License");
4+
# you may not use this file except in compliance with the License.
5+
# You may obtain a copy of the License at
6+
#
7+
# http://www.apache.org/licenses/LICENSE-2.0
8+
#
9+
# Unless required by applicable law or agreed to in writing, software
10+
# distributed under the License is distributed on an "AS IS" BASIS,
11+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
# See the License for the specific language governing permissions and
13+
# limitations under the License.
14+
15+
from enum import Enum
16+
from typing import Final
17+
18+
AZURE_CLIENT_ID: Final = "azure.client.id"
19+
"""
20+
The unique identifier of the client instance.
21+
"""
22+
23+
AZURE_COSMOSDB_CONNECTION_MODE: Final = "azure.cosmosdb.connection.mode"
24+
"""
25+
Cosmos client connection mode.
26+
"""
27+
28+
AZURE_COSMOSDB_CONSISTENCY_LEVEL: Final = "azure.cosmosdb.consistency.level"
29+
"""
30+
Account or request [consistency level](https://learn.microsoft.com/azure/cosmos-db/consistency-levels).
31+
"""
32+
33+
AZURE_COSMOSDB_OPERATION_CONTACTED_REGIONS: Final = (
34+
"azure.cosmosdb.operation.contacted_regions"
35+
)
36+
"""
37+
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.
38+
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).
39+
"""
40+
41+
AZURE_COSMOSDB_OPERATION_REQUEST_CHARGE: Final = (
42+
"azure.cosmosdb.operation.request_charge"
43+
)
44+
"""
45+
The number of request units consumed by the operation.
46+
"""
47+
48+
AZURE_COSMOSDB_REQUEST_BODY_SIZE: Final = "azure.cosmosdb.request.body.size"
49+
"""
50+
Request payload size in bytes.
51+
"""
52+
53+
AZURE_COSMOSDB_RESPONSE_SUB_STATUS_CODE: Final = (
54+
"azure.cosmosdb.response.sub_status_code"
55+
)
56+
"""
57+
Cosmos DB sub status code.
58+
"""
59+
60+
61+
class AzureCosmosdbConnectionModeValues(Enum):
62+
GATEWAY = "gateway"
63+
"""Gateway (HTTP) connection."""
64+
DIRECT = "direct"
65+
"""Direct connection."""
66+
67+
68+
class AzureCosmosdbConsistencyLevelValues(Enum):
69+
STRONG = "Strong"
70+
"""strong."""
71+
BOUNDED_STALENESS = "BoundedStaleness"
72+
"""bounded_staleness."""
73+
SESSION = "Session"
74+
"""session."""
75+
EVENTUAL = "Eventual"
76+
"""eventual."""
77+
CONSISTENT_PREFIX = "ConsistentPrefix"
78+
"""consistent_prefix."""
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
# Copyright The OpenTelemetry Authors
2+
#
3+
# Licensed under the Apache License, Version 2.0 (the "License");
4+
# you may not use this file except in compliance with the License.
5+
# You may obtain a copy of the License at
6+
#
7+
# http://www.apache.org/licenses/LICENSE-2.0
8+
#
9+
# Unless required by applicable law or agreed to in writing, software
10+
# distributed under the License is distributed on an "AS IS" BASIS,
11+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
# See the License for the specific language governing permissions and
13+
# limitations under the License.
14+
15+
from enum import Enum
16+
from typing import Final
17+
18+
CASSANDRA_CONSISTENCY_LEVEL: Final = "cassandra.consistency.level"
19+
"""
20+
The consistency level of the query. Based on consistency values from [CQL](https://docs.datastax.com/en/cassandra-oss/3.0/cassandra/dml/dmlConfigConsistency.html).
21+
"""
22+
23+
CASSANDRA_COORDINATOR_DC: Final = "cassandra.coordinator.dc"
24+
"""
25+
The data center of the coordinating node for a query.
26+
"""
27+
28+
CASSANDRA_COORDINATOR_ID: Final = "cassandra.coordinator.id"
29+
"""
30+
The ID of the coordinating node for a query.
31+
"""
32+
33+
CASSANDRA_PAGE_SIZE: Final = "cassandra.page.size"
34+
"""
35+
The fetch size used for paging, i.e. how many rows will be returned at once.
36+
"""
37+
38+
CASSANDRA_QUERY_IDEMPOTENT: Final = "cassandra.query.idempotent"
39+
"""
40+
Whether or not the query is idempotent.
41+
"""
42+
43+
CASSANDRA_SPECULATIVE_EXECUTION_COUNT: Final = (
44+
"cassandra.speculative_execution.count"
45+
)
46+
"""
47+
The number of times a query was speculatively executed. Not set or `0` if the query was not executed speculatively.
48+
"""
49+
50+
51+
class CassandraConsistencyLevelValues(Enum):
52+
ALL = "all"
53+
"""all."""
54+
EACH_QUORUM = "each_quorum"
55+
"""each_quorum."""
56+
QUORUM = "quorum"
57+
"""quorum."""
58+
LOCAL_QUORUM = "local_quorum"
59+
"""local_quorum."""
60+
ONE = "one"
61+
"""one."""
62+
TWO = "two"
63+
"""two."""
64+
THREE = "three"
65+
"""three."""
66+
LOCAL_ONE = "local_one"
67+
"""local_one."""
68+
ANY = "any"
69+
"""any."""
70+
SERIAL = "serial"
71+
"""serial."""
72+
LOCAL_SERIAL = "local_serial"
73+
"""local_serial."""

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

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,21 @@
2020
The human readable name of the pipeline within a CI/CD system.
2121
"""
2222

23+
CICD_PIPELINE_RESULT: Final = "cicd.pipeline.result"
24+
"""
25+
The result of a pipeline run.
26+
"""
27+
2328
CICD_PIPELINE_RUN_ID: Final = "cicd.pipeline.run.id"
2429
"""
2530
The unique identifier of a pipeline run within a CI/CD system.
2631
"""
2732

33+
CICD_PIPELINE_RUN_STATE: Final = "cicd.pipeline.run.state"
34+
"""
35+
The pipeline run goes through these states during its lifecycle.
36+
"""
37+
2838
CICD_PIPELINE_TASK_NAME: Final = "cicd.pipeline.task.name"
2939
"""
3040
The human readable name of a task within a pipeline. Task here most closely aligns with a [computing process](https://wikipedia.org/wiki/Pipeline_(computing)) in a pipeline. Other terms for tasks include commands, steps, and procedures.
@@ -45,6 +55,40 @@
4555
The type of the task within a pipeline.
4656
"""
4757

58+
CICD_SYSTEM_COMPONENT: Final = "cicd.system.component"
59+
"""
60+
The name of a component of the CICD system.
61+
"""
62+
63+
CICD_WORKER_STATE: Final = "cicd.worker.state"
64+
"""
65+
The state of a CICD worker / agent.
66+
"""
67+
68+
69+
class CicdPipelineResultValues(Enum):
70+
SUCCESS = "success"
71+
"""The pipeline run finished successfully."""
72+
FAILURE = "failure"
73+
"""The pipeline run did not finish successfully, eg. due to a compile error or a failing test. Such failures are usually detected by non-zero exit codes of the tools executed in the pipeline run."""
74+
ERROR = "error"
75+
"""The pipeline run failed due to an error in the CICD system, eg. due to the worker being killed."""
76+
TIMEOUT = "timeout"
77+
"""A timeout caused the pipeline run to be interrupted."""
78+
CANCELLATION = "cancellation"
79+
"""The pipeline run was cancelled, eg. by a user manually cancelling the pipeline run."""
80+
SKIP = "skip"
81+
"""The pipeline run was skipped, eg. due to a precondition not being met."""
82+
83+
84+
class CicdPipelineRunStateValues(Enum):
85+
PENDING = "pending"
86+
"""The run pending state spans from the event triggering the pipeline run until the execution of the run starts (eg. time spent in a queue, provisioning agents, creating run resources)."""
87+
EXECUTING = "executing"
88+
"""The executing state spans the execution of any run tasks (eg. build, test)."""
89+
FINALIZING = "finalizing"
90+
"""The finalizing state spans from when the run has finished executing (eg. cleanup of run resources)."""
91+
4892

4993
class CicdPipelineTaskTypeValues(Enum):
5094
BUILD = "build"
@@ -53,3 +97,12 @@ class CicdPipelineTaskTypeValues(Enum):
5397
"""test."""
5498
DEPLOY = "deploy"
5599
"""deploy."""
100+
101+
102+
class CicdWorkerStateValues(Enum):
103+
AVAILABLE = "available"
104+
"""The worker is not performing work for the CICD system. It is available to the CICD system to perform work on (online / idle)."""
105+
BUSY = "busy"
106+
"""The worker is performing work for the CICD system."""
107+
OFFLINE = "offline"
108+
"""The worker is not available to the CICD system (disconnected / down)."""

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

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,10 @@ class CloudPlatformValues(Enum):
117117
"""Red Hat OpenShift on Google Cloud."""
118118
IBM_CLOUD_OPENSHIFT = "ibm_cloud_openshift"
119119
"""Red Hat OpenShift on IBM Cloud."""
120+
ORACLE_CLOUD_COMPUTE = "oracle_cloud_compute"
121+
"""Compute on Oracle Cloud Infrastructure (OCI)."""
122+
ORACLE_CLOUD_OKE = "oracle_cloud_oke"
123+
"""Kubernetes Engine (OKE) on Oracle Cloud Infrastructure (OCI)."""
120124
TENCENT_CLOUD_CVM = "tencent_cloud_cvm"
121125
"""Tencent Cloud Cloud Virtual Machine (CVM)."""
122126
TENCENT_CLOUD_EKS = "tencent_cloud_eks"
@@ -138,5 +142,7 @@ class CloudProviderValues(Enum):
138142
"""Heroku Platform as a Service."""
139143
IBM_CLOUD = "ibm_cloud"
140144
"""IBM Cloud."""
145+
ORACLE_CLOUD = "oracle_cloud"
146+
"""Oracle Cloud Infrastructure (OCI)."""
141147
TENCENT_CLOUD = "tencent_cloud"
142148
"""Tencent Cloud."""

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

Lines changed: 24 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,27 +16,47 @@
1616

1717
CODE_COLUMN: Final = "code.column"
1818
"""
19-
The column number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`.
19+
Deprecated: Replaced by `code.column.number`.
2020
"""
2121

22-
CODE_FILEPATH: Final = "code.filepath"
22+
CODE_COLUMN_NUMBER: Final = "code.column.number"
23+
"""
24+
The column number in `code.file.path` best representing the operation. It SHOULD point within the code unit named in `code.function.name`.
25+
"""
26+
27+
CODE_FILE_PATH: Final = "code.file.path"
2328
"""
2429
The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path).
2530
"""
2631

32+
CODE_FILEPATH: Final = "code.filepath"
33+
"""
34+
Deprecated, use `code.file.path` instead.
35+
"""
36+
2737
CODE_FUNCTION: Final = "code.function"
2838
"""
39+
Deprecated: Replaced by `code.function.name`.
40+
"""
41+
42+
CODE_FUNCTION_NAME: Final = "code.function.name"
43+
"""
2944
The method or function name, or equivalent (usually rightmost part of the code unit's name).
3045
"""
3146

47+
CODE_LINE_NUMBER: Final = "code.line.number"
48+
"""
49+
The line number in `code.file.path` best representing the operation. It SHOULD point within the code unit named in `code.function.name`.
50+
"""
51+
3252
CODE_LINENO: Final = "code.lineno"
3353
"""
34-
The line number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`.
54+
Deprecated: Replaced by `code.line.number`.
3555
"""
3656

3757
CODE_NAMESPACE: Final = "code.namespace"
3858
"""
39-
The "namespace" within which `code.function` is defined. Usually the qualified class or module name, such that `code.namespace` + some separator + `code.function` form a unique identifier for the code unit.
59+
The "namespace" within which `code.function.name` is defined. Usually the qualified class or module name, such that `code.namespace` + some separator + `code.function.name` form a unique identifier for the code unit.
4060
"""
4161

4262
CODE_STACKTRACE: Final = "code.stacktrace"

0 commit comments

Comments
 (0)