diff --git a/.chloggen/820.yaml b/.chloggen/820.yaml
new file mode 100644
index 0000000000..85ac249f44
--- /dev/null
+++ b/.chloggen/820.yaml
@@ -0,0 +1,4 @@
+change_type: enhancement
+component: other
+note: Update build-tools version to 0.24.0 and make semantic conventions compatible with this version (add stability on enum members and deprecated attributes).
+issues: [ 807 ]
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 8e5b78e834..bc9b273e9f 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -82,7 +82,7 @@ environment configured:
### 1. Modify the YAML model
Refer to the
-[Semantic Convention YAML Language](https://github.com/open-telemetry/build-tools/blob/v0.23.0/semantic-conventions/syntax.md)
+[Semantic Convention YAML Language](https://github.com/open-telemetry/build-tools/blob/v0.24.0/semantic-conventions/syntax.md)
to learn how to make changes to the YAML files.
#### Schema files
diff --git a/Makefile b/Makefile
index 283402f5c0..dedc29b494 100644
--- a/Makefile
+++ b/Makefile
@@ -13,7 +13,7 @@ CHLOGGEN_CONFIG := .chloggen/config.yaml
# see https://github.com/open-telemetry/build-tools/releases for semconvgen updates
# Keep links in model/README.md and .vscode/settings.json in sync!
-SEMCONVGEN_VERSION=0.23.0
+SEMCONVGEN_VERSION=0.24.0
# TODO: add `yamllint` step to `all` after making sure it works on Mac.
.PHONY: all
@@ -95,13 +95,13 @@ yamllint:
.PHONY: table-generation
table-generation:
docker run --rm -v $(PWD)/model:/source -v $(PWD)/docs:/spec \
- otel/semconvgen:$(SEMCONVGEN_VERSION) -f /source markdown -md /spec --md-use-badges --md-stable
+ otel/semconvgen:$(SEMCONVGEN_VERSION) -f /source markdown
# Check if current markdown tables differ from the ones that would be generated from YAML definitions
.PHONY: table-check
table-check:
docker run --rm -v $(PWD)/model:/source -v $(PWD)/docs:/spec \
- otel/semconvgen:$(SEMCONVGEN_VERSION) -f /source markdown -md /spec --md-check --md-use-badges --md-stable
+ otel/semconvgen:$(SEMCONVGEN_VERSION) -f /source markdown -md /spec
.PHONY: schema-check
schema-check:
diff --git a/docs/attributes-registry/android.md b/docs/attributes-registry/android.md
index e8539f2b73..65072ef1aa 100644
--- a/docs/attributes-registry/android.md
+++ b/docs/attributes-registry/android.md
@@ -2,7 +2,7 @@
## Android Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `android.os.api_level` | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `android.os.api_level` | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` |  |
diff --git a/docs/attributes-registry/browser.md b/docs/attributes-registry/browser.md
index 84366ea986..fd51f5bf79 100644
--- a/docs/attributes-registry/browser.md
+++ b/docs/attributes-registry/browser.md
@@ -6,12 +6,12 @@
## Browser Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `browser.brands` | string[] | Array of brand name and version separated by a space [1] | `[ Not A;Brand 99, Chromium 99, Chrome 99]` |
-| `browser.language` | string | Preferred language of the user using the browser [2] | `en`; `en-US`; `fr`; `fr-FR` |
-| `browser.mobile` | boolean | A boolean that is true if the browser is running on a mobile device [3] | |
-| `browser.platform` | string | The platform on which the browser is running [4] | `Windows`; `macOS`; `Android` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `browser.brands` | string[] | Array of brand name and version separated by a space [1] | `[ Not A;Brand 99, Chromium 99, Chrome 99]` |  |
+| `browser.language` | string | Preferred language of the user using the browser [2] | `en`; `en-US`; `fr`; `fr-FR` |  |
+| `browser.mobile` | boolean | A boolean that is true if the browser is running on a mobile device [3] | |  |
+| `browser.platform` | string | The platform on which the browser is running [4] | `Windows`; `macOS`; `Android` |  |
**[1]:** This value is intended to be taken from the [UA client hints API](https://wicg.github.io/ua-client-hints/#interface) (`navigator.userAgentData.brands`).
diff --git a/docs/attributes-registry/client.md b/docs/attributes-registry/client.md
index 9ed3875a83..e5ad30b661 100644
--- a/docs/attributes-registry/client.md
+++ b/docs/attributes-registry/client.md
@@ -12,10 +12,10 @@ protocol / API does not expose a clear notion of client and server).
This also covers UDP network interactions where one side initiates the interaction, e.g. QUIC (HTTP/3) and DNS.
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `client.address` | string | 
Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `client.example.com`; `10.1.2.80`; `/tmp/my.sock` |
-| `client.port` | int | 
Client port number. [2] | `65123` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `client.address` | string | Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `client.example.com`; `10.1.2.80`; `/tmp/my.sock` |  |
+| `client.port` | int | Client port number. [2] | `65123` |  |
**[1]:** When observed from the server side, and when communicating through an intermediary, `client.address` SHOULD represent the client address behind any intermediaries, for example proxies, if it's available.
diff --git a/docs/attributes-registry/cloud.md b/docs/attributes-registry/cloud.md
index 1931f5a878..76176b3c93 100644
--- a/docs/attributes-registry/cloud.md
+++ b/docs/attributes-registry/cloud.md
@@ -6,14 +6,14 @@
## Cloud Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `cloud.account.id` | string | The cloud account ID the resource is assigned to. | `111111111111`; `opentelemetry` |
-| `cloud.availability_zone` | string | Cloud regions often have multiple, isolated locations known as zones to increase availability. Availability zone represents the zone where the resource is running. [1] | `us-east-1c` |
-| `cloud.platform` | string | The cloud platform in use. [2] | `alibaba_cloud_ecs` |
-| `cloud.provider` | string | Name of the cloud provider. | `alibaba_cloud` |
-| `cloud.region` | string | The geographical region the resource is running. [3] | `us-central1`; `us-east-1` |
-| `cloud.resource_id` | string | Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name) on GCP) [4] | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `cloud.account.id` | string | The cloud account ID the resource is assigned to. | `111111111111`; `opentelemetry` |  |
+| `cloud.availability_zone` | string | Cloud regions often have multiple, isolated locations known as zones to increase availability. Availability zone represents the zone where the resource is running. [1] | `us-east-1c` |  |
+| `cloud.platform` | string | The cloud platform in use. [2] | `alibaba_cloud_ecs` |  |
+| `cloud.provider` | string | Name of the cloud provider. | `alibaba_cloud` |  |
+| `cloud.region` | string | The geographical region the resource is running. [3] | `us-central1`; `us-east-1` |  |
+| `cloud.resource_id` | string | Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name) on GCP) [4] | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/` |  |
**[1]:** Availability zones are called "zones" on Alibaba Cloud and Google Cloud.
@@ -39,48 +39,48 @@ The following well-known definitions MUST be used if you set this attribute and
This means that a span attribute MUST be used, as an Azure function app can host multiple functions that would usually share
a TracerProvider.
-`cloud.platform` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`cloud.platform` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `alibaba_cloud_ecs` | Alibaba Cloud Elastic Compute Service |
-| `alibaba_cloud_fc` | Alibaba Cloud Function Compute |
-| `alibaba_cloud_openshift` | Red Hat OpenShift on Alibaba Cloud |
-| `aws_ec2` | AWS Elastic Compute Cloud |
-| `aws_ecs` | AWS Elastic Container Service |
-| `aws_eks` | AWS Elastic Kubernetes Service |
-| `aws_lambda` | AWS Lambda |
-| `aws_elastic_beanstalk` | AWS Elastic Beanstalk |
-| `aws_app_runner` | AWS App Runner |
-| `aws_openshift` | Red Hat OpenShift on AWS (ROSA) |
-| `azure_vm` | Azure Virtual Machines |
-| `azure_container_apps` | Azure Container Apps |
-| `azure_container_instances` | Azure Container Instances |
-| `azure_aks` | Azure Kubernetes Service |
-| `azure_functions` | Azure Functions |
-| `azure_app_service` | Azure App Service |
-| `azure_openshift` | Azure Red Hat OpenShift |
-| `gcp_bare_metal_solution` | Google Bare Metal Solution (BMS) |
-| `gcp_compute_engine` | Google Cloud Compute Engine (GCE) |
-| `gcp_cloud_run` | Google Cloud Run |
-| `gcp_kubernetes_engine` | Google Cloud Kubernetes Engine (GKE) |
-| `gcp_cloud_functions` | Google Cloud Functions (GCF) |
-| `gcp_app_engine` | Google Cloud App Engine (GAE) |
-| `gcp_openshift` | Red Hat OpenShift on Google Cloud |
-| `ibm_cloud_openshift` | Red Hat OpenShift on IBM Cloud |
-| `tencent_cloud_cvm` | Tencent Cloud Cloud Virtual Machine (CVM) |
-| `tencent_cloud_eks` | Tencent Cloud Elastic Kubernetes Service (EKS) |
-| `tencent_cloud_scf` | Tencent Cloud Serverless Cloud Function (SCF) |
+| Value | Description | Stability |
+|---|---|---|
+| `alibaba_cloud_ecs` | Alibaba Cloud Elastic Compute Service |  |
+| `alibaba_cloud_fc` | Alibaba Cloud Function Compute |  |
+| `alibaba_cloud_openshift` | Red Hat OpenShift on Alibaba Cloud |  |
+| `aws_ec2` | AWS Elastic Compute Cloud |  |
+| `aws_ecs` | AWS Elastic Container Service |  |
+| `aws_eks` | AWS Elastic Kubernetes Service |  |
+| `aws_lambda` | AWS Lambda |  |
+| `aws_elastic_beanstalk` | AWS Elastic Beanstalk |  |
+| `aws_app_runner` | AWS App Runner |  |
+| `aws_openshift` | Red Hat OpenShift on AWS (ROSA) |  |
+| `azure_vm` | Azure Virtual Machines |  |
+| `azure_container_apps` | Azure Container Apps |  |
+| `azure_container_instances` | Azure Container Instances |  |
+| `azure_aks` | Azure Kubernetes Service |  |
+| `azure_functions` | Azure Functions |  |
+| `azure_app_service` | Azure App Service |  |
+| `azure_openshift` | Azure Red Hat OpenShift |  |
+| `gcp_bare_metal_solution` | Google Bare Metal Solution (BMS) |  |
+| `gcp_compute_engine` | Google Cloud Compute Engine (GCE) |  |
+| `gcp_cloud_run` | Google Cloud Run |  |
+| `gcp_kubernetes_engine` | Google Cloud Kubernetes Engine (GKE) |  |
+| `gcp_cloud_functions` | Google Cloud Functions (GCF) |  |
+| `gcp_app_engine` | Google Cloud App Engine (GAE) |  |
+| `gcp_openshift` | Red Hat OpenShift on Google Cloud |  |
+| `ibm_cloud_openshift` | Red Hat OpenShift on IBM Cloud |  |
+| `tencent_cloud_cvm` | Tencent Cloud Cloud Virtual Machine (CVM) |  |
+| `tencent_cloud_eks` | Tencent Cloud Elastic Kubernetes Service (EKS) |  |
+| `tencent_cloud_scf` | Tencent Cloud Serverless Cloud Function (SCF) |  |
-`cloud.provider` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`cloud.provider` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `alibaba_cloud` | Alibaba Cloud |
-| `aws` | Amazon Web Services |
-| `azure` | Microsoft Azure |
-| `gcp` | Google Cloud Platform |
-| `heroku` | Heroku Platform as a Service |
-| `ibm_cloud` | IBM Cloud |
-| `tencent_cloud` | Tencent Cloud |
+| Value | Description | Stability |
+|---|---|---|
+| `alibaba_cloud` | Alibaba Cloud |  |
+| `aws` | Amazon Web Services |  |
+| `azure` | Microsoft Azure |  |
+| `gcp` | Google Cloud Platform |  |
+| `heroku` | Heroku Platform as a Service |  |
+| `ibm_cloud` | IBM Cloud |  |
+| `tencent_cloud` | Tencent Cloud |  |
\ No newline at end of file
diff --git a/docs/attributes-registry/cloudevents.md b/docs/attributes-registry/cloudevents.md
index aba5249b29..f7a7204310 100644
--- a/docs/attributes-registry/cloudevents.md
+++ b/docs/attributes-registry/cloudevents.md
@@ -6,11 +6,11 @@
## CloudEvents Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `cloudevents.event_id` | string | The [event_id](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#id) uniquely identifies the event. | `123e4567-e89b-12d3-a456-426614174000`; `0001` |
-| `cloudevents.event_source` | string | The [source](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#source-1) identifies the context in which an event happened. | `https://github.com/cloudevents`; `/cloudevents/spec/pull/123`; `my-service` |
-| `cloudevents.event_spec_version` | string | The [version of the CloudEvents specification](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#specversion) which the event uses. | `1.0` |
-| `cloudevents.event_subject` | string | The [subject](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#subject) of the event in the context of the event producer (identified by source). | `mynewfile.jpg` |
-| `cloudevents.event_type` | string | The [event_type](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#type) contains a value describing the type of event related to the originating occurrence. | `com.github.pull_request.opened`; `com.example.object.deleted.v2` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `cloudevents.event_id` | string | The [event_id](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#id) uniquely identifies the event. | `123e4567-e89b-12d3-a456-426614174000`; `0001` |  |
+| `cloudevents.event_source` | string | The [source](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#source-1) identifies the context in which an event happened. | `https://github.com/cloudevents`; `/cloudevents/spec/pull/123`; `my-service` |  |
+| `cloudevents.event_spec_version` | string | The [version of the CloudEvents specification](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#specversion) which the event uses. | `1.0` |  |
+| `cloudevents.event_subject` | string | The [subject](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#subject) of the event in the context of the event producer (identified by source). | `mynewfile.jpg` |  |
+| `cloudevents.event_type` | string | The [event_type](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#type) contains a value describing the type of event related to the originating occurrence. | `com.github.pull_request.opened`; `com.example.object.deleted.v2` |  |
diff --git a/docs/attributes-registry/code.md b/docs/attributes-registry/code.md
index 651caa99f5..de298c4526 100644
--- a/docs/attributes-registry/code.md
+++ b/docs/attributes-registry/code.md
@@ -8,12 +8,12 @@ These attributes allow to report this unit of code and therefore to provide more
## Code Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `code.column` | int | The column number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `16` |
-| `code.filepath` | string | The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). | `/usr/local/MyApplication/content_root/app/index.php` |
-| `code.function` | string | The method or function name, or equivalent (usually rightmost part of the code unit's name). | `serveRequest` |
-| `code.lineno` | int | The line number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `42` |
-| `code.namespace` | string | 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. | `com.example.MyHttpService` |
-| `code.stacktrace` | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `code.column` | int | The column number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `16` |  |
+| `code.filepath` | string | The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). | `/usr/local/MyApplication/content_root/app/index.php` |  |
+| `code.function` | string | The method or function name, or equivalent (usually rightmost part of the code unit's name). | `serveRequest` |  |
+| `code.lineno` | int | The line number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `42` |  |
+| `code.namespace` | string | 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. | `com.example.MyHttpService` |  |
+| `code.stacktrace` | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` |  |
\ No newline at end of file
diff --git a/docs/attributes-registry/container.md b/docs/attributes-registry/container.md
index 4e6ec20847..b8b37373c6 100644
--- a/docs/attributes-registry/container.md
+++ b/docs/attributes-registry/container.md
@@ -6,20 +6,20 @@
## Container Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `container.command` | string | The command used to run the container (i.e. the command name). [1] | `otelcontribcol` |
-| `container.command_args` | string[] | All the command arguments (including the command/executable itself) run by the container. [2] | `[otelcontribcol, --config, config.yaml]` |
-| `container.command_line` | string | The full command run by the container as a single string representing the full command. [2] | `otelcontribcol --config config.yaml` |
-| `container.cpu.state` | string | The CPU state for this data point. | `user`; `kernel` |
-| `container.id` | string | Container ID. Usually a UUID, as for example used to [identify Docker containers](https://docs.docker.com/engine/reference/run/#container-identification). The UUID might be abbreviated. | `a3bf90e006b2` |
-| `container.image.id` | string | Runtime specific image identifier. Usually a hash algorithm followed by a UUID. [2] | `sha256:19c92d0a00d1b66d897bceaa7319bee0dd38a10a851c60bcec9474aa3f01e50f` |
-| `container.image.name` | string | Name of the image the container was built on. | `gcr.io/opentelemetry/operator` |
-| `container.image.repo_digests` | string[] | Repo digests of the container image as provided by the container runtime. [3] | `[example@sha256:afcc7f1ac1b49db317a7196c902e61c6c3c4607d63599ee1a82d702d249a0ccb, internal.registry.example.com:5000/example@sha256:b69959407d21e8a062e0416bf13405bb2b71ed7a84dde4158ebafacfa06f5578]` |
-| `container.image.tags` | string[] | 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 `` section of the full name for example from `registry.example.com/my-org/my-image:`. | `[v1.27.1, 3.5.7-0]` |
-| `container.label.` | string | Container labels, `` being the label name, the value being the label value. | `container.label.app=nginx` |
-| `container.name` | string | Container name used by container runtime. | `opentelemetry-autoconf` |
-| `container.runtime` | string | The container runtime managing this container. | `docker`; `containerd`; `rkt` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `container.command` | string | The command used to run the container (i.e. the command name). [1] | `otelcontribcol` |  |
+| `container.command_args` | string[] | All the command arguments (including the command/executable itself) run by the container. [2] | `[otelcontribcol, --config, config.yaml]` |  |
+| `container.command_line` | string | The full command run by the container as a single string representing the full command. [2] | `otelcontribcol --config config.yaml` |  |
+| `container.cpu.state` | string | The CPU state for this data point. | `user`; `kernel` |  |
+| `container.id` | string | Container ID. Usually a UUID, as for example used to [identify Docker containers](https://docs.docker.com/engine/reference/run/#container-identification). The UUID might be abbreviated. | `a3bf90e006b2` |  |
+| `container.image.id` | string | Runtime specific image identifier. Usually a hash algorithm followed by a UUID. [2] | `sha256:19c92d0a00d1b66d897bceaa7319bee0dd38a10a851c60bcec9474aa3f01e50f` |  |
+| `container.image.name` | string | Name of the image the container was built on. | `gcr.io/opentelemetry/operator` |  |
+| `container.image.repo_digests` | string[] | Repo digests of the container image as provided by the container runtime. [3] | `[example@sha256:afcc7f1ac1b49db317a7196c902e61c6c3c4607d63599ee1a82d702d249a0ccb, internal.registry.example.com:5000/example@sha256:b69959407d21e8a062e0416bf13405bb2b71ed7a84dde4158ebafacfa06f5578]` |  |
+| `container.image.tags` | string[] | 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 `` section of the full name for example from `registry.example.com/my-org/my-image:`. | `[v1.27.1, 3.5.7-0]` |  |
+| `container.label.` | string | Container labels, `` being the label name, the value being the label value. | `container.label.app=nginx` |  |
+| `container.name` | string | Container name used by container runtime. | `opentelemetry-autoconf` |  |
+| `container.runtime` | string | The container runtime managing this container. | `docker`; `containerd`; `rkt` |  |
**[1]:** If using embedded credentials or sensitive data, it is recommended to remove them to prevent potential leakage.
@@ -29,11 +29,11 @@ The ID is assinged by the container runtime and can vary in different environmen
**[3]:** [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.
-`container.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`container.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `user` | When tasks of the cgroup are in user mode (Linux). When all container processes are in user mode (Windows). |
-| `system` | When CPU is used by the system (host OS) |
-| `kernel` | When tasks of the cgroup are in kernel mode (Linux). When all container processes are in kernel mode (Windows). |
+| Value | Description | Stability |
+|---|---|---|
+| `user` | When tasks of the cgroup are in user mode (Linux). When all container processes are in user mode (Windows). |  |
+| `system` | When CPU is used by the system (host OS) |  |
+| `kernel` | When tasks of the cgroup are in kernel mode (Linux). When all container processes are in kernel mode (Windows). |  |
diff --git a/docs/attributes-registry/db.md b/docs/attributes-registry/db.md
index 0c39de22e2..63824a6024 100644
--- a/docs/attributes-registry/db.md
+++ b/docs/attributes-registry/db.md
@@ -21,158 +21,158 @@
## Generic Database Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `db.instance.id` | string | An identifier (address, unique name, or any other identifier) of the database instance that is executing queries or mutations on the current connection. This is useful in cases where the database is running in a clustered environment and the instrumentation is able to record the node executing the query. The client may obtain this value in databases like MySQL using queries like `select @@hostname`. | `mysql-e26b99z.example.com` |
-| `db.name` | string | This attribute is used to report the name of the database being accessed. For commands that switch the database, this should be set to the target database (even if the command fails). [1] | `customers`; `main` |
-| `db.operation` | string | The name of the operation being executed, e.g. the [MongoDB command name](https://docs.mongodb.com/manual/reference/command/#database-operations) such as `findAndModify`, or the SQL keyword. [2] | `findAndModify`; `HMSET`; `SELECT` |
-| `db.statement` | string | The database statement being executed. | `SELECT * FROM wuser_table`; `SET mykey "WuValue"` |
-| `db.system` | string | An identifier for the database management system (DBMS) product being used. See below for a list of well-known identifiers. | `other_sql` |
-| `db.user` | string | Username for accessing the database. | `readonly_user`; `reporting_user` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.instance.id` | string | An identifier (address, unique name, or any other identifier) of the database instance that is executing queries or mutations on the current connection. This is useful in cases where the database is running in a clustered environment and the instrumentation is able to record the node executing the query. The client may obtain this value in databases like MySQL using queries like `select @@hostname`. | `mysql-e26b99z.example.com` |  |
+| `db.name` | string | This attribute is used to report the name of the database being accessed. For commands that switch the database, this should be set to the target database (even if the command fails). [1] | `customers`; `main` |  |
+| `db.operation` | string | The name of the operation being executed, e.g. the [MongoDB command name](https://docs.mongodb.com/manual/reference/command/#database-operations) such as `findAndModify`, or the SQL keyword. [2] | `findAndModify`; `HMSET`; `SELECT` |  |
+| `db.statement` | string | The database statement being executed. | `SELECT * FROM wuser_table`; `SET mykey "WuValue"` |  |
+| `db.system` | string | An identifier for the database management system (DBMS) product being used. See below for a list of well-known identifiers. | `other_sql` |  |
+| `db.user` | string | Username for accessing the database. | `readonly_user`; `reporting_user` |  |
**[1]:** In some SQL databases, the database name to be used is called "schema name". In case there are multiple layers that could be considered for database name (e.g. Oracle instance name and schema name), the database name to be used is the more specific layer (e.g. Oracle schema name).
**[2]:** When setting this to an SQL keyword, it is not recommended to attempt any client-side parsing of `db.statement` just to get this property, but it should be set if the operation name is provided by the library being instrumented. If the SQL statement has an ambiguous operation, or performs more than one operation, this value may be omitted.
-`db.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `other_sql` | Some other SQL database. Fallback only. See notes. |
-| `mssql` | Microsoft SQL Server |
-| `mssqlcompact` | Microsoft SQL Server Compact |
-| `mysql` | MySQL |
-| `oracle` | Oracle Database |
-| `db2` | IBM Db2 |
-| `postgresql` | PostgreSQL |
-| `redshift` | Amazon Redshift |
-| `hive` | Apache Hive |
-| `cloudscape` | Cloudscape |
-| `hsqldb` | HyperSQL DataBase |
-| `progress` | Progress Database |
-| `maxdb` | SAP MaxDB |
-| `hanadb` | SAP HANA |
-| `ingres` | Ingres |
-| `firstsql` | FirstSQL |
-| `edb` | EnterpriseDB |
-| `cache` | InterSystems Caché |
-| `adabas` | Adabas (Adaptable Database System) |
-| `firebird` | Firebird |
-| `derby` | Apache Derby |
-| `filemaker` | FileMaker |
-| `informix` | Informix |
-| `instantdb` | InstantDB |
-| `interbase` | InterBase |
-| `mariadb` | MariaDB |
-| `netezza` | Netezza |
-| `pervasive` | Pervasive PSQL |
-| `pointbase` | PointBase |
-| `sqlite` | SQLite |
-| `sybase` | Sybase |
-| `teradata` | Teradata |
-| `vertica` | Vertica |
-| `h2` | H2 |
-| `coldfusion` | ColdFusion IMQ |
-| `cassandra` | Apache Cassandra |
-| `hbase` | Apache HBase |
-| `mongodb` | MongoDB |
-| `redis` | Redis |
-| `couchbase` | Couchbase |
-| `couchdb` | CouchDB |
-| `cosmosdb` | Microsoft Azure Cosmos DB |
-| `dynamodb` | Amazon DynamoDB |
-| `neo4j` | Neo4j |
-| `geode` | Apache Geode |
-| `elasticsearch` | Elasticsearch |
-| `memcached` | Memcached |
-| `cockroachdb` | CockroachDB |
-| `opensearch` | OpenSearch |
-| `clickhouse` | ClickHouse |
-| `spanner` | Cloud Spanner |
-| `trino` | Trino |
+`db.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `other_sql` | Some other SQL database. Fallback only. See notes. |  |
+| `mssql` | Microsoft SQL Server |  |
+| `mssqlcompact` | Microsoft SQL Server Compact |  |
+| `mysql` | MySQL |  |
+| `oracle` | Oracle Database |  |
+| `db2` | IBM Db2 |  |
+| `postgresql` | PostgreSQL |  |
+| `redshift` | Amazon Redshift |  |
+| `hive` | Apache Hive |  |
+| `cloudscape` | Cloudscape |  |
+| `hsqldb` | HyperSQL DataBase |  |
+| `progress` | Progress Database |  |
+| `maxdb` | SAP MaxDB |  |
+| `hanadb` | SAP HANA |  |
+| `ingres` | Ingres |  |
+| `firstsql` | FirstSQL |  |
+| `edb` | EnterpriseDB |  |
+| `cache` | InterSystems Caché |  |
+| `adabas` | Adabas (Adaptable Database System) |  |
+| `firebird` | Firebird |  |
+| `derby` | Apache Derby |  |
+| `filemaker` | FileMaker |  |
+| `informix` | Informix |  |
+| `instantdb` | InstantDB |  |
+| `interbase` | InterBase |  |
+| `mariadb` | MariaDB |  |
+| `netezza` | Netezza |  |
+| `pervasive` | Pervasive PSQL |  |
+| `pointbase` | PointBase |  |
+| `sqlite` | SQLite |  |
+| `sybase` | Sybase |  |
+| `teradata` | Teradata |  |
+| `vertica` | Vertica |  |
+| `h2` | H2 |  |
+| `coldfusion` | ColdFusion IMQ |  |
+| `cassandra` | Apache Cassandra |  |
+| `hbase` | Apache HBase |  |
+| `mongodb` | MongoDB |  |
+| `redis` | Redis |  |
+| `couchbase` | Couchbase |  |
+| `couchdb` | CouchDB |  |
+| `cosmosdb` | Microsoft Azure Cosmos DB |  |
+| `dynamodb` | Amazon DynamoDB |  |
+| `neo4j` | Neo4j |  |
+| `geode` | Apache Geode |  |
+| `elasticsearch` | Elasticsearch |  |
+| `memcached` | Memcached |  |
+| `cockroachdb` | CockroachDB |  |
+| `opensearch` | OpenSearch |  |
+| `clickhouse` | ClickHouse |  |
+| `spanner` | Cloud Spanner |  |
+| `trino` | Trino |  |
## Cassandra Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `db.cassandra.consistency_level` | string | 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). | `all` |
-| `db.cassandra.coordinator.dc` | string | The data center of the coordinating node for a query. | `us-west-2` |
-| `db.cassandra.coordinator.id` | string | The ID of the coordinating node for a query. | `be13faa2-8574-4d71-926d-27f16cf8a7af` |
-| `db.cassandra.idempotence` | boolean | Whether or not the query is idempotent. | |
-| `db.cassandra.page_size` | int | The fetch size used for paging, i.e. how many rows will be returned at once. | `5000` |
-| `db.cassandra.speculative_execution_count` | int | The number of times a query was speculatively executed. Not set or `0` if the query was not executed speculatively. | `0`; `2` |
-| `db.cassandra.table` | string | The name of the primary Cassandra table that the operation is acting upon, including the keyspace name (if applicable). [1] | `mytable` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.cassandra.consistency_level` | string | 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). | `all` |  |
+| `db.cassandra.coordinator.dc` | string | The data center of the coordinating node for a query. | `us-west-2` |  |
+| `db.cassandra.coordinator.id` | string | The ID of the coordinating node for a query. | `be13faa2-8574-4d71-926d-27f16cf8a7af` |  |
+| `db.cassandra.idempotence` | boolean | Whether or not the query is idempotent. | |  |
+| `db.cassandra.page_size` | int | The fetch size used for paging, i.e. how many rows will be returned at once. | `5000` |  |
+| `db.cassandra.speculative_execution_count` | int | The number of times a query was speculatively executed. Not set or `0` if the query was not executed speculatively. | `0`; `2` |  |
+| `db.cassandra.table` | string | The name of the primary Cassandra table that the operation is acting upon, including the keyspace name (if applicable). [1] | `mytable` |  |
**[1]:** This mirrors the db.sql.table attribute but references cassandra rather than sql. It is not recommended to attempt any client-side parsing of `db.statement` just to get this property, but it should be set if it is provided by the library being instrumented. If the operation is acting upon an anonymous table, or more than one table, this value MUST NOT be set.
`db.cassandra.consistency_level` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `all` | all |
-| `each_quorum` | each_quorum |
-| `quorum` | quorum |
-| `local_quorum` | local_quorum |
-| `one` | one |
-| `two` | two |
-| `three` | three |
-| `local_one` | local_one |
-| `any` | any |
-| `serial` | serial |
-| `local_serial` | local_serial |
+| Value | Description | Stability |
+|---|---|---|
+| `all` | all |  |
+| `each_quorum` | each_quorum |  |
+| `quorum` | quorum |  |
+| `local_quorum` | local_quorum |  |
+| `one` | one |  |
+| `two` | two |  |
+| `three` | three |  |
+| `local_one` | local_one |  |
+| `any` | any |  |
+| `serial` | serial |  |
+| `local_serial` | local_serial |  |
## CosmosDB Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `db.cosmosdb.client_id` | string | Unique Cosmos client instance id. | `3ba4827d-4422-483f-b59f-85b74211c11d` |
-| `db.cosmosdb.connection_mode` | string | Cosmos client connection mode. | `gateway` |
-| `db.cosmosdb.container` | string | Cosmos DB container name. | `anystring` |
-| `db.cosmosdb.operation_type` | string | CosmosDB Operation Type. | `Invalid` |
-| `db.cosmosdb.request_charge` | double | RU consumed for that operation | `46.18`; `1.0` |
-| `db.cosmosdb.request_content_length` | int | Request payload size in bytes | |
-| `db.cosmosdb.status_code` | int | Cosmos DB status code. | `200`; `201` |
-| `db.cosmosdb.sub_status_code` | int | Cosmos DB sub status code. | `1000`; `1002` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.cosmosdb.client_id` | string | Unique Cosmos client instance id. | `3ba4827d-4422-483f-b59f-85b74211c11d` |  |
+| `db.cosmosdb.connection_mode` | string | Cosmos client connection mode. | `gateway` |  |
+| `db.cosmosdb.container` | string | Cosmos DB container name. | `anystring` |  |
+| `db.cosmosdb.operation_type` | string | CosmosDB Operation Type. | `Invalid` |  |
+| `db.cosmosdb.request_charge` | double | RU consumed for that operation | `46.18`; `1.0` |  |
+| `db.cosmosdb.request_content_length` | int | Request payload size in bytes | |  |
+| `db.cosmosdb.status_code` | int | Cosmos DB status code. | `200`; `201` |  |
+| `db.cosmosdb.sub_status_code` | int | Cosmos DB sub status code. | `1000`; `1002` |  |
`db.cosmosdb.connection_mode` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `gateway` | Gateway (HTTP) connections mode |
-| `direct` | Direct connection. |
-
-`db.cosmosdb.operation_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `Invalid` | invalid |
-| `Create` | create |
-| `Patch` | patch |
-| `Read` | read |
-| `ReadFeed` | read_feed |
-| `Delete` | delete |
-| `Replace` | replace |
-| `Execute` | execute |
-| `Query` | query |
-| `Head` | head |
-| `HeadFeed` | head_feed |
-| `Upsert` | upsert |
-| `Batch` | batch |
-| `QueryPlan` | query_plan |
-| `ExecuteJavaScript` | execute_javascript |
+| Value | Description | Stability |
+|---|---|---|
+| `gateway` | Gateway (HTTP) connections mode |  |
+| `direct` | Direct connection. |  |
+
+`db.cosmosdb.operation_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `Invalid` | invalid |  |
+| `Create` | create |  |
+| `Patch` | patch |  |
+| `Read` | read |  |
+| `ReadFeed` | read_feed |  |
+| `Delete` | delete |  |
+| `Replace` | replace |  |
+| `Execute` | execute |  |
+| `Query` | query |  |
+| `Head` | head |  |
+| `HeadFeed` | head_feed |  |
+| `Upsert` | upsert |  |
+| `Batch` | batch |  |
+| `QueryPlan` | query_plan |  |
+| `ExecuteJavaScript` | execute_javascript |  |
## Elasticsearch Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `db.elasticsearch.cluster.name` | string | Represents the identifier of an Elasticsearch cluster. | `e9106fc68e3044f0b1475b04bf4ffd5f` |
-| `db.elasticsearch.path_parts.` | string | A dynamic value in the url path. [1] | `db.elasticsearch.path_parts.index=test-index`; `db.elasticsearch.path_parts.doc_id=123` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.elasticsearch.cluster.name` | string | Represents the identifier of an Elasticsearch cluster. | `e9106fc68e3044f0b1475b04bf4ffd5f` |  |
+| `db.elasticsearch.path_parts.` | string | A dynamic value in the url path. [1] | `db.elasticsearch.path_parts.index=test-index`; `db.elasticsearch.path_parts.doc_id=123` |  |
**[1]:** Many Elasticsearch url paths allow dynamic values. These SHOULD be recorded in span attributes in the format `db.elasticsearch.path_parts.`, where `` is the url path part name. The implementation SHOULD reference the [elasticsearch schema](https://raw.githubusercontent.com/elastic/elasticsearch-specification/main/output/schema/schema.json) in order to map the path part values to their names.
@@ -180,17 +180,17 @@
## MongoDB Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `db.mongodb.collection` | string | The MongoDB collection being accessed within the database stated in `db.name`. | `customers`; `products` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.mongodb.collection` | string | The MongoDB collection being accessed within the database stated in `db.name`. | `customers`; `products` |  |
## MSSQL Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `db.mssql.instance_name` | string | The Microsoft SQL Server [instance name](https://docs.microsoft.com/sql/connect/jdbc/building-the-connection-url?view=sql-server-ver15) connecting to. This name is used to determine the port of a named instance. [1] | `MSSQLSERVER` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.mssql.instance_name` | string | The Microsoft SQL Server [instance name](https://docs.microsoft.com/sql/connect/jdbc/building-the-connection-url?view=sql-server-ver15) connecting to. This name is used to determine the port of a named instance. [1] | `MSSQLSERVER` |  |
**[1]:** If setting a `db.mssql.instance_name`, `server.port` is no longer required (but still recommended if non-standard).
@@ -198,17 +198,17 @@
## Redis Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `db.redis.database_index` | int | The index of the database being accessed as used in the [`SELECT` command](https://redis.io/commands/select), provided as an integer. To be used instead of the generic `db.name` attribute. | `0`; `1`; `15` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.redis.database_index` | int | The index of the database being accessed as used in the [`SELECT` command](https://redis.io/commands/select), provided as an integer. To be used instead of the generic `db.name` attribute. | `0`; `1`; `15` |  |
## SQL Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `db.sql.table` | string | The name of the primary table that the operation is acting upon, including the database name (if applicable). [1] | `public.users`; `customers` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.sql.table` | string | The name of the primary table that the operation is acting upon, including the database name (if applicable). [1] | `public.users`; `customers` |  |
**[1]:** It is not recommended to attempt any client-side parsing of `db.statement` just to get this property, but it should be set if it is provided by the library being instrumented. If the operation is acting upon an anonymous table, or more than one table, this value MUST NOT be set.
@@ -216,19 +216,19 @@
## Deprecated DB Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `db.connection_string` | string | 
Deprecated, use `server.address`, `server.port` attributes instead. | `Server=(localdb)\v11.0;Integrated Security=true;` |
-| `db.elasticsearch.node.name` | string | 
Deprecated, use `db.instance.id` instead. | `instance-0000000001` |
-| `db.jdbc.driver_classname` | string | 
Removed, no replacement at this time. | `org.postgresql.Driver`; `com.microsoft.sqlserver.jdbc.SQLServerDriver` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.connection_string` | string | Deprecated, use `server.address`, `server.port` attributes instead. | `Server=(localdb)\v11.0;Integrated Security=true;` | 
"Replaced by `server.address` and `server.port`." |
+| `db.elasticsearch.node.name` | string | Deprecated, use `db.instance.id` instead. | `instance-0000000001` | 
Replaced by `db.instance.id`. |
+| `db.jdbc.driver_classname` | string | Removed, no replacement at this time. | `org.postgresql.Driver`; `com.microsoft.sqlserver.jdbc.SQLServerDriver` | 
Removed as not used. |
### Deprecated Elasticsearch Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `db.connection_string` | string | 
Deprecated, use `server.address`, `server.port` attributes instead. | `Server=(localdb)\v11.0;Integrated Security=true;` |
-| `db.elasticsearch.node.name` | string | 
Deprecated, use `db.instance.id` instead. | `instance-0000000001` |
-| `db.jdbc.driver_classname` | string | 
Removed, no replacement at this time. | `org.postgresql.Driver`; `com.microsoft.sqlserver.jdbc.SQLServerDriver` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `db.connection_string` | string | Deprecated, use `server.address`, `server.port` attributes instead. | `Server=(localdb)\v11.0;Integrated Security=true;` | 
"Replaced by `server.address` and `server.port`." |
+| `db.elasticsearch.node.name` | string | Deprecated, use `db.instance.id` instead. | `instance-0000000001` | 
Replaced by `db.instance.id`. |
+| `db.jdbc.driver_classname` | string | Removed, no replacement at this time. | `org.postgresql.Driver`; `com.microsoft.sqlserver.jdbc.SQLServerDriver` | 
Removed as not used. |
diff --git a/docs/attributes-registry/deployment.md b/docs/attributes-registry/deployment.md
index 7e4ad484ed..a29d864de4 100644
--- a/docs/attributes-registry/deployment.md
+++ b/docs/attributes-registry/deployment.md
@@ -2,9 +2,9 @@
## Deployment Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `deployment.environment` | string | Name of the [deployment environment](https://wikipedia.org/wiki/Deployment_environment) (aka deployment tier). [1] | `staging`; `production` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `deployment.environment` | string | Name of the [deployment environment](https://wikipedia.org/wiki/Deployment_environment) (aka deployment tier). [1] | `staging`; `production` |  |
**[1]:** `deployment.environment` does not affect the uniqueness constraints defined through
the `service.namespace`, `service.name` and `service.instance.id` resource attributes.
diff --git a/docs/attributes-registry/destination.md b/docs/attributes-registry/destination.md
index db83cb53b0..1e5d7339d5 100644
--- a/docs/attributes-registry/destination.md
+++ b/docs/attributes-registry/destination.md
@@ -12,10 +12,10 @@ This also covers unidirectional UDP flows and peer-to-peer communication where t
"user-facing" surface of the protocol / API does not expose a clear notion of client and server.
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `destination.address` | string | Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `destination.example.com`; `10.1.2.80`; `/tmp/my.sock` |
-| `destination.port` | int | Destination port number | `3389`; `2888` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `destination.address` | string | Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `destination.example.com`; `10.1.2.80`; `/tmp/my.sock` |  |
+| `destination.port` | int | Destination port number | `3389`; `2888` |  |
**[1]:** When observed from the source side, and when communicating through an intermediary, `destination.address` SHOULD represent the destination address behind any intermediaries, for example proxies, if it's available.
diff --git a/docs/attributes-registry/device.md b/docs/attributes-registry/device.md
index 3c1f06c4ea..c52d23f5fa 100644
--- a/docs/attributes-registry/device.md
+++ b/docs/attributes-registry/device.md
@@ -6,12 +6,12 @@
## Device Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `device.id` | string | A unique identifier representing the device [1] | `2ab2916d-a51f-4ac8-80ee-45ac31a28092` |
-| `device.manufacturer` | string | The name of the device manufacturer [2] | `Apple`; `Samsung` |
-| `device.model.identifier` | string | The model identifier for the device [3] | `iPhone3,4`; `SM-G920F` |
-| `device.model.name` | string | The marketing name for the device model [4] | `iPhone 6s Plus`; `Samsung Galaxy S6` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `device.id` | string | A unique identifier representing the device [1] | `2ab2916d-a51f-4ac8-80ee-45ac31a28092` |  |
+| `device.manufacturer` | string | The name of the device manufacturer [2] | `Apple`; `Samsung` |  |
+| `device.model.identifier` | string | The model identifier for the device [3] | `iPhone3,4`; `SM-G920F` |  |
+| `device.model.name` | string | The marketing name for the device model [4] | `iPhone 6s Plus`; `Samsung Galaxy S6` |  |
**[1]:** The device identifier MUST only be defined using the values outlined below. This value is not an advertising identifier and MUST NOT be used as such. On iOS (Swift or Objective-C), this value MUST be equal to the [vendor identifier](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). On Android (Java or Kotlin), this value MUST be equal to the Firebase Installation ID or a globally unique UUID which is persisted across sessions in your application. More information can be found [here](https://developer.android.com/training/articles/user-data-ids) on best practices and exact implementation details. Caution should be taken when storing personal data or anything which can identify a user. GDPR and data protection laws may apply, ensure you do your own due diligence.
diff --git a/docs/attributes-registry/disk.md b/docs/attributes-registry/disk.md
index a983873365..b52b79af0f 100644
--- a/docs/attributes-registry/disk.md
+++ b/docs/attributes-registry/disk.md
@@ -6,14 +6,14 @@
## Disk Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `disk.io.direction` | string | The disk IO operation direction. | `read` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `disk.io.direction` | string | The disk IO operation direction. | `read` |  |
`disk.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `read` | read |
-| `write` | write |
+| Value | Description | Stability |
+|---|---|---|
+| `read` | read |  |
+| `write` | write |  |
diff --git a/docs/attributes-registry/dns.md b/docs/attributes-registry/dns.md
index eeb6e10d5e..59079ab01e 100644
--- a/docs/attributes-registry/dns.md
+++ b/docs/attributes-registry/dns.md
@@ -6,9 +6,9 @@
## DNS Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `dns.question.name` | string | The name being queried. [1] | `www.example.com`; `opentelemetry.io` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `dns.question.name` | string | The name being queried. [1] | `www.example.com`; `opentelemetry.io` |  |
**[1]:** 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.
\ No newline at end of file
diff --git a/docs/attributes-registry/enduser.md b/docs/attributes-registry/enduser.md
index f8be2f3699..616c7f89ad 100644
--- a/docs/attributes-registry/enduser.md
+++ b/docs/attributes-registry/enduser.md
@@ -2,9 +2,9 @@
## End User Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `enduser.id` | string | Username or client_id extracted from the access token or [Authorization](https://tools.ietf.org/html/rfc7235#section-4.2) header in the inbound request from outside the system. | `username` |
-| `enduser.role` | string | Actual/assumed role the client is making the request under extracted from token or application security context. | `admin` |
-| `enduser.scope` | string | Scopes or granted authorities the client currently possesses extracted from token or application security context. The value would come from the scope associated with an [OAuth 2.0 Access Token](https://tools.ietf.org/html/rfc6749#section-3.3) or an attribute value in a [SAML 2.0 Assertion](http://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html). | `read:message, write:files` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `enduser.id` | string | Username or client_id extracted from the access token or [Authorization](https://tools.ietf.org/html/rfc7235#section-4.2) header in the inbound request from outside the system. | `username` |  |
+| `enduser.role` | string | Actual/assumed role the client is making the request under extracted from token or application security context. | `admin` |  |
+| `enduser.scope` | string | Scopes or granted authorities the client currently possesses extracted from token or application security context. The value would come from the scope associated with an [OAuth 2.0 Access Token](https://tools.ietf.org/html/rfc6749#section-3.3) or an attribute value in a [SAML 2.0 Assertion](http://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html). | `read:message, write:files` |  |
diff --git a/docs/attributes-registry/error.md b/docs/attributes-registry/error.md
index 21e0d2c67d..1b43a77600 100644
--- a/docs/attributes-registry/error.md
+++ b/docs/attributes-registry/error.md
@@ -6,9 +6,9 @@
## Error Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `error.type` | string | 
Describes a class of error the operation ended with. [1] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `error.type` | string | Describes a class of error the operation ended with. [1] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` |  |
**[1]:** The `error.type` SHOULD be predictable and SHOULD have low cardinality.
Instrumentations SHOULD document the list of errors they report.
@@ -26,9 +26,9 @@ it's RECOMMENDED to:
* Use a domain-specific attribute
* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
\ No newline at end of file
diff --git a/docs/attributes-registry/exception.md b/docs/attributes-registry/exception.md
index e5d541c930..22f4bfc5c6 100644
--- a/docs/attributes-registry/exception.md
+++ b/docs/attributes-registry/exception.md
@@ -6,12 +6,12 @@
## Exception Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `exception.escaped` | boolean | 
SHOULD be set to true if the exception event is recorded at a point where it is known that the exception is escaping the scope of the span. [1] | |
-| `exception.message` | string | 
The exception message. | `Division by zero`; `Can't convert 'int' object to str implicitly` |
-| `exception.stacktrace` | string | 
A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `Exception in thread "main" java.lang.RuntimeException: Test exception\n at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` |
-| `exception.type` | string | 
The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it. | `java.net.ConnectException`; `OSError` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `exception.escaped` | boolean | SHOULD be set to true if the exception event is recorded at a point where it is known that the exception is escaping the scope of the span. [1] | |  |
+| `exception.message` | string | The exception message. | `Division by zero`; `Can't convert 'int' object to str implicitly` |  |
+| `exception.stacktrace` | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `Exception in thread "main" java.lang.RuntimeException: Test exception\n at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` |  |
+| `exception.type` | string | The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it. | `java.net.ConnectException`; `OSError` |  |
**[1]:** An exception is considered to have escaped (or left) the scope of a span,
if that span is ended while the exception is still logically "in flight".
diff --git a/docs/attributes-registry/faas.md b/docs/attributes-registry/faas.md
index 4f8f5e4ea8..ec0a9a61c2 100644
--- a/docs/attributes-registry/faas.md
+++ b/docs/attributes-registry/faas.md
@@ -7,24 +7,24 @@ linkTitle: FaaS
## FaaS Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `faas.coldstart` | boolean | A boolean that is true if the serverless function is executed for the first time (aka cold-start). | |
-| `faas.cron` | string | A string containing the schedule period as [Cron Expression](https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.htm). | `0/5 * * * ? *` |
-| `faas.document.collection` | string | The name of the source on which the triggering operation was performed. For example, in Cloud Storage or S3 corresponds to the bucket name, and in Cosmos DB to the database name. | `myBucketName`; `myDbName` |
-| `faas.document.name` | string | The document name/table subjected to the operation. For example, in Cloud Storage or S3 is the name of the file, and in Cosmos DB the table name. | `myFile.txt`; `myTableName` |
-| `faas.document.operation` | string | Describes the type of the operation that was performed on the data. | `insert` |
-| `faas.document.time` | string | A string containing the time when the data was accessed in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` |
-| `faas.instance` | string | The execution environment ID as a string, that will be potentially reused for other invocations to the same function/function version. [1] | `2021/06/28/[$LATEST]2f399eb14537447da05ab2a2e39309de` |
-| `faas.invocation_id` | string | The invocation ID of the current function invocation. | `af9d5aa4-a685-4c5f-a22b-444f80b3cc28` |
-| `faas.invoked_name` | string | The name of the invoked function. [2] | `my-function` |
-| `faas.invoked_provider` | string | The cloud provider of the invoked function. [3] | `alibaba_cloud` |
-| `faas.invoked_region` | string | The cloud region of the invoked function. [4] | `eu-central-1` |
-| `faas.max_memory` | int | The amount of memory available to the serverless function converted to Bytes. [5] | `134217728` |
-| `faas.name` | string | The name of the single function that this runtime instance executes. [6] | `my-function`; `myazurefunctionapp/some-function-name` |
-| `faas.time` | string | A string containing the function invocation time in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` |
-| `faas.trigger` | string | Type of the trigger which caused this function invocation. | `datasource` |
-| `faas.version` | string | The immutable version of the function being executed. [7] | `26`; `pinkfroid-00002` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `faas.coldstart` | boolean | A boolean that is true if the serverless function is executed for the first time (aka cold-start). | |  |
+| `faas.cron` | string | A string containing the schedule period as [Cron Expression](https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.htm). | `0/5 * * * ? *` |  |
+| `faas.document.collection` | string | The name of the source on which the triggering operation was performed. For example, in Cloud Storage or S3 corresponds to the bucket name, and in Cosmos DB to the database name. | `myBucketName`; `myDbName` |  |
+| `faas.document.name` | string | The document name/table subjected to the operation. For example, in Cloud Storage or S3 is the name of the file, and in Cosmos DB the table name. | `myFile.txt`; `myTableName` |  |
+| `faas.document.operation` | string | Describes the type of the operation that was performed on the data. | `insert` |  |
+| `faas.document.time` | string | A string containing the time when the data was accessed in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` |  |
+| `faas.instance` | string | The execution environment ID as a string, that will be potentially reused for other invocations to the same function/function version. [1] | `2021/06/28/[$LATEST]2f399eb14537447da05ab2a2e39309de` |  |
+| `faas.invocation_id` | string | The invocation ID of the current function invocation. | `af9d5aa4-a685-4c5f-a22b-444f80b3cc28` |  |
+| `faas.invoked_name` | string | The name of the invoked function. [2] | `my-function` |  |
+| `faas.invoked_provider` | string | The cloud provider of the invoked function. [3] | `alibaba_cloud` |  |
+| `faas.invoked_region` | string | The cloud region of the invoked function. [4] | `eu-central-1` |  |
+| `faas.max_memory` | int | The amount of memory available to the serverless function converted to Bytes. [5] | `134217728` |  |
+| `faas.name` | string | The name of the single function that this runtime instance executes. [6] | `my-function`; `myazurefunctionapp/some-function-name` |  |
+| `faas.time` | string | A string containing the function invocation time in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` |  |
+| `faas.trigger` | string | Type of the trigger which caused this function invocation. | `datasource` |  |
+| `faas.version` | string | The immutable version of the function being executed. [7] | `26`; `pinkfroid-00002` |  |
**[1]:** * **AWS Lambda:** Use the (full) log stream name.
@@ -63,31 +63,31 @@ definition of function name MUST be used for this attribute
[`K_REVISION` environment variable](https://cloud.google.com/functions/docs/env-var#runtime_environment_variables_set_automatically).
* **Azure Functions:** Not applicable. Do not set this attribute.
-`faas.document.operation` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`faas.document.operation` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `insert` | When a new object is created. |
-| `edit` | When an object is modified. |
-| `delete` | When an object is deleted. |
+| Value | Description | Stability |
+|---|---|---|
+| `insert` | When a new object is created. |  |
+| `edit` | When an object is modified. |  |
+| `delete` | When an object is deleted. |  |
-`faas.invoked_provider` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`faas.invoked_provider` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `alibaba_cloud` | Alibaba Cloud |
-| `aws` | Amazon Web Services |
-| `azure` | Microsoft Azure |
-| `gcp` | Google Cloud Platform |
-| `tencent_cloud` | Tencent Cloud |
+| Value | Description | Stability |
+|---|---|---|
+| `alibaba_cloud` | Alibaba Cloud |  |
+| `aws` | Amazon Web Services |  |
+| `azure` | Microsoft Azure |  |
+| `gcp` | Google Cloud Platform |  |
+| `tencent_cloud` | Tencent Cloud |  |
`faas.trigger` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `datasource` | A response to some data source operation such as a database or filesystem read/write |
-| `http` | To provide an answer to an inbound HTTP request |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |
-| `timer` | A function is scheduled to be executed regularly |
-| `other` | If none of the others apply |
+| Value | Description | Stability |
+|---|---|---|
+| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
+| `other` | If none of the others apply |  |
\ No newline at end of file
diff --git a/docs/attributes-registry/feature-flag.md b/docs/attributes-registry/feature-flag.md
index b1fcf8f872..cad407b363 100644
--- a/docs/attributes-registry/feature-flag.md
+++ b/docs/attributes-registry/feature-flag.md
@@ -2,11 +2,11 @@
## Feature Flag Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `feature_flag.key` | string | The unique identifier of the feature flag. | `logo-color` |
-| `feature_flag.provider_name` | string | The name of the service provider that performs the flag evaluation. | `Flag Manager` |
-| `feature_flag.variant` | string | SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of the value can be used. [1] | `red`; `true`; `on` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `feature_flag.key` | string | The unique identifier of the feature flag. | `logo-color` |  |
+| `feature_flag.provider_name` | string | The name of the service provider that performs the flag evaluation. | `Flag Manager` |  |
+| `feature_flag.variant` | string | SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of the value can be used. [1] | `red`; `true`; `on` |  |
**[1]:** A semantic identifier, commonly referred to as a variant, provides a means
for referring to a value without including the value itself. This can
diff --git a/docs/attributes-registry/file.md b/docs/attributes-registry/file.md
index 1848908a45..d2d83591ca 100644
--- a/docs/attributes-registry/file.md
+++ b/docs/attributes-registry/file.md
@@ -6,13 +6,13 @@
## File Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `file.directory` | string | Directory where the file is located. It should include the drive letter, when appropriate. | `/home/user`; `C:\Program Files\MyApp` |
-| `file.extension` | string | File extension, excluding the leading dot. [1] | `png`; `gz` |
-| `file.name` | string | Name of the file including the extension, without the directory. | `example.png` |
-| `file.path` | string | Full path to the file, including the file name. It should include the drive letter, when appropriate. | `/home/alice/example.png`; `C:\Program Files\MyApp\myapp.exe` |
-| `file.size` | int | File size in bytes. | |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `file.directory` | string | Directory where the file is located. It should include the drive letter, when appropriate. | `/home/user`; `C:\Program Files\MyApp` |  |
+| `file.extension` | string | File extension, excluding the leading dot. [1] | `png`; `gz` |  |
+| `file.name` | string | Name of the file including the extension, without the directory. | `example.png` |  |
+| `file.path` | string | Full path to the file, including the file name. It should include the drive letter, when appropriate. | `/home/alice/example.png`; `C:\Program Files\MyApp\myapp.exe` |  |
+| `file.size` | int | File size in bytes. | |  |
**[1]:** When the file name has multiple extensions (example.tar.gz), only the last one should be captured ("gz", not "tar.gz").
diff --git a/docs/attributes-registry/gcp-cloud-run.md b/docs/attributes-registry/gcp-cloud-run.md
index 219b854ebb..fc754e943a 100644
--- a/docs/attributes-registry/gcp-cloud-run.md
+++ b/docs/attributes-registry/gcp-cloud-run.md
@@ -2,8 +2,8 @@
## Google Cloud Run Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `gcp.cloud_run.job.execution` | string | The name of the Cloud Run [execution](https://cloud.google.com/run/docs/managing/job-executions) being run for the Job, as set by the [`CLOUD_RUN_EXECUTION`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `job-name-xxxx`; `sample-job-mdw84` |
-| `gcp.cloud_run.job.task_index` | int | The index for a task within an execution as provided by the [`CLOUD_RUN_TASK_INDEX`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `0`; `1` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `gcp.cloud_run.job.execution` | string | The name of the Cloud Run [execution](https://cloud.google.com/run/docs/managing/job-executions) being run for the Job, as set by the [`CLOUD_RUN_EXECUTION`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `job-name-xxxx`; `sample-job-mdw84` |  |
+| `gcp.cloud_run.job.task_index` | int | The index for a task within an execution as provided by the [`CLOUD_RUN_TASK_INDEX`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `0`; `1` |  |
diff --git a/docs/attributes-registry/gcp-gce.md b/docs/attributes-registry/gcp-gce.md
index da3b46486d..d6735be23e 100644
--- a/docs/attributes-registry/gcp-gce.md
+++ b/docs/attributes-registry/gcp-gce.md
@@ -2,8 +2,8 @@
## Google Compute Engine Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `gcp.gce.instance.hostname` | string | The hostname of a GCE instance. This is the full value of the default or [custom hostname](https://cloud.google.com/compute/docs/instances/custom-hostname-vm). | `my-host1234.example.com`; `sample-vm.us-west1-b.c.my-project.internal` |
-| `gcp.gce.instance.name` | string | The instance name of a GCE instance. This is the value provided by `host.name`, the visible name of the instance in the Cloud Console UI, and the prefix for the default hostname of the instance as defined by the [default internal DNS name](https://cloud.google.com/compute/docs/internal-dns#instance-fully-qualified-domain-names). | `instance-1`; `my-vm-name` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `gcp.gce.instance.hostname` | string | The hostname of a GCE instance. This is the full value of the default or [custom hostname](https://cloud.google.com/compute/docs/instances/custom-hostname-vm). | `my-host1234.example.com`; `sample-vm.us-west1-b.c.my-project.internal` |  |
+| `gcp.gce.instance.name` | string | The instance name of a GCE instance. This is the value provided by `host.name`, the visible name of the instance in the Cloud Console UI, and the prefix for the default hostname of the instance as defined by the [default internal DNS name](https://cloud.google.com/compute/docs/internal-dns#instance-fully-qualified-domain-names). | `instance-1`; `my-vm-name` |  |
diff --git a/docs/attributes-registry/host.md b/docs/attributes-registry/host.md
index a8c1de6e3f..dc571c70cd 100644
--- a/docs/attributes-registry/host.md
+++ b/docs/attributes-registry/host.md
@@ -6,23 +6,23 @@
## Host Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `host.arch` | string | The CPU architecture the host system is running on. | `amd64` |
-| `host.cpu.cache.l2.size` | int | The amount of level 2 memory cache available to the processor (in Bytes). | `12288000` |
-| `host.cpu.family` | string | Family or generation of the CPU. | `6`; `PA-RISC 1.1e` |
-| `host.cpu.model.id` | string | Model identifier. It provides more granular information about the CPU, distinguishing it from other CPUs within the same family. | `6`; `9000/778/B180L` |
-| `host.cpu.model.name` | string | Model designation of the processor. | `11th Gen Intel(R) Core(TM) i7-1185G7 @ 3.00GHz` |
-| `host.cpu.stepping` | string | Stepping or core revisions. | `1`; `r1p1` |
-| `host.cpu.vendor.id` | string | Processor manufacturer identifier. A maximum 12-character string. [1] | `GenuineIntel` |
-| `host.id` | string | Unique host ID. For Cloud, this must be the instance_id assigned by the cloud provider. For non-containerized systems, this should be the `machine-id`. See the table below for the sources to use to determine the `machine-id` based on operating system. | `fdbf79e8af94cb7f9e8df36789187052` |
-| `host.image.id` | string | VM image ID or host OS image ID. For Cloud, this value is from the provider. | `ami-07b06b442921831e5` |
-| `host.image.name` | string | Name of the VM image or OS install the host was instantiated from. | `infra-ami-eks-worker-node-7d4ec78312`; `CentOS-8-x86_64-1905` |
-| `host.image.version` | string | The version string of the VM image or host OS as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `0.1` |
-| `host.ip` | string[] | Available IP addresses of the host, excluding loopback interfaces. [2] | `[192.168.1.140, fe80::abc2:4a28:737a:609e]` |
-| `host.mac` | string[] | Available MAC addresses of the host, excluding loopback interfaces. [3] | `[AC-DE-48-23-45-67, AC-DE-48-23-45-67-01-9F]` |
-| `host.name` | string | Name of the host. On Unix systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user. | `opentelemetry-test` |
-| `host.type` | string | Type of host. For Cloud, this must be the machine type. | `n1-standard-1` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `host.arch` | string | The CPU architecture the host system is running on. | `amd64` |  |
+| `host.cpu.cache.l2.size` | int | The amount of level 2 memory cache available to the processor (in Bytes). | `12288000` |  |
+| `host.cpu.family` | string | Family or generation of the CPU. | `6`; `PA-RISC 1.1e` |  |
+| `host.cpu.model.id` | string | Model identifier. It provides more granular information about the CPU, distinguishing it from other CPUs within the same family. | `6`; `9000/778/B180L` |  |
+| `host.cpu.model.name` | string | Model designation of the processor. | `11th Gen Intel(R) Core(TM) i7-1185G7 @ 3.00GHz` |  |
+| `host.cpu.stepping` | string | Stepping or core revisions. | `1`; `r1p1` |  |
+| `host.cpu.vendor.id` | string | Processor manufacturer identifier. A maximum 12-character string. [1] | `GenuineIntel` |  |
+| `host.id` | string | Unique host ID. For Cloud, this must be the instance_id assigned by the cloud provider. For non-containerized systems, this should be the `machine-id`. See the table below for the sources to use to determine the `machine-id` based on operating system. | `fdbf79e8af94cb7f9e8df36789187052` |  |
+| `host.image.id` | string | VM image ID or host OS image ID. For Cloud, this value is from the provider. | `ami-07b06b442921831e5` |  |
+| `host.image.name` | string | Name of the VM image or OS install the host was instantiated from. | `infra-ami-eks-worker-node-7d4ec78312`; `CentOS-8-x86_64-1905` |  |
+| `host.image.version` | string | The version string of the VM image or host OS as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `0.1` |  |
+| `host.ip` | string[] | Available IP addresses of the host, excluding loopback interfaces. [2] | `[192.168.1.140, fe80::abc2:4a28:737a:609e]` |  |
+| `host.mac` | string[] | Available MAC addresses of the host, excluding loopback interfaces. [3] | `[AC-DE-48-23-45-67, AC-DE-48-23-45-67-01-9F]` |  |
+| `host.name` | string | Name of the host. On Unix systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user. | `opentelemetry-test` |  |
+| `host.type` | string | Type of host. For Cloud, this must be the machine type. | `n1-standard-1` |  |
**[1]:** [CPUID](https://wiki.osdev.org/CPUID) command returns the vendor ID string in EBX, EDX and ECX registers. Writing these to memory in this order results in a 12-character string.
@@ -30,16 +30,16 @@
**[3]:** MAC Addresses MUST be represented in [IEEE RA hexadecimal form](https://standards.ieee.org/wp-content/uploads/import/documents/tutorials/eui.pdf): as hyphen-separated octets in uppercase hexadecimal form from most to least significant.
-`host.arch` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `amd64` | AMD64 |
-| `arm32` | ARM32 |
-| `arm64` | ARM64 |
-| `ia64` | Itanium |
-| `ppc32` | 32-bit PowerPC |
-| `ppc64` | 64-bit PowerPC |
-| `s390x` | IBM z/Architecture |
-| `x86` | 32-bit x86 |
+`host.arch` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `amd64` | AMD64 |  |
+| `arm32` | ARM32 |  |
+| `arm64` | ARM64 |  |
+| `ia64` | Itanium |  |
+| `ppc32` | 32-bit PowerPC |  |
+| `ppc64` | 64-bit PowerPC |  |
+| `s390x` | IBM z/Architecture |  |
+| `x86` | 32-bit x86 |  |
\ No newline at end of file
diff --git a/docs/attributes-registry/http.md b/docs/attributes-registry/http.md
index 31fb5b6355..e25443590d 100644
--- a/docs/attributes-registry/http.md
+++ b/docs/attributes-registry/http.md
@@ -6,20 +6,20 @@
## HTTP Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `http.connection.state` | string | State of the HTTP connection in the HTTP connection pool. | `active`; `idle` |
-| `http.request.body.size` | int | The size of the request payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size. | `3495` |
-| `http.request.header.` | string[] | 
HTTP request headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [1] | `http.request.header.content-type=["application/json"]`; `http.request.header.x-forwarded-for=["1.2.3.4", "1.2.3.5"]` |
-| `http.request.method` | string | 
HTTP request method. [2] | `GET`; `POST`; `HEAD` |
-| `http.request.method_original` | string | 
Original HTTP method sent by the client in the request line. | `GeT`; `ACL`; `foo` |
-| `http.request.resend_count` | int | 
The ordinal number of request resending attempt (for any reason, including redirects). [3] | `3` |
-| `http.request.size` | int | The total size of the request in bytes. This should be the total number of bytes sent over the wire, including the request line (HTTP/1.1), framing (HTTP/2 and HTTP/3), headers, and request body if any. | `1437` |
-| `http.response.body.size` | int | The size of the response payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size. | `3495` |
-| `http.response.header.` | string[] | 
HTTP response headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [4] | `http.response.header.content-type=["application/json"]`; `http.response.header.my-custom-header=["abc", "def"]` |
-| `http.response.size` | int | The total size of the response in bytes. This should be the total number of bytes sent over the wire, including the status line (HTTP/1.1), framing (HTTP/2 and HTTP/3), headers, and response body and trailers if any. | `1437` |
-| `http.response.status_code` | int | 
[HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` |
-| `http.route` | string | 
The matched route, that is, the path template in the format used by the respective server framework. [5] | `/users/:userID?`; `{controller}/{action}/{id?}` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `http.connection.state` | string | State of the HTTP connection in the HTTP connection pool. | `active`; `idle` |  |
+| `http.request.body.size` | int | The size of the request payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size. | `3495` |  |
+| `http.request.header.` | string[] | HTTP request headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [1] | `http.request.header.content-type=["application/json"]`; `http.request.header.x-forwarded-for=["1.2.3.4", "1.2.3.5"]` |  |
+| `http.request.method` | string | HTTP request method. [2] | `GET`; `POST`; `HEAD` |  |
+| `http.request.method_original` | string | Original HTTP method sent by the client in the request line. | `GeT`; `ACL`; `foo` |  |
+| `http.request.resend_count` | int | The ordinal number of request resending attempt (for any reason, including redirects). [3] | `3` |  |
+| `http.request.size` | int | The total size of the request in bytes. This should be the total number of bytes sent over the wire, including the request line (HTTP/1.1), framing (HTTP/2 and HTTP/3), headers, and request body if any. | `1437` |  |
+| `http.response.body.size` | int | The size of the response payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size. | `3495` |  |
+| `http.response.header.` | string[] | HTTP response headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [4] | `http.response.header.content-type=["application/json"]`; `http.response.header.my-custom-header=["abc", "def"]` |  |
+| `http.response.size` | int | The total size of the response in bytes. This should be the total number of bytes sent over the wire, including the status line (HTTP/1.1), framing (HTTP/2 and HTTP/3), headers, and response body and trailers if any. | `1437` |  |
+| `http.response.status_code` | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` |  |
+| `http.route` | string | The matched route, that is, the path template in the format used by the respective server framework. [5] | `/users/:userID?`; `{controller}/{action}/{id?}` |  |
**[1]:** Instrumentations SHOULD require an explicit configuration of which headers are to be captured. Including all request headers can be a security risk - explicit configuration helps avoid leaking sensitive information.
The `User-Agent` header is already captured in the `user_agent.original` attribute. Users MAY explicitly configure instrumentations to capture them even though it is not recommended.
@@ -49,52 +49,52 @@ The attribute value MUST consist of either multiple header values as an array of
**[5]:** MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
SHOULD include the [application root](/docs/http/http-spans.md#http-server-definitions) if there is one.
-`http.connection.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `active` | active state. |
-| `idle` | idle state. |
-
-`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `CONNECT` | CONNECT method. |
-| `DELETE` | DELETE method. |
-| `GET` | GET method. |
-| `HEAD` | HEAD method. |
-| `OPTIONS` | OPTIONS method. |
-| `PATCH` | PATCH method. |
-| `POST` | POST method. |
-| `PUT` | PUT method. |
-| `TRACE` | TRACE method. |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |
+`http.connection.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `active` | active state. |  |
+| `idle` | idle state. |  |
+
+`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
## Deprecated HTTP Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `http.flavor` | string | 
Deprecated, use `network.protocol.name` instead. | `1.0` |
-| `http.method` | string | 
Deprecated, use `http.request.method` instead. | `GET`; `POST`; `HEAD` |
-| `http.request_content_length` | int | 
Deprecated, use `http.request.header.content-length` instead. | `3495` |
-| `http.response_content_length` | int | 
Deprecated, use `http.response.header.content-length` instead. | `3495` |
-| `http.scheme` | string | 
Deprecated, use `url.scheme` instead. | `http`; `https` |
-| `http.status_code` | int | 
Deprecated, use `http.response.status_code` instead. | `200` |
-| `http.target` | string | 
Deprecated, use `url.path` and `url.query` instead. | `/search?q=OpenTelemetry#SemConv` |
-| `http.url` | string | 
Deprecated, use `url.full` instead. | `https://www.foo.bar/search?q=OpenTelemetry#SemConv` |
-| `http.user_agent` | string | 
Deprecated, use `user_agent.original` instead. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1` |
-
-`http.flavor` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `1.0` | HTTP/1.0 |
-| `1.1` | HTTP/1.1 |
-| `2.0` | HTTP/2 |
-| `3.0` | HTTP/3 |
-| `SPDY` | SPDY protocol. |
-| `QUIC` | QUIC protocol. |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `http.flavor` | string | Deprecated, use `network.protocol.name` instead. | `1.0` | 
Replaced by `network.protocol.name`. |
+| `http.method` | string | Deprecated, use `http.request.method` instead. | `GET`; `POST`; `HEAD` | 
Replaced by `http.request.method`. |
+| `http.request_content_length` | int | Deprecated, use `http.request.header.content-length` instead. | `3495` | 
Replaced by `http.request.header.content-length`. |
+| `http.response_content_length` | int | Deprecated, use `http.response.header.content-length` instead. | `3495` | 
Replaced by `http.response.header.content-length`. |
+| `http.scheme` | string | Deprecated, use `url.scheme` instead. | `http`; `https` | 
Replaced by `url.scheme` instead. |
+| `http.status_code` | int | Deprecated, use `http.response.status_code` instead. | `200` | 
Replaced by `http.response.status_code`. |
+| `http.target` | string | Deprecated, use `url.path` and `url.query` instead. | `/search?q=OpenTelemetry#SemConv` | 
Split to `url.path` and `url.query. |
+| `http.url` | string | Deprecated, use `url.full` instead. | `https://www.foo.bar/search?q=OpenTelemetry#SemConv` | 
Replaced by `url.full`. |
+| `http.user_agent` | string | Deprecated, use `user_agent.original` instead. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1` | 
Replaced by `user_agent.original`. |
+
+`http.flavor` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `1.0` | HTTP/1.0 |  |
+| `1.1` | HTTP/1.1 |  |
+| `2.0` | HTTP/2 |  |
+| `3.0` | HTTP/3 |  |
+| `SPDY` | SPDY protocol. |  |
+| `QUIC` | QUIC protocol. |  |
diff --git a/docs/attributes-registry/k8s.md b/docs/attributes-registry/k8s.md
index 7c85db4516..ea7c55d6fc 100644
--- a/docs/attributes-registry/k8s.md
+++ b/docs/attributes-registry/k8s.md
@@ -3,31 +3,31 @@
## Kubernetes Resource Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `k8s.cluster.name` | string | The name of the cluster. | `opentelemetry-cluster` |
-| `k8s.cluster.uid` | string | A pseudo-ID for the cluster, set to the UID of the `kube-system` namespace. [1] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |
-| `k8s.container.name` | string | The name of the Container from Pod specification, must be unique within a Pod. Container runtime usually uses different globally unique name (`container.name`). | `redis` |
-| `k8s.container.restart_count` | int | Number of times the container was restarted. This attribute can be used to identify a particular container (running or stopped) within a container spec. | `0`; `2` |
-| `k8s.cronjob.name` | string | The name of the CronJob. | `opentelemetry` |
-| `k8s.cronjob.uid` | string | The UID of the CronJob. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |
-| `k8s.daemonset.name` | string | The name of the DaemonSet. | `opentelemetry` |
-| `k8s.daemonset.uid` | string | The UID of the DaemonSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |
-| `k8s.deployment.name` | string | The name of the Deployment. | `opentelemetry` |
-| `k8s.deployment.uid` | string | The UID of the Deployment. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |
-| `k8s.job.name` | string | The name of the Job. | `opentelemetry` |
-| `k8s.job.uid` | string | The UID of the Job. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |
-| `k8s.namespace.name` | string | The name of the namespace that the pod is running in. | `default` |
-| `k8s.node.name` | string | The name of the Node. | `node-1` |
-| `k8s.node.uid` | string | The UID of the Node. | `1eb3a0c6-0477-4080-a9cb-0cb7db65c6a2` |
-| `k8s.pod.annotation.` | string | The annotation key-value pairs placed on the Pod, the `` being the annotation name, the value being the annotation value. | `k8s.pod.annotation.kubernetes.io/enforce-mountable-secrets=true`; `k8s.pod.annotation.mycompany.io/arch=x64`; `k8s.pod.annotation.data=` |
-| `k8s.pod.label.` | string | The label key-value pairs placed on the Pod, the `` being the label name, the value being the label value. | `k8s.pod.label.app=my-app`; `k8s.pod.label.mycompany.io/arch=x64`; `k8s.pod.label.data=` |
-| `k8s.pod.name` | string | The name of the Pod. | `opentelemetry-pod-autoconf` |
-| `k8s.pod.uid` | string | The UID of the Pod. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |
-| `k8s.replicaset.name` | string | The name of the ReplicaSet. | `opentelemetry` |
-| `k8s.replicaset.uid` | string | The UID of the ReplicaSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |
-| `k8s.statefulset.name` | string | The name of the StatefulSet. | `opentelemetry` |
-| `k8s.statefulset.uid` | string | The UID of the StatefulSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `k8s.cluster.name` | string | The name of the cluster. | `opentelemetry-cluster` |  |
+| `k8s.cluster.uid` | string | A pseudo-ID for the cluster, set to the UID of the `kube-system` namespace. [1] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` |  |
+| `k8s.container.name` | string | The name of the Container from Pod specification, must be unique within a Pod. Container runtime usually uses different globally unique name (`container.name`). | `redis` |  |
+| `k8s.container.restart_count` | int | Number of times the container was restarted. This attribute can be used to identify a particular container (running or stopped) within a container spec. | `0`; `2` |  |
+| `k8s.cronjob.name` | string | The name of the CronJob. | `opentelemetry` |  |
+| `k8s.cronjob.uid` | string | The UID of the CronJob. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.daemonset.name` | string | The name of the DaemonSet. | `opentelemetry` |  |
+| `k8s.daemonset.uid` | string | The UID of the DaemonSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.deployment.name` | string | The name of the Deployment. | `opentelemetry` |  |
+| `k8s.deployment.uid` | string | The UID of the Deployment. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.job.name` | string | The name of the Job. | `opentelemetry` |  |
+| `k8s.job.uid` | string | The UID of the Job. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.namespace.name` | string | The name of the namespace that the pod is running in. | `default` |  |
+| `k8s.node.name` | string | The name of the Node. | `node-1` |  |
+| `k8s.node.uid` | string | The UID of the Node. | `1eb3a0c6-0477-4080-a9cb-0cb7db65c6a2` |  |
+| `k8s.pod.annotation.` | string | The annotation key-value pairs placed on the Pod, the `` being the annotation name, the value being the annotation value. | `k8s.pod.annotation.kubernetes.io/enforce-mountable-secrets=true`; `k8s.pod.annotation.mycompany.io/arch=x64`; `k8s.pod.annotation.data=` |  |
+| `k8s.pod.label.` | string | The label key-value pairs placed on the Pod, the `` being the label name, the value being the label value. | `k8s.pod.label.app=my-app`; `k8s.pod.label.mycompany.io/arch=x64`; `k8s.pod.label.data=` |  |
+| `k8s.pod.name` | string | The name of the Pod. | `opentelemetry-pod-autoconf` |  |
+| `k8s.pod.uid` | string | The UID of the Pod. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.replicaset.name` | string | The name of the ReplicaSet. | `opentelemetry` |  |
+| `k8s.replicaset.uid` | string | The UID of the ReplicaSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
+| `k8s.statefulset.name` | string | The name of the StatefulSet. | `opentelemetry` |  |
+| `k8s.statefulset.uid` | string | The UID of the StatefulSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` |  |
**[1]:** K8s doesn't have support for obtaining a cluster ID. If this is ever
added, we will recommend collecting the `k8s.cluster.uid` through the
diff --git a/docs/attributes-registry/messaging.md b/docs/attributes-registry/messaging.md
index 7e3491b8d3..3e713cdd5a 100644
--- a/docs/attributes-registry/messaging.md
+++ b/docs/attributes-registry/messaging.md
@@ -19,23 +19,23 @@
## Generic Messaging Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `messaging.batch.message_count` | int | The number of messages sent, received, or processed in the scope of the batching operation. [1] | `0`; `1`; `2` |
-| `messaging.client_id` | string | A unique identifier for the client that consumes or produces a message. | `client-5`; `myhost@8742@s8083jm` |
-| `messaging.destination.anonymous` | boolean | A boolean that is true if the message destination is anonymous (could be unnamed or have auto-generated name). | |
-| `messaging.destination.name` | string | The message destination name [2] | `MyQueue`; `MyTopic` |
-| `messaging.destination.partition.id` | string | The identifier of the partition messages are sent to or received from, unique within the `messaging.destination.name`. | `1` |
-| `messaging.destination.template` | string | Low cardinality representation of the messaging destination name [3] | `/customers/{customerId}` |
-| `messaging.destination.temporary` | boolean | A boolean that is true if the message destination is temporary and might not exist anymore after messages are processed. | |
-| `messaging.destination_publish.anonymous` | boolean | A boolean that is true if the publish message destination is anonymous (could be unnamed or have auto-generated name). | |
-| `messaging.destination_publish.name` | string | The name of the original destination the message was published to [4] | `MyQueue`; `MyTopic` |
-| `messaging.message.body.size` | int | The size of the message body in bytes. [5] | `1439` |
-| `messaging.message.conversation_id` | string | The conversation ID identifying the conversation to which the message belongs, represented as a string. Sometimes called "Correlation ID". | `MyConversationId` |
-| `messaging.message.envelope.size` | int | The size of the message body and metadata in bytes. [6] | `2738` |
-| `messaging.message.id` | string | A value used by the messaging system as an identifier for the message, represented as a string. | `452a7c7c7c7048c2f887f61572b18fc2` |
-| `messaging.operation` | string | A string identifying the kind of messaging operation. [7] | `publish` |
-| `messaging.system` | string | An identifier for the messaging system being used. See below for a list of well-known identifiers. | `activemq` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.batch.message_count` | int | The number of messages sent, received, or processed in the scope of the batching operation. [1] | `0`; `1`; `2` |  |
+| `messaging.client_id` | string | A unique identifier for the client that consumes or produces a message. | `client-5`; `myhost@8742@s8083jm` |  |
+| `messaging.destination.anonymous` | boolean | A boolean that is true if the message destination is anonymous (could be unnamed or have auto-generated name). | |  |
+| `messaging.destination.name` | string | The message destination name [2] | `MyQueue`; `MyTopic` |  |
+| `messaging.destination.partition.id` | string | The identifier of the partition messages are sent to or received from, unique within the `messaging.destination.name`. | `1` |  |
+| `messaging.destination.template` | string | Low cardinality representation of the messaging destination name [3] | `/customers/{customerId}` |  |
+| `messaging.destination.temporary` | boolean | A boolean that is true if the message destination is temporary and might not exist anymore after messages are processed. | |  |
+| `messaging.destination_publish.anonymous` | boolean | A boolean that is true if the publish message destination is anonymous (could be unnamed or have auto-generated name). | |  |
+| `messaging.destination_publish.name` | string | The name of the original destination the message was published to [4] | `MyQueue`; `MyTopic` |  |
+| `messaging.message.body.size` | int | The size of the message body in bytes. [5] | `1439` |  |
+| `messaging.message.conversation_id` | string | The conversation ID identifying the conversation to which the message belongs, represented as a string. Sometimes called "Correlation ID". | `MyConversationId` |  |
+| `messaging.message.envelope.size` | int | The size of the message body and metadata in bytes. [6] | `2738` |  |
+| `messaging.message.id` | string | A value used by the messaging system as an identifier for the message, represented as a string. | `452a7c7c7c7048c2f887f61572b18fc2` |  |
+| `messaging.operation` | string | A string identifying the kind of messaging operation. [7] | `publish` |  |
+| `messaging.system` | string | An identifier for the messaging system being used. See below for a list of well-known identifiers. | `activemq` |  |
**[1]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
@@ -55,49 +55,49 @@ size should be used.
**[7]:** If a custom value is used, it MUST be of low cardinality.
-`messaging.operation` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `publish` | One or more messages are provided for publishing to an intermediary. If a single message is published, the context of the "Publish" span can be used as the creation context and no "Create" span needs to be created. |
-| `create` | A message is created. "Create" spans always refer to a single message and are used to provide a unique creation context for messages in batch publishing scenarios. |
-| `receive` | One or more messages are requested by a consumer. This operation refers to pull-based scenarios, where consumers explicitly call methods of messaging SDKs to receive messages. |
-| `process` | One or more messages are delivered to or processed by a consumer. |
-| `settle` | One or more messages are settled. |
-
-`messaging.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `activemq` | Apache ActiveMQ |
-| `aws_sqs` | Amazon Simple Queue Service (SQS) |
-| `eventgrid` | Azure Event Grid |
-| `eventhubs` | Azure Event Hubs |
-| `servicebus` | Azure Service Bus |
-| `gcp_pubsub` | Google Cloud Pub/Sub |
-| `jms` | Java Message Service |
-| `kafka` | Apache Kafka |
-| `rabbitmq` | RabbitMQ |
-| `rocketmq` | Apache RocketMQ |
+`messaging.operation` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `publish` | One or more messages are provided for publishing to an intermediary. If a single message is published, the context of the "Publish" span can be used as the creation context and no "Create" span needs to be created. |  |
+| `create` | A message is created. "Create" spans always refer to a single message and are used to provide a unique creation context for messages in batch publishing scenarios. |  |
+| `receive` | One or more messages are requested by a consumer. This operation refers to pull-based scenarios, where consumers explicitly call methods of messaging SDKs to receive messages. |  |
+| `process` | One or more messages are delivered to or processed by a consumer. |  |
+| `settle` | One or more messages are settled. |  |
+
+`messaging.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `activemq` | Apache ActiveMQ |  |
+| `aws_sqs` | Amazon Simple Queue Service (SQS) |  |
+| `eventgrid` | Azure Event Grid |  |
+| `eventhubs` | Azure Event Hubs |  |
+| `servicebus` | Azure Service Bus |  |
+| `gcp_pubsub` | Google Cloud Pub/Sub |  |
+| `jms` | Java Message Service |  |
+| `kafka` | Apache Kafka |  |
+| `rabbitmq` | RabbitMQ |  |
+| `rocketmq` | Apache RocketMQ |  |
## GCP Pub/Sub Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `messaging.gcp_pubsub.message.ordering_key` | string | The ordering key for a given message. If the attribute is not present, the message does not have an ordering key. | `ordering_key` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.gcp_pubsub.message.ordering_key` | string | The ordering key for a given message. If the attribute is not present, the message does not have an ordering key. | `ordering_key` |  |
## Kafka Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `messaging.kafka.consumer.group` | string | Name of the Kafka Consumer Group that is handling the message. Only applies to consumers, not producers. | `my-group` |
-| `messaging.kafka.message.key` | string | Message keys in Kafka are used for grouping alike messages to ensure they're processed on the same partition. They differ from `messaging.message.id` in that they're not unique. If the key is `null`, the attribute MUST NOT be set. [1] | `myKey` |
-| `messaging.kafka.message.offset` | int | The offset of a record in the corresponding Kafka partition. | `42` |
-| `messaging.kafka.message.tombstone` | boolean | A boolean that is true if the message is a tombstone. | |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.kafka.consumer.group` | string | Name of the Kafka Consumer Group that is handling the message. Only applies to consumers, not producers. | `my-group` |  |
+| `messaging.kafka.message.key` | string | Message keys in Kafka are used for grouping alike messages to ensure they're processed on the same partition. They differ from `messaging.message.id` in that they're not unique. If the key is `null`, the attribute MUST NOT be set. [1] | `myKey` |  |
+| `messaging.kafka.message.offset` | int | The offset of a record in the corresponding Kafka partition. | `42` |  |
+| `messaging.kafka.message.tombstone` | boolean | A boolean that is true if the message is a tombstone. | |  |
**[1]:** If the key type is not string, it's string representation has to be supplied for the attribute. If the key has no unambiguous, canonical string form, don't include its value.
@@ -105,77 +105,77 @@ size should be used.
## RabbitMQ Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `messaging.rabbitmq.destination.routing_key` | string | RabbitMQ message routing key. | `myKey` |
-| `messaging.rabbitmq.message.delivery_tag` | int | RabbitMQ message delivery tag | `123` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.rabbitmq.destination.routing_key` | string | RabbitMQ message routing key. | `myKey` |  |
+| `messaging.rabbitmq.message.delivery_tag` | int | RabbitMQ message delivery tag | `123` |  |
## RocketMQ Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `messaging.rocketmq.client_group` | string | Name of the RocketMQ producer/consumer group that is handling the message. The client type is identified by the SpanKind. | `myConsumerGroup` |
-| `messaging.rocketmq.consumption_model` | string | Model of message consumption. This only applies to consumer spans. | `clustering` |
-| `messaging.rocketmq.message.delay_time_level` | int | The delay time level for delay message, which determines the message delay time. | `3` |
-| `messaging.rocketmq.message.delivery_timestamp` | int | The timestamp in milliseconds that the delay message is expected to be delivered to consumer. | `1665987217045` |
-| `messaging.rocketmq.message.group` | string | It is essential for FIFO message. Messages that belong to the same message group are always processed one by one within the same consumer group. | `myMessageGroup` |
-| `messaging.rocketmq.message.keys` | string[] | Key(s) of message, another way to mark message besides message id. | `[keyA, keyB]` |
-| `messaging.rocketmq.message.tag` | string | The secondary classifier of message besides topic. | `tagA` |
-| `messaging.rocketmq.message.type` | string | Type of message. | `normal` |
-| `messaging.rocketmq.namespace` | string | Namespace of RocketMQ resources, resources in different namespaces are individual. | `myNamespace` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.rocketmq.client_group` | string | Name of the RocketMQ producer/consumer group that is handling the message. The client type is identified by the SpanKind. | `myConsumerGroup` |  |
+| `messaging.rocketmq.consumption_model` | string | Model of message consumption. This only applies to consumer spans. | `clustering` |  |
+| `messaging.rocketmq.message.delay_time_level` | int | The delay time level for delay message, which determines the message delay time. | `3` |  |
+| `messaging.rocketmq.message.delivery_timestamp` | int | The timestamp in milliseconds that the delay message is expected to be delivered to consumer. | `1665987217045` |  |
+| `messaging.rocketmq.message.group` | string | It is essential for FIFO message. Messages that belong to the same message group are always processed one by one within the same consumer group. | `myMessageGroup` |  |
+| `messaging.rocketmq.message.keys` | string[] | Key(s) of message, another way to mark message besides message id. | `[keyA, keyB]` |  |
+| `messaging.rocketmq.message.tag` | string | The secondary classifier of message besides topic. | `tagA` |  |
+| `messaging.rocketmq.message.type` | string | Type of message. | `normal` |  |
+| `messaging.rocketmq.namespace` | string | Namespace of RocketMQ resources, resources in different namespaces are individual. | `myNamespace` |  |
`messaging.rocketmq.consumption_model` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `clustering` | Clustering consumption model |
-| `broadcasting` | Broadcasting consumption model |
+| Value | Description | Stability |
+|---|---|---|
+| `clustering` | Clustering consumption model |  |
+| `broadcasting` | Broadcasting consumption model |  |
`messaging.rocketmq.message.type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `normal` | Normal message |
-| `fifo` | FIFO message |
-| `delay` | Delay message |
-| `transaction` | Transaction message |
+| Value | Description | Stability |
+|---|---|---|
+| `normal` | Normal message |  |
+| `fifo` | FIFO message |  |
+| `delay` | Delay message |  |
+| `transaction` | Transaction message |  |
## Azure Event Hubs Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `messaging.eventhubs.consumer.group` | string | The name of the consumer group the event consumer is associated with. | `indexer` |
-| `messaging.eventhubs.message.enqueued_time` | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.eventhubs.consumer.group` | string | The name of the consumer group the event consumer is associated with. | `indexer` |  |
+| `messaging.eventhubs.message.enqueued_time` | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` |  |
## Azure Service Bus Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `messaging.servicebus.destination.subscription_name` | string | The name of the subscription in the topic messages are received from. | `mySubscription` |
-| `messaging.servicebus.disposition_status` | string | Describes the [settlement type](https://learn.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock). | `complete` |
-| `messaging.servicebus.message.delivery_count` | int | Number of deliveries that have been attempted for this message. | `2` |
-| `messaging.servicebus.message.enqueued_time` | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` |
-
-`messaging.servicebus.disposition_status` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `complete` | Message is completed |
-| `abandon` | Message is abandoned |
-| `dead_letter` | Message is sent to dead letter queue |
-| `defer` | Message is deferred |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.servicebus.destination.subscription_name` | string | The name of the subscription in the topic messages are received from. | `mySubscription` |  |
+| `messaging.servicebus.disposition_status` | string | Describes the [settlement type](https://learn.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock). | `complete` |  |
+| `messaging.servicebus.message.delivery_count` | int | Number of deliveries that have been attempted for this message. | `2` |  |
+| `messaging.servicebus.message.enqueued_time` | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` |  |
+
+`messaging.servicebus.disposition_status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `complete` | Message is completed |  |
+| `abandon` | Message is abandoned |  |
+| `dead_letter` | Message is sent to dead letter queue |  |
+| `defer` | Message is deferred |  |
## Deprecated Messaging Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `messaging.kafka.destination.partition` | int | 
"Deprecated, use `messaging.destination.partition.id` instead." | `2` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `messaging.kafka.destination.partition` | int | "Deprecated, use `messaging.destination.partition.id` instead." | `2` | 
Replaced by `messaging.destination.partition.id`. |
\ No newline at end of file
diff --git a/docs/attributes-registry/network.md b/docs/attributes-registry/network.md
index b534c86f54..497a575c31 100644
--- a/docs/attributes-registry/network.md
+++ b/docs/attributes-registry/network.md
@@ -8,23 +8,23 @@ These attributes may be used for any network related operation.
## Network Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `network.carrier.icc` | string | The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network. | `DE` |
-| `network.carrier.mcc` | string | The mobile carrier country code. | `310` |
-| `network.carrier.mnc` | string | The mobile carrier network code. | `001` |
-| `network.carrier.name` | string | The name of the mobile carrier. | `sprint` |
-| `network.connection.subtype` | string | This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection. | `LTE` |
-| `network.connection.type` | string | The internet connection type. | `wifi` |
-| `network.io.direction` | string | The network IO operation direction. | `transmit` |
-| `network.local.address` | string | 
Local address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |
-| `network.local.port` | int | 
Local port number of the network connection. | `65123` |
-| `network.peer.address` | string | 
Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |
-| `network.peer.port` | int | 
Peer port number of the network connection. | `65123` |
-| `network.protocol.name` | string | 
[OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [1] | `amqp`; `http`; `mqtt` |
-| `network.protocol.version` | string | 
The actual version of the protocol used for network communication. [2] | `1.1`; `2` |
-| `network.transport` | string | 
[OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `udp` |
-| `network.type` | string | 
[OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [4] | `ipv4`; `ipv6` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `network.carrier.icc` | string | The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network. | `DE` |  |
+| `network.carrier.mcc` | string | The mobile carrier country code. | `310` |  |
+| `network.carrier.mnc` | string | The mobile carrier network code. | `001` |  |
+| `network.carrier.name` | string | The name of the mobile carrier. | `sprint` |  |
+| `network.connection.subtype` | string | This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection. | `LTE` |  |
+| `network.connection.type` | string | The internet connection type. | `wifi` |  |
+| `network.io.direction` | string | The network IO operation direction. | `transmit` |  |
+| `network.local.address` | string | Local address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |  |
+| `network.local.port` | int | Local port number of the network connection. | `65123` |  |
+| `network.peer.address` | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` |  |
+| `network.peer.port` | int | Peer port number of the network connection. | `65123` |  |
+| `network.protocol.name` | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [1] | `amqp`; `http`; `mqtt` |  |
+| `network.protocol.version` | string | The actual version of the protocol used for network communication. [2] | `1.1`; `2` |  |
+| `network.transport` | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `udp` |  |
+| `network.type` | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [4] | `ipv4`; `ipv6` |  |
**[1]:** The value SHOULD be normalized to lowercase.
@@ -38,102 +38,102 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
**[4]:** The value SHOULD be normalized to lowercase.
-`network.connection.subtype` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `gprs` | GPRS |
-| `edge` | EDGE |
-| `umts` | UMTS |
-| `cdma` | CDMA |
-| `evdo_0` | EVDO Rel. 0 |
-| `evdo_a` | EVDO Rev. A |
-| `cdma2000_1xrtt` | CDMA2000 1XRTT |
-| `hsdpa` | HSDPA |
-| `hsupa` | HSUPA |
-| `hspa` | HSPA |
-| `iden` | IDEN |
-| `evdo_b` | EVDO Rev. B |
-| `lte` | LTE |
-| `ehrpd` | EHRPD |
-| `hspap` | HSPAP |
-| `gsm` | GSM |
-| `td_scdma` | TD-SCDMA |
-| `iwlan` | IWLAN |
-| `nr` | 5G NR (New Radio) |
-| `nrnsa` | 5G NRNSA (New Radio Non-Standalone) |
-| `lte_ca` | LTE CA |
-
-`network.connection.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `wifi` | wifi |
-| `wired` | wired |
-| `cell` | cell |
-| `unavailable` | unavailable |
-| `unknown` | unknown |
+`network.connection.subtype` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `gprs` | GPRS |  |
+| `edge` | EDGE |  |
+| `umts` | UMTS |  |
+| `cdma` | CDMA |  |
+| `evdo_0` | EVDO Rel. 0 |  |
+| `evdo_a` | EVDO Rev. A |  |
+| `cdma2000_1xrtt` | CDMA2000 1XRTT |  |
+| `hsdpa` | HSDPA |  |
+| `hsupa` | HSUPA |  |
+| `hspa` | HSPA |  |
+| `iden` | IDEN |  |
+| `evdo_b` | EVDO Rev. B |  |
+| `lte` | LTE |  |
+| `ehrpd` | EHRPD |  |
+| `hspap` | HSPAP |  |
+| `gsm` | GSM |  |
+| `td_scdma` | TD-SCDMA |  |
+| `iwlan` | IWLAN |  |
+| `nr` | 5G NR (New Radio) |  |
+| `nrnsa` | 5G NRNSA (New Radio Non-Standalone) |  |
+| `lte_ca` | LTE CA |  |
+
+`network.connection.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `wifi` | wifi |  |
+| `wired` | wired |  |
+| `cell` | cell |  |
+| `unavailable` | unavailable |  |
+| `unknown` | unknown |  |
`network.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `transmit` | transmit |
-| `receive` | receive |
+| Value | Description | Stability |
+|---|---|---|
+| `transmit` | transmit |  |
+| `receive` | receive |  |
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
## Deprecated Network Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `net.host.name` | string | 
Deprecated, use `server.address`. | `example.com` |
-| `net.host.port` | int | 
Deprecated, use `server.port`. | `8080` |
-| `net.peer.name` | string | 
Deprecated, use `server.address` on client spans and `client.address` on server spans. | `example.com` |
-| `net.peer.port` | int | 
Deprecated, use `server.port` on client spans and `client.port` on server spans. | `8080` |
-| `net.protocol.name` | string | 
Deprecated, use `network.protocol.name`. | `amqp`; `http`; `mqtt` |
-| `net.protocol.version` | string | 
Deprecated, use `network.protocol.version`. | `3.1.1` |
-| `net.sock.family` | string | 
Deprecated, use `network.transport` and `network.type`. | `inet` |
-| `net.sock.host.addr` | string | 
Deprecated, use `network.local.address`. | `/var/my.sock` |
-| `net.sock.host.port` | int | 
Deprecated, use `network.local.port`. | `8080` |
-| `net.sock.peer.addr` | string | 
Deprecated, use `network.peer.address`. | `192.168.0.1` |
-| `net.sock.peer.name` | string | 
Deprecated, no replacement at this time. | `/var/my.sock` |
-| `net.sock.peer.port` | int | 
Deprecated, use `network.peer.port`. | `65531` |
-| `net.transport` | string | 
Deprecated, use `network.transport`. | `ip_tcp` |
-
-`net.sock.family` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `inet` | IPv4 address |
-| `inet6` | IPv6 address |
-| `unix` | Unix domain socket path |
-
-`net.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `ip_tcp` | ip_tcp |
-| `ip_udp` | ip_udp |
-| `pipe` | Named or anonymous pipe. |
-| `inproc` | In-process communication. [1] |
-| `other` | Something else (non IP-based). |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `net.host.name` | string | Deprecated, use `server.address`. | `example.com` | 
Replaced by `server.address`. |
+| `net.host.port` | int | Deprecated, use `server.port`. | `8080` | 
Replaced by `server.port`. |
+| `net.peer.name` | string | Deprecated, use `server.address` on client spans and `client.address` on server spans. | `example.com` | 
Replaced by `server.address` on client spans and `client.address` on server spans. |
+| `net.peer.port` | int | Deprecated, use `server.port` on client spans and `client.port` on server spans. | `8080` | 
Replaced by `server.port` on client spans and `client.port` on server spans. |
+| `net.protocol.name` | string | Deprecated, use `network.protocol.name`. | `amqp`; `http`; `mqtt` | 
Replaced by `network.protocol.name`. |
+| `net.protocol.version` | string | Deprecated, use `network.protocol.version`. | `3.1.1` | 
Replaced by `network.protocol.version`. |
+| `net.sock.family` | string | Deprecated, use `network.transport` and `network.type`. | `inet` | 
Split to `network.transport` and `network.type`. |
+| `net.sock.host.addr` | string | Deprecated, use `network.local.address`. | `/var/my.sock` | 
Replaced by `network.local.address`. |
+| `net.sock.host.port` | int | Deprecated, use `network.local.port`. | `8080` | 
Replaced by `network.local.port`. |
+| `net.sock.peer.addr` | string | Deprecated, use `network.peer.address`. | `192.168.0.1` | 
Replaced by `network.peer.address`. |
+| `net.sock.peer.name` | string | Deprecated, no replacement at this time. | `/var/my.sock` | 
Removed. |
+| `net.sock.peer.port` | int | Deprecated, use `network.peer.port`. | `65531` | 
Replaced by `network.peer.port`. |
+| `net.transport` | string | Deprecated, use `network.transport`. | `ip_tcp` | 
Replaced by `network.transport`. |
+
+`net.sock.family` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `inet` | IPv4 address |  |
+| `inet6` | IPv6 address |  |
+| `unix` | Unix domain socket path |  |
+
+`net.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `ip_tcp` | ip_tcp |  |
+| `ip_udp` | ip_udp |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `inproc` | In-process communication. [1] |  |
+| `other` | Something else (non IP-based). |  |
**[1]:** Signals that there is only in-process communication not using a "real" network protocol in cases where network attributes would normally be expected. Usually all other network attributes can be left out in that case.
diff --git a/docs/attributes-registry/oci.md b/docs/attributes-registry/oci.md
index abfc4f7479..839aa4da9e 100644
--- a/docs/attributes-registry/oci.md
+++ b/docs/attributes-registry/oci.md
@@ -5,9 +5,9 @@ The [Open Container Initiative](https://opencontainers.org/) defines open indust
## OCI Image Manifest
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `oci.manifest.digest` | string | The digest of the OCI image manifest. For container images specifically is the digest by which the container image is known. [1] | `sha256:e4ca62c0d62f3e886e684806dfe9d4e0cda60d54986898173c1083856cfda0f4` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `oci.manifest.digest` | string | The digest of the OCI image manifest. For container images specifically is the digest by which the container image is known. [1] | `sha256:e4ca62c0d62f3e886e684806dfe9d4e0cda60d54986898173c1083856cfda0f4` |  |
**[1]:** Follows [OCI Image Manifest Specification](https://github.com/opencontainers/image-spec/blob/main/manifest.md), and specifically the [Digest property](https://github.com/opencontainers/image-spec/blob/main/descriptor.md#digests).
An example can be found in [Example Image Manifest](https://docs.docker.com/registry/spec/manifest-v2-2/#example-image-manifest).
diff --git a/docs/attributes-registry/os.md b/docs/attributes-registry/os.md
index 1a9df99771..aff35e76e8 100644
--- a/docs/attributes-registry/os.md
+++ b/docs/attributes-registry/os.md
@@ -7,27 +7,27 @@ linkTitle: OS
## Operating System Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `os.build_id` | string | Unique identifier for a particular build or compilation of the operating system. | `TQ3C.230805.001.B2`; `20E247`; `22621` |
-| `os.description` | string | Human readable (not intended to be parsed) OS version information, like e.g. reported by `ver` or `lsb_release -a` commands. | `Microsoft Windows [Version 10.0.18363.778]`; `Ubuntu 18.04.1 LTS` |
-| `os.name` | string | Human readable operating system name. | `iOS`; `Android`; `Ubuntu` |
-| `os.type` | string | The operating system type. | `windows` |
-| `os.version` | string | The version string of the operating system as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `14.2.1`; `18.04.1` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `os.build_id` | string | Unique identifier for a particular build or compilation of the operating system. | `TQ3C.230805.001.B2`; `20E247`; `22621` |  |
+| `os.description` | string | Human readable (not intended to be parsed) OS version information, like e.g. reported by `ver` or `lsb_release -a` commands. | `Microsoft Windows [Version 10.0.18363.778]`; `Ubuntu 18.04.1 LTS` |  |
+| `os.name` | string | Human readable operating system name. | `iOS`; `Android`; `Ubuntu` |  |
+| `os.type` | string | The operating system type. | `windows` |  |
+| `os.version` | string | The version string of the operating system as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `14.2.1`; `18.04.1` |  |
-`os.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`os.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `windows` | Microsoft Windows |
-| `linux` | Linux |
-| `darwin` | Apple Darwin |
-| `freebsd` | FreeBSD |
-| `netbsd` | NetBSD |
-| `openbsd` | OpenBSD |
-| `dragonflybsd` | DragonFly BSD |
-| `hpux` | HP-UX (Hewlett Packard Unix) |
-| `aix` | AIX (Advanced Interactive eXecutive) |
-| `solaris` | SunOS, Oracle Solaris |
-| `z_os` | IBM z/OS |
+| Value | Description | Stability |
+|---|---|---|
+| `windows` | Microsoft Windows |  |
+| `linux` | Linux |  |
+| `darwin` | Apple Darwin |  |
+| `freebsd` | FreeBSD |  |
+| `netbsd` | NetBSD |  |
+| `openbsd` | OpenBSD |  |
+| `dragonflybsd` | DragonFly BSD |  |
+| `hpux` | HP-UX (Hewlett Packard Unix) |  |
+| `aix` | AIX (Advanced Interactive eXecutive) |  |
+| `solaris` | SunOS, Oracle Solaris |  |
+| `z_os` | IBM z/OS |  |
\ No newline at end of file
diff --git a/docs/attributes-registry/process.md b/docs/attributes-registry/process.md
index 3405cb03c1..280cb7e851 100644
--- a/docs/attributes-registry/process.md
+++ b/docs/attributes-registry/process.md
@@ -6,17 +6,17 @@
## Process Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `process.command` | string | The command used to launch the process (i.e. the command name). On Linux based systems, can be set to the zeroth string in `proc/[pid]/cmdline`. On Windows, can be set to the first parameter extracted from `GetCommandLineW`. | `cmd/otelcol` |
-| `process.command_args` | string[] | All the command arguments (including the command/executable itself) as received by the process. On Linux-based systems (and some other Unixoid systems supporting procfs), can be set according to the list of null-delimited strings extracted from `proc/[pid]/cmdline`. For libc-based executables, this would be the full argv vector passed to `main`. | `[cmd/otecol, --config=config.yaml]` |
-| `process.command_line` | string | The full command used to launch the process as a single string representing the full command. On Windows, can be set to the result of `GetCommandLineW`. Do not set this if you have to assemble it just for monitoring; use `process.command_args` instead. | `C:\cmd\otecol --config="my directory\config.yaml"` |
-| `process.executable.name` | string | The name of the process executable. On Linux based systems, can be set to the `Name` in `proc/[pid]/status`. On Windows, can be set to the base name of `GetProcessImageFileNameW`. | `otelcol` |
-| `process.executable.path` | string | The full path to the process executable. On Linux based systems, can be set to the target of `proc/[pid]/exe`. On Windows, can be set to the result of `GetProcessImageFileNameW`. | `/usr/bin/cmd/otelcol` |
-| `process.owner` | string | The username of the user that owns the process. | `root` |
-| `process.parent_pid` | int | Parent Process identifier (PPID). | `111` |
-| `process.pid` | int | Process identifier (PID). | `1234` |
-| `process.runtime.description` | string | An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment. | `Eclipse OpenJ9 Eclipse OpenJ9 VM openj9-0.21.0` |
-| `process.runtime.name` | string | The name of the runtime of this process. For compiled native binaries, this SHOULD be the name of the compiler. | `OpenJDK Runtime Environment` |
-| `process.runtime.version` | string | The version of the runtime of this process, as returned by the runtime without modification. | `14.0.2` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `process.command` | string | The command used to launch the process (i.e. the command name). On Linux based systems, can be set to the zeroth string in `proc/[pid]/cmdline`. On Windows, can be set to the first parameter extracted from `GetCommandLineW`. | `cmd/otelcol` |  |
+| `process.command_args` | string[] | All the command arguments (including the command/executable itself) as received by the process. On Linux-based systems (and some other Unixoid systems supporting procfs), can be set according to the list of null-delimited strings extracted from `proc/[pid]/cmdline`. For libc-based executables, this would be the full argv vector passed to `main`. | `[cmd/otecol, --config=config.yaml]` |  |
+| `process.command_line` | string | The full command used to launch the process as a single string representing the full command. On Windows, can be set to the result of `GetCommandLineW`. Do not set this if you have to assemble it just for monitoring; use `process.command_args` instead. | `C:\cmd\otecol --config="my directory\config.yaml"` |  |
+| `process.executable.name` | string | The name of the process executable. On Linux based systems, can be set to the `Name` in `proc/[pid]/status`. On Windows, can be set to the base name of `GetProcessImageFileNameW`. | `otelcol` |  |
+| `process.executable.path` | string | The full path to the process executable. On Linux based systems, can be set to the target of `proc/[pid]/exe`. On Windows, can be set to the result of `GetProcessImageFileNameW`. | `/usr/bin/cmd/otelcol` |  |
+| `process.owner` | string | The username of the user that owns the process. | `root` |  |
+| `process.parent_pid` | int | Parent Process identifier (PPID). | `111` |  |
+| `process.pid` | int | Process identifier (PID). | `1234` |  |
+| `process.runtime.description` | string | An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment. | `Eclipse OpenJ9 Eclipse OpenJ9 VM openj9-0.21.0` |  |
+| `process.runtime.name` | string | The name of the runtime of this process. For compiled native binaries, this SHOULD be the name of the compiler. | `OpenJDK Runtime Environment` |  |
+| `process.runtime.version` | string | The version of the runtime of this process, as returned by the runtime without modification. | `14.0.2` |  |
diff --git a/docs/attributes-registry/rpc.md b/docs/attributes-registry/rpc.md
index fd112b1d2b..0c904e3f48 100644
--- a/docs/attributes-registry/rpc.md
+++ b/docs/attributes-registry/rpc.md
@@ -8,21 +8,21 @@
RPC attributes are intended to be used in the context of events related to remote procedure calls (RPC).
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `rpc.connect_rpc.error_code` | string | The [error codes](https://connect.build/docs/protocol/#error-codes) of the Connect request. Error codes are always string values. | `cancelled` |
-| `rpc.connect_rpc.request.metadata.` | string[] | Connect request metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [1] | `rpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` |
-| `rpc.connect_rpc.response.metadata.` | string[] | Connect response metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [2] | `rpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` |
-| `rpc.grpc.request.metadata.` | string[] | gRPC request metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [3] | `rpc.grpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` |
-| `rpc.grpc.response.metadata.` | string[] | gRPC response metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [4] | `rpc.grpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` |
-| `rpc.grpc.status_code` | int | The [numeric status code](https://github.com/grpc/grpc/blob/v1.33.2/doc/statuscodes.md) of the gRPC request. | `0` |
-| `rpc.jsonrpc.error_code` | int | `error.code` property of response if it is an error response. | `-32700`; `100` |
-| `rpc.jsonrpc.error_message` | string | `error.message` property of response if it is an error response. | `Parse error`; `User already exists` |
-| `rpc.jsonrpc.request_id` | string | `id` property of request or response. Since protocol allows id to be int, string, `null` or missing (for notifications), value is expected to be cast to string for simplicity. Use empty string in case of `null` value. Omit entirely if this is a notification. | `10`; `request-7`; `` |
-| `rpc.jsonrpc.version` | string | Protocol version as in `jsonrpc` property of request/response. Since JSON-RPC 1.0 doesn't specify this, the value can be omitted. | `2.0`; `1.0` |
-| `rpc.method` | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [5] | `exampleMethod` |
-| `rpc.service` | string | The full (logical) name of the service being called, including its package name, if applicable. [6] | `myservice.EchoService` |
-| `rpc.system` | string | A string identifying the remoting system. See below for a list of well-known identifiers. | `grpc` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `rpc.connect_rpc.error_code` | string | The [error codes](https://connect.build/docs/protocol/#error-codes) of the Connect request. Error codes are always string values. | `cancelled` |  |
+| `rpc.connect_rpc.request.metadata.` | string[] | Connect request metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [1] | `rpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` |  |
+| `rpc.connect_rpc.response.metadata.` | string[] | Connect response metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [2] | `rpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` |  |
+| `rpc.grpc.request.metadata.` | string[] | gRPC request metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [3] | `rpc.grpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` |  |
+| `rpc.grpc.response.metadata.` | string[] | gRPC response metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [4] | `rpc.grpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` |  |
+| `rpc.grpc.status_code` | int | The [numeric status code](https://github.com/grpc/grpc/blob/v1.33.2/doc/statuscodes.md) of the gRPC request. | `0` |  |
+| `rpc.jsonrpc.error_code` | int | `error.code` property of response if it is an error response. | `-32700`; `100` |  |
+| `rpc.jsonrpc.error_message` | string | `error.message` property of response if it is an error response. | `Parse error`; `User already exists` |  |
+| `rpc.jsonrpc.request_id` | string | `id` property of request or response. Since protocol allows id to be int, string, `null` or missing (for notifications), value is expected to be cast to string for simplicity. Use empty string in case of `null` value. Omit entirely if this is a notification. | `10`; `request-7`; `` |  |
+| `rpc.jsonrpc.version` | string | Protocol version as in `jsonrpc` property of request/response. Since JSON-RPC 1.0 doesn't specify this, the value can be omitted. | `2.0`; `1.0` |  |
+| `rpc.method` | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [5] | `exampleMethod` |  |
+| `rpc.service` | string | The full (logical) name of the service being called, including its package name, if applicable. [6] | `myservice.EchoService` |  |
+| `rpc.system` | string | A string identifying the remoting system. See below for a list of well-known identifiers. | `grpc` |  |
**[1]:** Instrumentations SHOULD require an explicit configuration of which metadata values are to be captured. Including all request metadata values can be a security risk - explicit configuration helps avoid leaking sensitive information.
@@ -38,54 +38,54 @@ RPC attributes are intended to be used in the context of events related to remot
`rpc.connect_rpc.error_code` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `cancelled` | cancelled |
-| `unknown` | unknown |
-| `invalid_argument` | invalid_argument |
-| `deadline_exceeded` | deadline_exceeded |
-| `not_found` | not_found |
-| `already_exists` | already_exists |
-| `permission_denied` | permission_denied |
-| `resource_exhausted` | resource_exhausted |
-| `failed_precondition` | failed_precondition |
-| `aborted` | aborted |
-| `out_of_range` | out_of_range |
-| `unimplemented` | unimplemented |
-| `internal` | internal |
-| `unavailable` | unavailable |
-| `data_loss` | data_loss |
-| `unauthenticated` | unauthenticated |
+| Value | Description | Stability |
+|---|---|---|
+| `cancelled` | cancelled |  |
+| `unknown` | unknown |  |
+| `invalid_argument` | invalid_argument |  |
+| `deadline_exceeded` | deadline_exceeded |  |
+| `not_found` | not_found |  |
+| `already_exists` | already_exists |  |
+| `permission_denied` | permission_denied |  |
+| `resource_exhausted` | resource_exhausted |  |
+| `failed_precondition` | failed_precondition |  |
+| `aborted` | aborted |  |
+| `out_of_range` | out_of_range |  |
+| `unimplemented` | unimplemented |  |
+| `internal` | internal |  |
+| `unavailable` | unavailable |  |
+| `data_loss` | data_loss |  |
+| `unauthenticated` | unauthenticated |  |
`rpc.grpc.status_code` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `0` | OK |
-| `1` | CANCELLED |
-| `2` | UNKNOWN |
-| `3` | INVALID_ARGUMENT |
-| `4` | DEADLINE_EXCEEDED |
-| `5` | NOT_FOUND |
-| `6` | ALREADY_EXISTS |
-| `7` | PERMISSION_DENIED |
-| `8` | RESOURCE_EXHAUSTED |
-| `9` | FAILED_PRECONDITION |
-| `10` | ABORTED |
-| `11` | OUT_OF_RANGE |
-| `12` | UNIMPLEMENTED |
-| `13` | INTERNAL |
-| `14` | UNAVAILABLE |
-| `15` | DATA_LOSS |
-| `16` | UNAUTHENTICATED |
-
-`rpc.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `grpc` | gRPC |
-| `java_rmi` | Java RMI |
-| `dotnet_wcf` | .NET WCF |
-| `apache_dubbo` | Apache Dubbo |
-| `connect_rpc` | Connect RPC |
+| Value | Description | Stability |
+|---|---|---|
+| `0` | OK |  |
+| `1` | CANCELLED |  |
+| `2` | UNKNOWN |  |
+| `3` | INVALID_ARGUMENT |  |
+| `4` | DEADLINE_EXCEEDED |  |
+| `5` | NOT_FOUND |  |
+| `6` | ALREADY_EXISTS |  |
+| `7` | PERMISSION_DENIED |  |
+| `8` | RESOURCE_EXHAUSTED |  |
+| `9` | FAILED_PRECONDITION |  |
+| `10` | ABORTED |  |
+| `11` | OUT_OF_RANGE |  |
+| `12` | UNIMPLEMENTED |  |
+| `13` | INTERNAL |  |
+| `14` | UNAVAILABLE |  |
+| `15` | DATA_LOSS |  |
+| `16` | UNAUTHENTICATED |  |
+
+`rpc.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `grpc` | gRPC |  |
+| `java_rmi` | Java RMI |  |
+| `dotnet_wcf` | .NET WCF |  |
+| `apache_dubbo` | Apache Dubbo |  |
+| `connect_rpc` | Connect RPC |  |
diff --git a/docs/attributes-registry/server.md b/docs/attributes-registry/server.md
index a1189591a1..a55453f54a 100644
--- a/docs/attributes-registry/server.md
+++ b/docs/attributes-registry/server.md
@@ -12,10 +12,10 @@ protocol / API does not expose a clear notion of client and server).
This also covers UDP network interactions where one side initiates the interaction, e.g. QUIC (HTTP/3) and DNS.
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `server.address` | string | 
Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `example.com`; `10.1.2.80`; `/tmp/my.sock` |
-| `server.port` | int | 
Server port number. [2] | `80`; `8080`; `443` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `server.address` | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `example.com`; `10.1.2.80`; `/tmp/my.sock` |  |
+| `server.port` | int | Server port number. [2] | `80`; `8080`; `443` |  |
**[1]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
diff --git a/docs/attributes-registry/source.md b/docs/attributes-registry/source.md
index c239896bf1..b4d4af5da1 100644
--- a/docs/attributes-registry/source.md
+++ b/docs/attributes-registry/source.md
@@ -12,10 +12,10 @@ This also covers unidirectional UDP flows and peer-to-peer communication where t
"user-facing" surface of the protocol / API does not expose a clear notion of client and server.
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `source.address` | string | Source address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `source.example.com`; `10.1.2.80`; `/tmp/my.sock` |
-| `source.port` | int | Source port number | `3389`; `2888` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `source.address` | string | Source address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `source.example.com`; `10.1.2.80`; `/tmp/my.sock` |  |
+| `source.port` | int | Source port number | `3389`; `2888` |  |
**[1]:** When observed from the destination side, and when communicating through an intermediary, `source.address` SHOULD represent the source address behind any intermediaries, for example proxies, if it's available.
\ No newline at end of file
diff --git a/docs/attributes-registry/thread.md b/docs/attributes-registry/thread.md
index 5a71c29cc8..4e503b99c2 100644
--- a/docs/attributes-registry/thread.md
+++ b/docs/attributes-registry/thread.md
@@ -8,8 +8,8 @@ These attributes may be used for any operation to store information about a thre
## Thread Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `thread.id` | int | Current "managed" thread ID (as opposed to OS thread ID). | `42` |
-| `thread.name` | string | Current thread name. | `main` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `thread.id` | int | Current "managed" thread ID (as opposed to OS thread ID). | `42` |  |
+| `thread.name` | string | Current thread name. | `main` |  |
\ No newline at end of file
diff --git a/docs/attributes-registry/tls.md b/docs/attributes-registry/tls.md
index f774c31a26..081192af6b 100644
--- a/docs/attributes-registry/tls.md
+++ b/docs/attributes-registry/tls.md
@@ -6,44 +6,44 @@
## TLS Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `tls.cipher` | string | String indicating the [cipher](https://datatracker.ietf.org/doc/html/rfc5246#appendix-A.5) used during the current connection. [1] | `TLS_RSA_WITH_3DES_EDE_CBC_SHA`; `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256` |
-| `tls.client.certificate` | string | PEM-encoded stand-alone certificate offered by the client. This is usually mutually-exclusive of `client.certificate_chain` since this value also exists in that list. | `MII...` |
-| `tls.client.certificate_chain` | string[] | Array of PEM-encoded certificates that make up the certificate chain offered by the client. This is usually mutually-exclusive of `client.certificate` since that value should be the first certificate in the chain. | `[MII..., MI...]` |
-| `tls.client.hash.md5` | string | Certificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0F76C7F2C55BFD7D8E8B8F4BFBF0C9EC` |
-| `tls.client.hash.sha1` | string | Certificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `9E393D93138888D288266C2D915214D1D1CCEB2A` |
-| `tls.client.hash.sha256` | string | Certificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0687F666A054EF17A08E2F2162EAB4CBC0D265E1D7875BE74BF3C712CA92DAF0` |
-| `tls.client.issuer` | string | Distinguished name of [subject](https://datatracker.ietf.org/doc/html/rfc5280#section-4.1.2.6) of the issuer of the x.509 certificate presented by the client. | `CN=Example Root CA, OU=Infrastructure Team, DC=example, DC=com` |
-| `tls.client.ja3` | string | A hash that identifies clients based on how they perform an SSL/TLS handshake. | `d4e5b18d6b55c71272893221c96ba240` |
-| `tls.client.not_after` | string | Date/Time indicating when client certificate is no longer considered valid. | `2021-01-01T00:00:00.000Z` |
-| `tls.client.not_before` | string | Date/Time indicating when client certificate is first considered valid. | `1970-01-01T00:00:00.000Z` |
-| `tls.client.server_name` | string | Also called an SNI, this tells the server which hostname to which the client is attempting to connect to. | `opentelemetry.io` |
-| `tls.client.subject` | string | Distinguished name of subject of the x.509 certificate presented by the client. | `CN=myclient, OU=Documentation Team, DC=example, DC=com` |
-| `tls.client.supported_ciphers` | string[] | Array of ciphers offered by the client during the client hello. | `["TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384", "..."]` |
-| `tls.curve` | string | String indicating the curve used for the given cipher, when applicable | `secp256r1` |
-| `tls.established` | boolean | Boolean flag indicating if the TLS negotiation was successful and transitioned to an encrypted tunnel. | `True` |
-| `tls.next_protocol` | string | String indicating the protocol being tunneled. Per the values in the [IANA registry](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids), this string should be lower case. | `http/1.1` |
-| `tls.protocol.name` | string | Normalized lowercase protocol name parsed from original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `ssl` |
-| `tls.protocol.version` | string | Numeric part of the version parsed from the original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `1.2`; `3` |
-| `tls.resumed` | boolean | Boolean flag indicating if this TLS connection was resumed from an existing TLS negotiation. | `True` |
-| `tls.server.certificate` | string | PEM-encoded stand-alone certificate offered by the server. This is usually mutually-exclusive of `server.certificate_chain` since this value also exists in that list. | `MII...` |
-| `tls.server.certificate_chain` | string[] | Array of PEM-encoded certificates that make up the certificate chain offered by the server. This is usually mutually-exclusive of `server.certificate` since that value should be the first certificate in the chain. | `[MII..., MI...]` |
-| `tls.server.hash.md5` | string | Certificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0F76C7F2C55BFD7D8E8B8F4BFBF0C9EC` |
-| `tls.server.hash.sha1` | string | Certificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `9E393D93138888D288266C2D915214D1D1CCEB2A` |
-| `tls.server.hash.sha256` | string | Certificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0687F666A054EF17A08E2F2162EAB4CBC0D265E1D7875BE74BF3C712CA92DAF0` |
-| `tls.server.issuer` | string | Distinguished name of [subject](https://datatracker.ietf.org/doc/html/rfc5280#section-4.1.2.6) of the issuer of the x.509 certificate presented by the client. | `CN=Example Root CA, OU=Infrastructure Team, DC=example, DC=com` |
-| `tls.server.ja3s` | string | A hash that identifies servers based on how they perform an SSL/TLS handshake. | `d4e5b18d6b55c71272893221c96ba240` |
-| `tls.server.not_after` | string | Date/Time indicating when server certificate is no longer considered valid. | `2021-01-01T00:00:00.000Z` |
-| `tls.server.not_before` | string | Date/Time indicating when server certificate is first considered valid. | `1970-01-01T00:00:00.000Z` |
-| `tls.server.subject` | string | Distinguished name of subject of the x.509 certificate presented by the server. | `CN=myserver, OU=Documentation Team, DC=example, DC=com` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `tls.cipher` | string | String indicating the [cipher](https://datatracker.ietf.org/doc/html/rfc5246#appendix-A.5) used during the current connection. [1] | `TLS_RSA_WITH_3DES_EDE_CBC_SHA`; `TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256` |  |
+| `tls.client.certificate` | string | PEM-encoded stand-alone certificate offered by the client. This is usually mutually-exclusive of `client.certificate_chain` since this value also exists in that list. | `MII...` |  |
+| `tls.client.certificate_chain` | string[] | Array of PEM-encoded certificates that make up the certificate chain offered by the client. This is usually mutually-exclusive of `client.certificate` since that value should be the first certificate in the chain. | `[MII..., MI...]` |  |
+| `tls.client.hash.md5` | string | Certificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0F76C7F2C55BFD7D8E8B8F4BFBF0C9EC` |  |
+| `tls.client.hash.sha1` | string | Certificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `9E393D93138888D288266C2D915214D1D1CCEB2A` |  |
+| `tls.client.hash.sha256` | string | Certificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the client. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0687F666A054EF17A08E2F2162EAB4CBC0D265E1D7875BE74BF3C712CA92DAF0` |  |
+| `tls.client.issuer` | string | Distinguished name of [subject](https://datatracker.ietf.org/doc/html/rfc5280#section-4.1.2.6) of the issuer of the x.509 certificate presented by the client. | `CN=Example Root CA, OU=Infrastructure Team, DC=example, DC=com` |  |
+| `tls.client.ja3` | string | A hash that identifies clients based on how they perform an SSL/TLS handshake. | `d4e5b18d6b55c71272893221c96ba240` |  |
+| `tls.client.not_after` | string | Date/Time indicating when client certificate is no longer considered valid. | `2021-01-01T00:00:00.000Z` |  |
+| `tls.client.not_before` | string | Date/Time indicating when client certificate is first considered valid. | `1970-01-01T00:00:00.000Z` |  |
+| `tls.client.server_name` | string | Also called an SNI, this tells the server which hostname to which the client is attempting to connect to. | `opentelemetry.io` |  |
+| `tls.client.subject` | string | Distinguished name of subject of the x.509 certificate presented by the client. | `CN=myclient, OU=Documentation Team, DC=example, DC=com` |  |
+| `tls.client.supported_ciphers` | string[] | Array of ciphers offered by the client during the client hello. | `["TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384", "TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384", "..."]` |  |
+| `tls.curve` | string | String indicating the curve used for the given cipher, when applicable | `secp256r1` |  |
+| `tls.established` | boolean | Boolean flag indicating if the TLS negotiation was successful and transitioned to an encrypted tunnel. | `True` |  |
+| `tls.next_protocol` | string | String indicating the protocol being tunneled. Per the values in the [IANA registry](https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids), this string should be lower case. | `http/1.1` |  |
+| `tls.protocol.name` | string | Normalized lowercase protocol name parsed from original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `ssl` |  |
+| `tls.protocol.version` | string | Numeric part of the version parsed from the original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `1.2`; `3` |  |
+| `tls.resumed` | boolean | Boolean flag indicating if this TLS connection was resumed from an existing TLS negotiation. | `True` |  |
+| `tls.server.certificate` | string | PEM-encoded stand-alone certificate offered by the server. This is usually mutually-exclusive of `server.certificate_chain` since this value also exists in that list. | `MII...` |  |
+| `tls.server.certificate_chain` | string[] | Array of PEM-encoded certificates that make up the certificate chain offered by the server. This is usually mutually-exclusive of `server.certificate` since that value should be the first certificate in the chain. | `[MII..., MI...]` |  |
+| `tls.server.hash.md5` | string | Certificate fingerprint using the MD5 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0F76C7F2C55BFD7D8E8B8F4BFBF0C9EC` |  |
+| `tls.server.hash.sha1` | string | Certificate fingerprint using the SHA1 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `9E393D93138888D288266C2D915214D1D1CCEB2A` |  |
+| `tls.server.hash.sha256` | string | Certificate fingerprint using the SHA256 digest of DER-encoded version of certificate offered by the server. For consistency with other hash values, this value should be formatted as an uppercase hash. | `0687F666A054EF17A08E2F2162EAB4CBC0D265E1D7875BE74BF3C712CA92DAF0` |  |
+| `tls.server.issuer` | string | Distinguished name of [subject](https://datatracker.ietf.org/doc/html/rfc5280#section-4.1.2.6) of the issuer of the x.509 certificate presented by the client. | `CN=Example Root CA, OU=Infrastructure Team, DC=example, DC=com` |  |
+| `tls.server.ja3s` | string | A hash that identifies servers based on how they perform an SSL/TLS handshake. | `d4e5b18d6b55c71272893221c96ba240` |  |
+| `tls.server.not_after` | string | Date/Time indicating when server certificate is no longer considered valid. | `2021-01-01T00:00:00.000Z` |  |
+| `tls.server.not_before` | string | Date/Time indicating when server certificate is first considered valid. | `1970-01-01T00:00:00.000Z` |  |
+| `tls.server.subject` | string | Distinguished name of subject of the x.509 certificate presented by the server. | `CN=myserver, OU=Documentation Team, DC=example, DC=com` |  |
**[1]:** The values allowed for `tls.cipher` MUST be one of the `Descriptions` of the [registered TLS Cipher Suits](https://www.iana.org/assignments/tls-parameters/tls-parameters.xhtml#table-tls-parameters-4).
-`tls.protocol.name` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`tls.protocol.name` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ssl` | ssl |
-| `tls` | tls |
+| Value | Description | Stability |
+|---|---|---|
+| `ssl` | ssl |  |
+| `tls` | tls |  |
\ No newline at end of file
diff --git a/docs/attributes-registry/url.md b/docs/attributes-registry/url.md
index 630c8fc639..69ca3fb8f3 100644
--- a/docs/attributes-registry/url.md
+++ b/docs/attributes-registry/url.md
@@ -7,20 +7,20 @@ linkTitle: URL
## URL Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `url.domain` | string | Domain extracted from the `url.full`, such as "opentelemetry.io". [1] | `www.foo.bar`; `opentelemetry.io`; `3.12.167.2`; `[1080:0:0:0:8:800:200C:417A]` |
-| `url.extension` | string | The file extension extracted from the `url.full`, excluding the leading dot. [2] | `png`; `gz` |
-| `url.fragment` | string | 
The [URI fragment](https://www.rfc-editor.org/rfc/rfc3986#section-3.5) component | `SemConv` |
-| `url.full` | string | 
Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986) [3] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `//localhost` |
-| `url.original` | string | Unmodified original URL as seen in the event source. [4] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `search?q=OpenTelemetry` |
-| `url.path` | string | 
The [URI path](https://www.rfc-editor.org/rfc/rfc3986#section-3.3) component [5] | `/search` |
-| `url.port` | int | Port extracted from the `url.full` | `443` |
-| `url.query` | string | 
The [URI query](https://www.rfc-editor.org/rfc/rfc3986#section-3.4) component [6] | `q=OpenTelemetry` |
-| `url.registered_domain` | string | The highest registered url domain, stripped of the subdomain. [7] | `example.com`; `foo.co.uk` |
-| `url.scheme` | string | 
The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `https`; `ftp`; `telnet` |
-| `url.subdomain` | string | The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. [8] | `east`; `sub2.sub1` |
-| `url.top_level_domain` | string | The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is `com`. [9] | `com`; `co.uk` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `url.domain` | string | Domain extracted from the `url.full`, such as "opentelemetry.io". [1] | `www.foo.bar`; `opentelemetry.io`; `3.12.167.2`; `[1080:0:0:0:8:800:200C:417A]` |  |
+| `url.extension` | string | The file extension extracted from the `url.full`, excluding the leading dot. [2] | `png`; `gz` |  |
+| `url.fragment` | string | The [URI fragment](https://www.rfc-editor.org/rfc/rfc3986#section-3.5) component | `SemConv` |  |
+| `url.full` | string | Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986) [3] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `//localhost` |  |
+| `url.original` | string | Unmodified original URL as seen in the event source. [4] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `search?q=OpenTelemetry` |  |
+| `url.path` | string | The [URI path](https://www.rfc-editor.org/rfc/rfc3986#section-3.3) component [5] | `/search` |  |
+| `url.port` | int | Port extracted from the `url.full` | `443` |  |
+| `url.query` | string | The [URI query](https://www.rfc-editor.org/rfc/rfc3986#section-3.4) component [6] | `q=OpenTelemetry` |  |
+| `url.registered_domain` | string | The highest registered url domain, stripped of the subdomain. [7] | `example.com`; `foo.co.uk` |  |
+| `url.scheme` | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `https`; `ftp`; `telnet` |  |
+| `url.subdomain` | string | The subdomain portion of a fully qualified domain name includes all of the names except the host name under the registered_domain. In a partially qualified domain, or if the qualification level of the full name cannot be determined, subdomain contains all of the names below the registered domain. [8] | `east`; `sub2.sub1` |  |
+| `url.top_level_domain` | string | The effective top level domain (eTLD), also known as the domain suffix, is the last part of the domain name. For example, the top level domain for example.com is `com`. [9] | `com`; `co.uk` |  |
**[1]:** In some cases a URL may refer to an IP and/or port directly, without a domain name. In this case, the IP address would go to the domain field. If the URL contains a [literal IPv6 address](https://www.rfc-editor.org/rfc/rfc2732#section-2) enclosed by `[` and `]`, the `[` and `]` characters should also be captured in the domain field.
diff --git a/docs/attributes-registry/user-agent.md b/docs/attributes-registry/user-agent.md
index 3baeaaf931..cc0cd35a0c 100644
--- a/docs/attributes-registry/user-agent.md
+++ b/docs/attributes-registry/user-agent.md
@@ -6,11 +6,11 @@
## User agent Attributes
-| Attribute | Type | Description | Examples |
-|---|---|---|---|
-| `user_agent.name` | string | Name of the user-agent extracted from original. Usually refers to the browser's name. [1] | `Safari`; `YourApp` |
-| `user_agent.original` | string | 
Value of the [HTTP User-Agent](https://www.rfc-editor.org/rfc/rfc9110.html#field.user-agent) header sent by the client. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1`; `YourApp/1.0.0 grpc-java-okhttp/1.27.2` |
-| `user_agent.version` | string | Version of the user-agent extracted from original. Usually refers to the browser's version [2] | `14.1.2`; `1.0.0` |
+| Attribute | Type | Description | Examples | Stability |
+|---|---|---|---|---|
+| `user_agent.name` | string | Name of the user-agent extracted from original. Usually refers to the browser's name. [1] | `Safari`; `YourApp` |  |
+| `user_agent.original` | string | Value of the [HTTP User-Agent](https://www.rfc-editor.org/rfc/rfc9110.html#field.user-agent) header sent by the client. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1`; `YourApp/1.0.0 grpc-java-okhttp/1.27.2` |  |
+| `user_agent.version` | string | Version of the user-agent extracted from original. Usually refers to the browser's version [2] | `14.1.2`; `1.0.0` |  |
**[1]:** [Example](https://www.whatsmyua.info) of extracting browser's name from original string. In the case of using a user-agent for non-browser products, such as microservices with multiple names/versions inside the `user_agent.original`, the most significant name SHOULD be selected. In such a scenario it should align with `user_agent.version`
diff --git a/docs/cloud-providers/aws-sdk.md b/docs/cloud-providers/aws-sdk.md
index 9eb2077746..a23c543d33 100644
--- a/docs/cloud-providers/aws-sdk.md
+++ b/docs/cloud-providers/aws-sdk.md
@@ -25,12 +25,12 @@ with the naming guidelines for RPC client spans.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.request_id` | string | The AWS request ID as returned in the response headers `x-amz-request-id` or `x-amz-requestid`. | `79b9da39-b7ae-508a-a6bc-864b2829c622`; `C9ER4AJX75574TDJ` | Recommended |
-| [`rpc.method`](../attributes-registry/rpc.md) | string | The name of the operation corresponding to the request, as returned by the AWS SDK [1] | `GetItem`; `PutItem` | Recommended |
-| [`rpc.service`](../attributes-registry/rpc.md) | string | The name of the service to which a request is made, as returned by the AWS SDK. [2] | `DynamoDB`; `S3` | Recommended |
-| [`rpc.system`](../attributes-registry/rpc.md) | string | The value `aws-api`. | `aws-api` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`rpc.system`](../attributes-registry/rpc.md) | string | The value `aws-api`. | `aws-api` | `Required` |  |
+| `aws.request_id` | string | The AWS request ID as returned in the response headers `x-amz-request-id` or `x-amz-requestid`. | `79b9da39-b7ae-508a-a6bc-864b2829c622`; `C9ER4AJX75574TDJ` | `Recommended` |  |
+| [`rpc.method`](../attributes-registry/rpc.md) | string | The name of the operation corresponding to the request, as returned by the AWS SDK [1] | `GetItem`; `PutItem` | `Recommended` |  |
+| [`rpc.service`](../attributes-registry/rpc.md) | string | The name of the service to which a request is made, as returned by the AWS SDK. [2] | `DynamoDB`; `S3` | `Recommended` |  |
**[1]:** This is the logical name of the method from the RPC interface perspective, which can be different from the name of any implementing method/function. The `code.function` attribute may be used to store the latter (e.g., method actually executing the call on the server side, RPC client stub method on the client side).
diff --git a/docs/cloudevents/cloudevents-spans.md b/docs/cloudevents/cloudevents-spans.md
index 472f8aea16..7587bad336 100644
--- a/docs/cloudevents/cloudevents-spans.md
+++ b/docs/cloudevents/cloudevents-spans.md
@@ -200,13 +200,13 @@ The following attributes are applicable to creation and processing Spans.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`cloudevents.event_id`](../attributes-registry/cloudevents.md) | string | The [event_id](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#id) uniquely identifies the event. | `123e4567-e89b-12d3-a456-426614174000`; `0001` | Required |
-| [`cloudevents.event_source`](../attributes-registry/cloudevents.md) | string | The [source](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#source-1) identifies the context in which an event happened. | `https://github.com/cloudevents`; `/cloudevents/spec/pull/123`; `my-service` | Required |
-| [`cloudevents.event_spec_version`](../attributes-registry/cloudevents.md) | string | The [version of the CloudEvents specification](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#specversion) which the event uses. | `1.0` | Recommended |
-| [`cloudevents.event_subject`](../attributes-registry/cloudevents.md) | string | The [subject](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#subject) of the event in the context of the event producer (identified by source). | `mynewfile.jpg` | Recommended |
-| [`cloudevents.event_type`](../attributes-registry/cloudevents.md) | string | The [event_type](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#type) contains a value describing the type of event related to the originating occurrence. | `com.github.pull_request.opened`; `com.example.object.deleted.v2` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`cloudevents.event_id`](../attributes-registry/cloudevents.md) | string | The [event_id](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#id) uniquely identifies the event. | `123e4567-e89b-12d3-a456-426614174000`; `0001` | `Required` |  |
+| [`cloudevents.event_source`](../attributes-registry/cloudevents.md) | string | The [source](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#source-1) identifies the context in which an event happened. | `https://github.com/cloudevents`; `/cloudevents/spec/pull/123`; `my-service` | `Required` |  |
+| [`cloudevents.event_spec_version`](../attributes-registry/cloudevents.md) | string | The [version of the CloudEvents specification](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#specversion) which the event uses. | `1.0` | `Recommended` |  |
+| [`cloudevents.event_subject`](../attributes-registry/cloudevents.md) | string | The [subject](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#subject) of the event in the context of the event producer (identified by source). | `mynewfile.jpg` | `Recommended` |  |
+| [`cloudevents.event_type`](../attributes-registry/cloudevents.md) | string | The [event_type](https://github.com/cloudevents/spec/blob/v1.0.2/cloudevents/spec.md#type) contains a value describing the type of event related to the originating occurrence. | `com.github.pull_request.opened`; `com.example.object.deleted.v2` | `Recommended` |  |
diff --git a/docs/database/cassandra.md b/docs/database/cassandra.md
index 6e83dd1a69..96ff729430 100644
--- a/docs/database/cassandra.md
+++ b/docs/database/cassandra.md
@@ -15,40 +15,40 @@ described on this page.
## Attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`db.cassandra.consistency_level`](../attributes-registry/db.md) | string | 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). | `all` | Recommended |
-| [`db.cassandra.coordinator.dc`](../attributes-registry/db.md) | string | The data center of the coordinating node for a query. | `us-west-2` | Recommended |
-| [`db.cassandra.coordinator.id`](../attributes-registry/db.md) | string | The ID of the coordinating node for a query. | `be13faa2-8574-4d71-926d-27f16cf8a7af` | Recommended |
-| [`db.cassandra.idempotence`](../attributes-registry/db.md) | boolean | Whether or not the query is idempotent. | | Recommended |
-| [`db.cassandra.page_size`](../attributes-registry/db.md) | int | The fetch size used for paging, i.e. how many rows will be returned at once. | `5000` | Recommended |
-| [`db.cassandra.speculative_execution_count`](../attributes-registry/db.md) | int | The number of times a query was speculatively executed. Not set or `0` if the query was not executed speculatively. | `0`; `2` | Recommended |
-| [`db.cassandra.table`](../attributes-registry/db.md) | string | The name of the primary Cassandra table that the operation is acting upon, including the keyspace name (if applicable). [1] | `mytable` | Recommended |
-| [`db.name`](../attributes-registry/db.md) | string | The keyspace name in Cassandra. [2] | `mykeyspace` | Conditionally Required: If applicable. |
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the database node where the operation was performed. [3] | `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | Recommended: if and only if `network.peer.address` is set. |
-
-**[1]:** This mirrors the db.sql.table attribute but references cassandra rather than sql. It is not recommended to attempt any client-side parsing of `db.statement` just to get this property, but it should be set if it is provided by the library being instrumented. If the operation is acting upon an anonymous table, or more than one table, this value MUST NOT be set.
-
-**[2]:** For Cassandra the `db.name` should be set to the Cassandra keyspace name.
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`db.name`](../attributes-registry/db.md) | string | The keyspace name in Cassandra. [1] | `mykeyspace` | `Conditionally Required` If applicable. |  |
+| [`db.cassandra.consistency_level`](../attributes-registry/db.md) | string | 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). | `all` | `Recommended` |  |
+| [`db.cassandra.coordinator.dc`](../attributes-registry/db.md) | string | The data center of the coordinating node for a query. | `us-west-2` | `Recommended` |  |
+| [`db.cassandra.coordinator.id`](../attributes-registry/db.md) | string | The ID of the coordinating node for a query. | `be13faa2-8574-4d71-926d-27f16cf8a7af` | `Recommended` |  |
+| [`db.cassandra.idempotence`](../attributes-registry/db.md) | boolean | Whether or not the query is idempotent. | | `Recommended` |  |
+| [`db.cassandra.page_size`](../attributes-registry/db.md) | int | The fetch size used for paging, i.e. how many rows will be returned at once. | `5000` | `Recommended` |  |
+| [`db.cassandra.speculative_execution_count`](../attributes-registry/db.md) | int | The number of times a query was speculatively executed. Not set or `0` if the query was not executed speculatively. | `0`; `2` | `Recommended` |  |
+| [`db.cassandra.table`](../attributes-registry/db.md) | string | The name of the primary Cassandra table that the operation is acting upon, including the keyspace name (if applicable). [2] | `mytable` | `Recommended` |  |
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the database node where the operation was performed. [3] | `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | `Recommended` if and only if `network.peer.address` is set. |  |
+
+**[1]:** For Cassandra the `db.name` should be set to the Cassandra keyspace name.
+
+**[2]:** This mirrors the db.sql.table attribute but references cassandra rather than sql. It is not recommended to attempt any client-side parsing of `db.statement` just to get this property, but it should be set if it is provided by the library being instrumented. If the operation is acting upon an anonymous table, or more than one table, this value MUST NOT be set.
**[3]:** If a database operation involved multiple network calls (for example retries), the address of the last contacted node SHOULD be used.
`db.cassandra.consistency_level` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `all` | all |
-| `each_quorum` | each_quorum |
-| `quorum` | quorum |
-| `local_quorum` | local_quorum |
-| `one` | one |
-| `two` | two |
-| `three` | three |
-| `local_one` | local_one |
-| `any` | any |
-| `serial` | serial |
-| `local_serial` | local_serial |
+| Value | Description | Stability |
+|---|---|---|
+| `all` | all |  |
+| `each_quorum` | each_quorum |  |
+| `quorum` | quorum |  |
+| `local_quorum` | local_quorum |  |
+| `one` | one |  |
+| `two` | two |  |
+| `three` | three |  |
+| `local_one` | local_one |  |
+| `any` | any |  |
+| `serial` | serial |  |
+| `local_serial` | local_serial |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/database/cosmosdb.md b/docs/database/cosmosdb.md
index 51fc4ba2f9..822ddeccc7 100644
--- a/docs/database/cosmosdb.md
+++ b/docs/database/cosmosdb.md
@@ -18,17 +18,17 @@ described on this page.
Cosmos DB instrumentation includes call-level (public API) surface spans and network spans. Depending on the connection mode (Gateway or Direct), network-level spans may also be created.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`db.cosmosdb.client_id`](../attributes-registry/db.md) | string | Unique Cosmos client instance id. | `3ba4827d-4422-483f-b59f-85b74211c11d` | Recommended |
-| [`db.cosmosdb.connection_mode`](../attributes-registry/db.md) | string | Cosmos client connection mode. | `gateway` | Conditionally Required: if not `direct` (or pick gw as default) |
-| [`db.cosmosdb.container`](../attributes-registry/db.md) | string | Cosmos DB container name. | `anystring` | Conditionally Required: if available |
-| [`db.cosmosdb.operation_type`](../attributes-registry/db.md) | string | CosmosDB Operation Type. | `Invalid` | Conditionally Required: [1] |
-| [`db.cosmosdb.request_charge`](../attributes-registry/db.md) | double | RU consumed for that operation | `46.18`; `1.0` | Conditionally Required: when available |
-| [`db.cosmosdb.request_content_length`](../attributes-registry/db.md) | int | Request payload size in bytes | | Recommended |
-| [`db.cosmosdb.status_code`](../attributes-registry/db.md) | int | Cosmos DB status code. | `200`; `201` | Conditionally Required: if response was received |
-| [`db.cosmosdb.sub_status_code`](../attributes-registry/db.md) | int | Cosmos DB sub status code. | `1000`; `1002` | Conditionally Required: [2] |
-| [`user_agent.original`](../attributes-registry/user-agent.md) | string | Full user-agent string is generated by Cosmos DB SDK [3] | `cosmos-netstandard-sdk/3.23.0\|3.23.1\|1\|X64\|Linux 5.4.0-1098-azure 104 18\|.NET Core 3.1.32\|S\|` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`db.cosmosdb.connection_mode`](../attributes-registry/db.md) | string | Cosmos client connection mode. | `gateway` | `Conditionally Required` if not `direct` (or pick gw as default) |  |
+| [`db.cosmosdb.container`](../attributes-registry/db.md) | string | Cosmos DB container name. | `anystring` | `Conditionally Required` if available |  |
+| [`db.cosmosdb.operation_type`](../attributes-registry/db.md) | string | CosmosDB Operation Type. | `Invalid` | `Conditionally Required` [1] |  |
+| [`db.cosmosdb.request_charge`](../attributes-registry/db.md) | double | RU consumed for that operation | `46.18`; `1.0` | `Conditionally Required` when available |  |
+| [`db.cosmosdb.status_code`](../attributes-registry/db.md) | int | Cosmos DB status code. | `200`; `201` | `Conditionally Required` if response was received |  |
+| [`db.cosmosdb.sub_status_code`](../attributes-registry/db.md) | int | Cosmos DB sub status code. | `1000`; `1002` | `Conditionally Required` [2] |  |
+| [`db.cosmosdb.client_id`](../attributes-registry/db.md) | string | Unique Cosmos client instance id. | `3ba4827d-4422-483f-b59f-85b74211c11d` | `Recommended` |  |
+| [`db.cosmosdb.request_content_length`](../attributes-registry/db.md) | int | Request payload size in bytes | | `Recommended` |  |
+| [`user_agent.original`](../attributes-registry/user-agent.md) | string | Full user-agent string is generated by Cosmos DB SDK [3] | `cosmos-netstandard-sdk/3.23.0\|3.23.1\|1\|X64\|Linux 5.4.0-1098-azure 104 18\|.NET Core 3.1.32\|S\|` | `Recommended` |  |
**[1]:** when performing one of the operations in this list
@@ -40,30 +40,30 @@ Cosmos DB instrumentation includes call-level (public API) surface spans and net
`db.cosmosdb.connection_mode` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `gateway` | Gateway (HTTP) connections mode |
-| `direct` | Direct connection. |
-
-`db.cosmosdb.operation_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `Invalid` | invalid |
-| `Create` | create |
-| `Patch` | patch |
-| `Read` | read |
-| `ReadFeed` | read_feed |
-| `Delete` | delete |
-| `Replace` | replace |
-| `Execute` | execute |
-| `Query` | query |
-| `Head` | head |
-| `HeadFeed` | head_feed |
-| `Upsert` | upsert |
-| `Batch` | batch |
-| `QueryPlan` | query_plan |
-| `ExecuteJavaScript` | execute_javascript |
+| Value | Description | Stability |
+|---|---|---|
+| `gateway` | Gateway (HTTP) connections mode |  |
+| `direct` | Direct connection. |  |
+
+`db.cosmosdb.operation_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `Invalid` | invalid |  |
+| `Create` | create |  |
+| `Patch` | patch |  |
+| `Read` | read |  |
+| `ReadFeed` | read_feed |  |
+| `Delete` | delete |  |
+| `Replace` | replace |  |
+| `Execute` | execute |  |
+| `Query` | query |  |
+| `Head` | head |  |
+| `HeadFeed` | head_feed |  |
+| `Upsert` | upsert |  |
+| `Batch` | batch |  |
+| `QueryPlan` | query_plan |  |
+| `ExecuteJavaScript` | execute_javascript |  |
In addition to Cosmos DB attributes, all spans include
diff --git a/docs/database/couchdb.md b/docs/database/couchdb.md
index 5ad2aae166..a7ba93e347 100644
--- a/docs/database/couchdb.md
+++ b/docs/database/couchdb.md
@@ -15,9 +15,9 @@ described on this page.
## Attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`db.operation`](../attributes-registry/db.md) | string | The HTTP method + the target REST route. [1] | `GET /{db}/{docid}` | Conditionally Required: If `db.statement` is not applicable. |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`db.operation`](../attributes-registry/db.md) | string | The HTTP method + the target REST route. [1] | `GET /{db}/{docid}` | `Conditionally Required` If `db.statement` is not applicable. |  |
**[1]:** In **CouchDB**, `db.operation` should be set to the HTTP method + the target REST route according to the API reference documentation. For example, when retrieving a document, `db.operation` would be set to (literally, i.e., without replacing the placeholders with concrete values): [`GET /{db}/{docid}`](https://docs.couchdb.org/en/stable/api/document/common.html#get--db-docid).
diff --git a/docs/database/database-metrics.md b/docs/database/database-metrics.md
index f7bedea83d..03c69cb6e2 100644
--- a/docs/database/database-metrics.md
+++ b/docs/database/database-metrics.md
@@ -44,38 +44,38 @@ The following metric instruments describe database client connection pool operat
This metric is [required][MetricRequired].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `db.client.connections.usage` | UpDownCounter | `{connection}` | The number of connections that are currently in state described by the `state` attribute |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `db.client.connections.usage` | UpDownCounter | `{connection}` | The number of connections that are currently in state described by the `state` attribute |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | Required |
-| `state` | string | The state of a connection in the pool | `idle` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | `Required` |  |
+| `state` | string | The state of a connection in the pool | `idle` | `Required` |  |
`state` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `idle` | idle |
-| `used` | used |
+| Value | Description | Stability |
+|---|---|---|
+| `idle` | idle |  |
+| `used` | used |  |
### Metric: `db.client.connections.idle.max`
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `db.client.connections.idle.max` | UpDownCounter | `{connection}` | The maximum number of idle open connections allowed |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `db.client.connections.idle.max` | UpDownCounter | `{connection}` | The maximum number of idle open connections allowed |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | `Required` |  |
### Metric: `db.client.connections.idle.min`
@@ -83,15 +83,15 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `db.client.connections.idle.min` | UpDownCounter | `{connection}` | The minimum number of idle open connections allowed |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `db.client.connections.idle.min` | UpDownCounter | `{connection}` | The minimum number of idle open connections allowed |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | `Required` |  |
### Metric: `db.client.connections.max`
@@ -99,15 +99,15 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `db.client.connections.max` | UpDownCounter | `{connection}` | The maximum number of open connections allowed |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `db.client.connections.max` | UpDownCounter | `{connection}` | The maximum number of open connections allowed |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | `Required` |  |
### Metric: `db.client.connections.pending_requests`
@@ -115,15 +115,15 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `db.client.connections.pending_requests` | UpDownCounter | `{request}` | The number of pending requests for an open connection, cumulative for the entire pool |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `db.client.connections.pending_requests` | UpDownCounter | `{request}` | The number of pending requests for an open connection, cumulative for the entire pool |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | `Required` |  |
### Metric: `db.client.connections.timeouts`
@@ -131,15 +131,15 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `db.client.connections.timeouts` | Counter | `{timeout}` | The number of connection timeouts that have occurred trying to obtain a connection from the pool |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `db.client.connections.timeouts` | Counter | `{timeout}` | The number of connection timeouts that have occurred trying to obtain a connection from the pool |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | `Required` |  |
### Metric: `db.client.connections.create_time`
@@ -147,15 +147,15 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `db.client.connections.create_time` | Histogram | `ms` | The time it took to create a new connection |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `db.client.connections.create_time` | Histogram | `ms` | The time it took to create a new connection |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | `Required` |  |
### Metric: `db.client.connections.wait_time`
@@ -163,15 +163,15 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `db.client.connections.wait_time` | Histogram | `ms` | The time it took to obtain an open connection from the pool |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `db.client.connections.wait_time` | Histogram | `ms` | The time it took to obtain an open connection from the pool |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | `Required` |  |
### Metric: `db.client.connections.use_time`
@@ -179,15 +179,15 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `db.client.connections.use_time` | Histogram | `ms` | The time between borrowing a connection and returning it to the pool |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `db.client.connections.use_time` | Histogram | `ms` | The time between borrowing a connection and returning it to the pool |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `pool.name` | string | The name of the connection pool; unique within the instrumented application. In case the connection pool implementation doesn't provide a name, instrumentation should use a combination of `server.address` and `server.port` attributes formatted as `server.address:server.port`. | `myDataSource` | `Required` |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/database/database-spans.md b/docs/database/database-spans.md
index a37429f009..7f9d792e34 100644
--- a/docs/database/database-spans.md
+++ b/docs/database/database-spans.md
@@ -71,90 +71,90 @@ These attributes will usually be the same for all operations performed over the
Some database systems may allow a connection to switch to a different `db.user`, for example, and other database systems may not even have the concept of a connection at all.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`db.instance.id`](../attributes-registry/db.md) | string | An identifier (address, unique name, or any other identifier) of the database instance that is executing queries or mutations on the current connection. This is useful in cases where the database is running in a clustered environment and the instrumentation is able to record the node executing the query. The client may obtain this value in databases like MySQL using queries like `select @@hostname`. | `mysql-e26b99z.example.com` | Recommended: If different from the `server.address` |
-| [`db.name`](../attributes-registry/db.md) | string | This attribute is used to report the name of the database being accessed. For commands that switch the database, this should be set to the target database (even if the command fails). [1] | `customers`; `main` | Conditionally Required: If applicable. |
-| [`db.operation`](../attributes-registry/db.md) | string | The name of the operation being executed, e.g. the [MongoDB command name](https://docs.mongodb.com/manual/reference/command/#database-operations) such as `findAndModify`, or the SQL keyword. [2] | `findAndModify`; `HMSET`; `SELECT` | Conditionally Required: If `db.statement` is not applicable. |
-| [`db.statement`](../attributes-registry/db.md) | string | The database statement being executed. | `SELECT * FROM wuser_table`; `SET mykey "WuValue"` | Recommended: [3] |
-| [`db.system`](../attributes-registry/db.md) | string | An identifier for the database management system (DBMS) product being used. See below for a list of well-known identifiers. | `other_sql` | Required |
-| [`db.user`](../attributes-registry/db.md) | string | Username for accessing the database. | `readonly_user`; `reporting_user` | Recommended |
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the database node where the operation was performed. [4] | `10.1.2.80`; `/tmp/my.sock` | Recommended: If applicable for this database system. |
-| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | Recommended: if and only if `network.peer.address` is set. |
-| [`server.address`](../attributes-registry/server.md) | string | Name of the database host. [5] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [6] | `80`; `8080`; `443` | Conditionally Required: [7] |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`db.system`](../attributes-registry/db.md) | string | An identifier for the database management system (DBMS) product being used. See below for a list of well-known identifiers. | `other_sql` | `Required` |  |
+| [`db.name`](../attributes-registry/db.md) | string | This attribute is used to report the name of the database being accessed. For commands that switch the database, this should be set to the target database (even if the command fails). [1] | `customers`; `main` | `Conditionally Required` If applicable. |  |
+| [`db.operation`](../attributes-registry/db.md) | string | The name of the operation being executed, e.g. the [MongoDB command name](https://docs.mongodb.com/manual/reference/command/#database-operations) such as `findAndModify`, or the SQL keyword. [2] | `findAndModify`; `HMSET`; `SELECT` | `Conditionally Required` If `db.statement` is not applicable. |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [3] | `80`; `8080`; `443` | `Conditionally Required` [4] |  |
+| [`db.instance.id`](../attributes-registry/db.md) | string | An identifier (address, unique name, or any other identifier) of the database instance that is executing queries or mutations on the current connection. This is useful in cases where the database is running in a clustered environment and the instrumentation is able to record the node executing the query. The client may obtain this value in databases like MySQL using queries like `select @@hostname`. | `mysql-e26b99z.example.com` | `Recommended` If different from the `server.address` |  |
+| [`db.statement`](../attributes-registry/db.md) | string | The database statement being executed. | `SELECT * FROM wuser_table`; `SET mykey "WuValue"` | `Recommended` [5] |  |
+| [`db.user`](../attributes-registry/db.md) | string | Username for accessing the database. | `readonly_user`; `reporting_user` | `Recommended` |  |
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the database node where the operation was performed. [6] | `10.1.2.80`; `/tmp/my.sock` | `Recommended` If applicable for this database system. |  |
+| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | `Recommended` if and only if `network.peer.address` is set. |  |
+| [`server.address`](../attributes-registry/server.md) | string | Name of the database host. [7] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
**[1]:** In some SQL databases, the database name to be used is called "schema name". In case there are multiple layers that could be considered for database name (e.g. Oracle instance name and schema name), the database name to be used is the more specific layer (e.g. Oracle schema name).
**[2]:** When setting this to an SQL keyword, it is not recommended to attempt any client-side parsing of `db.statement` just to get this property, but it should be set if the operation name is provided by the library being instrumented. If the SQL statement has an ambiguous operation, or performs more than one operation, this value may be omitted.
-**[3]:** Should be collected by default only if there is sanitization that excludes sensitive information.
+**[3]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-**[4]:** Semantic conventions for individual database systems SHOULD document whether `network.peer.*` attributes are applicable. Network peer address and port are useful when the application interacts with individual database nodes directly.
+**[4]:** If using a port other than the default port for this DBMS and if `server.address` is set.
+
+**[5]:** Should be collected by default only if there is sanitization that excludes sensitive information.
+
+**[6]:** Semantic conventions for individual database systems SHOULD document whether `network.peer.*` attributes are applicable. Network peer address and port are useful when the application interacts with individual database nodes directly.
If a database operation involved multiple network calls (for example retries), the address of the last contacted node SHOULD be used.
-**[5]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
-
-**[6]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-
-**[7]:** If using a port other than the default port for this DBMS and if `server.address` is set.
-
-`db.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `other_sql` | Some other SQL database. Fallback only. See notes. |
-| `mssql` | Microsoft SQL Server |
-| `mssqlcompact` | Microsoft SQL Server Compact |
-| `mysql` | MySQL |
-| `oracle` | Oracle Database |
-| `db2` | IBM Db2 |
-| `postgresql` | PostgreSQL |
-| `redshift` | Amazon Redshift |
-| `hive` | Apache Hive |
-| `cloudscape` | Cloudscape |
-| `hsqldb` | HyperSQL DataBase |
-| `progress` | Progress Database |
-| `maxdb` | SAP MaxDB |
-| `hanadb` | SAP HANA |
-| `ingres` | Ingres |
-| `firstsql` | FirstSQL |
-| `edb` | EnterpriseDB |
-| `cache` | InterSystems Caché |
-| `adabas` | Adabas (Adaptable Database System) |
-| `firebird` | Firebird |
-| `derby` | Apache Derby |
-| `filemaker` | FileMaker |
-| `informix` | Informix |
-| `instantdb` | InstantDB |
-| `interbase` | InterBase |
-| `mariadb` | MariaDB |
-| `netezza` | Netezza |
-| `pervasive` | Pervasive PSQL |
-| `pointbase` | PointBase |
-| `sqlite` | SQLite |
-| `sybase` | Sybase |
-| `teradata` | Teradata |
-| `vertica` | Vertica |
-| `h2` | H2 |
-| `coldfusion` | ColdFusion IMQ |
-| `cassandra` | Apache Cassandra |
-| `hbase` | Apache HBase |
-| `mongodb` | MongoDB |
-| `redis` | Redis |
-| `couchbase` | Couchbase |
-| `couchdb` | CouchDB |
-| `cosmosdb` | Microsoft Azure Cosmos DB |
-| `dynamodb` | Amazon DynamoDB |
-| `neo4j` | Neo4j |
-| `geode` | Apache Geode |
-| `elasticsearch` | Elasticsearch |
-| `memcached` | Memcached |
-| `cockroachdb` | CockroachDB |
-| `opensearch` | OpenSearch |
-| `clickhouse` | ClickHouse |
-| `spanner` | Cloud Spanner |
-| `trino` | Trino |
+**[7]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
+
+`db.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `other_sql` | Some other SQL database. Fallback only. See notes. |  |
+| `mssql` | Microsoft SQL Server |  |
+| `mssqlcompact` | Microsoft SQL Server Compact |  |
+| `mysql` | MySQL |  |
+| `oracle` | Oracle Database |  |
+| `db2` | IBM Db2 |  |
+| `postgresql` | PostgreSQL |  |
+| `redshift` | Amazon Redshift |  |
+| `hive` | Apache Hive |  |
+| `cloudscape` | Cloudscape |  |
+| `hsqldb` | HyperSQL DataBase |  |
+| `progress` | Progress Database |  |
+| `maxdb` | SAP MaxDB |  |
+| `hanadb` | SAP HANA |  |
+| `ingres` | Ingres |  |
+| `firstsql` | FirstSQL |  |
+| `edb` | EnterpriseDB |  |
+| `cache` | InterSystems Caché |  |
+| `adabas` | Adabas (Adaptable Database System) |  |
+| `firebird` | Firebird |  |
+| `derby` | Apache Derby |  |
+| `filemaker` | FileMaker |  |
+| `informix` | Informix |  |
+| `instantdb` | InstantDB |  |
+| `interbase` | InterBase |  |
+| `mariadb` | MariaDB |  |
+| `netezza` | Netezza |  |
+| `pervasive` | Pervasive PSQL |  |
+| `pointbase` | PointBase |  |
+| `sqlite` | SQLite |  |
+| `sybase` | Sybase |  |
+| `teradata` | Teradata |  |
+| `vertica` | Vertica |  |
+| `h2` | H2 |  |
+| `coldfusion` | ColdFusion IMQ |  |
+| `cassandra` | Apache Cassandra |  |
+| `hbase` | Apache HBase |  |
+| `mongodb` | MongoDB |  |
+| `redis` | Redis |  |
+| `couchbase` | Couchbase |  |
+| `couchdb` | CouchDB |  |
+| `cosmosdb` | Microsoft Azure Cosmos DB |  |
+| `dynamodb` | Amazon DynamoDB |  |
+| `neo4j` | Neo4j |  |
+| `geode` | Apache Geode |  |
+| `elasticsearch` | Elasticsearch |  |
+| `memcached` | Memcached |  |
+| `cockroachdb` | CockroachDB |  |
+| `opensearch` | OpenSearch |  |
+| `clickhouse` | ClickHouse |  |
+| `spanner` | Cloud Spanner |  |
+| `trino` | Trino |  |
### Notes and well-known identifiers for `db.system`
diff --git a/docs/database/dynamodb.md b/docs/database/dynamodb.md
index 932f5e5fc0..b81e58fdda 100644
--- a/docs/database/dynamodb.md
+++ b/docs/database/dynamodb.md
@@ -17,157 +17,157 @@ described on this page.
These attributes are filled in for all DynamoDB request types.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`db.system`](../attributes-registry/db.md) | string | The value `dynamodb`. | `dynamodb` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`db.system`](../attributes-registry/db.md) | string | The value `dynamodb`. | `dynamodb` | `Required` |  |
## DynamoDB.BatchGetItem
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | Recommended |
-| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` |  |
+| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | `Recommended` |  |
## DynamoDB.BatchWriteItem
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | Recommended |
-| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | Recommended |
-| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` |  |
+| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` |  |
+| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | `Recommended` |  |
## DynamoDB.CreateTable
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | Recommended |
-| `aws.dynamodb.global_secondary_indexes` | string[] | The JSON-serialized value of each item of the `GlobalSecondaryIndexes` request field | `[{ "IndexName": "string", "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" }, "ProvisionedThroughput": { "ReadCapacityUnits": number, "WriteCapacityUnits": number } }]` | Recommended |
-| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | Recommended |
-| `aws.dynamodb.local_secondary_indexes` | string[] | The JSON-serialized value of each item of the `LocalSecondaryIndexes` request field. | `[{ "IndexArn": "string", "IndexName": "string", "IndexSizeBytes": number, "ItemCount": number, "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" } }]` | Recommended |
-| `aws.dynamodb.provisioned_read_capacity` | double | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter. | `1.0`; `2.0` | Recommended |
-| `aws.dynamodb.provisioned_write_capacity` | double | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter. | `1.0`; `2.0` | Recommended |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` |  |
+| `aws.dynamodb.global_secondary_indexes` | string[] | The JSON-serialized value of each item of the `GlobalSecondaryIndexes` request field | `[{ "IndexName": "string", "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" }, "ProvisionedThroughput": { "ReadCapacityUnits": number, "WriteCapacityUnits": number } }]` | `Recommended` |  |
+| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` |  |
+| `aws.dynamodb.local_secondary_indexes` | string[] | The JSON-serialized value of each item of the `LocalSecondaryIndexes` request field. | `[{ "IndexArn": "string", "IndexName": "string", "IndexSizeBytes": number, "ItemCount": number, "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" } }]` | `Recommended` |  |
+| `aws.dynamodb.provisioned_read_capacity` | double | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` |  |
+| `aws.dynamodb.provisioned_write_capacity` | double | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` |  |
+| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` |  |
## DynamoDB.DeleteItem
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | Recommended |
-| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | Recommended |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` |  |
+| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` |  |
+| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` |  |
## DynamoDB.DeleteTable
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` |  |
## DynamoDB.DescribeTable
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` |  |
## DynamoDB.GetItem
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. | | Recommended |
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | Recommended |
-| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | Recommended |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. | | `Recommended` |  |
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` |  |
+| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | `Recommended` |  |
+| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` |  |
## DynamoDB.ListTables
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.exclusive_start_table` | string | The value of the `ExclusiveStartTableName` request parameter. | `Users`; `CatsTable` | Recommended |
-| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` | Recommended |
-| `aws.dynamodb.table_count` | int | The number of items in the `TableNames` response parameter. | `20` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.exclusive_start_table` | string | The value of the `ExclusiveStartTableName` request parameter. | `Users`; `CatsTable` | `Recommended` |  |
+| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` | `Recommended` |  |
+| `aws.dynamodb.table_count` | int | The number of items in the `TableNames` response parameter. | `20` | `Recommended` |  |
## DynamoDB.PutItem
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | Recommended |
-| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | Recommended |
-| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` |  |
+| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` |  |
+| `aws.dynamodb.table_names` | string[] | The keys in the `RequestItems` object field. | `[Users, Cats]` | `Recommended` |  |
## DynamoDB.Query
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.attributes_to_get` | string[] | The value of the `AttributesToGet` request parameter. | `[lives, id]` | Recommended |
-| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. | | Recommended |
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | Recommended |
-| `aws.dynamodb.index_name` | string | The value of the `IndexName` request parameter. | `name_to_group` | Recommended |
-| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` | Recommended |
-| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | Recommended |
-| `aws.dynamodb.scan_forward` | boolean | The value of the `ScanIndexForward` request parameter. | | Recommended |
-| `aws.dynamodb.select` | string | The value of the `Select` request parameter. | `ALL_ATTRIBUTES`; `COUNT` | Recommended |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.attributes_to_get` | string[] | The value of the `AttributesToGet` request parameter. | `[lives, id]` | `Recommended` |  |
+| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. | | `Recommended` |  |
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` |  |
+| `aws.dynamodb.index_name` | string | The value of the `IndexName` request parameter. | `name_to_group` | `Recommended` |  |
+| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` | `Recommended` |  |
+| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | `Recommended` |  |
+| `aws.dynamodb.scan_forward` | boolean | The value of the `ScanIndexForward` request parameter. | | `Recommended` |  |
+| `aws.dynamodb.select` | string | The value of the `Select` request parameter. | `ALL_ATTRIBUTES`; `COUNT` | `Recommended` |  |
+| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` |  |
## DynamoDB.Scan
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.attributes_to_get` | string[] | The value of the `AttributesToGet` request parameter. | `[lives, id]` | Recommended |
-| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. | | Recommended |
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | Recommended |
-| `aws.dynamodb.count` | int | The value of the `Count` response parameter. | `10` | Recommended |
-| `aws.dynamodb.index_name` | string | The value of the `IndexName` request parameter. | `name_to_group` | Recommended |
-| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` | Recommended |
-| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | Recommended |
-| `aws.dynamodb.scanned_count` | int | The value of the `ScannedCount` response parameter. | `50` | Recommended |
-| `aws.dynamodb.segment` | int | The value of the `Segment` request parameter. | `10` | Recommended |
-| `aws.dynamodb.select` | string | The value of the `Select` request parameter. | `ALL_ATTRIBUTES`; `COUNT` | Recommended |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | Recommended |
-| `aws.dynamodb.total_segments` | int | The value of the `TotalSegments` request parameter. | `100` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.attributes_to_get` | string[] | The value of the `AttributesToGet` request parameter. | `[lives, id]` | `Recommended` |  |
+| `aws.dynamodb.consistent_read` | boolean | The value of the `ConsistentRead` request parameter. | | `Recommended` |  |
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` |  |
+| `aws.dynamodb.count` | int | The value of the `Count` response parameter. | `10` | `Recommended` |  |
+| `aws.dynamodb.index_name` | string | The value of the `IndexName` request parameter. | `name_to_group` | `Recommended` |  |
+| `aws.dynamodb.limit` | int | The value of the `Limit` request parameter. | `10` | `Recommended` |  |
+| `aws.dynamodb.projection` | string | The value of the `ProjectionExpression` request parameter. | `Title`; `Title, Price, Color`; `Title, Description, RelatedItems, ProductReviews` | `Recommended` |  |
+| `aws.dynamodb.scanned_count` | int | The value of the `ScannedCount` response parameter. | `50` | `Recommended` |  |
+| `aws.dynamodb.segment` | int | The value of the `Segment` request parameter. | `10` | `Recommended` |  |
+| `aws.dynamodb.select` | string | The value of the `Select` request parameter. | `ALL_ATTRIBUTES`; `COUNT` | `Recommended` |  |
+| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` |  |
+| `aws.dynamodb.total_segments` | int | The value of the `TotalSegments` request parameter. | `100` | `Recommended` |  |
## DynamoDB.UpdateItem
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | Recommended |
-| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | Recommended |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` |  |
+| `aws.dynamodb.item_collection_metrics` | string | The JSON-serialized value of the `ItemCollectionMetrics` response field. | `{ "string" : [ { "ItemCollectionKey": { "string" : { "B": blob, "BOOL": boolean, "BS": [ blob ], "L": [ "AttributeValue" ], "M": { "string" : "AttributeValue" }, "N": "string", "NS": [ "string" ], "NULL": boolean, "S": "string", "SS": [ "string" ] } }, "SizeEstimateRangeGB": [ number ] } ] }` | `Recommended` |  |
+| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` |  |
## DynamoDB.UpdateTable
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.dynamodb.attribute_definitions` | string[] | The JSON-serialized value of each item in the `AttributeDefinitions` request field. | `[{ "AttributeName": "string", "AttributeType": "string" }]` | Recommended |
-| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | Recommended |
-| `aws.dynamodb.global_secondary_index_updates` | string[] | The JSON-serialized value of each item in the `GlobalSecondaryIndexUpdates` request field. | `[{ "Create": { "IndexName": "string", "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" }, "ProvisionedThroughput": { "ReadCapacityUnits": number, "WriteCapacityUnits": number } }]` | Recommended |
-| `aws.dynamodb.provisioned_read_capacity` | double | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter. | `1.0`; `2.0` | Recommended |
-| `aws.dynamodb.provisioned_write_capacity` | double | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter. | `1.0`; `2.0` | Recommended |
-| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.dynamodb.attribute_definitions` | string[] | The JSON-serialized value of each item in the `AttributeDefinitions` request field. | `[{ "AttributeName": "string", "AttributeType": "string" }]` | `Recommended` |  |
+| `aws.dynamodb.consumed_capacity` | string[] | The JSON-serialized value of each item in the `ConsumedCapacity` response field. | `[{ "CapacityUnits": number, "GlobalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "LocalSecondaryIndexes": { "string" : { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number } }, "ReadCapacityUnits": number, "Table": { "CapacityUnits": number, "ReadCapacityUnits": number, "WriteCapacityUnits": number }, "TableName": "string", "WriteCapacityUnits": number }]` | `Recommended` |  |
+| `aws.dynamodb.global_secondary_index_updates` | string[] | The JSON-serialized value of each item in the `GlobalSecondaryIndexUpdates` request field. | `[{ "Create": { "IndexName": "string", "KeySchema": [ { "AttributeName": "string", "KeyType": "string" } ], "Projection": { "NonKeyAttributes": [ "string" ], "ProjectionType": "string" }, "ProvisionedThroughput": { "ReadCapacityUnits": number, "WriteCapacityUnits": number } }]` | `Recommended` |  |
+| `aws.dynamodb.provisioned_read_capacity` | double | The value of the `ProvisionedThroughput.ReadCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` |  |
+| `aws.dynamodb.provisioned_write_capacity` | double | The value of the `ProvisionedThroughput.WriteCapacityUnits` request parameter. | `1.0`; `2.0` | `Recommended` |  |
+| `aws.dynamodb.table_names` | string[] | A single-element array with the value of the TableName request parameter. | `[Users]` | `Recommended` |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/database/elasticsearch.md b/docs/database/elasticsearch.md
index 5c8d9f5a9d..2b85f275b8 100644
--- a/docs/database/elasticsearch.md
+++ b/docs/database/elasticsearch.md
@@ -24,31 +24,23 @@ If the endpoint id is not available, the span name SHOULD be the `http.request.m
## Attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`db.elasticsearch.cluster.name`](../attributes-registry/db.md) | string | Represents the identifier of an Elasticsearch cluster. | `e9106fc68e3044f0b1475b04bf4ffd5f` | Recommended: [1] |
-| [`db.elasticsearch.path_parts.`](../attributes-registry/db.md) | string | A dynamic value in the url path. [2] | `db.elasticsearch.path_parts.index=test-index`; `db.elasticsearch.path_parts.doc_id=123` | Conditionally Required: when the url has dynamic values |
-| [`db.instance.id`](../attributes-registry/db.md) | string | An identifier (address, unique name, or any other identifier) of the database instance that is executing queries or mutations on the current connection. This is useful in cases where the database is running in a clustered environment and the instrumentation is able to record the node executing the query. The client may obtain this value in databases like MySQL using queries like `select @@hostname`. | `mysql-e26b99z.example.com` | Recommended: [3] |
-| [`db.operation`](../attributes-registry/db.md) | string | The endpoint identifier for the request. [4] | `search`; `ml.close_job`; `cat.aliases` | Required |
-| [`db.statement`](../attributes-registry/db.md) | string | The request body for a [search-type query](https://www.elastic.co/guide/en/elasticsearch/reference/current/search.html), as a json string. | `"{\"query\":{\"term\":{\"user.id\":\"kimchy\"}}}"` | Recommended: [5] |
-| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [6] | `GET`; `POST`; `HEAD` | Required |
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the database node where the operation was performed. [7] | `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | Recommended: if and only if `network.peer.address` is set. |
-| [`server.address`](../attributes-registry/server.md) | string | Name of the database host. [8] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [9] | `80`; `8080`; `443` | Conditionally Required: [10] |
-| [`url.full`](../attributes-registry/url.md) | string | Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986) [11] | `https://localhost:9200/index/_search?q=user.id:kimchy` | Required |
-
-**[1]:** When communicating with an Elastic Cloud deployment, this should be collected from the "X-Found-Handling-Cluster" HTTP response header.
-
-**[2]:** Many Elasticsearch url paths allow dynamic values. These SHOULD be recorded in span attributes in the format `db.elasticsearch.path_parts.`, where `` is the url path part name. The implementation SHOULD reference the [elasticsearch schema](https://raw.githubusercontent.com/elastic/elasticsearch-specification/main/output/schema/schema.json) in order to map the path part values to their names.
-
-**[3]:** When communicating with an Elastic Cloud deployment, this should be collected from the "X-Found-Handling-Instance" HTTP response header.
-
-**[4]:** When setting this to an SQL keyword, it is not recommended to attempt any client-side parsing of `db.statement` just to get this property, but it should be set if the operation name is provided by the library being instrumented. If the SQL statement has an ambiguous operation, or performs more than one operation, this value may be omitted.
-
-**[5]:** Should be collected by default for search-type queries and only if there is sanitization that excludes sensitive information.
-
-**[6]:** HTTP request method value SHOULD be "known" to the instrumentation.
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`db.operation`](../attributes-registry/db.md) | string | The endpoint identifier for the request. [1] | `search`; `ml.close_job`; `cat.aliases` | `Required` |  |
+| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [2] | `GET`; `POST`; `HEAD` | `Required` |  |
+| [`url.full`](../attributes-registry/url.md) | string | Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986) [3] | `https://localhost:9200/index/_search?q=user.id:kimchy` | `Required` |  |
+| [`db.elasticsearch.path_parts.`](../attributes-registry/db.md) | string | A dynamic value in the url path. [4] | `db.elasticsearch.path_parts.index=test-index`; `db.elasticsearch.path_parts.doc_id=123` | `Conditionally Required` when the url has dynamic values |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [5] | `80`; `8080`; `443` | `Conditionally Required` [6] |  |
+| [`db.elasticsearch.cluster.name`](../attributes-registry/db.md) | string | Represents the identifier of an Elasticsearch cluster. | `e9106fc68e3044f0b1475b04bf4ffd5f` | `Recommended` [7] |  |
+| [`db.instance.id`](../attributes-registry/db.md) | string | An identifier (address, unique name, or any other identifier) of the database instance that is executing queries or mutations on the current connection. This is useful in cases where the database is running in a clustered environment and the instrumentation is able to record the node executing the query. The client may obtain this value in databases like MySQL using queries like `select @@hostname`. | `mysql-e26b99z.example.com` | `Recommended` [8] |  |
+| [`db.statement`](../attributes-registry/db.md) | string | The request body for a [search-type query](https://www.elastic.co/guide/en/elasticsearch/reference/current/search.html), as a json string. | `"{\"query\":{\"term\":{\"user.id\":\"kimchy\"}}}"` | `Recommended` [9] |  |
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the database node where the operation was performed. [10] | `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | `Recommended` if and only if `network.peer.address` is set. |  |
+| [`server.address`](../attributes-registry/server.md) | string | Name of the database host. [11] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+
+**[1]:** When setting this to an SQL keyword, it is not recommended to attempt any client-side parsing of `db.statement` just to get this property, but it should be set if the operation name is provided by the library being instrumented. If the SQL statement has an ambiguous operation, or performs more than one operation, this value may be omitted.
+
+**[2]:** HTTP request method value SHOULD be "known" to the instrumentation.
By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
@@ -63,32 +55,40 @@ HTTP method names are case-sensitive and `http.request.method` attribute value M
Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
-**[7]:** If a database operation involved multiple network calls (for example retries), the address of the last contacted node SHOULD be used.
+**[3]:** For network calls, URL usually has `scheme://host[:port][path][?query][#fragment]` format, where the fragment is not transmitted over HTTP, but if it is known, it SHOULD be included nevertheless.
+`url.full` MUST NOT contain credentials passed via URL in form of `https://username:password@www.example.com/`. In such case username and password SHOULD be redacted and attribute's value SHOULD be `https://REDACTED:REDACTED@www.example.com/`.
+`url.full` SHOULD capture the absolute URL when it is available (or can be reconstructed). Sensitive content provided in `url.full` SHOULD be scrubbed when instrumentations can identify it.
-**[8]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
+**[4]:** Many Elasticsearch url paths allow dynamic values. These SHOULD be recorded in span attributes in the format `db.elasticsearch.path_parts.`, where `` is the url path part name. The implementation SHOULD reference the [elasticsearch schema](https://raw.githubusercontent.com/elastic/elasticsearch-specification/main/output/schema/schema.json) in order to map the path part values to their names.
-**[9]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
+**[5]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-**[10]:** If using a port other than the default port for this DBMS and if `server.address` is set.
+**[6]:** If using a port other than the default port for this DBMS and if `server.address` is set.
-**[11]:** For network calls, URL usually has `scheme://host[:port][path][?query][#fragment]` format, where the fragment is not transmitted over HTTP, but if it is known, it SHOULD be included nevertheless.
-`url.full` MUST NOT contain credentials passed via URL in form of `https://username:password@www.example.com/`. In such case username and password SHOULD be redacted and attribute's value SHOULD be `https://REDACTED:REDACTED@www.example.com/`.
-`url.full` SHOULD capture the absolute URL when it is available (or can be reconstructed). Sensitive content provided in `url.full` SHOULD be scrubbed when instrumentations can identify it.
+**[7]:** When communicating with an Elastic Cloud deployment, this should be collected from the "X-Found-Handling-Cluster" HTTP response header.
+
+**[8]:** When communicating with an Elastic Cloud deployment, this should be collected from the "X-Found-Handling-Instance" HTTP response header.
+
+**[9]:** Should be collected by default for search-type queries and only if there is sanitization that excludes sensitive information.
+
+**[10]:** If a database operation involved multiple network calls (for example retries), the address of the last contacted node SHOULD be used.
+
+**[11]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
+
+`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `CONNECT` | CONNECT method. |
-| `DELETE` | DELETE method. |
-| `GET` | GET method. |
-| `HEAD` | HEAD method. |
-| `OPTIONS` | OPTIONS method. |
-| `PATCH` | PATCH method. |
-| `POST` | POST method. |
-| `PUT` | PUT method. |
-| `TRACE` | TRACE method. |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |
+| Value | Description | Stability |
+|---|---|---|
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
## Example
diff --git a/docs/database/hbase.md b/docs/database/hbase.md
index 50675d6b91..45a665eef1 100644
--- a/docs/database/hbase.md
+++ b/docs/database/hbase.md
@@ -15,9 +15,9 @@ described on this page.
## Attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`db.name`](../attributes-registry/db.md) | string | The HBase namespace. [1] | `mynamespace` | Conditionally Required: If applicable. |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`db.name`](../attributes-registry/db.md) | string | The HBase namespace. [1] | `mynamespace` | `Conditionally Required` If applicable. |  |
**[1]:** For HBase the `db.name` should be set to the HBase namespace.
diff --git a/docs/database/mongodb.md b/docs/database/mongodb.md
index 71558732c8..2bd73c8df3 100644
--- a/docs/database/mongodb.md
+++ b/docs/database/mongodb.md
@@ -15,9 +15,9 @@ described on this page.
## Attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`db.mongodb.collection`](../attributes-registry/db.md) | string | The MongoDB collection being accessed within the database stated in `db.name`. | `customers`; `products` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`db.mongodb.collection`](../attributes-registry/db.md) | string | The MongoDB collection being accessed within the database stated in `db.name`. | `customers`; `products` | `Required` |  |
## Example
diff --git a/docs/database/mssql.md b/docs/database/mssql.md
index e0ad3c6727..90c80af32d 100644
--- a/docs/database/mssql.md
+++ b/docs/database/mssql.md
@@ -15,10 +15,10 @@ described on this page.
## Attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`db.mssql.instance_name`](../attributes-registry/db.md) | string | The Microsoft SQL Server [instance name](https://docs.microsoft.com/sql/connect/jdbc/building-the-connection-url?view=sql-server-ver15) connecting to. This name is used to determine the port of a named instance. [1] | `MSSQLSERVER` | Recommended |
-| [`db.sql.table`](../attributes-registry/db.md) | string | The name of the primary table that the operation is acting upon, including the database name (if applicable). [2] | `public.users`; `customers` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`db.mssql.instance_name`](../attributes-registry/db.md) | string | The Microsoft SQL Server [instance name](https://docs.microsoft.com/sql/connect/jdbc/building-the-connection-url?view=sql-server-ver15) connecting to. This name is used to determine the port of a named instance. [1] | `MSSQLSERVER` | `Recommended` |  |
+| [`db.sql.table`](../attributes-registry/db.md) | string | The name of the primary table that the operation is acting upon, including the database name (if applicable). [2] | `public.users`; `customers` | `Recommended` |  |
**[1]:** If setting a `db.mssql.instance_name`, `server.port` is no longer required (but still recommended if non-standard).
diff --git a/docs/database/redis.md b/docs/database/redis.md
index 895a293895..be0897ba42 100644
--- a/docs/database/redis.md
+++ b/docs/database/redis.md
@@ -15,12 +15,12 @@ described on this page.
## Attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`db.redis.database_index`](../attributes-registry/db.md) | int | The index of the database being accessed as used in the [`SELECT` command](https://redis.io/commands/select), provided as an integer. To be used instead of the generic `db.name` attribute. | `0`; `1`; `15` | Conditionally Required: If other than the default database (`0`). |
-| [`db.statement`](../attributes-registry/db.md) | string | The full syntax of the Redis CLI command. [1] | `HMSET myhash field1 'Hello' field2 'World'` | Recommended: [2] |
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the database node where the operation was performed. [3] | `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | Recommended: if and only if `network.peer.address` is set. |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`db.redis.database_index`](../attributes-registry/db.md) | int | The index of the database being accessed as used in the [`SELECT` command](https://redis.io/commands/select), provided as an integer. To be used instead of the generic `db.name` attribute. | `0`; `1`; `15` | `Conditionally Required` If other than the default database (`0`). |  |
+| [`db.statement`](../attributes-registry/db.md) | string | The full syntax of the Redis CLI command. [1] | `HMSET myhash field1 'Hello' field2 'World'` | `Recommended` [2] |  |
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the database node where the operation was performed. [3] | `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | `Recommended` if and only if `network.peer.address` is set. |  |
**[1]:** For **Redis**, the value provided for `db.statement` SHOULD correspond to the syntax of the Redis CLI. If, for example, the [`HMSET` command](https://redis.io/commands/hmset) is invoked, `"HMSET myhash field1 'Hello' field2 'World'"` would be a suitable value for `db.statement`.
diff --git a/docs/database/sql.md b/docs/database/sql.md
index 17b8dcc892..32aeaa31cb 100644
--- a/docs/database/sql.md
+++ b/docs/database/sql.md
@@ -13,9 +13,9 @@ described on this page.
## Attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`db.sql.table`](../attributes-registry/db.md) | string | The name of the primary table that the operation is acting upon, including the database name (if applicable). [1] | `public.users`; `customers` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`db.sql.table`](../attributes-registry/db.md) | string | The name of the primary table that the operation is acting upon, including the database name (if applicable). [1] | `public.users`; `customers` | `Recommended` |  |
**[1]:** It is not recommended to attempt any client-side parsing of `db.statement` just to get this property, but it should be set if it is provided by the library being instrumented. If the operation is acting upon an anonymous table, or more than one table, this value MUST NOT be set.
diff --git a/docs/dns/dns-metrics.md b/docs/dns/dns-metrics.md
index 46262286cc..7c67b1f9e6 100644
--- a/docs/dns/dns-metrics.md
+++ b/docs/dns/dns-metrics.md
@@ -21,8 +21,6 @@ This document defines semantic conventions to apply when instrumenting DNS queri
### Metric: `dns.lookup.duration`
-**Status**: [Experimental][DocumentStatus]
-
This metric is optional.
This metric SHOULD be specified with
@@ -30,26 +28,26 @@ This metric SHOULD be specified with
of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `dns.lookup.duration` | Histogram | `s` | Measures the time taken to perform a DNS lookup. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `dns.lookup.duration` | Histogram | `s` | Measures the time taken to perform a DNS lookup. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`dns.question.name`](../attributes-registry/dns.md) | string | The name being queried. [1] | `www.example.com`; `dot.net` | Required |
-| [`error.type`](../attributes-registry/error.md) | string | Describes the error the DNS lookup failed with. [2] | `host_not_found`; `no_recovery`; `java.net.UnknownHostException` | Conditionally Required: if and only if an error has occurred. |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`dns.question.name`](../attributes-registry/dns.md) | string | The name being queried. [1] | `www.example.com`; `dot.net` | `Required` |  |
+| [`error.type`](../attributes-registry/error.md) | string | Describes the error the DNS lookup failed with. [2] | `host_not_found`; `no_recovery`; `java.net.UnknownHostException` | `Conditionally Required` if and only if an error has occurred. |  |
**[1]:** 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.
**[2]:** Instrumentations SHOULD use error code such as one of errors reported by `getaddrinfo`([Linux or other POSIX systems](https://man7.org/linux/man-pages/man3/getaddrinfo.3.html) / [Windows](https://learn.microsoft.com/windows/win32/api/ws2tcpip/nf-ws2tcpip-getaddrinfo)) or one reported by the runtime or client library. If error code is not available, the full name of exception type SHOULD be used.
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/dotnet/dotnet-aspnetcore-metrics.md b/docs/dotnet/dotnet-aspnetcore-metrics.md
index 54b8fc04a0..95617251d4 100644
--- a/docs/dotnet/dotnet-aspnetcore-metrics.md
+++ b/docs/dotnet/dotnet-aspnetcore-metrics.md
@@ -33,29 +33,29 @@ All routing metrics are reported by the `Microsoft.AspNetCore.Routing` meter.
### Metric: `aspnetcore.routing.match_attempts`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `aspnetcore.routing.match_attempts` | Counter | `{match_attempt}` | Number of requests that were attempted to be matched to an endpoint. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `aspnetcore.routing.match_attempts` | Counter | `{match_attempt}` | Number of requests that were attempted to be matched to an endpoint. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.Routing`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aspnetcore.routing.is_fallback` | boolean | 
A value that indicates whether the matched route is a fallback route. | `True` | Conditionally Required: if and only if a route was successfully matched. |
-| `aspnetcore.routing.match_status` | string | 
Match result - success or failure | `success`; `failure` | Required |
-| [`http.route`](../attributes-registry/http.md) | string | 
The matched route, that is, the path template in the format used by the respective server framework. [1] | `/users/:userID?`; `{controller}/{action}/{id?}` | Conditionally Required: if and only if a route was successfully matched. |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aspnetcore.routing.match_status` | string | Match result - success or failure | `success`; `failure` | `Required` |  |
+| `aspnetcore.routing.is_fallback` | boolean | A value that indicates whether the matched route is a fallback route. | `True` | `Conditionally Required` if and only if a route was successfully matched. |  |
+| [`http.route`](../attributes-registry/http.md) | string | The matched route, that is, the path template in the format used by the respective server framework. [1] | `/users/:userID?`; `{controller}/{action}/{id?}` | `Conditionally Required` if and only if a route was successfully matched. |  |
**[1]:** MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
SHOULD include the [application root](/docs/http/http-spans.md#http-server-definitions) if there is one.
-`aspnetcore.routing.match_status` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`aspnetcore.routing.match_status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `success` | Match succeeded |
-| `failure` | Match failed |
+| Value | Description | Stability |
+|---|---|---|
+| `success` | Match succeeded |  |
+| `failure` | Match failed |  |
## Exceptions
@@ -65,23 +65,21 @@ Exceptions Metric is reported by the `Microsoft.AspNetCore.Diagnostics` meter.
### Metric: `aspnetcore.diagnostics.exceptions`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `aspnetcore.diagnostics.exceptions` | Counter | `{exception}` | Number of exceptions caught by exception handling middleware. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `aspnetcore.diagnostics.exceptions` | Counter | `{exception}` | Number of exceptions caught by exception handling middleware. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.Diagnostics`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aspnetcore.diagnostics.exception.result` | string | 
ASP.NET Core exception middleware handling result | `handled`; `unhandled` | Required |
-| `aspnetcore.diagnostics.handler.type` | string | 
Full type name of the [`IExceptionHandler`](https://learn.microsoft.com/dotnet/api/microsoft.aspnetcore.diagnostics.iexceptionhandler) implementation that handled the exception. | `Contoso.MyHandler` | Conditionally Required: [1] |
-| [`error.type`](../attributes-registry/error.md) | string | 
The full name of exception type. [2] | `System.OperationCanceledException`; `Contoso.MyException` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aspnetcore.diagnostics.exception.result` | string | ASP.NET Core exception middleware handling result | `handled`; `unhandled` | `Required` |  |
+| [`error.type`](../attributes-registry/error.md) | string | The full name of exception type. [1] | `System.OperationCanceledException`; `Contoso.MyException` | `Required` |  |
+| `aspnetcore.diagnostics.handler.type` | string | Full type name of the [`IExceptionHandler`](https://learn.microsoft.com/dotnet/api/microsoft.aspnetcore.diagnostics.iexceptionhandler) implementation that handled the exception. | `Contoso.MyHandler` | `Conditionally Required` [2] |  |
-**[1]:** if and only if the exception was handled by this handler.
-
-**[2]:** The `error.type` SHOULD be predictable and SHOULD have low cardinality.
+**[1]:** The `error.type` SHOULD be predictable and SHOULD have low cardinality.
Instrumentations SHOULD document the list of errors they report.
The cardinality of `error.type` within one instrumentation library SHOULD be low.
@@ -97,20 +95,22 @@ it's RECOMMENDED to:
* Use a domain-specific attribute
* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
+**[2]:** if and only if the exception was handled by this handler.
+
`aspnetcore.diagnostics.exception.result` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `handled` | Exception was handled by the exception handling middleware. |
-| `unhandled` | Exception was not handled by the exception handling middleware. |
-| `skipped` | Exception handling was skipped because the response had started. |
-| `aborted` | Exception handling didn't run because the request was aborted. |
+| Value | Description | Stability |
+|---|---|---|
+| `handled` | Exception was handled by the exception handling middleware. |  |
+| `unhandled` | Exception was not handled by the exception handling middleware. |  |
+| `skipped` | Exception handling was skipped because the response had started. |  |
+| `aborted` | Exception handling didn't run because the request was aborted. |  |
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
## Rate-limiting
@@ -120,17 +120,17 @@ All rate-limiting metrics are reported by the `Microsoft.AspNetCore.RateLimiting
### Metric: `aspnetcore.rate_limiting.active_request_leases`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `aspnetcore.rate_limiting.active_request_leases` | UpDownCounter | `{request}` | Number of requests that are currently active on the server that hold a rate limiting lease. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `aspnetcore.rate_limiting.active_request_leases` | UpDownCounter | `{request}` | Number of requests that are currently active on the server that hold a rate limiting lease. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.RateLimiting`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aspnetcore.rate_limiting.policy` | string | 
Rate limiting policy name. | `fixed`; `sliding`; `token` | Conditionally Required: [1] |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aspnetcore.rate_limiting.policy` | string | Rate limiting policy name. | `fixed`; `sliding`; `token` | `Conditionally Required` [1] |  |
**[1]:** if the matched endpoint for the request had a rate-limiting policy.
@@ -142,17 +142,17 @@ this metric SHOULD be specified with
of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `aspnetcore.rate_limiting.request_lease.duration` | Histogram | `s` | The duration of rate limiting lease held by requests on the server. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `aspnetcore.rate_limiting.request_lease.duration` | Histogram | `s` | The duration of rate limiting lease held by requests on the server. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.RateLimiting`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aspnetcore.rate_limiting.policy` | string | 
Rate limiting policy name. | `fixed`; `sliding`; `token` | Conditionally Required: [1] |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aspnetcore.rate_limiting.policy` | string | Rate limiting policy name. | `fixed`; `sliding`; `token` | `Conditionally Required` [1] |  |
**[1]:** if the matched endpoint for the request had a rate-limiting policy.
@@ -160,17 +160,17 @@ of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10
### Metric: `aspnetcore.rate_limiting.queued_requests`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `aspnetcore.rate_limiting.queued_requests` | UpDownCounter | `{request}` | Number of requests that are currently queued, waiting to acquire a rate limiting lease. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `aspnetcore.rate_limiting.queued_requests` | UpDownCounter | `{request}` | Number of requests that are currently queued, waiting to acquire a rate limiting lease. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.RateLimiting`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aspnetcore.rate_limiting.policy` | string | 
Rate limiting policy name. | `fixed`; `sliding`; `token` | Conditionally Required: [1] |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aspnetcore.rate_limiting.policy` | string | Rate limiting policy name. | `fixed`; `sliding`; `token` | `Conditionally Required` [1] |  |
**[1]:** if the matched endpoint for the request had a rate-limiting policy.
@@ -182,37 +182,37 @@ this metric SHOULD be specified with
of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `aspnetcore.rate_limiting.request.time_in_queue` | Histogram | `s` | The time the request spent in a queue waiting to acquire a rate limiting lease. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `aspnetcore.rate_limiting.request.time_in_queue` | Histogram | `s` | The time the request spent in a queue waiting to acquire a rate limiting lease. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.RateLimiting`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aspnetcore.rate_limiting.policy` | string | 
Rate limiting policy name. | `fixed`; `sliding`; `token` | Conditionally Required: [1] |
-| `aspnetcore.rate_limiting.result` | string | 
Rate-limiting result, shows whether the lease was acquired or contains a rejection reason | `acquired`; `request_canceled` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aspnetcore.rate_limiting.result` | string | Rate-limiting result, shows whether the lease was acquired or contains a rejection reason | `acquired`; `request_canceled` | `Required` |  |
+| `aspnetcore.rate_limiting.policy` | string | Rate limiting policy name. | `fixed`; `sliding`; `token` | `Conditionally Required` [1] |  |
**[1]:** if the matched endpoint for the request had a rate-limiting policy.
-`aspnetcore.rate_limiting.result` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`aspnetcore.rate_limiting.result` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `acquired` | Lease was acquired |
-| `endpoint_limiter` | Lease request was rejected by the endpoint limiter |
-| `global_limiter` | Lease request was rejected by the global limiter |
-| `request_canceled` | Lease request was canceled |
+| Value | Description | Stability |
+|---|---|---|
+| `acquired` | Lease was acquired |  |
+| `endpoint_limiter` | Lease request was rejected by the endpoint limiter |  |
+| `global_limiter` | Lease request was rejected by the global limiter |  |
+| `request_canceled` | Lease request was canceled |  |
### Metric: `aspnetcore.rate_limiting.requests`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `aspnetcore.rate_limiting.requests` | Counter | `{request}` | Number of requests that tried to acquire a rate limiting lease. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `aspnetcore.rate_limiting.requests` | Counter | `{request}` | Number of requests that tried to acquire a rate limiting lease. [1] |  |
**[1]:** Requests could be:
@@ -223,21 +223,21 @@ Meter name: `Microsoft.AspNetCore.RateLimiting`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aspnetcore.rate_limiting.policy` | string | 
Rate limiting policy name. | `fixed`; `sliding`; `token` | Conditionally Required: [1] |
-| `aspnetcore.rate_limiting.result` | string | 
Rate-limiting result, shows whether the lease was acquired or contains a rejection reason | `acquired`; `request_canceled` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aspnetcore.rate_limiting.result` | string | Rate-limiting result, shows whether the lease was acquired or contains a rejection reason | `acquired`; `request_canceled` | `Required` |  |
+| `aspnetcore.rate_limiting.policy` | string | Rate limiting policy name. | `fixed`; `sliding`; `token` | `Conditionally Required` [1] |  |
**[1]:** if the matched endpoint for the request had a rate-limiting policy.
-`aspnetcore.rate_limiting.result` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`aspnetcore.rate_limiting.result` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `acquired` | Lease was acquired |
-| `endpoint_limiter` | Lease request was rejected by the endpoint limiter |
-| `global_limiter` | Lease request was rejected by the global limiter |
-| `request_canceled` | Lease request was canceled |
+| Value | Description | Stability |
+|---|---|---|
+| `acquired` | Lease was acquired |  |
+| `endpoint_limiter` | Lease request was rejected by the endpoint limiter |  |
+| `global_limiter` | Lease request was rejected by the global limiter |  |
+| `request_canceled` | Lease request was canceled |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/dotnet/dotnet-kestrel-metrics.md b/docs/dotnet/dotnet-kestrel-metrics.md
index a6971f77ef..34727f84e2 100644
--- a/docs/dotnet/dotnet-kestrel-metrics.md
+++ b/docs/dotnet/dotnet-kestrel-metrics.md
@@ -33,20 +33,20 @@ In case instrumentation does not recognize `EndPoint` implementation, it sets th
## Metric: `kestrel.active_connections`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `kestrel.active_connections` | UpDownCounter | `{connection}` | Number of connections that are currently active on the server. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `kestrel.active_connections` | UpDownCounter | `{connection}` | Number of connections that are currently active on the server. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.Server.Kestrel`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `unix` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | Recommended: if the transport is `tcp` or `udp` |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [3] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [4] | `80`; `8080`; `443` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `unix` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | `Recommended` if the transport is `tcp` or `udp` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [3] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [4] | `80`; `8080`; `443` | `Recommended` |  |
**[1]:** The value SHOULD be normalized to lowercase.
@@ -60,21 +60,21 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
**[4]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
## Metric: `kestrel.connection.duration`
@@ -84,24 +84,24 @@ this metric SHOULD be specified with
of `[ 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60, 120, 300 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `kestrel.connection.duration` | Histogram | `s` | The duration of connections on the server. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `kestrel.connection.duration` | Histogram | `s` | The duration of connections on the server. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.Server.Kestrel`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`error.type`](../attributes-registry/error.md) | string | 
The full name of exception type. [1] | `System.OperationCanceledException`; `Contoso.MyException` | Conditionally Required: if and only if an error has occurred. |
-| [`network.protocol.name`](../attributes-registry/network.md) | string | 
[OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [2] | `http`; `web_sockets` | Recommended |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | 
The actual version of the protocol used for network communication. [3] | `1.1`; `2` | Recommended |
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [4] | `tcp`; `unix` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [5] | `ipv4`; `ipv6` | Recommended: if the transport is `tcp` or `udp` |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [6] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [7] | `80`; `8080`; `443` | Recommended |
-| [`tls.protocol.version`](../attributes-registry/tls.md) | string | Numeric part of the version parsed from the original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `1.2`; `3` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`error.type`](../attributes-registry/error.md) | string | The full name of exception type. [1] | `System.OperationCanceledException`; `Contoso.MyException` | `Conditionally Required` if and only if an error has occurred. |  |
+| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [2] | `http`; `web_sockets` | `Recommended` |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [3] | `1.1`; `2` | `Recommended` |  |
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [4] | `tcp`; `unix` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [5] | `ipv4`; `ipv6` | `Recommended` if the transport is `tcp` or `udp` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [6] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [7] | `80`; `8080`; `443` | `Recommended` |  |
+| [`tls.protocol.version`](../attributes-registry/tls.md) | string | Numeric part of the version parsed from the original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `1.2`; `3` | `Recommended` |  |
**[1]:** Captures the exception type when a connection fails.
@@ -121,47 +121,47 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
**[7]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
## Metric: `kestrel.rejected_connections`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `kestrel.rejected_connections` | Counter | `{connection}` | Number of connections rejected by the server. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `kestrel.rejected_connections` | Counter | `{connection}` | Number of connections rejected by the server. [1] |  |
**[1]:** Connections are rejected when the currently active count exceeds the value configured with `MaxConcurrentConnections`.
Meter name: `Microsoft.AspNetCore.Server.Kestrel`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `unix` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | Recommended: if the transport is `tcp` or `udp` |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [3] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [4] | `80`; `8080`; `443` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `unix` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | `Recommended` if the transport is `tcp` or `udp` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [3] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [4] | `80`; `8080`; `443` | `Recommended` |  |
**[1]:** The value SHOULD be normalized to lowercase.
@@ -175,40 +175,40 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
**[4]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
## Metric: `kestrel.queued_connections`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `kestrel.queued_connections` | UpDownCounter | `{connection}` | Number of connections that are currently queued and are waiting to start. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `kestrel.queued_connections` | UpDownCounter | `{connection}` | Number of connections that are currently queued and are waiting to start. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.Server.Kestrel`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `unix` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | Recommended: if the transport is `tcp` or `udp` |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [3] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [4] | `80`; `8080`; `443` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `unix` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | `Recommended` if the transport is `tcp` or `udp` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [3] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [4] | `80`; `8080`; `443` | `Recommended` |  |
**[1]:** The value SHOULD be normalized to lowercase.
@@ -222,42 +222,42 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
**[4]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
## Metric: `kestrel.queued_requests`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `kestrel.queued_requests` | UpDownCounter | `{request}` | Number of HTTP requests on multiplexed connections (HTTP/2 and HTTP/3) that are currently queued and are waiting to start. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `kestrel.queued_requests` | UpDownCounter | `{request}` | Number of HTTP requests on multiplexed connections (HTTP/2 and HTTP/3) that are currently queued and are waiting to start. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.Server.Kestrel`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.protocol.name`](../attributes-registry/network.md) | string | 
[OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [1] | `http`; `web_sockets` | Recommended |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | 
The actual version of the protocol used for network communication. [2] | `1.1`; `2` | Recommended |
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `unix` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [4] | `ipv4`; `ipv6` | Recommended: if the transport is `tcp` or `udp` |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [5] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [6] | `80`; `8080`; `443` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [1] | `http`; `web_sockets` | `Recommended` |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [2] | `1.1`; `2` | `Recommended` |  |
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `unix` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [4] | `ipv4`; `ipv6` | `Recommended` if the transport is `tcp` or `udp` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [5] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [6] | `80`; `8080`; `443` | `Recommended` |  |
**[1]:** The value SHOULD be normalized to lowercase.
@@ -275,29 +275,29 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
**[6]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
## Metric: `kestrel.upgraded_connections`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `kestrel.upgraded_connections` | UpDownCounter | `{connection}` | Number of connections that are currently upgraded (WebSockets). . [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `kestrel.upgraded_connections` | UpDownCounter | `{connection}` | Number of connections that are currently upgraded (WebSockets). . [1] |  |
**[1]:** The counter only tracks HTTP/1.1 connections.
@@ -305,12 +305,12 @@ Meter name: `Microsoft.AspNetCore.Server.Kestrel`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `unix` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | Recommended: if the transport is `tcp` or `udp` |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [3] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [4] | `80`; `8080`; `443` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `unix` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | `Recommended` if the transport is `tcp` or `udp` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [3] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [4] | `80`; `8080`; `443` | `Recommended` |  |
**[1]:** The value SHOULD be normalized to lowercase.
@@ -324,21 +324,21 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
**[4]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
## Metric: `kestrel.tls_handshake.duration`
@@ -348,22 +348,22 @@ this metric SHOULD be specified with
of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `kestrel.tls_handshake.duration` | Histogram | `s` | The duration of TLS handshakes on the server. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `kestrel.tls_handshake.duration` | Histogram | `s` | The duration of TLS handshakes on the server. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.Server.Kestrel`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`error.type`](../attributes-registry/error.md) | string | 
The full name of exception type. [1] | `System.OperationCanceledException`; `Contoso.MyException` | Conditionally Required: if and only if an error has occurred. |
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [2] | `tcp`; `unix` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [3] | `ipv4`; `ipv6` | Recommended: if the transport is `tcp` or `udp` |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [4] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [5] | `80`; `8080`; `443` | Recommended |
-| [`tls.protocol.version`](../attributes-registry/tls.md) | string | Numeric part of the version parsed from the original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `1.2`; `3` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`error.type`](../attributes-registry/error.md) | string | The full name of exception type. [1] | `System.OperationCanceledException`; `Contoso.MyException` | `Conditionally Required` if and only if an error has occurred. |  |
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [2] | `tcp`; `unix` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [3] | `ipv4`; `ipv6` | `Recommended` if the transport is `tcp` or `udp` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [4] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [5] | `80`; `8080`; `443` | `Recommended` |  |
+| [`tls.protocol.version`](../attributes-registry/tls.md) | string | Numeric part of the version parsed from the original string of the negotiated [SSL/TLS protocol version](https://www.openssl.org/docs/man1.1.1/man3/SSL_get_version.html#RETURN-VALUES) | `1.2`; `3` | `Recommended` |  |
**[1]:** Captures the exception type when a TLS handshake fails.
@@ -379,46 +379,46 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
**[5]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
## Metric: `kestrel.active_tls_handshakes`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `kestrel.active_tls_handshakes` | UpDownCounter | `{handshake}` | Number of TLS handshakes that are currently in progress on the server. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `kestrel.active_tls_handshakes` | UpDownCounter | `{handshake}` | Number of TLS handshakes that are currently in progress on the server. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.Server.Kestrel`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `unix` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | Recommended: if the transport is `tcp` or `udp` |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [3] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [4] | `80`; `8080`; `443` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `unix` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | `Recommended` if the transport is `tcp` or `udp` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [3] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [4] | `80`; `8080`; `443` | `Recommended` |  |
**[1]:** The value SHOULD be normalized to lowercase.
@@ -432,21 +432,21 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
**[4]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/dotnet/dotnet-signalr-metrics.md b/docs/dotnet/dotnet-signalr-metrics.md
index 931d5f4bf3..73471c645b 100644
--- a/docs/dotnet/dotnet-signalr-metrics.md
+++ b/docs/dotnet/dotnet-signalr-metrics.md
@@ -22,67 +22,67 @@ this metric SHOULD be specified with
of `[ 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60, 120, 300 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `signalr.server.connection.duration` | Histogram | `s` | The duration of connections on the server. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `signalr.server.connection.duration` | Histogram | `s` | The duration of connections on the server. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.Http.Connections`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `signalr.connection.status` | string | 
SignalR HTTP connection closure status. | `app_shutdown`; `timeout` | Recommended |
-| `signalr.transport` | string | 
[SignalR transport type](https://github.com/dotnet/aspnetcore/blob/main/src/SignalR/docs/specs/TransportProtocols.md) | `web_sockets`; `long_polling` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `signalr.connection.status` | string | SignalR HTTP connection closure status. | `app_shutdown`; `timeout` | `Recommended` |  |
+| `signalr.transport` | string | [SignalR transport type](https://github.com/dotnet/aspnetcore/blob/main/src/SignalR/docs/specs/TransportProtocols.md) | `web_sockets`; `long_polling` | `Recommended` |  |
`signalr.connection.status` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `normal_closure` | The connection was closed normally. |
-| `timeout` | The connection was closed due to a timeout. |
-| `app_shutdown` | The connection was closed because the app is shutting down. |
+| Value | Description | Stability |
+|---|---|---|
+| `normal_closure` | The connection was closed normally. |  |
+| `timeout` | The connection was closed due to a timeout. |  |
+| `app_shutdown` | The connection was closed because the app is shutting down. |  |
-`signalr.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`signalr.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `server_sent_events` | ServerSentEvents protocol |
-| `long_polling` | LongPolling protocol |
-| `web_sockets` | WebSockets protocol |
+| Value | Description | Stability |
+|---|---|---|
+| `server_sent_events` | ServerSentEvents protocol |  |
+| `long_polling` | LongPolling protocol |  |
+| `web_sockets` | WebSockets protocol |  |
## Metric: `signalr.server.active_connections`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `signalr.server.active_connections` | UpDownCounter | `{connection}` | Number of connections that are currently active on the server. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `signalr.server.active_connections` | UpDownCounter | `{connection}` | Number of connections that are currently active on the server. [1] |  |
**[1]:** Meter name: `Microsoft.AspNetCore.Http.Connections`; Added in: ASP.NET Core 8.0
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `signalr.connection.status` | string | 
SignalR HTTP connection closure status. | `app_shutdown`; `timeout` | Recommended |
-| `signalr.transport` | string | 
[SignalR transport type](https://github.com/dotnet/aspnetcore/blob/main/src/SignalR/docs/specs/TransportProtocols.md) | `web_sockets`; `long_polling` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `signalr.connection.status` | string | SignalR HTTP connection closure status. | `app_shutdown`; `timeout` | `Recommended` |  |
+| `signalr.transport` | string | [SignalR transport type](https://github.com/dotnet/aspnetcore/blob/main/src/SignalR/docs/specs/TransportProtocols.md) | `web_sockets`; `long_polling` | `Recommended` |  |
`signalr.connection.status` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `normal_closure` | The connection was closed normally. |
-| `timeout` | The connection was closed due to a timeout. |
-| `app_shutdown` | The connection was closed because the app is shutting down. |
+| Value | Description | Stability |
+|---|---|---|
+| `normal_closure` | The connection was closed normally. |  |
+| `timeout` | The connection was closed due to a timeout. |  |
+| `app_shutdown` | The connection was closed because the app is shutting down. |  |
-`signalr.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`signalr.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `server_sent_events` | ServerSentEvents protocol |
-| `long_polling` | LongPolling protocol |
-| `web_sockets` | WebSockets protocol |
+| Value | Description | Stability |
+|---|---|---|
+| `server_sent_events` | ServerSentEvents protocol |  |
+| `long_polling` | LongPolling protocol |  |
+| `web_sockets` | WebSockets protocol |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/exceptions/exceptions-logs.md b/docs/exceptions/exceptions-logs.md
index 0746762191..1365a02753 100644
--- a/docs/exceptions/exceptions-logs.md
+++ b/docs/exceptions/exceptions-logs.md
@@ -36,11 +36,11 @@ The table below indicates which attributes should be added to the
[LogRecord](https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/logs/data-model.md#log-and-event-record-definition) and their types.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`exception.message`](../attributes-registry/exception.md) | string | The exception message. | `Division by zero`; `Can't convert 'int' object to str implicitly` | See below |
-| [`exception.stacktrace`](../attributes-registry/exception.md) | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `Exception in thread "main" java.lang.RuntimeException: Test exception\n at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` | Recommended |
-| [`exception.type`](../attributes-registry/exception.md) | string | The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it. | `java.net.ConnectException`; `OSError` | See below |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`exception.message`](../attributes-registry/exception.md) | string | The exception message. | `Division by zero`; `Can't convert 'int' object to str implicitly` | See below |  |
+| [`exception.stacktrace`](../attributes-registry/exception.md) | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `Exception in thread "main" java.lang.RuntimeException: Test exception\n at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` | `Recommended` |  |
+| [`exception.type`](../attributes-registry/exception.md) | string | The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it. | `java.net.ConnectException`; `OSError` | See below |  |
**Additional attribute requirements:** At least one of the following sets of attributes is required:
diff --git a/docs/exceptions/exceptions-spans.md b/docs/exceptions/exceptions-spans.md
index ef9d3849e1..66ff658c1a 100644
--- a/docs/exceptions/exceptions-spans.md
+++ b/docs/exceptions/exceptions-spans.md
@@ -46,12 +46,12 @@ their types.
The event name MUST be `exception`.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`exception.escaped`](../attributes-registry/exception.md) | boolean | SHOULD be set to true if the exception event is recorded at a point where it is known that the exception is escaping the scope of the span. [1] | | Recommended |
-| [`exception.message`](../attributes-registry/exception.md) | string | The exception message. | `Division by zero`; `Can't convert 'int' object to str implicitly` | See below |
-| [`exception.stacktrace`](../attributes-registry/exception.md) | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `Exception in thread "main" java.lang.RuntimeException: Test exception\n at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` | Recommended |
-| [`exception.type`](../attributes-registry/exception.md) | string | The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it. | `java.net.ConnectException`; `OSError` | See below |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`exception.escaped`](../attributes-registry/exception.md) | boolean | SHOULD be set to true if the exception event is recorded at a point where it is known that the exception is escaping the scope of the span. [1] | | `Recommended` |  |
+| [`exception.message`](../attributes-registry/exception.md) | string | The exception message. | `Division by zero`; `Can't convert 'int' object to str implicitly` | See below |  |
+| [`exception.stacktrace`](../attributes-registry/exception.md) | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `Exception in thread "main" java.lang.RuntimeException: Test exception\n at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` | `Recommended` |  |
+| [`exception.type`](../attributes-registry/exception.md) | string | The type of the exception (its fully-qualified class name, if applicable). The dynamic type of the exception should be preferred over the static type in languages that support it. | `java.net.ConnectException`; `OSError` | See below |  |
**[1]:** An exception is considered to have escaped (or left) the scope of a span,
if that span is ended while the exception is still logically "in flight".
diff --git a/docs/faas/aws-lambda.md b/docs/faas/aws-lambda.md
index c2219b9e4e..f980a2b2f1 100644
--- a/docs/faas/aws-lambda.md
+++ b/docs/faas/aws-lambda.md
@@ -45,9 +45,9 @@ Also consider setting other attributes of the [`faas` resource][faasres] and [tr
and the [cloud resource conventions][cloud]. The following AWS Lambda-specific attribute MAY also be set:
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.lambda.invoked_arn` | string | 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). [1] | `arn:aws:lambda:us-east-1:123456:function:myfunction:myalias` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.lambda.invoked_arn` | string | 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). [1] | `arn:aws:lambda:us-east-1:123456:function:myfunction:myalias` | `Recommended` |  |
**[1]:** This may be different from `cloud.resource_id` if an alias is involved.
diff --git a/docs/faas/faas-metrics.md b/docs/faas/faas-metrics.md
index 9ecf509df3..e7211edf2c 100644
--- a/docs/faas/faas-metrics.md
+++ b/docs/faas/faas-metrics.md
@@ -50,25 +50,25 @@ This metric SHOULD be specified with
of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `faas.invoke_duration` | Histogram | `s` | Measures the duration of the function's logic execution |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `faas.invoke_duration` | Histogram | `s` | Measures the duration of the function's logic execution |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | `Recommended` |  |
`faas.trigger` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `datasource` | A response to some data source operation such as a database or filesystem read/write |
-| `http` | To provide an answer to an inbound HTTP request |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |
-| `timer` | A function is scheduled to be executed regularly |
-| `other` | If none of the others apply |
+| Value | Description | Stability |
+|---|---|---|
+| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
+| `other` | If none of the others apply |  |
#### Metric: `faas.init_duration`
@@ -80,25 +80,25 @@ This metric SHOULD be specified with
of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `faas.init_duration` | Histogram | `s` | Measures the duration of the function's initialization, such as a cold start |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `faas.init_duration` | Histogram | `s` | Measures the duration of the function's initialization, such as a cold start |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | `Recommended` |  |
`faas.trigger` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `datasource` | A response to some data source operation such as a database or filesystem read/write |
-| `http` | To provide an answer to an inbound HTTP request |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |
-| `timer` | A function is scheduled to be executed regularly |
-| `other` | If none of the others apply |
+| Value | Description | Stability |
+|---|---|---|
+| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
+| `other` | If none of the others apply |  |
#### Metric: `faas.coldstarts`
@@ -106,25 +106,25 @@ of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `faas.coldstarts` | Counter | `{coldstart}` | Number of invocation cold starts |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `faas.coldstarts` | Counter | `{coldstart}` | Number of invocation cold starts |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | `Recommended` |  |
`faas.trigger` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `datasource` | A response to some data source operation such as a database or filesystem read/write |
-| `http` | To provide an answer to an inbound HTTP request |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |
-| `timer` | A function is scheduled to be executed regularly |
-| `other` | If none of the others apply |
+| Value | Description | Stability |
+|---|---|---|
+| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
+| `other` | If none of the others apply |  |
#### Metric: `faas.errors`
@@ -132,25 +132,25 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `faas.errors` | Counter | `{error}` | Number of invocation errors |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `faas.errors` | Counter | `{error}` | Number of invocation errors |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | `Recommended` |  |
`faas.trigger` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `datasource` | A response to some data source operation such as a database or filesystem read/write |
-| `http` | To provide an answer to an inbound HTTP request |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |
-| `timer` | A function is scheduled to be executed regularly |
-| `other` | If none of the others apply |
+| Value | Description | Stability |
+|---|---|---|
+| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
+| `other` | If none of the others apply |  |
#### Metric: `faas.invocations`
@@ -158,25 +158,25 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `faas.invocations` | Counter | `{invocation}` | Number of successful invocations |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `faas.invocations` | Counter | `{invocation}` | Number of successful invocations |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | `Recommended` |  |
`faas.trigger` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `datasource` | A response to some data source operation such as a database or filesystem read/write |
-| `http` | To provide an answer to an inbound HTTP request |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |
-| `timer` | A function is scheduled to be executed regularly |
-| `other` | If none of the others apply |
+| Value | Description | Stability |
+|---|---|---|
+| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
+| `other` | If none of the others apply |  |
#### Metric: `faas.timeouts`
@@ -184,25 +184,25 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `faas.timeouts` | Counter | `{timeout}` | Number of invocation timeouts |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `faas.timeouts` | Counter | `{timeout}` | Number of invocation timeouts |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | `Recommended` |  |
`faas.trigger` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `datasource` | A response to some data source operation such as a database or filesystem read/write |
-| `http` | To provide an answer to an inbound HTTP request |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |
-| `timer` | A function is scheduled to be executed regularly |
-| `other` | If none of the others apply |
+| Value | Description | Stability |
+|---|---|---|
+| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
+| `other` | If none of the others apply |  |
#### Metric: `faas.mem_usage`
@@ -210,25 +210,25 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `faas.mem_usage` | Histogram | `By` | Distribution of max memory usage per invocation |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `faas.mem_usage` | Histogram | `By` | Distribution of max memory usage per invocation |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | `Recommended` |  |
`faas.trigger` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `datasource` | A response to some data source operation such as a database or filesystem read/write |
-| `http` | To provide an answer to an inbound HTTP request |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |
-| `timer` | A function is scheduled to be executed regularly |
-| `other` | If none of the others apply |
+| Value | Description | Stability |
+|---|---|---|
+| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
+| `other` | If none of the others apply |  |
#### Metric: `faas.cpu_usage`
@@ -240,25 +240,25 @@ This metric SHOULD be specified with
of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `faas.cpu_usage` | Histogram | `s` | Distribution of CPU usage per invocation |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `faas.cpu_usage` | Histogram | `s` | Distribution of CPU usage per invocation |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | `Recommended` |  |
`faas.trigger` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `datasource` | A response to some data source operation such as a database or filesystem read/write |
-| `http` | To provide an answer to an inbound HTTP request |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |
-| `timer` | A function is scheduled to be executed regularly |
-| `other` | If none of the others apply |
+| Value | Description | Stability |
+|---|---|---|
+| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
+| `other` | If none of the others apply |  |
#### Metric: `faas.net_io`
@@ -266,25 +266,25 @@ of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `faas.net_io` | Histogram | `By` | Distribution of net I/O usage per invocation |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `faas.net_io` | Histogram | `By` | Distribution of net I/O usage per invocation |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. | `datasource` | `Recommended` |  |
`faas.trigger` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `datasource` | A response to some data source operation such as a database or filesystem read/write |
-| `http` | To provide an answer to an inbound HTTP request |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |
-| `timer` | A function is scheduled to be executed regularly |
-| `other` | If none of the others apply |
+| Value | Description | Stability |
+|---|---|---|
+| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
+| `other` | If none of the others apply |  |
## References
diff --git a/docs/faas/faas-spans.md b/docs/faas/faas-spans.md
index ee38715df3..3b49cc5bca 100644
--- a/docs/faas/faas-spans.md
+++ b/docs/faas/faas-spans.md
@@ -39,11 +39,11 @@ Span `name` should be set to the function name being executed. Depending on the
If Spans following this convention are produced, a Resource of type `faas` MUST exist following the [Resource semantic convention](../resource/faas.md).
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`cloud.resource_id`](../attributes-registry/cloud.md) | string | Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name) on GCP) [1] | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/` | Recommended |
-| [`faas.invocation_id`](../attributes-registry/faas.md) | string | The invocation ID of the current function invocation. | `af9d5aa4-a685-4c5f-a22b-444f80b3cc28` | Recommended |
-| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. [2] | `datasource` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`cloud.resource_id`](../attributes-registry/cloud.md) | string | Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name) on GCP) [1] | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/` | `Recommended` |  |
+| [`faas.invocation_id`](../attributes-registry/faas.md) | string | The invocation ID of the current function invocation. | `af9d5aa4-a685-4c5f-a22b-444f80b3cc28` | `Recommended` |  |
+| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. [2] | `datasource` | `Recommended` |  |
**[1]:** On some cloud providers, it may not be possible to determine the full ID at startup,
so it may be necessary to set `cloud.resource_id` as a span attribute instead.
@@ -75,13 +75,13 @@ call to invoke the lambda, which is often HTTP).
`faas.trigger` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `datasource` | A response to some data source operation such as a database or filesystem read/write |
-| `http` | To provide an answer to an inbound HTTP request |
-| `pubsub` | A function is set to be executed when messages are sent to a messaging system |
-| `timer` | A function is scheduled to be executed regularly |
-| `other` | If none of the others apply |
+| Value | Description | Stability |
+|---|---|---|
+| `datasource` | A response to some data source operation such as a database or filesystem read/write |  |
+| `http` | To provide an answer to an inbound HTTP request |  |
+| `pubsub` | A function is set to be executed when messages are sent to a messaging system |  |
+| `timer` | A function is scheduled to be executed regularly |  |
+| `other` | If none of the others apply |  |
### Function Name
@@ -120,10 +120,10 @@ For incoming FaaS spans, the span kind MUST be `Server`.
### Incoming FaaS Span attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.coldstart`](../attributes-registry/faas.md) | boolean | A boolean that is true if the serverless function is executed for the first time (aka cold-start). | | Recommended |
-| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. [1] | `datasource` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.trigger`](../attributes-registry/faas.md) | string | Type of the trigger which caused this function invocation. [1] | `datasource` | `Required` |  |
+| [`faas.coldstart`](../attributes-registry/faas.md) | boolean | A boolean that is true if the serverless function is executed for the first time (aka cold-start). | | `Recommended` |  |
**[1]:** For the server/consumer span on the incoming side,
`faas.trigger` MUST be set.
@@ -159,11 +159,11 @@ the corresponding [FaaS resource attributes][] and [Cloud resource attributes][]
which the invoked FaaS instance reports about itself, if it's instrumented.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.invoked_name`](../attributes-registry/faas.md) | string | The name of the invoked function. [1] | `my-function` | Required |
-| [`faas.invoked_provider`](../attributes-registry/faas.md) | string | The cloud provider of the invoked function. [2] | `alibaba_cloud` | Required |
-| [`faas.invoked_region`](../attributes-registry/faas.md) | string | The cloud region of the invoked function. [3] | `eu-central-1` | Conditionally Required: [4] |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.invoked_name`](../attributes-registry/faas.md) | string | The name of the invoked function. [1] | `my-function` | `Required` |  |
+| [`faas.invoked_provider`](../attributes-registry/faas.md) | string | The cloud provider of the invoked function. [2] | `alibaba_cloud` | `Required` |  |
+| [`faas.invoked_region`](../attributes-registry/faas.md) | string | The cloud region of the invoked function. [3] | `eu-central-1` | `Conditionally Required` [4] |  |
**[1]:** SHOULD be equal to the `faas.name` resource attribute of the invoked function.
@@ -173,15 +173,15 @@ which the invoked FaaS instance reports about itself, if it's instrumented.
**[4]:** For some cloud providers, like AWS or GCP, the region in which a function is hosted is essential to uniquely identify the function and also part of its endpoint. Since it's part of the endpoint being called, the region is always known to clients. In these cases, `faas.invoked_region` MUST be set accordingly. If the region is unknown to the client or not required for identifying the invoked function, setting `faas.invoked_region` is optional.
-`faas.invoked_provider` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`faas.invoked_provider` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `alibaba_cloud` | Alibaba Cloud |
-| `aws` | Amazon Web Services |
-| `azure` | Microsoft Azure |
-| `gcp` | Google Cloud Platform |
-| `tencent_cloud` | Tencent Cloud |
+| Value | Description | Stability |
+|---|---|---|
+| `alibaba_cloud` | Alibaba Cloud |  |
+| `aws` | Amazon Web Services |  |
+| `azure` | Microsoft Azure |  |
+| `gcp` | Google Cloud Platform |  |
+| `tencent_cloud` | Tencent Cloud |  |
[FaaS resource attributes]: ../resource/faas.md
@@ -197,20 +197,20 @@ A datasource function is triggered as a response to some data source operation s
FaaS instrumentations that produce `faas` spans with trigger `datasource`, SHOULD use the following set of attributes.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.document.collection`](../attributes-registry/faas.md) | string | The name of the source on which the triggering operation was performed. For example, in Cloud Storage or S3 corresponds to the bucket name, and in Cosmos DB to the database name. | `myBucketName`; `myDbName` | Required |
-| [`faas.document.name`](../attributes-registry/faas.md) | string | The document name/table subjected to the operation. For example, in Cloud Storage or S3 is the name of the file, and in Cosmos DB the table name. | `myFile.txt`; `myTableName` | Recommended |
-| [`faas.document.operation`](../attributes-registry/faas.md) | string | Describes the type of the operation that was performed on the data. | `insert` | Required |
-| [`faas.document.time`](../attributes-registry/faas.md) | string | A string containing the time when the data was accessed in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` | Recommended |
-
-`faas.document.operation` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `insert` | When a new object is created. |
-| `edit` | When an object is modified. |
-| `delete` | When an object is deleted. |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.document.collection`](../attributes-registry/faas.md) | string | The name of the source on which the triggering operation was performed. For example, in Cloud Storage or S3 corresponds to the bucket name, and in Cosmos DB to the database name. | `myBucketName`; `myDbName` | `Required` |  |
+| [`faas.document.operation`](../attributes-registry/faas.md) | string | Describes the type of the operation that was performed on the data. | `insert` | `Required` |  |
+| [`faas.document.name`](../attributes-registry/faas.md) | string | The document name/table subjected to the operation. For example, in Cloud Storage or S3 is the name of the file, and in Cosmos DB the table name. | `myFile.txt`; `myTableName` | `Recommended` |  |
+| [`faas.document.time`](../attributes-registry/faas.md) | string | A string containing the time when the data was accessed in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` | `Recommended` |  |
+
+`faas.document.operation` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `insert` | When a new object is created. |  |
+| `edit` | When an object is modified. |  |
+| `delete` | When an object is deleted. |  |
### HTTP
@@ -230,10 +230,10 @@ This way, it is possible to correlate each individual message with its invocatio
A function is scheduled to be executed regularly. The following additional attributes are recommended.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`faas.cron`](../attributes-registry/faas.md) | string | A string containing the schedule period as [Cron Expression](https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.htm). | `0/5 * * * ? *` | Recommended |
-| [`faas.time`](../attributes-registry/faas.md) | string | A string containing the function invocation time in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.cron`](../attributes-registry/faas.md) | string | A string containing the schedule period as [Cron Expression](https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.htm). | `0/5 * * * ? *` | `Recommended` |  |
+| [`faas.time`](../attributes-registry/faas.md) | string | A string containing the function invocation time in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format expressed in [UTC](https://www.w3.org/TR/NOTE-datetime). | `2020-01-23T13:47:06Z` | `Recommended` |  |
### Other
diff --git a/docs/feature-flags/feature-flags-logs.md b/docs/feature-flags/feature-flags-logs.md
index e86df3b2f3..e9db9d3a2d 100644
--- a/docs/feature-flags/feature-flags-logs.md
+++ b/docs/feature-flags/feature-flags-logs.md
@@ -40,11 +40,11 @@ The table below indicates which attributes should be added to the
The event name MUST be `feature_flag`.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`feature_flag.key`](../attributes-registry/feature-flag.md) | string | The unique identifier of the feature flag. | `logo-color` | Recommended |
-| [`feature_flag.provider_name`](../attributes-registry/feature-flag.md) | string | The name of the service provider that performs the flag evaluation. | `Flag Manager` | Recommended |
-| [`feature_flag.variant`](../attributes-registry/feature-flag.md) | string | SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of the value can be used. [1] | `red`; `true`; `on` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`feature_flag.key`](../attributes-registry/feature-flag.md) | string | The unique identifier of the feature flag. | `logo-color` | `Recommended` |  |
+| [`feature_flag.provider_name`](../attributes-registry/feature-flag.md) | string | The name of the service provider that performs the flag evaluation. | `Flag Manager` | `Recommended` |  |
+| [`feature_flag.variant`](../attributes-registry/feature-flag.md) | string | SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of the value can be used. [1] | `red`; `true`; `on` | `Recommended` |  |
**[1]:** A semantic identifier, commonly referred to as a variant, provides a means
for referring to a value without including the value itself. This can
diff --git a/docs/feature-flags/feature-flags-spans.md b/docs/feature-flags/feature-flags-spans.md
index da0fa1cc1f..8a6548338e 100644
--- a/docs/feature-flags/feature-flags-spans.md
+++ b/docs/feature-flags/feature-flags-spans.md
@@ -44,11 +44,11 @@ A flag evaluation SHOULD be recorded as an Event on the span during which it occ
The event name MUST be `feature_flag`.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`feature_flag.key`](../attributes-registry/feature-flag.md) | string | The unique identifier of the feature flag. | `logo-color` | Required |
-| [`feature_flag.provider_name`](../attributes-registry/feature-flag.md) | string | The name of the service provider that performs the flag evaluation. | `Flag Manager` | Recommended |
-| [`feature_flag.variant`](../attributes-registry/feature-flag.md) | string | SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of the value can be used. [1] | `red`; `true`; `on` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`feature_flag.key`](../attributes-registry/feature-flag.md) | string | The unique identifier of the feature flag. | `logo-color` | `Required` |  |
+| [`feature_flag.provider_name`](../attributes-registry/feature-flag.md) | string | The name of the service provider that performs the flag evaluation. | `Flag Manager` | `Recommended` |  |
+| [`feature_flag.variant`](../attributes-registry/feature-flag.md) | string | SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of the value can be used. [1] | `red`; `true`; `on` | `Recommended` |  |
**[1]:** A semantic identifier, commonly referred to as a variant, provides a means
for referring to a value without including the value itself. This can
diff --git a/docs/general/attributes.md b/docs/general/attributes.md
index 9a74f6807f..2c6f13649d 100644
--- a/docs/general/attributes.md
+++ b/docs/general/attributes.md
@@ -67,10 +67,10 @@ Once the HTTP semantic conventions are declared stable, changes to the attribute
if they do not cause breaking changes to HTTP semantic conventions.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [2] | `80`; `8080`; `443` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [2] | `80`; `8080`; `443` | `Recommended` |  |
**[1]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
@@ -104,10 +104,10 @@ Once the HTTP semantic conventions are declared stable, changes to the attribute
if they do not cause breaking changes to HTTP semantic conventions.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`client.address`](../attributes-registry/client.md) | string | Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `client.example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`client.port`](../attributes-registry/client.md) | int | Client port number. [2] | `65123` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`client.address`](../attributes-registry/client.md) | string | Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `client.example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`client.port`](../attributes-registry/client.md) | int | Client port number. [2] | `65123` | `Recommended` |  |
**[1]:** When observed from the server side, and when communicating through an intermediary, `client.address` SHOULD represent the client address behind any intermediaries, for example proxies, if it's available.
@@ -126,10 +126,10 @@ This also covers unidirectional UDP flows and peer-to-peer communication where t
#### Source
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`source.address`](../attributes-registry/source.md) | string | Source address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `source.example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`source.port`](../attributes-registry/source.md) | int | Source port number | `3389`; `2888` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`source.address`](../attributes-registry/source.md) | string | Source address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `source.example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`source.port`](../attributes-registry/source.md) | int | Source port number | `3389`; `2888` | `Recommended` |  |
**[1]:** When observed from the destination side, and when communicating through an intermediary, `source.address` SHOULD represent the source address behind any intermediaries, for example proxies, if it's available.
@@ -139,10 +139,10 @@ This also covers unidirectional UDP flows and peer-to-peer communication where t
Destination fields capture details about the receiver of a network exchange/packet.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`destination.address`](../attributes-registry/destination.md) | string | Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `destination.example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`destination.port`](../attributes-registry/destination.md) | int | Destination port number | `3389`; `2888` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`destination.address`](../attributes-registry/destination.md) | string | Destination address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `destination.example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`destination.port`](../attributes-registry/destination.md) | int | Destination port number | `3389`; `2888` | `Recommended` |  |
**[1]:** When observed from the source side, and when communicating through an intermediary, `destination.address` SHOULD represent the destination address behind any intermediaries, for example proxies, if it's available.
@@ -157,16 +157,16 @@ Once the HTTP semantic conventions are declared stable, changes to the attribute
if they do not cause breaking changes to HTTP semantic conventions.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.local.address`](../attributes-registry/network.md) | string | Local address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`network.local.port`](../attributes-registry/network.md) | int | Local port number of the network connection. | `65123` | Recommended |
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | Recommended |
-| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [1] | `amqp`; `http`; `mqtt` | Recommended |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [2] | `1.1`; `2` | Recommended |
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `udp` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [4] | `ipv4`; `ipv6` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.local.address`](../attributes-registry/network.md) | string | Local address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`network.local.port`](../attributes-registry/network.md) | int | Local port number of the network connection. | `65123` | `Recommended` |  |
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | `Recommended` |  |
+| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [1] | `amqp`; `http`; `mqtt` | `Recommended` |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [2] | `1.1`; `2` | `Recommended` |  |
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `udp` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [4] | `ipv4`; `ipv6` | `Recommended` |  |
**[1]:** The value SHOULD be normalized to lowercase.
@@ -180,21 +180,21 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
**[4]:** The value SHOULD be normalized to lowercase.
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
#### `network.peer.*` and `network.local.*` attributes
@@ -239,50 +239,50 @@ Note that `network.local.*` attributes are not included in these examples since
#### Network connection and carrier attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.carrier.icc`](../attributes-registry/network.md) | string | The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network. | `DE` | Recommended |
-| [`network.carrier.mcc`](../attributes-registry/network.md) | string | The mobile carrier country code. | `310` | Recommended |
-| [`network.carrier.mnc`](../attributes-registry/network.md) | string | The mobile carrier network code. | `001` | Recommended |
-| [`network.carrier.name`](../attributes-registry/network.md) | string | The name of the mobile carrier. | `sprint` | Recommended |
-| [`network.connection.subtype`](../attributes-registry/network.md) | string | This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection. | `LTE` | Recommended |
-| [`network.connection.type`](../attributes-registry/network.md) | string | The internet connection type. | `wifi` | Recommended |
-
-`network.connection.subtype` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `gprs` | GPRS |
-| `edge` | EDGE |
-| `umts` | UMTS |
-| `cdma` | CDMA |
-| `evdo_0` | EVDO Rel. 0 |
-| `evdo_a` | EVDO Rev. A |
-| `cdma2000_1xrtt` | CDMA2000 1XRTT |
-| `hsdpa` | HSDPA |
-| `hsupa` | HSUPA |
-| `hspa` | HSPA |
-| `iden` | IDEN |
-| `evdo_b` | EVDO Rev. B |
-| `lte` | LTE |
-| `ehrpd` | EHRPD |
-| `hspap` | HSPAP |
-| `gsm` | GSM |
-| `td_scdma` | TD-SCDMA |
-| `iwlan` | IWLAN |
-| `nr` | 5G NR (New Radio) |
-| `nrnsa` | 5G NRNSA (New Radio Non-Standalone) |
-| `lte_ca` | LTE CA |
-
-`network.connection.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `wifi` | wifi |
-| `wired` | wired |
-| `cell` | cell |
-| `unavailable` | unavailable |
-| `unknown` | unknown |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.carrier.icc`](../attributes-registry/network.md) | string | The ISO 3166-1 alpha-2 2-character country code associated with the mobile carrier network. | `DE` | `Recommended` |  |
+| [`network.carrier.mcc`](../attributes-registry/network.md) | string | The mobile carrier country code. | `310` | `Recommended` |  |
+| [`network.carrier.mnc`](../attributes-registry/network.md) | string | The mobile carrier network code. | `001` | `Recommended` |  |
+| [`network.carrier.name`](../attributes-registry/network.md) | string | The name of the mobile carrier. | `sprint` | `Recommended` |  |
+| [`network.connection.subtype`](../attributes-registry/network.md) | string | This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection. | `LTE` | `Recommended` |  |
+| [`network.connection.type`](../attributes-registry/network.md) | string | The internet connection type. | `wifi` | `Recommended` |  |
+
+`network.connection.subtype` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `gprs` | GPRS |  |
+| `edge` | EDGE |  |
+| `umts` | UMTS |  |
+| `cdma` | CDMA |  |
+| `evdo_0` | EVDO Rel. 0 |  |
+| `evdo_a` | EVDO Rev. A |  |
+| `cdma2000_1xrtt` | CDMA2000 1XRTT |  |
+| `hsdpa` | HSDPA |  |
+| `hsupa` | HSUPA |  |
+| `hspa` | HSPA |  |
+| `iden` | IDEN |  |
+| `evdo_b` | EVDO Rev. B |  |
+| `lte` | LTE |  |
+| `ehrpd` | EHRPD |  |
+| `hspap` | HSPAP |  |
+| `gsm` | GSM |  |
+| `td_scdma` | TD-SCDMA |  |
+| `iwlan` | IWLAN |  |
+| `nr` | 5G NR (New Radio) |  |
+| `nrnsa` | 5G NRNSA (New Radio Non-Standalone) |  |
+| `lte_ca` | LTE CA |  |
+
+`network.connection.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `wifi` | wifi |  |
+| `wired` | wired |  |
+| `cell` | cell |  |
+| `unavailable` | unavailable |  |
+| `unknown` | unknown |  |
For `Unix` and `pipe`, since the connection goes over the file system instead of being directly to a known peer, `server.address` is the only attribute that usually makes sense (see description of `server.address` below).
@@ -294,9 +294,9 @@ Users can define what the name of a service is based on their particular semanti
Instrumentations SHOULD provide a way for users to configure this name.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `peer.service` | string | The [`service.name`](/docs/resource/README.md#service) of the remote service. SHOULD be equal to the actual `service.name` resource attribute of the remote service if any. | `AuthTokenCache` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `peer.service` | string | The [`service.name`](/docs/resource/README.md#service) of the remote service. SHOULD be equal to the actual `service.name` resource attribute of the remote service if any. | `AuthTokenCache` | `Recommended` |  |
Examples of `peer.service` that users may specify:
@@ -309,11 +309,11 @@ Examples of `peer.service` that users may specify:
These attributes may be used for any operation with an authenticated and/or authorized enduser.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`enduser.id`](../attributes-registry/enduser.md) | string | Username or client_id extracted from the access token or [Authorization](https://tools.ietf.org/html/rfc7235#section-4.2) header in the inbound request from outside the system. | `username` | Recommended |
-| [`enduser.role`](../attributes-registry/enduser.md) | string | Actual/assumed role the client is making the request under extracted from token or application security context. | `admin` | Recommended |
-| [`enduser.scope`](../attributes-registry/enduser.md) | string | Scopes or granted authorities the client currently possesses extracted from token or application security context. The value would come from the scope associated with an [OAuth 2.0 Access Token](https://tools.ietf.org/html/rfc6749#section-3.3) or an attribute value in a [SAML 2.0 Assertion](http://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html). | `read:message, write:files` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`enduser.id`](../attributes-registry/enduser.md) | string | Username or client_id extracted from the access token or [Authorization](https://tools.ietf.org/html/rfc7235#section-4.2) header in the inbound request from outside the system. | `username` | `Recommended` |  |
+| [`enduser.role`](../attributes-registry/enduser.md) | string | Actual/assumed role the client is making the request under extracted from token or application security context. | `admin` | `Recommended` |  |
+| [`enduser.scope`](../attributes-registry/enduser.md) | string | Scopes or granted authorities the client currently possesses extracted from token or application security context. The value would come from the scope associated with an [OAuth 2.0 Access Token](https://tools.ietf.org/html/rfc6749#section-3.3) or an attribute value in a [SAML 2.0 Assertion](http://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0.html). | `read:message, write:files` | `Recommended` |  |
These attributes describe the authenticated user driving the user agent making requests to the instrumented
@@ -356,10 +356,10 @@ These attributes may be used for any operation to store information about
a thread that started a span.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`thread.id`](../attributes-registry/thread.md) | int | Current "managed" thread ID (as opposed to OS thread ID). | `42` | Recommended |
-| [`thread.name`](../attributes-registry/thread.md) | string | Current thread name. | `main` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`thread.id`](../attributes-registry/thread.md) | int | Current "managed" thread ID (as opposed to OS thread ID). | `42` | `Recommended` |  |
+| [`thread.name`](../attributes-registry/thread.md) | string | Current thread name. | `main` | `Recommended` |  |
Examples of where `thread.id` and `thread.name` can be extracted from:
@@ -382,14 +382,14 @@ The attributes listed below allow to report this unit of code and therefore to p
about the span.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`code.column`](../attributes-registry/code.md) | int | The column number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `16` | Recommended |
-| [`code.filepath`](../attributes-registry/code.md) | string | The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). | `/usr/local/MyApplication/content_root/app/index.php` | Recommended |
-| [`code.function`](../attributes-registry/code.md) | string | The method or function name, or equivalent (usually rightmost part of the code unit's name). | `serveRequest` | Recommended |
-| [`code.lineno`](../attributes-registry/code.md) | int | The line number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `42` | Recommended |
-| [`code.namespace`](../attributes-registry/code.md) | string | 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. | `com.example.MyHttpService` | Recommended |
-| [`code.stacktrace`](../attributes-registry/code.md) | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`code.column`](../attributes-registry/code.md) | int | The column number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `16` | `Recommended` |  |
+| [`code.filepath`](../attributes-registry/code.md) | string | The source code file name that identifies the code unit as uniquely as possible (preferably an absolute file path). | `/usr/local/MyApplication/content_root/app/index.php` | `Recommended` |  |
+| [`code.function`](../attributes-registry/code.md) | string | The method or function name, or equivalent (usually rightmost part of the code unit's name). | `serveRequest` | `Recommended` |  |
+| [`code.lineno`](../attributes-registry/code.md) | int | The line number in `code.filepath` best representing the operation. It SHOULD point within the code unit named in `code.function`. | `42` | `Recommended` |  |
+| [`code.namespace`](../attributes-registry/code.md) | string | 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. | `com.example.MyHttpService` | `Recommended` |  |
+| [`code.stacktrace`](../attributes-registry/code.md) | string | A stacktrace as a string in the natural representation for the language runtime. The representation is to be determined and documented by each language SIG. | `at com.example.GenerateTrace.methodB(GenerateTrace.java:13)\n at com.example.GenerateTrace.methodA(GenerateTrace.java:9)\n at com.example.GenerateTrace.main(GenerateTrace.java:5)` | `Opt-In` |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/general/events.md b/docs/general/events.md
index 51f4ef29d9..8f3e51c2f8 100644
--- a/docs/general/events.md
+++ b/docs/general/events.md
@@ -53,9 +53,9 @@ the event names have low-cardinality, so care must be taken to use fields
that identify the class of Events but not the instance of the Event.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `event.name` | string | Identifies the class / type of event. [1] | `browser.mouse.click`; `device.app.lifecycle` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `event.name` | string | Identifies the class / type of event. [1] | `browser.mouse.click`; `device.app.lifecycle` | `Required` |  |
**[1]:** Event names are subject to the same rules as [attribute names](https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/common/attribute-naming.md). Notably, event names are namespaced to avoid collisions and provide a clean separation of semantics for events in separate domains like browser, mobile, and kubernetes.
diff --git a/docs/general/logs.md b/docs/general/logs.md
index 152950057a..2debe8fc08 100644
--- a/docs/general/logs.md
+++ b/docs/general/logs.md
@@ -36,9 +36,9 @@ OpenTelemetry also defines the concept of overarching [Resources](https://github
These attributes may be used for identifying a Log Record.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `log.record.uid` | string | A unique identifier for the Log Record. [1] | `01ARZ3NDEKTSV4RRFFQ69G5FAV` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `log.record.uid` | string | A unique identifier for the Log Record. [1] | `01ARZ3NDEKTSV4RRFFQ69G5FAV` | `Opt-In` |  |
**[1]:** If an id is provided, other log records with the same id will be considered duplicates and can be removed safely. This means, that two distinguishable log records MUST have different values.
The id MAY be an [Universally Unique Lexicographically Sortable Identifier (ULID)](https://github.com/ulid/spec), but other identifiers (e.g. UUID) may be used as needed.
@@ -57,12 +57,12 @@ As such, these should be recorded as Log Record attributes when applicable. They
**Description:** A file to which log was emitted.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `log.file.name` | string | The basename of the file. | `audit.log` | Recommended |
-| `log.file.name_resolved` | string | The basename of the file, with symlinks resolved. | `uuid.log` | Opt-In |
-| `log.file.path` | string | The full path to the file. | `/var/log/mysql/audit.log` | Opt-In |
-| `log.file.path_resolved` | string | The full path to the file, with symlinks resolved. | `/var/lib/docker/uuid.log` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `log.file.name` | string | The basename of the file. | `audit.log` | `Recommended` |  |
+| `log.file.name_resolved` | string | The basename of the file, with symlinks resolved. | `uuid.log` | `Opt-In` |  |
+| `log.file.path` | string | The full path to the file. | `/var/log/mysql/audit.log` | `Opt-In` |  |
+| `log.file.path_resolved` | string | The full path to the file, with symlinks resolved. | `/var/lib/docker/uuid.log` | `Opt-In` |  |
### I/O Stream
@@ -70,16 +70,16 @@ As such, these should be recorded as Log Record attributes when applicable. They
**Description:** The I/O stream to which the log was emitted.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `log.iostream` | string | The stream associated with the log. See below for a list of well-known values. | `stdout` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `log.iostream` | string | The stream associated with the log. See below for a list of well-known values. | `stdout` | `Opt-In` |  |
`log.iostream` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `stdout` | Logs from stdout stream |
-| `stderr` | Events from stderr stream |
+| Value | Description | Stability |
+|---|---|---|
+| `stdout` | Logs from stdout stream |  |
+| `stderr` | Events from stderr stream |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/general/session.md b/docs/general/session.md
index 9c58d3fc44..8b0fa3d2f0 100644
--- a/docs/general/session.md
+++ b/docs/general/session.md
@@ -18,10 +18,10 @@ backends can link the two sessions.
## Attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `session.id` | string | A unique id to identify a session. | `00112233-4455-6677-8899-aabbccddeeff` | Opt-In |
-| `session.previous_id` | string | The previous `session.id` for this user, when known. | `00112233-4455-6677-8899-aabbccddeeff` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `session.id` | string | A unique id to identify a session. | `00112233-4455-6677-8899-aabbccddeeff` | `Opt-In` |  |
+| `session.previous_id` | string | The previous `session.id` for this user, when known. | `00112233-4455-6677-8899-aabbccddeeff` | `Opt-In` |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/general/trace-compatibility.md b/docs/general/trace-compatibility.md
index bfac2262af..abdc34d4f8 100644
--- a/docs/general/trace-compatibility.md
+++ b/docs/general/trace-compatibility.md
@@ -25,18 +25,18 @@ between a child Span and a parent Span, as defined by
[OpenTracing](https://github.com/opentracing/specification/blob/master/specification.md).
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `opentracing.ref_type` | string | Parent-child Reference type [1] | `child_of` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `opentracing.ref_type` | string | Parent-child Reference type [1] | `child_of` | `Recommended` |  |
**[1]:** The causal relationship between a child Span and a parent Span.
`opentracing.ref_type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `child_of` | The parent Span depends on the child Span in some capacity |
-| `follows_from` | The parent Span doesn't depend in any way on the result of the child Span |
+| Value | Description | Stability |
+|---|---|---|
+| `child_of` | The parent Span depends on the child Span in some capacity |  |
+| `follows_from` | The parent Span doesn't depend in any way on the result of the child Span |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/graphql/graphql-spans.md b/docs/graphql/graphql-spans.md
index fb94a7b25e..98d62a4b61 100644
--- a/docs/graphql/graphql-spans.md
+++ b/docs/graphql/graphql-spans.md
@@ -15,21 +15,21 @@ span SHOULD be named ``. When ``
MAY be used as span name.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `graphql.document` | string | The GraphQL document being executed. [1] | `query findBookById { bookById(id: ?) { name } }` | Recommended |
-| `graphql.operation.name` | string | The name of the operation being executed. | `findBookById` | Recommended |
-| `graphql.operation.type` | string | The type of the operation being executed. | `query`; `mutation`; `subscription` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `graphql.document` | string | The GraphQL document being executed. [1] | `query findBookById { bookById(id: ?) { name } }` | `Recommended` |  |
+| `graphql.operation.name` | string | The name of the operation being executed. | `findBookById` | `Recommended` |  |
+| `graphql.operation.type` | string | The type of the operation being executed. | `query`; `mutation`; `subscription` | `Recommended` |  |
**[1]:** The value may be sanitized to exclude sensitive information.
`graphql.operation.type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `query` | GraphQL query |
-| `mutation` | GraphQL mutation |
-| `subscription` | GraphQL subscription |
+| Value | Description | Stability |
+|---|---|---|
+| `query` | GraphQL query |  |
+| `mutation` | GraphQL mutation |  |
+| `subscription` | GraphQL subscription |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/http/http-metrics.md b/docs/http/http-metrics.md
index f6e5d7ec3c..f61c862e63 100644
--- a/docs/http/http-metrics.md
+++ b/docs/http/http-metrics.md
@@ -59,8 +59,6 @@ operations. By adding HTTP attributes to metric events it allows for finely tune
### Metric: `http.server.request.duration`
-**Status**: [Stable][DocumentStatus]
-
This metric is required.
When this metric is reported alongside an HTTP server span, the metric value SHOULD be the same as the HTTP server span duration.
@@ -70,25 +68,42 @@ This metric SHOULD be specified with
of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `http.server.request.duration` | Histogram | `s` | Duration of HTTP server requests. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `http.server.request.duration` | Histogram | `s` | Duration of HTTP server requests. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [1] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | Conditionally Required: If request has ended with an error. |
-| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [2] | `GET`; `POST`; `HEAD` | Required |
-| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | Conditionally Required: If and only if one was received/sent. |
-| [`http.route`](../attributes-registry/http.md) | string | The matched route, that is, the path template in the format used by the respective server framework. [3] | `/users/:userID?`; `{controller}/{action}/{id?}` | Conditionally Required: If and only if it's available |
-| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [4] | `http`; `spdy` | Conditionally Required: [5] |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [6] | `1.0`; `1.1`; `2`; `3` | Recommended |
-| [`server.address`](../attributes-registry/server.md) | string | Name of the local HTTP server that received the request. [7] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Opt-In |
-| [`server.port`](../attributes-registry/server.md) | int | Port of the local HTTP server that received the request. [8] | `80`; `8080`; `443` | Opt-In |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. [9] | `http`; `https` | Required |
-
-**[1]:** If the request fails with an error before response status code was sent or received,
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [1] | `GET`; `POST`; `HEAD` | `Required` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. [2] | `http`; `https` | `Required` |  |
+| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [3] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | `Conditionally Required` If request has ended with an error. |  |
+| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | `Conditionally Required` If and only if one was received/sent. |  |
+| [`http.route`](../attributes-registry/http.md) | string | The matched route, that is, the path template in the format used by the respective server framework. [4] | `/users/:userID?`; `{controller}/{action}/{id?}` | `Conditionally Required` If and only if it's available |  |
+| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [5] | `http`; `spdy` | `Conditionally Required` [6] |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [7] | `1.0`; `1.1`; `2`; `3` | `Recommended` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Name of the local HTTP server that received the request. [8] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Opt-In` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port of the local HTTP server that received the request. [9] | `80`; `8080`; `443` | `Opt-In` |  |
+
+**[1]:** HTTP request method value SHOULD be "known" to the instrumentation.
+By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
+and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
+
+If the HTTP request method is not known to instrumentation, it MUST set the `http.request.method` attribute to `_OTHER`.
+
+If the HTTP instrumentation could end up converting valid HTTP request methods to `_OTHER`, then it MUST provide a way to override
+the list of known HTTP methods. If this override is done via environment variable, then the environment variable MUST be named
+OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods
+(this list MUST be a full override of the default known method, it is not a list of known methods in addition to the defaults).
+
+HTTP method names are case-sensitive and `http.request.method` attribute value MUST match a known HTTP method name exactly.
+Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
+Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
+
+**[2]:** The scheme of the original client request, if known (e.g. from [Forwarded#proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded#proto), [X-Forwarded-Proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-Proto), or a similar header). Otherwise, the scheme of the immediate peer request.
+
+**[3]:** If the request fails with an error before response status code was sent or received,
`error.type` SHOULD be set to exception type (its fully-qualified class name, if applicable)
or a component-specific low cardinality error identifier.
@@ -105,83 +120,64 @@ additional filters are applied.
If the request has completed successfully, instrumentations SHOULD NOT set `error.type`.
-**[2]:** HTTP request method value SHOULD be "known" to the instrumentation.
-By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
-and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
-
-If the HTTP request method is not known to instrumentation, it MUST set the `http.request.method` attribute to `_OTHER`.
-
-If the HTTP instrumentation could end up converting valid HTTP request methods to `_OTHER`, then it MUST provide a way to override
-the list of known HTTP methods. If this override is done via environment variable, then the environment variable MUST be named
-OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods
-(this list MUST be a full override of the default known method, it is not a list of known methods in addition to the defaults).
-
-HTTP method names are case-sensitive and `http.request.method` attribute value MUST match a known HTTP method name exactly.
-Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
-Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
-
-**[3]:** MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
+**[4]:** MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
SHOULD include the [application root](/docs/http/http-spans.md#http-server-definitions) if there is one.
-**[4]:** The value SHOULD be normalized to lowercase.
+**[5]:** The value SHOULD be normalized to lowercase.
-**[5]:** If not `http` and `network.protocol.version` is set.
+**[6]:** If not `http` and `network.protocol.version` is set.
-**[6]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
+**[7]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
-**[7]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
+**[8]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
> **Warning**
> Since this attribute is based on HTTP headers, opting in to it may allow an attacker
> to trigger cardinality limits, degrading the usefulness of the metric.
-**[8]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
+**[9]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
> **Warning**
> Since this attribute is based on HTTP headers, opting in to it may allow an attacker
> to trigger cardinality limits, degrading the usefulness of the metric.
-**[9]:** The scheme of the original client request, if known (e.g. from [Forwarded#proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded#proto), [X-Forwarded-Proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-Proto), or a similar header). Otherwise, the scheme of the immediate peer request.
-
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
-
-`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `CONNECT` | CONNECT method. |
-| `DELETE` | DELETE method. |
-| `GET` | GET method. |
-| `HEAD` | HEAD method. |
-| `OPTIONS` | OPTIONS method. |
-| `PATCH` | PATCH method. |
-| `POST` | POST method. |
-| `PUT` | PUT method. |
-| `TRACE` | TRACE method. |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |
+`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
+
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
### Metric: `http.server.active_requests`
-**Status**: [Experimental][DocumentStatus]
-
This metric is optional.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `http.server.active_requests` | UpDownCounter | `{request}` | Number of active HTTP server requests. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `http.server.active_requests` | UpDownCounter | `{request}` | Number of active HTTP server requests. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [1] | `GET`; `POST`; `HEAD` | Required |
-| [`server.address`](../attributes-registry/server.md) | string | Name of the local HTTP server that received the request. [2] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Opt-In |
-| [`server.port`](../attributes-registry/server.md) | int | Port of the local HTTP server that received the request. [3] | `80`; `8080`; `443` | Opt-In |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [1] | `GET`; `POST`; `HEAD` | `Required` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | `Required` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Name of the local HTTP server that received the request. [2] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Opt-In` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port of the local HTTP server that received the request. [3] | `80`; `8080`; `443` | `Opt-In` |  |
**[1]:** HTTP request method value SHOULD be "known" to the instrumentation.
By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
@@ -208,50 +204,65 @@ Tracing instrumentations that do so, MUST also set `http.request.method_original
> Since this attribute is based on HTTP headers, opting in to it may allow an attacker
> to trigger cardinality limits, degrading the usefulness of the metric.
-`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `CONNECT` | CONNECT method. |
-| `DELETE` | DELETE method. |
-| `GET` | GET method. |
-| `HEAD` | HEAD method. |
-| `OPTIONS` | OPTIONS method. |
-| `PATCH` | PATCH method. |
-| `POST` | POST method. |
-| `PUT` | PUT method. |
-| `TRACE` | TRACE method. |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |
+`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
### Metric: `http.server.request.body.size`
-**Status**: [Experimental][DocumentStatus]
-
This metric is optional.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `http.server.request.body.size` | Histogram | `By` | Size of HTTP server request bodies. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `http.server.request.body.size` | Histogram | `By` | Size of HTTP server request bodies. [1] |  |
**[1]:** The size of the request payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [1] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | Conditionally Required: If request has ended with an error. |
-| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [2] | `GET`; `POST`; `HEAD` | Required |
-| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | Conditionally Required: If and only if one was received/sent. |
-| [`http.route`](../attributes-registry/http.md) | string | The matched route, that is, the path template in the format used by the respective server framework. [3] | `/users/:userID?`; `{controller}/{action}/{id?}` | Conditionally Required: If and only if it's available |
-| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [4] | `http`; `spdy` | Conditionally Required: [5] |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [6] | `1.0`; `1.1`; `2`; `3` | Recommended |
-| [`server.address`](../attributes-registry/server.md) | string | Name of the local HTTP server that received the request. [7] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Opt-In |
-| [`server.port`](../attributes-registry/server.md) | int | Port of the local HTTP server that received the request. [8] | `80`; `8080`; `443` | Opt-In |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. [9] | `http`; `https` | Required |
-
-**[1]:** If the request fails with an error before response status code was sent or received,
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [1] | `GET`; `POST`; `HEAD` | `Required` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. [2] | `http`; `https` | `Required` |  |
+| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [3] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | `Conditionally Required` If request has ended with an error. |  |
+| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | `Conditionally Required` If and only if one was received/sent. |  |
+| [`http.route`](../attributes-registry/http.md) | string | The matched route, that is, the path template in the format used by the respective server framework. [4] | `/users/:userID?`; `{controller}/{action}/{id?}` | `Conditionally Required` If and only if it's available |  |
+| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [5] | `http`; `spdy` | `Conditionally Required` [6] |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [7] | `1.0`; `1.1`; `2`; `3` | `Recommended` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Name of the local HTTP server that received the request. [8] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Opt-In` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port of the local HTTP server that received the request. [9] | `80`; `8080`; `443` | `Opt-In` |  |
+
+**[1]:** HTTP request method value SHOULD be "known" to the instrumentation.
+By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
+and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
+
+If the HTTP request method is not known to instrumentation, it MUST set the `http.request.method` attribute to `_OTHER`.
+
+If the HTTP instrumentation could end up converting valid HTTP request methods to `_OTHER`, then it MUST provide a way to override
+the list of known HTTP methods. If this override is done via environment variable, then the environment variable MUST be named
+OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods
+(this list MUST be a full override of the default known method, it is not a list of known methods in addition to the defaults).
+
+HTTP method names are case-sensitive and `http.request.method` attribute value MUST match a known HTTP method name exactly.
+Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
+Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
+
+**[2]:** The scheme of the original client request, if known (e.g. from [Forwarded#proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded#proto), [X-Forwarded-Proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-Proto), or a similar header). Otherwise, the scheme of the immediate peer request.
+
+**[3]:** If the request fails with an error before response status code was sent or received,
`error.type` SHOULD be set to exception type (its fully-qualified class name, if applicable)
or a component-specific low cardinality error identifier.
@@ -268,92 +279,90 @@ additional filters are applied.
If the request has completed successfully, instrumentations SHOULD NOT set `error.type`.
-**[2]:** HTTP request method value SHOULD be "known" to the instrumentation.
-By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
-and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
-
-If the HTTP request method is not known to instrumentation, it MUST set the `http.request.method` attribute to `_OTHER`.
-
-If the HTTP instrumentation could end up converting valid HTTP request methods to `_OTHER`, then it MUST provide a way to override
-the list of known HTTP methods. If this override is done via environment variable, then the environment variable MUST be named
-OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods
-(this list MUST be a full override of the default known method, it is not a list of known methods in addition to the defaults).
-
-HTTP method names are case-sensitive and `http.request.method` attribute value MUST match a known HTTP method name exactly.
-Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
-Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
-
-**[3]:** MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
+**[4]:** MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
SHOULD include the [application root](/docs/http/http-spans.md#http-server-definitions) if there is one.
-**[4]:** The value SHOULD be normalized to lowercase.
+**[5]:** The value SHOULD be normalized to lowercase.
-**[5]:** If not `http` and `network.protocol.version` is set.
+**[6]:** If not `http` and `network.protocol.version` is set.
-**[6]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
+**[7]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
-**[7]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
+**[8]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
> **Warning**
> Since this attribute is based on HTTP headers, opting in to it may allow an attacker
> to trigger cardinality limits, degrading the usefulness of the metric.
-**[8]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
+**[9]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
> **Warning**
> Since this attribute is based on HTTP headers, opting in to it may allow an attacker
> to trigger cardinality limits, degrading the usefulness of the metric.
-**[9]:** The scheme of the original client request, if known (e.g. from [Forwarded#proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded#proto), [X-Forwarded-Proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-Proto), or a similar header). Otherwise, the scheme of the immediate peer request.
-
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
-
-`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `CONNECT` | CONNECT method. |
-| `DELETE` | DELETE method. |
-| `GET` | GET method. |
-| `HEAD` | HEAD method. |
-| `OPTIONS` | OPTIONS method. |
-| `PATCH` | PATCH method. |
-| `POST` | POST method. |
-| `PUT` | PUT method. |
-| `TRACE` | TRACE method. |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |
+`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
+
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
### Metric: `http.server.response.body.size`
-**Status**: [Experimental][DocumentStatus]
-
This metric is optional.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `http.server.response.body.size` | Histogram | `By` | Size of HTTP server response bodies. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `http.server.response.body.size` | Histogram | `By` | Size of HTTP server response bodies. [1] |  |
**[1]:** The size of the response payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [1] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | Conditionally Required: If request has ended with an error. |
-| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [2] | `GET`; `POST`; `HEAD` | Required |
-| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | Conditionally Required: If and only if one was received/sent. |
-| [`http.route`](../attributes-registry/http.md) | string | The matched route, that is, the path template in the format used by the respective server framework. [3] | `/users/:userID?`; `{controller}/{action}/{id?}` | Conditionally Required: If and only if it's available |
-| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [4] | `http`; `spdy` | Conditionally Required: [5] |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [6] | `1.0`; `1.1`; `2`; `3` | Recommended |
-| [`server.address`](../attributes-registry/server.md) | string | Name of the local HTTP server that received the request. [7] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Opt-In |
-| [`server.port`](../attributes-registry/server.md) | int | Port of the local HTTP server that received the request. [8] | `80`; `8080`; `443` | Opt-In |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. [9] | `http`; `https` | Required |
-
-**[1]:** If the request fails with an error before response status code was sent or received,
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [1] | `GET`; `POST`; `HEAD` | `Required` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. [2] | `http`; `https` | `Required` |  |
+| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [3] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | `Conditionally Required` If request has ended with an error. |  |
+| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | `Conditionally Required` If and only if one was received/sent. |  |
+| [`http.route`](../attributes-registry/http.md) | string | The matched route, that is, the path template in the format used by the respective server framework. [4] | `/users/:userID?`; `{controller}/{action}/{id?}` | `Conditionally Required` If and only if it's available |  |
+| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [5] | `http`; `spdy` | `Conditionally Required` [6] |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [7] | `1.0`; `1.1`; `2`; `3` | `Recommended` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Name of the local HTTP server that received the request. [8] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Opt-In` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port of the local HTTP server that received the request. [9] | `80`; `8080`; `443` | `Opt-In` |  |
+
+**[1]:** HTTP request method value SHOULD be "known" to the instrumentation.
+By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
+and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
+
+If the HTTP request method is not known to instrumentation, it MUST set the `http.request.method` attribute to `_OTHER`.
+
+If the HTTP instrumentation could end up converting valid HTTP request methods to `_OTHER`, then it MUST provide a way to override
+the list of known HTTP methods. If this override is done via environment variable, then the environment variable MUST be named
+OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods
+(this list MUST be a full override of the default known method, it is not a list of known methods in addition to the defaults).
+
+HTTP method names are case-sensitive and `http.request.method` attribute value MUST match a known HTTP method name exactly.
+Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
+Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
+
+**[2]:** The scheme of the original client request, if known (e.g. from [Forwarded#proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded#proto), [X-Forwarded-Proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-Proto), or a similar header). Otherwise, the scheme of the immediate peer request.
+
+**[3]:** If the request fails with an error before response status code was sent or received,
`error.type` SHOULD be set to exception type (its fully-qualified class name, if applicable)
or a component-specific low cardinality error identifier.
@@ -370,70 +379,51 @@ additional filters are applied.
If the request has completed successfully, instrumentations SHOULD NOT set `error.type`.
-**[2]:** HTTP request method value SHOULD be "known" to the instrumentation.
-By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
-and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
-
-If the HTTP request method is not known to instrumentation, it MUST set the `http.request.method` attribute to `_OTHER`.
-
-If the HTTP instrumentation could end up converting valid HTTP request methods to `_OTHER`, then it MUST provide a way to override
-the list of known HTTP methods. If this override is done via environment variable, then the environment variable MUST be named
-OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods
-(this list MUST be a full override of the default known method, it is not a list of known methods in addition to the defaults).
-
-HTTP method names are case-sensitive and `http.request.method` attribute value MUST match a known HTTP method name exactly.
-Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
-Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
-
-**[3]:** MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
+**[4]:** MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
SHOULD include the [application root](/docs/http/http-spans.md#http-server-definitions) if there is one.
-**[4]:** The value SHOULD be normalized to lowercase.
+**[5]:** The value SHOULD be normalized to lowercase.
-**[5]:** If not `http` and `network.protocol.version` is set.
+**[6]:** If not `http` and `network.protocol.version` is set.
-**[6]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
+**[7]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
-**[7]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
+**[8]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
> **Warning**
> Since this attribute is based on HTTP headers, opting in to it may allow an attacker
> to trigger cardinality limits, degrading the usefulness of the metric.
-**[8]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
+**[9]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
> **Warning**
> Since this attribute is based on HTTP headers, opting in to it may allow an attacker
> to trigger cardinality limits, degrading the usefulness of the metric.
-**[9]:** The scheme of the original client request, if known (e.g. from [Forwarded#proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded#proto), [X-Forwarded-Proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-Proto), or a similar header). Otherwise, the scheme of the immediate peer request.
-
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
-
-`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `CONNECT` | CONNECT method. |
-| `DELETE` | DELETE method. |
-| `GET` | GET method. |
-| `HEAD` | HEAD method. |
-| `OPTIONS` | OPTIONS method. |
-| `PATCH` | PATCH method. |
-| `POST` | POST method. |
-| `PUT` | PUT method. |
-| `TRACE` | TRACE method. |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |
+`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
+
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
## HTTP Client
### Metric: `http.client.request.duration`
-**Status**: [Stable][DocumentStatus]
-
This metric is required.
When this metric is reported alongside an HTTP client span, the metric value SHOULD be the same as the HTTP client span duration.
@@ -443,41 +433,24 @@ This metric SHOULD be specified with
of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `http.client.request.duration` | Histogram | `s` | Duration of HTTP client requests. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `http.client.request.duration` | Histogram | `s` | Duration of HTTP client requests. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [1] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | Conditionally Required: If request has ended with an error. |
-| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [2] | `GET`; `POST`; `HEAD` | Required |
-| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | Conditionally Required: If and only if one was received/sent. |
-| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [3] | `http`; `spdy` | Conditionally Required: [4] |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [5] | `1.0`; `1.1`; `2`; `3` | Recommended |
-| [`server.address`](../attributes-registry/server.md) | string | Host identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [6] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Required |
-| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [7] | `80`; `8080`; `443` | Required |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | Opt-In |
-
-**[1]:** If the request fails with an error before response status code was sent or received,
-`error.type` SHOULD be set to exception type (its fully-qualified class name, if applicable)
-or a component-specific low cardinality error identifier.
-
-If response status code was sent or received and status indicates an error according to [HTTP span status definition](/docs/http/http-spans.md),
-`error.type` SHOULD be set to the status code number (represented as a string), an exception type (if thrown) or a component-specific error identifier.
-
-The `error.type` value SHOULD be predictable and SHOULD have low cardinality.
-Instrumentations SHOULD document the list of errors they report.
-
-The cardinality of `error.type` within one instrumentation library SHOULD be low, but
-telemetry consumers that aggregate data from multiple instrumentation libraries and applications
-should be prepared for `error.type` to have high cardinality at query time, when no
-additional filters are applied.
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [1] | `GET`; `POST`; `HEAD` | `Required` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Host identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [2] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Required` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [3] | `80`; `8080`; `443` | `Required` |  |
+| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [4] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | `Conditionally Required` If request has ended with an error. |  |
+| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | `Conditionally Required` If and only if one was received/sent. |  |
+| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [5] | `http`; `spdy` | `Conditionally Required` [6] |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [7] | `1.0`; `1.1`; `2`; `3` | `Recommended` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | `Opt-In` |  |
-If the request has completed successfully, instrumentations SHOULD NOT set `error.type`.
-
-**[2]:** HTTP request method value SHOULD be "known" to the instrumentation.
+**[1]:** HTTP request method value SHOULD be "known" to the instrumentation.
By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
@@ -492,82 +465,80 @@ HTTP method names are case-sensitive and `http.request.method` attribute value M
Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
-**[3]:** The value SHOULD be normalized to lowercase.
+**[2]:** If an HTTP client request is explicitly made to an IP address, e.g. `http://x.x.x.x:8080`, then `server.address` SHOULD be the IP address `x.x.x.x`. A DNS lookup SHOULD NOT be used.
-**[4]:** If not `http` and `network.protocol.version` is set.
+**[3]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-**[5]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
+**[4]:** If the request fails with an error before response status code was sent or received,
+`error.type` SHOULD be set to exception type (its fully-qualified class name, if applicable)
+or a component-specific low cardinality error identifier.
-**[6]:** If an HTTP client request is explicitly made to an IP address, e.g. `http://x.x.x.x:8080`, then `server.address` SHOULD be the IP address `x.x.x.x`. A DNS lookup SHOULD NOT be used.
+If response status code was sent or received and status indicates an error according to [HTTP span status definition](/docs/http/http-spans.md),
+`error.type` SHOULD be set to the status code number (represented as a string), an exception type (if thrown) or a component-specific error identifier.
-**[7]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
+The `error.type` value SHOULD be predictable and SHOULD have low cardinality.
+Instrumentations SHOULD document the list of errors they report.
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+The cardinality of `error.type` within one instrumentation library SHOULD be low, but
+telemetry consumers that aggregate data from multiple instrumentation libraries and applications
+should be prepared for `error.type` to have high cardinality at query time, when no
+additional filters are applied.
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
+If the request has completed successfully, instrumentations SHOULD NOT set `error.type`.
-`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+**[5]:** The value SHOULD be normalized to lowercase.
-| Value | Description |
-|---|---|
-| `CONNECT` | CONNECT method. |
-| `DELETE` | DELETE method. |
-| `GET` | GET method. |
-| `HEAD` | HEAD method. |
-| `OPTIONS` | OPTIONS method. |
-| `PATCH` | PATCH method. |
-| `POST` | POST method. |
-| `PUT` | PUT method. |
-| `TRACE` | TRACE method. |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |
+**[6]:** If not `http` and `network.protocol.version` is set.
+
+**[7]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
+
+`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
+
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
### Metric: `http.client.request.body.size`
-**Status**: [Experimental][DocumentStatus]
-
This metric is optional.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `http.client.request.body.size` | Histogram | `By` | Size of HTTP client request bodies. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `http.client.request.body.size` | Histogram | `By` | Size of HTTP client request bodies. [1] |  |
**[1]:** The size of the request payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [1] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | Conditionally Required: If request has ended with an error. |
-| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [2] | `GET`; `POST`; `HEAD` | Required |
-| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | Conditionally Required: If and only if one was received/sent. |
-| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [3] | `http`; `spdy` | Conditionally Required: [4] |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [5] | `1.0`; `1.1`; `2`; `3` | Recommended |
-| [`server.address`](../attributes-registry/server.md) | string | Host identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [6] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Required |
-| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [7] | `80`; `8080`; `443` | Required |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | Opt-In |
-
-**[1]:** If the request fails with an error before response status code was sent or received,
-`error.type` SHOULD be set to exception type (its fully-qualified class name, if applicable)
-or a component-specific low cardinality error identifier.
-
-If response status code was sent or received and status indicates an error according to [HTTP span status definition](/docs/http/http-spans.md),
-`error.type` SHOULD be set to the status code number (represented as a string), an exception type (if thrown) or a component-specific error identifier.
-
-The `error.type` value SHOULD be predictable and SHOULD have low cardinality.
-Instrumentations SHOULD document the list of errors they report.
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [1] | `GET`; `POST`; `HEAD` | `Required` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Host identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [2] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Required` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [3] | `80`; `8080`; `443` | `Required` |  |
+| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [4] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | `Conditionally Required` If request has ended with an error. |  |
+| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | `Conditionally Required` If and only if one was received/sent. |  |
+| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [5] | `http`; `spdy` | `Conditionally Required` [6] |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [7] | `1.0`; `1.1`; `2`; `3` | `Recommended` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | `Opt-In` |  |
-The cardinality of `error.type` within one instrumentation library SHOULD be low, but
-telemetry consumers that aggregate data from multiple instrumentation libraries and applications
-should be prepared for `error.type` to have high cardinality at query time, when no
-additional filters are applied.
-
-If the request has completed successfully, instrumentations SHOULD NOT set `error.type`.
-
-**[2]:** HTTP request method value SHOULD be "known" to the instrumentation.
+**[1]:** HTTP request method value SHOULD be "known" to the instrumentation.
By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
@@ -582,82 +553,80 @@ HTTP method names are case-sensitive and `http.request.method` attribute value M
Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
-**[3]:** The value SHOULD be normalized to lowercase.
+**[2]:** If an HTTP client request is explicitly made to an IP address, e.g. `http://x.x.x.x:8080`, then `server.address` SHOULD be the IP address `x.x.x.x`. A DNS lookup SHOULD NOT be used.
-**[4]:** If not `http` and `network.protocol.version` is set.
+**[3]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-**[5]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
+**[4]:** If the request fails with an error before response status code was sent or received,
+`error.type` SHOULD be set to exception type (its fully-qualified class name, if applicable)
+or a component-specific low cardinality error identifier.
-**[6]:** If an HTTP client request is explicitly made to an IP address, e.g. `http://x.x.x.x:8080`, then `server.address` SHOULD be the IP address `x.x.x.x`. A DNS lookup SHOULD NOT be used.
+If response status code was sent or received and status indicates an error according to [HTTP span status definition](/docs/http/http-spans.md),
+`error.type` SHOULD be set to the status code number (represented as a string), an exception type (if thrown) or a component-specific error identifier.
-**[7]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
+The `error.type` value SHOULD be predictable and SHOULD have low cardinality.
+Instrumentations SHOULD document the list of errors they report.
+
+The cardinality of `error.type` within one instrumentation library SHOULD be low, but
+telemetry consumers that aggregate data from multiple instrumentation libraries and applications
+should be prepared for `error.type` to have high cardinality at query time, when no
+additional filters are applied.
+
+If the request has completed successfully, instrumentations SHOULD NOT set `error.type`.
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+**[5]:** The value SHOULD be normalized to lowercase.
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
+**[6]:** If not `http` and `network.protocol.version` is set.
-`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+**[7]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
-| Value | Description |
-|---|---|
-| `CONNECT` | CONNECT method. |
-| `DELETE` | DELETE method. |
-| `GET` | GET method. |
-| `HEAD` | HEAD method. |
-| `OPTIONS` | OPTIONS method. |
-| `PATCH` | PATCH method. |
-| `POST` | POST method. |
-| `PUT` | PUT method. |
-| `TRACE` | TRACE method. |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |
+`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
+
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
### Metric: `http.client.response.body.size`
-**Status**: [Experimental][DocumentStatus]
-
This metric is optional.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `http.client.response.body.size` | Histogram | `By` | Size of HTTP client response bodies. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `http.client.response.body.size` | Histogram | `By` | Size of HTTP client response bodies. [1] |  |
**[1]:** The size of the response payload body in bytes. This is the number of bytes transferred excluding headers and is often, but not always, present as the [Content-Length](https://www.rfc-editor.org/rfc/rfc9110.html#field.content-length) header. For requests using transport encoding, this should be the compressed size.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [1] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | Conditionally Required: If request has ended with an error. |
-| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [2] | `GET`; `POST`; `HEAD` | Required |
-| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | Conditionally Required: If and only if one was received/sent. |
-| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [3] | `http`; `spdy` | Conditionally Required: [4] |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [5] | `1.0`; `1.1`; `2`; `3` | Recommended |
-| [`server.address`](../attributes-registry/server.md) | string | Host identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [6] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Required |
-| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [7] | `80`; `8080`; `443` | Required |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | Opt-In |
-
-**[1]:** If the request fails with an error before response status code was sent or received,
-`error.type` SHOULD be set to exception type (its fully-qualified class name, if applicable)
-or a component-specific low cardinality error identifier.
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [1] | `GET`; `POST`; `HEAD` | `Required` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Host identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [2] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Required` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [3] | `80`; `8080`; `443` | `Required` |  |
+| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [4] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | `Conditionally Required` If request has ended with an error. |  |
+| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | `Conditionally Required` If and only if one was received/sent. |  |
+| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [5] | `http`; `spdy` | `Conditionally Required` [6] |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [7] | `1.0`; `1.1`; `2`; `3` | `Recommended` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | `Opt-In` |  |
-If response status code was sent or received and status indicates an error according to [HTTP span status definition](/docs/http/http-spans.md),
-`error.type` SHOULD be set to the status code number (represented as a string), an exception type (if thrown) or a component-specific error identifier.
-
-The `error.type` value SHOULD be predictable and SHOULD have low cardinality.
-Instrumentations SHOULD document the list of errors they report.
-
-The cardinality of `error.type` within one instrumentation library SHOULD be low, but
-telemetry consumers that aggregate data from multiple instrumentation libraries and applications
-should be prepared for `error.type` to have high cardinality at query time, when no
-additional filters are applied.
-
-If the request has completed successfully, instrumentations SHOULD NOT set `error.type`.
-
-**[2]:** HTTP request method value SHOULD be "known" to the instrumentation.
+**[1]:** HTTP request method value SHOULD be "known" to the instrumentation.
By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
@@ -672,72 +641,87 @@ HTTP method names are case-sensitive and `http.request.method` attribute value M
Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
-**[3]:** The value SHOULD be normalized to lowercase.
+**[2]:** If an HTTP client request is explicitly made to an IP address, e.g. `http://x.x.x.x:8080`, then `server.address` SHOULD be the IP address `x.x.x.x`. A DNS lookup SHOULD NOT be used.
-**[4]:** If not `http` and `network.protocol.version` is set.
+**[3]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
+
+**[4]:** If the request fails with an error before response status code was sent or received,
+`error.type` SHOULD be set to exception type (its fully-qualified class name, if applicable)
+or a component-specific low cardinality error identifier.
-**[5]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
+If response status code was sent or received and status indicates an error according to [HTTP span status definition](/docs/http/http-spans.md),
+`error.type` SHOULD be set to the status code number (represented as a string), an exception type (if thrown) or a component-specific error identifier.
-**[6]:** If an HTTP client request is explicitly made to an IP address, e.g. `http://x.x.x.x:8080`, then `server.address` SHOULD be the IP address `x.x.x.x`. A DNS lookup SHOULD NOT be used.
+The `error.type` value SHOULD be predictable and SHOULD have low cardinality.
+Instrumentations SHOULD document the list of errors they report.
+
+The cardinality of `error.type` within one instrumentation library SHOULD be low, but
+telemetry consumers that aggregate data from multiple instrumentation libraries and applications
+should be prepared for `error.type` to have high cardinality at query time, when no
+additional filters are applied.
+
+If the request has completed successfully, instrumentations SHOULD NOT set `error.type`.
-**[7]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
+**[5]:** The value SHOULD be normalized to lowercase.
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+**[6]:** If not `http` and `network.protocol.version` is set.
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
+**[7]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
-`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `CONNECT` | CONNECT method. |
-| `DELETE` | DELETE method. |
-| `GET` | GET method. |
-| `HEAD` | HEAD method. |
-| `OPTIONS` | OPTIONS method. |
-| `PATCH` | PATCH method. |
-| `POST` | POST method. |
-| `PUT` | PUT method. |
-| `TRACE` | TRACE method. |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |
+| Value | Description | Stability |
+|---|---|---|
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
+
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
### Metric: `http.client.open_connections`
-**Status**: [Experimental][DocumentStatus]
-
This metric is optional.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `http.client.open_connections` | UpDownCounter | `{connection}` | Number of outbound HTTP connections that are currently active or idle on the client. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `http.client.open_connections` | UpDownCounter | `{connection}` | Number of outbound HTTP connections that are currently active or idle on the client. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`http.connection.state`](../attributes-registry/http.md) | string | State of the HTTP connection in the HTTP connection pool. | `active`; `idle` | Required |
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [1] | `1.1`; `2` | Recommended |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [2] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Required |
-| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [3] | `80`; `8080`; `443` | Required |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`http.connection.state`](../attributes-registry/http.md) | string | State of the HTTP connection in the HTTP connection pool. | `active`; `idle` | `Required` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Required` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [2] | `80`; `8080`; `443` | `Required` |  |
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [3] | `1.1`; `2` | `Recommended` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | `Opt-In` |  |
-**[1]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
+**[1]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
-**[2]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
+**[2]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-**[3]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
+**[3]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
-`http.connection.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`http.connection.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `active` | active state. |
-| `idle` | idle state. |
+| Value | Description | Stability |
+|---|---|---|
+| `active` | active state. |  |
+| `idle` | idle state. |  |
### Metric: `http.client.connection.duration`
@@ -746,30 +730,28 @@ This metric SHOULD be specified with
[`ExplicitBucketBoundaries`](https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/metrics/api.md#instrument-advisory-parameters)
of `[ 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 30, 60, 120, 300 ]`.
-**Status**: [Experimental][DocumentStatus]
-
This metric is optional.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `http.client.connection.duration` | Histogram | `s` | The duration of the successfully established outbound HTTP connections. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `http.client.connection.duration` | Histogram | `s` | The duration of the successfully established outbound HTTP connections. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [1] | `1.1`; `2` | Recommended |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [2] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Required |
-| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [3] | `80`; `8080`; `443` | Required |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Required` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [2] | `80`; `8080`; `443` | `Required` |  |
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [3] | `1.1`; `2` | `Recommended` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | `Opt-In` |  |
-**[1]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
+**[1]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
-**[2]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
+**[2]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-**[3]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
+**[3]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
### Metric: `http.client.active_requests`
@@ -779,20 +761,24 @@ This metric is optional.
This metric is optional.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `http.client.active_requests` | UpDownCounter | `{request}` | Number of active HTTP requests. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `http.client.active_requests` | UpDownCounter | `{request}` | Number of active HTTP requests. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [1] | `GET`; `POST`; `HEAD` | Recommended |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [2] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Required |
-| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [3] | `80`; `8080`; `443` | Required |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Required` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [2] | `80`; `8080`; `443` | `Required` |  |
+| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [3] | `GET`; `POST`; `HEAD` | `Recommended` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | `Opt-In` |  |
-**[1]:** HTTP request method value SHOULD be "known" to the instrumentation.
+**[1]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
+
+**[2]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
+
+**[3]:** HTTP request method value SHOULD be "known" to the instrumentation.
By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
@@ -807,24 +793,20 @@ HTTP method names are case-sensitive and `http.request.method` attribute value M
Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
-**[2]:** When observed from the client side, and when communicating through an intermediary, `server.address` SHOULD represent the server address behind any intermediaries, for example proxies, if it's available.
-
-**[3]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-
-`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `CONNECT` | CONNECT method. |
-| `DELETE` | DELETE method. |
-| `GET` | GET method. |
-| `HEAD` | HEAD method. |
-| `OPTIONS` | OPTIONS method. |
-| `PATCH` | PATCH method. |
-| `POST` | POST method. |
-| `PUT` | PUT method. |
-| `TRACE` | TRACE method. |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |
+`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/http/http-spans.md b/docs/http/http-spans.md
index fcbadbf9b3..07309707c9 100644
--- a/docs/http/http-spans.md
+++ b/docs/http/http-spans.md
@@ -115,20 +115,35 @@ the specific attributes listed in the [HTTP client](#http-client) and [HTTP serv
sections below.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [1] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | Conditionally Required: If request has ended with an error. |
-| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [2] | `GET`; `POST`; `HEAD` | Required |
-| [`http.request.method_original`](../attributes-registry/http.md) | string | Original HTTP method sent by the client in the request line. | `GeT`; `ACL`; `foo` | Conditionally Required: [3] |
-| [`http.response.header.`](../attributes-registry/http.md) | string[] | HTTP response headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [4] | `http.response.header.content-type=["application/json"]`; `http.response.header.my-custom-header=["abc", "def"]` | Opt-In |
-| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | Conditionally Required: If and only if one was received/sent. |
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | Recommended: If `network.peer.address` is set. |
-| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [5] | `http`; `spdy` | Conditionally Required: [6] |
-| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [7] | `1.0`; `1.1`; `2`; `3` | Recommended |
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [8] | `tcp`; `udp` | Opt-In |
-
-**[1]:** If the request fails with an error before response status code was sent or received,
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`http.request.method`](../attributes-registry/http.md) | string | HTTP request method. [1] | `GET`; `POST`; `HEAD` | `Required` |  |
+| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [2] | `timeout`; `java.net.UnknownHostException`; `server_certificate_invalid`; `500` | `Conditionally Required` If request has ended with an error. |  |
+| [`http.request.method_original`](../attributes-registry/http.md) | string | Original HTTP method sent by the client in the request line. | `GeT`; `ACL`; `foo` | `Conditionally Required` [3] |  |
+| [`http.response.status_code`](../attributes-registry/http.md) | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` | `Conditionally Required` If and only if one was received/sent. |  |
+| [`network.protocol.name`](../attributes-registry/network.md) | string | [OSI application layer](https://osi-model.com/application-layer/) or non-OSI equivalent. [4] | `http`; `spdy` | `Conditionally Required` [5] |  |
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | `Recommended` If `network.peer.address` is set. |  |
+| [`network.protocol.version`](../attributes-registry/network.md) | string | The actual version of the protocol used for network communication. [6] | `1.0`; `1.1`; `2`; `3` | `Recommended` |  |
+| [`http.response.header.`](../attributes-registry/http.md) | string[] | HTTP response headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [7] | `http.response.header.content-type=["application/json"]`; `http.response.header.my-custom-header=["abc", "def"]` | `Opt-In` |  |
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [8] | `tcp`; `udp` | `Opt-In` |  |
+
+**[1]:** HTTP request method value SHOULD be "known" to the instrumentation.
+By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
+and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
+
+If the HTTP request method is not known to instrumentation, it MUST set the `http.request.method` attribute to `_OTHER`.
+
+If the HTTP instrumentation could end up converting valid HTTP request methods to `_OTHER`, then it MUST provide a way to override
+the list of known HTTP methods. If this override is done via environment variable, then the environment variable MUST be named
+OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods
+(this list MUST be a full override of the default known method, it is not a list of known methods in addition to the defaults).
+
+HTTP method names are case-sensitive and `http.request.method` attribute value MUST match a known HTTP method name exactly.
+Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
+Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
+
+**[2]:** If the request fails with an error before response status code was sent or received,
`error.type` SHOULD be set to exception type (its fully-qualified class name, if applicable)
or a component-specific low cardinality error identifier.
@@ -145,68 +160,53 @@ additional filters are applied.
If the request has completed successfully, instrumentations SHOULD NOT set `error.type`.
-**[2]:** HTTP request method value SHOULD be "known" to the instrumentation.
-By default, this convention defines "known" methods as the ones listed in [RFC9110](https://www.rfc-editor.org/rfc/rfc9110.html#name-methods)
-and the PATCH method defined in [RFC5789](https://www.rfc-editor.org/rfc/rfc5789.html).
+**[3]:** If and only if it's different than `http.request.method`.
-If the HTTP request method is not known to instrumentation, it MUST set the `http.request.method` attribute to `_OTHER`.
+**[4]:** The value SHOULD be normalized to lowercase.
-If the HTTP instrumentation could end up converting valid HTTP request methods to `_OTHER`, then it MUST provide a way to override
-the list of known HTTP methods. If this override is done via environment variable, then the environment variable MUST be named
-OTEL_INSTRUMENTATION_HTTP_KNOWN_METHODS and support a comma-separated list of case-sensitive known HTTP methods
-(this list MUST be a full override of the default known method, it is not a list of known methods in addition to the defaults).
-
-HTTP method names are case-sensitive and `http.request.method` attribute value MUST match a known HTTP method name exactly.
-Instrumentations for specific web frameworks that consider HTTP methods to be case insensitive, SHOULD populate a canonical equivalent.
-Tracing instrumentations that do so, MUST also set `http.request.method_original` to the original value.
+**[5]:** If not `http` and `network.protocol.version` is set.
-**[3]:** If and only if it's different than `http.request.method`.
+**[6]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
-**[4]:** Instrumentations SHOULD require an explicit configuration of which headers are to be captured. Including all response headers can be a security risk - explicit configuration helps avoid leaking sensitive information.
+**[7]:** Instrumentations SHOULD require an explicit configuration of which headers are to be captured. Including all response headers can be a security risk - explicit configuration helps avoid leaking sensitive information.
Users MAY explicitly configure instrumentations to capture them even though it is not recommended.
The attribute value MUST consist of either multiple header values as an array of strings or a single-item array containing a possibly comma-concatenated string, depending on the way the HTTP library provides access to headers.
-**[5]:** The value SHOULD be normalized to lowercase.
-
-**[6]:** If not `http` and `network.protocol.version` is set.
-
-**[7]:** If protocol version is subject to negotiation (for example using [ALPN](https://www.rfc-editor.org/rfc/rfc7301.html)), this attribute SHOULD be set to the negotiated version. If the actual protocol version is not known, this attribute SHOULD NOT be set.
-
**[8]:** Generally `tcp` for `HTTP/1.0`, `HTTP/1.1`, and `HTTP/2`. Generally `udp` for `HTTP/3`. Other obscure implementations are possible.
The following attributes can be important for making sampling decisions and SHOULD be provided **at span creation time** (if provided at all):
* [`http.request.method`](../attributes-registry/http.md)
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
-
-`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `CONNECT` | CONNECT method. |
-| `DELETE` | DELETE method. |
-| `GET` | GET method. |
-| `HEAD` | HEAD method. |
-| `OPTIONS` | OPTIONS method. |
-| `PATCH` | PATCH method. |
-| `POST` | POST method. |
-| `PUT` | PUT method. |
-| `TRACE` | TRACE method. |
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |
-
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+`http.request.method` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `CONNECT` | CONNECT method. |  |
+| `DELETE` | DELETE method. |  |
+| `GET` | GET method. |  |
+| `HEAD` | HEAD method. |  |
+| `OPTIONS` | OPTIONS method. |  |
+| `PATCH` | PATCH method. |  |
+| `POST` | POST method. |  |
+| `PUT` | PUT method. |  |
+| `TRACE` | TRACE method. |  |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
+
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
+
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
## HTTP client
@@ -224,30 +224,30 @@ This span type represents an outbound HTTP request. There are two ways this can
For an HTTP client span, `SpanKind` MUST be `Client`.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`http.request.header.`](../attributes-registry/http.md) | string[] | HTTP request headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [1] | `http.request.header.content-type=["application/json"]`; `http.request.header.x-forwarded-for=["1.2.3.4", "1.2.3.5"]` | Opt-In |
-| [`http.request.resend_count`](../attributes-registry/http.md) | int | The ordinal number of request resending attempt (for any reason, including redirects). [2] | `3` | Recommended: if and only if request was retried. |
-| [`server.address`](../attributes-registry/server.md) | string | Host identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [3] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Required |
-| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [4] | `80`; `8080`; `443` | Required |
-| [`url.full`](../attributes-registry/url.md) | string | Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986) [5] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `//localhost` | Required |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | Opt-In |
-| [`user_agent.original`](../attributes-registry/user-agent.md) | string | Value of the [HTTP User-Agent](https://www.rfc-editor.org/rfc/rfc9110.html#field.user-agent) header sent by the client. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1`; `YourApp/1.0.0 grpc-java-okhttp/1.27.2` | Opt-In |
-
-**[1]:** Instrumentations SHOULD require an explicit configuration of which headers are to be captured. Including all request headers can be a security risk - explicit configuration helps avoid leaking sensitive information.
-The `User-Agent` header is already captured in the `user_agent.original` attribute. Users MAY explicitly configure instrumentations to capture them even though it is not recommended.
-The attribute value MUST consist of either multiple header values as an array of strings or a single-item array containing a possibly comma-concatenated string, depending on the way the HTTP library provides access to headers.
-
-**[2]:** The resend count SHOULD be updated each time an HTTP request gets resent by the client, regardless of what was the cause of the resending (e.g. redirection, authorization failure, 503 Server Unavailable, network issues, or any other).
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`server.address`](../attributes-registry/server.md) | string | Host identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [1] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Required` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port identifier of the ["URI origin"](https://www.rfc-editor.org/rfc/rfc9110.html#name-uri-origin) HTTP request is sent to. [2] | `80`; `8080`; `443` | `Required` |  |
+| [`url.full`](../attributes-registry/url.md) | string | Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986) [3] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `//localhost` | `Required` |  |
+| [`http.request.resend_count`](../attributes-registry/http.md) | int | The ordinal number of request resending attempt (for any reason, including redirects). [4] | `3` | `Recommended` if and only if request was retried. |  |
+| [`http.request.header.`](../attributes-registry/http.md) | string[] | HTTP request headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [5] | `http.request.header.content-type=["application/json"]`; `http.request.header.x-forwarded-for=["1.2.3.4", "1.2.3.5"]` | `Opt-In` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `http`; `https` | `Opt-In` |  |
+| [`user_agent.original`](../attributes-registry/user-agent.md) | string | Value of the [HTTP User-Agent](https://www.rfc-editor.org/rfc/rfc9110.html#field.user-agent) header sent by the client. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1`; `YourApp/1.0.0 grpc-java-okhttp/1.27.2` | `Opt-In` |  |
-**[3]:** If an HTTP client request is explicitly made to an IP address, e.g. `http://x.x.x.x:8080`, then `server.address` SHOULD be the IP address `x.x.x.x`. A DNS lookup SHOULD NOT be used.
+**[1]:** If an HTTP client request is explicitly made to an IP address, e.g. `http://x.x.x.x:8080`, then `server.address` SHOULD be the IP address `x.x.x.x`. A DNS lookup SHOULD NOT be used.
-**[4]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
+**[2]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-**[5]:** For network calls, URL usually has `scheme://host[:port][path][?query][#fragment]` format, where the fragment is not transmitted over HTTP, but if it is known, it SHOULD be included nevertheless.
+**[3]:** For network calls, URL usually has `scheme://host[:port][path][?query][#fragment]` format, where the fragment is not transmitted over HTTP, but if it is known, it SHOULD be included nevertheless.
`url.full` MUST NOT contain credentials passed via URL in form of `https://username:password@www.example.com/`. In such case username and password SHOULD be redacted and attribute's value SHOULD be `https://REDACTED:REDACTED@www.example.com/`.
`url.full` SHOULD capture the absolute URL when it is available (or can be reconstructed). Sensitive content provided in `url.full` SHOULD be scrubbed when instrumentations can identify it.
+**[4]:** The resend count SHOULD be updated each time an HTTP request gets resent by the client, regardless of what was the cause of the resending (e.g. redirection, authorization failure, 503 Server Unavailable, network issues, or any other).
+
+**[5]:** Instrumentations SHOULD require an explicit configuration of which headers are to be captured. Including all request headers can be a security risk - explicit configuration helps avoid leaking sensitive information.
+The `User-Agent` header is already captured in the `user_agent.original` attribute. Users MAY explicitly configure instrumentations to capture them even though it is not recommended.
+The attribute value MUST consist of either multiple header values as an array of strings or a single-item array containing a possibly comma-concatenated string, depending on the way the HTTP library provides access to headers.
+
The following attributes can be important for making sampling decisions and SHOULD be provided **at span creation time** (if provided at all):
* [`server.address`](../attributes-registry/server.md)
@@ -336,52 +336,52 @@ This span type represents an inbound HTTP request.
For an HTTP server span, `SpanKind` MUST be `Server`.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`client.address`](../attributes-registry/client.md) | string | Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `83.164.160.102` | Recommended |
-| [`client.port`](../attributes-registry/client.md) | int | The port of whichever client was captured in `client.address`. [2] | `65123` | Opt-In |
-| [`http.request.header.`](../attributes-registry/http.md) | string[] | HTTP request headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [3] | `http.request.header.content-type=["application/json"]`; `http.request.header.x-forwarded-for=["1.2.3.4", "1.2.3.5"]` | Opt-In |
-| [`http.route`](../attributes-registry/http.md) | string | The matched route, that is, the path template in the format used by the respective server framework. [4] | `/users/:userID?`; `{controller}/{action}/{id?}` | Conditionally Required: If and only if it's available |
-| [`network.local.address`](../attributes-registry/network.md) | string | Local socket address. Useful in case of a multi-IP host. | `10.1.2.80`; `/tmp/my.sock` | Opt-In |
-| [`network.local.port`](../attributes-registry/network.md) | int | Local socket port. Useful in case of a multi-port host. | `65123` | Opt-In |
-| [`server.address`](../attributes-registry/server.md) | string | Name of the local HTTP server that received the request. [5] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Port of the local HTTP server that received the request. [6] | `80`; `8080`; `443` | Conditionally Required: If `server.address` is set. |
-| [`url.path`](../attributes-registry/url.md) | string | The [URI path](https://www.rfc-editor.org/rfc/rfc3986#section-3.3) component [7] | `/search` | Required |
-| [`url.query`](../attributes-registry/url.md) | string | The [URI query](https://www.rfc-editor.org/rfc/rfc3986#section-3.4) component [8] | `q=OpenTelemetry` | Conditionally Required: If and only if one was received/sent. |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. [9] | `http`; `https` | Required |
-| [`user_agent.original`](../attributes-registry/user-agent.md) | string | Value of the [HTTP User-Agent](https://www.rfc-editor.org/rfc/rfc9110.html#field.user-agent) header sent by the client. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1`; `YourApp/1.0.0 grpc-java-okhttp/1.27.2` | Recommended |
-
-**[1]:** The IP address of the original client behind all proxies, if known (e.g. from [Forwarded#for](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded#for), [X-Forwarded-For](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-For), or a similar header). Otherwise, the immediate client peer address.
-
-**[2]:** When observed from the server side, and when communicating through an intermediary, `client.port` SHOULD represent the client port behind any intermediaries, for example proxies, if it's available.
-
-**[3]:** Instrumentations SHOULD require an explicit configuration of which headers are to be captured. Including all request headers can be a security risk - explicit configuration helps avoid leaking sensitive information.
-The `User-Agent` header is already captured in the `user_agent.original` attribute. Users MAY explicitly configure instrumentations to capture them even though it is not recommended.
-The attribute value MUST consist of either multiple header values as an array of strings or a single-item array containing a possibly comma-concatenated string, depending on the way the HTTP library provides access to headers.
-
-**[4]:** MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`url.path`](../attributes-registry/url.md) | string | The [URI path](https://www.rfc-editor.org/rfc/rfc3986#section-3.3) component [1] | `/search` | `Required` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. [2] | `http`; `https` | `Required` |  |
+| [`http.route`](../attributes-registry/http.md) | string | The matched route, that is, the path template in the format used by the respective server framework. [3] | `/users/:userID?`; `{controller}/{action}/{id?}` | `Conditionally Required` If and only if it's available |  |
+| [`server.port`](../attributes-registry/server.md) | int | Port of the local HTTP server that received the request. [4] | `80`; `8080`; `443` | `Conditionally Required` If `server.address` is set. |  |
+| [`url.query`](../attributes-registry/url.md) | string | The [URI query](https://www.rfc-editor.org/rfc/rfc3986#section-3.4) component [5] | `q=OpenTelemetry` | `Conditionally Required` If and only if one was received/sent. |  |
+| [`client.address`](../attributes-registry/client.md) | string | Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [6] | `83.164.160.102` | `Recommended` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Name of the local HTTP server that received the request. [7] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`user_agent.original`](../attributes-registry/user-agent.md) | string | Value of the [HTTP User-Agent](https://www.rfc-editor.org/rfc/rfc9110.html#field.user-agent) header sent by the client. | `CERN-LineMode/2.15 libwww/2.17b3`; `Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1`; `YourApp/1.0.0 grpc-java-okhttp/1.27.2` | `Recommended` |  |
+| [`client.port`](../attributes-registry/client.md) | int | The port of whichever client was captured in `client.address`. [8] | `65123` | `Opt-In` |  |
+| [`http.request.header.`](../attributes-registry/http.md) | string[] | HTTP request headers, `` being the normalized HTTP Header name (lowercase), the value being the header values. [9] | `http.request.header.content-type=["application/json"]`; `http.request.header.x-forwarded-for=["1.2.3.4", "1.2.3.5"]` | `Opt-In` |  |
+| [`network.local.address`](../attributes-registry/network.md) | string | Local socket address. Useful in case of a multi-IP host. | `10.1.2.80`; `/tmp/my.sock` | `Opt-In` |  |
+| [`network.local.port`](../attributes-registry/network.md) | int | Local socket port. Useful in case of a multi-port host. | `65123` | `Opt-In` |  |
+
+**[1]:** Sensitive content provided in `url.path` SHOULD be scrubbed when instrumentations can identify it.
+
+**[2]:** The scheme of the original client request, if known (e.g. from [Forwarded#proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded#proto), [X-Forwarded-Proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-Proto), or a similar header). Otherwise, the scheme of the immediate peer request.
+
+**[3]:** MUST NOT be populated when this is not supported by the HTTP server framework as the route attribute should have low-cardinality and the URI path can NOT substitute it.
SHOULD include the [application root](/docs/http/http-spans.md#http-server-definitions) if there is one.
-**[5]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
+**[4]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
-**[6]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
+**[5]:** Sensitive content provided in `url.query` SHOULD be scrubbed when instrumentations can identify it.
-**[7]:** Sensitive content provided in `url.path` SHOULD be scrubbed when instrumentations can identify it.
+**[6]:** The IP address of the original client behind all proxies, if known (e.g. from [Forwarded#for](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded#for), [X-Forwarded-For](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-For), or a similar header). Otherwise, the immediate client peer address.
-**[8]:** Sensitive content provided in `url.query` SHOULD be scrubbed when instrumentations can identify it.
+**[7]:** See [Setting `server.address` and `server.port` attributes](/docs/http/http-spans.md#setting-serveraddress-and-serverport-attributes).
-**[9]:** The scheme of the original client request, if known (e.g. from [Forwarded#proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/Forwarded#proto), [X-Forwarded-Proto](https://developer.mozilla.org/docs/Web/HTTP/Headers/X-Forwarded-Proto), or a similar header). Otherwise, the scheme of the immediate peer request.
+**[8]:** When observed from the server side, and when communicating through an intermediary, `client.port` SHOULD represent the client port behind any intermediaries, for example proxies, if it's available.
+
+**[9]:** Instrumentations SHOULD require an explicit configuration of which headers are to be captured. Including all request headers can be a security risk - explicit configuration helps avoid leaking sensitive information.
+The `User-Agent` header is already captured in the `user_agent.original` attribute. Users MAY explicitly configure instrumentations to capture them even though it is not recommended.
+The attribute value MUST consist of either multiple header values as an array of strings or a single-item array containing a possibly comma-concatenated string, depending on the way the HTTP library provides access to headers.
The following attributes can be important for making sampling decisions and SHOULD be provided **at span creation time** (if provided at all):
-* [`client.address`](../attributes-registry/client.md)
-* [`http.request.header.`](../attributes-registry/http.md)
-* [`server.address`](../attributes-registry/server.md)
-* [`server.port`](../attributes-registry/server.md)
* [`url.path`](../attributes-registry/url.md)
-* [`url.query`](../attributes-registry/url.md)
* [`url.scheme`](../attributes-registry/url.md)
+* [`server.port`](../attributes-registry/server.md)
+* [`url.query`](../attributes-registry/url.md)
+* [`client.address`](../attributes-registry/client.md)
+* [`server.address`](../attributes-registry/server.md)
* [`user_agent.original`](../attributes-registry/user-agent.md)
+* [`http.request.header.`](../attributes-registry/http.md)
`http.route` MUST be provided at span creation time if and only if it's already available. If it becomes available after span starts, instrumentation MUST populate it anytime before span ends.
diff --git a/docs/messaging/azure-messaging.md b/docs/messaging/azure-messaging.md
index e9b49cc5cf..8626cb2c2c 100644
--- a/docs/messaging/azure-messaging.md
+++ b/docs/messaging/azure-messaging.md
@@ -25,12 +25,12 @@ The span name SHOULD follow [the general messaging span name pattern](../messagi
The following additional attributes are defined:
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`messaging.servicebus.destination.subscription_name`](../attributes-registry/messaging.md) | string | The name of the subscription in the topic messages are received from. | `mySubscription` | Conditionally Required: If messages are received from the subscription. |
-| [`messaging.servicebus.disposition_status`](../attributes-registry/messaging.md) | string | Describes the [settlement type](https://learn.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock). | `complete` | Conditionally Required: if and only if `messaging.operation` is `settle`. |
-| [`messaging.servicebus.message.delivery_count`](../attributes-registry/messaging.md) | int | Number of deliveries that have been attempted for this message. | `2` | Conditionally Required: [1] |
-| [`messaging.servicebus.message.enqueued_time`](../attributes-registry/messaging.md) | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`messaging.servicebus.destination.subscription_name`](../attributes-registry/messaging.md) | string | The name of the subscription in the topic messages are received from. | `mySubscription` | `Conditionally Required` If messages are received from the subscription. |  |
+| [`messaging.servicebus.disposition_status`](../attributes-registry/messaging.md) | string | Describes the [settlement type](https://learn.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock). | `complete` | `Conditionally Required` if and only if `messaging.operation` is `settle`. |  |
+| [`messaging.servicebus.message.delivery_count`](../attributes-registry/messaging.md) | int | Number of deliveries that have been attempted for this message. | `2` | `Conditionally Required` [1] |  |
+| [`messaging.servicebus.message.enqueued_time`](../attributes-registry/messaging.md) | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` | `Recommended` |  |
**[1]:** If delivery count is available and is bigger than 0.
@@ -52,11 +52,11 @@ contain a low-cardinality name of an operation the span describes:
The following additional attributes are defined:
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`messaging.destination.partition.id`](../attributes-registry/messaging.md) | string | "String representation of the partition id messages are sent to or received from, unique within the Event Hub." | `1` | Conditionally Required: If available. |
-| [`messaging.eventhubs.consumer.group`](../attributes-registry/messaging.md) | string | The name of the consumer group the event consumer is associated with. | `indexer` | Conditionally Required: If not default ("$Default"). |
-| [`messaging.eventhubs.message.enqueued_time`](../attributes-registry/messaging.md) | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`messaging.destination.partition.id`](../attributes-registry/messaging.md) | string | "String representation of the partition id messages are sent to or received from, unique within the Event Hub." | `1` | `Conditionally Required` If available. |  |
+| [`messaging.eventhubs.consumer.group`](../attributes-registry/messaging.md) | string | The name of the consumer group the event consumer is associated with. | `indexer` | `Conditionally Required` If not default ("$Default"). |  |
+| [`messaging.eventhubs.message.enqueued_time`](../attributes-registry/messaging.md) | int | The UTC epoch seconds at which the message has been accepted and stored in the entity. | `1701393730` | `Recommended` |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/messaging/gcp-pubsub.md b/docs/messaging/gcp-pubsub.md
index 17b74081a9..ad3b6fa0fb 100644
--- a/docs/messaging/gcp-pubsub.md
+++ b/docs/messaging/gcp-pubsub.md
@@ -13,10 +13,11 @@ The Semantic Conventions for [Google Cloud Pub/Sub](https://cloud.google.com/pub
## Span attributes
For Google Cloud Pub/Sub, the following additional attributes are defined:
+<<<<<<< HEAD
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`messaging.gcp_pubsub.message.ordering_key`](../attributes-registry/messaging.md) | string | The ordering key for a given message. If the attribute is not present, the message does not have an ordering key. | `ordering_key` | Conditionally Required: If the message type has an ordering key set. |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`messaging.gcp_pubsub.message.ordering_key`](../attributes-registry/messaging.md) | string | The ordering key for a given message. If the attribute is not present, the message does not have an ordering key. | `ordering_key` | `Conditionally Required` If the message type has an ordering key set. |  |
## Examples
diff --git a/docs/messaging/kafka.md b/docs/messaging/kafka.md
index 522c4c2a16..c1affa011a 100644
--- a/docs/messaging/kafka.md
+++ b/docs/messaging/kafka.md
@@ -24,18 +24,19 @@ described on this page.
For Apache Kafka, the following additional attributes are defined:
+<<<<<<< HEAD
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`messaging.destination.partition.id`](../attributes-registry/messaging.md) | string | "String representation of the partition id the message (or batch) is sent to or received from."" | `1` | Recommended |
-| [`messaging.kafka.consumer.group`](../attributes-registry/messaging.md) | string | Name of the Kafka Consumer Group that is handling the message. Only applies to consumers, not producers. | `my-group` | Recommended |
-| [`messaging.kafka.message.key`](../attributes-registry/messaging.md) | string | Message keys in Kafka are used for grouping alike messages to ensure they're processed on the same partition. They differ from `messaging.message.id` in that they're not unique. If the key is `null`, the attribute MUST NOT be set. [1] | `myKey` | Recommended |
-| [`messaging.kafka.message.offset`](../attributes-registry/messaging.md) | int | The offset of a record in the corresponding Kafka partition. | `42` | Recommended |
-| [`messaging.kafka.message.tombstone`](../attributes-registry/messaging.md) | boolean | A boolean that is true if the message is a tombstone. | | Conditionally Required: [2] |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`messaging.kafka.message.tombstone`](../attributes-registry/messaging.md) | boolean | A boolean that is true if the message is a tombstone. | | `Conditionally Required` [1] |  |
+| [`messaging.destination.partition.id`](../attributes-registry/messaging.md) | string | "String representation of the partition id the message (or batch) is sent to or received from."" | `1` | `Recommended` |  |
+| [`messaging.kafka.consumer.group`](../attributes-registry/messaging.md) | string | Name of the Kafka Consumer Group that is handling the message. Only applies to consumers, not producers. | `my-group` | `Recommended` |  |
+| [`messaging.kafka.message.key`](../attributes-registry/messaging.md) | string | Message keys in Kafka are used for grouping alike messages to ensure they're processed on the same partition. They differ from `messaging.message.id` in that they're not unique. If the key is `null`, the attribute MUST NOT be set. [2] | `myKey` | `Recommended` |  |
+| [`messaging.kafka.message.offset`](../attributes-registry/messaging.md) | int | The offset of a record in the corresponding Kafka partition. | `42` | `Recommended` |  |
-**[1]:** If the key type is not string, it's string representation has to be supplied for the attribute. If the key has no unambiguous, canonical string form, don't include its value.
+**[1]:** If value is `true`. When missing, the value is assumed to be `false`.
-**[2]:** If value is `true`. When missing, the value is assumed to be `false`.
+**[2]:** If the key type is not string, it's string representation has to be supplied for the attribute. If the key has no unambiguous, canonical string form, don't include its value.
For Apache Kafka producers, [`peer.service`](/docs/general/attributes.md#general-remote-service-attributes) SHOULD be set to the name of the broker or service the message will be sent to.
diff --git a/docs/messaging/messaging-metrics.md b/docs/messaging/messaging-metrics.md
index 4f2678243c..63caaf8e14 100644
--- a/docs/messaging/messaging-metrics.md
+++ b/docs/messaging/messaging-metrics.md
@@ -30,14 +30,14 @@
All messaging metrics share the same set of attributes:
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [1] | `amqp:decode-error`; `KAFKA_STORAGE_ERROR`; `channel-error` | Conditionally Required: [2] |
-| [`messaging.destination.name`](../attributes-registry/messaging.md) | string | The message destination name [3] | `MyQueue`; `MyTopic` | Conditionally Required: [4] |
-| [`messaging.destination.template`](../attributes-registry/messaging.md) | string | Low cardinality representation of the messaging destination name [5] | `/customers/{customerId}` | Conditionally Required: if available. |
-| [`messaging.system`](../attributes-registry/messaging.md) | string | An identifier for the messaging system being used. See below for a list of well-known identifiers. | `activemq` | Required |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [6] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Conditionally Required: If available. |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [7] | `80`; `8080`; `443` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`messaging.system`](../attributes-registry/messaging.md) | string | An identifier for the messaging system being used. See below for a list of well-known identifiers. | `activemq` | `Required` |  |
+| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [1] | `amqp:decode-error`; `KAFKA_STORAGE_ERROR`; `channel-error` | `Conditionally Required` [2] |  |
+| [`messaging.destination.name`](../attributes-registry/messaging.md) | string | The message destination name [3] | `MyQueue`; `MyTopic` | `Conditionally Required` [4] |  |
+| [`messaging.destination.template`](../attributes-registry/messaging.md) | string | Low cardinality representation of the messaging destination name [5] | `/customers/{customerId}` | `Conditionally Required` if available. |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [6] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Conditionally Required` If available. |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [7] | `80`; `8080`; `443` | `Recommended` |  |
**[1]:** The `error.type` SHOULD be predictable and SHOULD have low cardinality.
Instrumentations SHOULD document the list of errors they report.
@@ -68,26 +68,26 @@ the broker doesn't have such notion, the destination name SHOULD uniquely identi
**[7]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
-
-`messaging.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `activemq` | Apache ActiveMQ |
-| `aws_sqs` | Amazon Simple Queue Service (SQS) |
-| `eventgrid` | Azure Event Grid |
-| `eventhubs` | Azure Event Hubs |
-| `servicebus` | Azure Service Bus |
-| `gcp_pubsub` | Google Cloud Pub/Sub |
-| `jms` | Java Message Service |
-| `kafka` | Apache Kafka |
-| `rabbitmq` | RabbitMQ |
-| `rocketmq` | Apache RocketMQ |
+`messaging.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `activemq` | Apache ActiveMQ |  |
+| `aws_sqs` | Amazon Simple Queue Service (SQS) |  |
+| `eventgrid` | Azure Event Grid |  |
+| `eventhubs` | Azure Event Hubs |  |
+| `servicebus` | Azure Service Bus |  |
+| `gcp_pubsub` | Google Cloud Pub/Sub |  |
+| `jms` | Java Message Service |  |
+| `kafka` | Apache Kafka |  |
+| `rabbitmq` | RabbitMQ |  |
+| `rocketmq` | Apache RocketMQ |  |
+
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
## Producer metrics
@@ -103,9 +103,9 @@ This metric SHOULD be specified with
of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `messaging.publish.duration` | Histogram | `s` | Measures the duration of publish operation. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `messaging.publish.duration` | Histogram | `s` | Measures the duration of publish operation. |  |
### Metric: `messaging.publish.messages`
@@ -113,9 +113,9 @@ of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10
This metric is [required][MetricRequired] when the messaging system supports batch publishing. It's [opt-in][MetricOptIn] when the messaging system does not support batch publishing, since the message count can be derived from the `messaging.publish.duration` histogram.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `messaging.publish.messages` | Counter | `{message}` | Measures the number of published messages. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `messaging.publish.messages` | Counter | `{message}` | Measures the number of published messages. |  |
> The need to report `messaging.publish.messages` depends on the messaging system capabilities and not application scenarios or client library limitations. For example, RabbitMQ does not support batch publishing and corresponding instrumentations don't need to report `messaging.publish.messages`. Kafka supports both, single and batch publishing, and instrumentations MUST report `messaging.publish.messages` counter regardless of application scenarios or APIs available in the client library.
@@ -133,9 +133,9 @@ of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10
When this metric is reported alongside a messaging receive span, the metric value SHOULD be the same as the corresponding span duration.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `messaging.receive.duration` | Histogram | `s` | Measures the duration of receive operation. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `messaging.receive.duration` | Histogram | `s` | Measures the duration of receive operation. |  |
### Metric: `messaging.receive.messages`
@@ -145,9 +145,9 @@ This metric is [required][MetricRequired] for batch receive operations. It's [op
_Note: The need to report `messaging.receive.messages` depends on the messaging system capabilities and not application scenarios or client library limitations._
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `messaging.receive.messages` | Counter | `{message}` | Measures the number of received messages. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `messaging.receive.messages` | Counter | `{message}` | Measures the number of received messages. |  |
### Metric: `messaging.process.duration`
@@ -161,9 +161,9 @@ This metric SHOULD be specified with
of `[ 0.005, 0.01, 0.025, 0.05, 0.075, 0.1, 0.25, 0.5, 0.75, 1, 2.5, 5, 7.5, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `messaging.process.duration` | Histogram | `s` | Measures the duration of process operation. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `messaging.process.duration` | Histogram | `s` | Measures the duration of process operation. |  |
### Metric: `messaging.process.messages`
@@ -173,9 +173,9 @@ This metric is [required][MetricRequired] for batch process operations, and [rec
_Note: The need to report `messaging.process.messages` depends on the messaging system capabilities and not application scenarios or client library limitations._
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `messaging.process.messages` | Counter | `{message}` | Measures the number of processed messages. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `messaging.process.messages` | Counter | `{message}` | Measures the number of processed messages. |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/blob/v1.21.0/specification/document-status.md
diff --git a/docs/messaging/messaging-spans.md b/docs/messaging/messaging-spans.md
index f78ad5993c..ee1204f99c 100644
--- a/docs/messaging/messaging-spans.md
+++ b/docs/messaging/messaging-spans.md
@@ -279,27 +279,29 @@ Messaging system-specific attributes MUST be defined in the corresponding `messa
as described in [Attributes specific to certain messaging systems](#attributes-specific-to-certain-messaging-systems).
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [1] | `amqp:decode-error`; `KAFKA_STORAGE_ERROR`; `channel-error` | Conditionally Required: [2] |
-| [`messaging.batch.message_count`](../attributes-registry/messaging.md) | int | The number of messages sent, received, or processed in the scope of the batching operation. [3] | `0`; `1`; `2` | Conditionally Required: [4] |
-| [`messaging.client_id`](../attributes-registry/messaging.md) | string | A unique identifier for the client that consumes or produces a message. | `client-5`; `myhost@8742@s8083jm` | Recommended: If a client id is available |
-| [`messaging.destination.anonymous`](../attributes-registry/messaging.md) | boolean | A boolean that is true if the message destination is anonymous (could be unnamed or have auto-generated name). | | Conditionally Required: [5] |
-| [`messaging.destination.name`](../attributes-registry/messaging.md) | string | The message destination name [6] | `MyQueue`; `MyTopic` | Conditionally Required: [7] |
-| [`messaging.destination.template`](../attributes-registry/messaging.md) | string | Low cardinality representation of the messaging destination name [8] | `/customers/{customerId}` | Conditionally Required: [9] |
-| [`messaging.destination.temporary`](../attributes-registry/messaging.md) | boolean | A boolean that is true if the message destination is temporary and might not exist anymore after messages are processed. | | Conditionally Required: [10] |
-| [`messaging.message.body.size`](../attributes-registry/messaging.md) | int | The size of the message body in bytes. [11] | `1439` | Recommended |
-| [`messaging.message.conversation_id`](../attributes-registry/messaging.md) | string | The conversation ID identifying the conversation to which the message belongs, represented as a string. Sometimes called "Correlation ID". | `MyConversationId` | Recommended |
-| [`messaging.message.envelope.size`](../attributes-registry/messaging.md) | int | The size of the message body and metadata in bytes. [12] | `2738` | Recommended |
-| [`messaging.message.id`](../attributes-registry/messaging.md) | string | A value used by the messaging system as an identifier for the message, represented as a string. | `452a7c7c7c7048c2f887f61572b18fc2` | Recommended |
-| [`messaging.operation`](../attributes-registry/messaging.md) | string | A string identifying the kind of messaging operation. [13] | `publish` | Required |
-| [`messaging.system`](../attributes-registry/messaging.md) | string | An identifier for the messaging system being used. See below for a list of well-known identifiers. | `activemq` | Required |
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the messaging intermediary node where the operation was performed. [14] | `10.1.2.80`; `/tmp/my.sock` | Recommended: If applicable for this messaging system. |
-| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port of the messaging intermediary node where the operation was performed. | `65123` | Recommended: if and only if `network.peer.address` is set. |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [15] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Conditionally Required: If available. |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [16] | `80`; `8080`; `443` | Recommended |
-
-**[1]:** The `error.type` SHOULD be predictable and SHOULD have low cardinality.
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`messaging.operation`](../attributes-registry/messaging.md) | string | A string identifying the kind of messaging operation. [1] | `publish` | `Required` |  |
+| [`messaging.system`](../attributes-registry/messaging.md) | string | An identifier for the messaging system being used. See below for a list of well-known identifiers. | `activemq` | `Required` |  |
+| [`error.type`](../attributes-registry/error.md) | string | Describes a class of error the operation ended with. [2] | `amqp:decode-error`; `KAFKA_STORAGE_ERROR`; `channel-error` | `Conditionally Required` [3] |  |
+| [`messaging.batch.message_count`](../attributes-registry/messaging.md) | int | The number of messages sent, received, or processed in the scope of the batching operation. [4] | `0`; `1`; `2` | `Conditionally Required` [5] |  |
+| [`messaging.destination.anonymous`](../attributes-registry/messaging.md) | boolean | A boolean that is true if the message destination is anonymous (could be unnamed or have auto-generated name). | | `Conditionally Required` [6] |  |
+| [`messaging.destination.name`](../attributes-registry/messaging.md) | string | The message destination name [7] | `MyQueue`; `MyTopic` | `Conditionally Required` [8] |  |
+| [`messaging.destination.template`](../attributes-registry/messaging.md) | string | Low cardinality representation of the messaging destination name [9] | `/customers/{customerId}` | `Conditionally Required` [10] |  |
+| [`messaging.destination.temporary`](../attributes-registry/messaging.md) | boolean | A boolean that is true if the message destination is temporary and might not exist anymore after messages are processed. | | `Conditionally Required` [11] |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [12] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Conditionally Required` If available. |  |
+| [`messaging.client_id`](../attributes-registry/messaging.md) | string | A unique identifier for the client that consumes or produces a message. | `client-5`; `myhost@8742@s8083jm` | `Recommended` If a client id is available |  |
+| [`messaging.message.body.size`](../attributes-registry/messaging.md) | int | The size of the message body in bytes. [13] | `1439` | `Recommended` |  |
+| [`messaging.message.conversation_id`](../attributes-registry/messaging.md) | string | The conversation ID identifying the conversation to which the message belongs, represented as a string. Sometimes called "Correlation ID". | `MyConversationId` | `Recommended` |  |
+| [`messaging.message.envelope.size`](../attributes-registry/messaging.md) | int | The size of the message body and metadata in bytes. [14] | `2738` | `Recommended` |  |
+| [`messaging.message.id`](../attributes-registry/messaging.md) | string | A value used by the messaging system as an identifier for the message, represented as a string. | `452a7c7c7c7048c2f887f61572b18fc2` | `Recommended` |  |
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the messaging intermediary node where the operation was performed. [15] | `10.1.2.80`; `/tmp/my.sock` | `Recommended` If applicable for this messaging system. |  |
+| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port of the messaging intermediary node where the operation was performed. | `65123` | `Recommended` if and only if `network.peer.address` is set. |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [16] | `80`; `8080`; `443` | `Recommended` |  |
+
+**[1]:** If a custom value is used, it MUST be of low cardinality.
+
+**[2]:** The `error.type` SHOULD be predictable and SHOULD have low cardinality.
Instrumentations SHOULD document the list of errors they report.
The cardinality of `error.type` within one instrumentation library SHOULD be low.
@@ -315,71 +317,69 @@ it's RECOMMENDED to:
* Use a domain-specific attribute
* Set `error.type` to capture all errors, regardless of whether they are defined within the domain-specific set or not.
-**[2]:** If and only if the messaging operation has failed.
+**[3]:** If and only if the messaging operation has failed.
-**[3]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
+**[4]:** Instrumentations SHOULD NOT set `messaging.batch.message_count` on spans that operate with a single message. When a messaging client library supports both batch and single-message API for the same operation, instrumentations SHOULD use `messaging.batch.message_count` for batching APIs and SHOULD NOT use it for single-message APIs.
-**[4]:** If the span describes an operation on a batch of messages.
+**[5]:** If the span describes an operation on a batch of messages.
-**[5]:** If value is `true`. When missing, the value is assumed to be `false`.
+**[6]:** If value is `true`. When missing, the value is assumed to be `false`.
-**[6]:** Destination name SHOULD uniquely identify a specific queue, topic or other entity within the broker. If
+**[7]:** Destination name SHOULD uniquely identify a specific queue, topic or other entity within the broker. If
the broker doesn't have such notion, the destination name SHOULD uniquely identify the broker.
-**[7]:** If span describes operation on a single message or if the value applies to all messages in the batch.
+**[8]:** If span describes operation on a single message or if the value applies to all messages in the batch.
-**[8]:** Destination names could be constructed from templates. An example would be a destination name involving a user name or product id. Although the destination name in this case is of high cardinality, the underlying template is of low cardinality and can be effectively used for grouping and aggregation.
+**[9]:** Destination names could be constructed from templates. An example would be a destination name involving a user name or product id. Although the destination name in this case is of high cardinality, the underlying template is of low cardinality and can be effectively used for grouping and aggregation.
-**[9]:** If available. Instrumentations MUST NOT use `messaging.destination.name` as template unless low-cardinality of destination name is guaranteed.
+**[10]:** If available. Instrumentations MUST NOT use `messaging.destination.name` as template unless low-cardinality of destination name is guaranteed.
-**[10]:** If value is `true`. When missing, the value is assumed to be `false`.
+**[11]:** If value is `true`. When missing, the value is assumed to be `false`.
-**[11]:** This can refer to both the compressed or uncompressed body size. If both sizes are known, the uncompressed
+**[12]:** Server domain name of the broker if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
+
+**[13]:** This can refer to both the compressed or uncompressed body size. If both sizes are known, the uncompressed
body size should be used.
-**[12]:** This can refer to both the compressed or uncompressed size. If both sizes are known, the uncompressed
+**[14]:** This can refer to both the compressed or uncompressed size. If both sizes are known, the uncompressed
size should be used.
-**[13]:** If a custom value is used, it MUST be of low cardinality.
-
-**[14]:** Semantic conventions for individual messaging systems SHOULD document whether `network.peer.*` attributes are applicable.
+**[15]:** Semantic conventions for individual messaging systems SHOULD document whether `network.peer.*` attributes are applicable.
Network peer address and port are important when the application interacts with individual intermediary nodes directly,
If a messaging operation involved multiple network calls (for example retries), the address of the last contacted node SHOULD be used.
-**[15]:** Server domain name of the broker if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name.
-
**[16]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |
-
-`messaging.operation` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `publish` | One or more messages are provided for publishing to an intermediary. If a single message is published, the context of the "Publish" span can be used as the creation context and no "Create" span needs to be created. |
-| `create` | A message is created. "Create" spans always refer to a single message and are used to provide a unique creation context for messages in batch publishing scenarios. |
-| `receive` | One or more messages are requested by a consumer. This operation refers to pull-based scenarios, where consumers explicitly call methods of messaging SDKs to receive messages. |
-| `process` | One or more messages are delivered to or processed by a consumer. |
-| `settle` | One or more messages are settled. |
-
-`messaging.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `activemq` | Apache ActiveMQ |
-| `aws_sqs` | Amazon Simple Queue Service (SQS) |
-| `eventgrid` | Azure Event Grid |
-| `eventhubs` | Azure Event Hubs |
-| `servicebus` | Azure Service Bus |
-| `gcp_pubsub` | Google Cloud Pub/Sub |
-| `jms` | Java Message Service |
-| `kafka` | Apache Kafka |
-| `rabbitmq` | RabbitMQ |
-| `rocketmq` | Apache RocketMQ |
+`messaging.operation` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `publish` | One or more messages are provided for publishing to an intermediary. If a single message is published, the context of the "Publish" span can be used as the creation context and no "Create" span needs to be created. |  |
+| `create` | A message is created. "Create" spans always refer to a single message and are used to provide a unique creation context for messages in batch publishing scenarios. |  |
+| `receive` | One or more messages are requested by a consumer. This operation refers to pull-based scenarios, where consumers explicitly call methods of messaging SDKs to receive messages. |  |
+| `process` | One or more messages are delivered to or processed by a consumer. |  |
+| `settle` | One or more messages are settled. |  |
+
+`messaging.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `activemq` | Apache ActiveMQ |  |
+| `aws_sqs` | Amazon Simple Queue Service (SQS) |  |
+| `eventgrid` | Azure Event Grid |  |
+| `eventhubs` | Azure Event Hubs |  |
+| `servicebus` | Azure Service Bus |  |
+| `gcp_pubsub` | Google Cloud Pub/Sub |  |
+| `jms` | Java Message Service |  |
+| `kafka` | Apache Kafka |  |
+| `rabbitmq` | RabbitMQ |  |
+| `rocketmq` | Apache RocketMQ |  |
+
+`error.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
### Consumer attributes
@@ -394,10 +394,10 @@ consumer instrumentations SHOULD populate the attributes
under the namespace `messaging.destination_publish.*`
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`messaging.destination_publish.anonymous`](../attributes-registry/messaging.md) | boolean | A boolean that is true if the publish message destination is anonymous (could be unnamed or have auto-generated name). | | Recommended |
-| [`messaging.destination_publish.name`](../attributes-registry/messaging.md) | string | The name of the original destination the message was published to [1] | `MyQueue`; `MyTopic` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`messaging.destination_publish.anonymous`](../attributes-registry/messaging.md) | boolean | A boolean that is true if the publish message destination is anonymous (could be unnamed or have auto-generated name). | | `Recommended` |  |
+| [`messaging.destination_publish.name`](../attributes-registry/messaging.md) | string | The name of the original destination the message was published to [1] | `MyQueue`; `MyTopic` | `Recommended` |  |
**[1]:** The name SHOULD uniquely identify a specific queue, topic, or other entity within the broker. If
the broker doesn't have such notion, the original destination name SHOULD uniquely identify the broker.
diff --git a/docs/messaging/rabbitmq.md b/docs/messaging/rabbitmq.md
index 7852546f4d..6b792e3784 100644
--- a/docs/messaging/rabbitmq.md
+++ b/docs/messaging/rabbitmq.md
@@ -17,13 +17,14 @@ described on this page.
In RabbitMQ, the destination is defined by an *exchange* and a *routing key*.
`messaging.destination.name` MUST be set to the name of the exchange. This will be an empty string if the default exchange is used.
+<<<<<<< HEAD
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`messaging.rabbitmq.destination.routing_key`](../attributes-registry/messaging.md) | string | RabbitMQ message routing key. | `myKey` | Conditionally Required: If not empty. |
-| [`messaging.rabbitmq.message.delivery_tag`](../attributes-registry/messaging.md) | int | RabbitMQ message delivery tag | `123` | Conditionally Required: When available. |
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the messaging intermediary node where the operation was performed. [1] | `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port of the messaging intermediary node where the operation was performed. | `65123` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`messaging.rabbitmq.destination.routing_key`](../attributes-registry/messaging.md) | string | RabbitMQ message routing key. | `myKey` | `Conditionally Required` If not empty. |  |
+| [`messaging.rabbitmq.message.delivery_tag`](../attributes-registry/messaging.md) | int | RabbitMQ message delivery tag | `123` | `Conditionally Required` When available. |  |
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the messaging intermediary node where the operation was performed. [1] | `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port of the messaging intermediary node where the operation was performed. | `65123` | `Recommended` |  |
**[1]:** If an operation involved multiple network calls (for example retries), the address of the last contacted node SHOULD be used.
diff --git a/docs/messaging/rocketmq.md b/docs/messaging/rocketmq.md
index eb0d8b3d5d..5454938a73 100644
--- a/docs/messaging/rocketmq.md
+++ b/docs/messaging/rocketmq.md
@@ -16,18 +16,19 @@ described on this page.
Specific attributes for Apache RocketMQ are defined below.
+<<<<<<< HEAD
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`messaging.rocketmq.client_group`](../attributes-registry/messaging.md) | string | Name of the RocketMQ producer/consumer group that is handling the message. The client type is identified by the SpanKind. | `myConsumerGroup` | Required |
-| [`messaging.rocketmq.consumption_model`](../attributes-registry/messaging.md) | string | Model of message consumption. This only applies to consumer spans. | `clustering` | Recommended |
-| [`messaging.rocketmq.message.delay_time_level`](../attributes-registry/messaging.md) | int | The delay time level for delay message, which determines the message delay time. | `3` | Conditionally Required: [1] |
-| [`messaging.rocketmq.message.delivery_timestamp`](../attributes-registry/messaging.md) | int | The timestamp in milliseconds that the delay message is expected to be delivered to consumer. | `1665987217045` | Conditionally Required: [2] |
-| [`messaging.rocketmq.message.group`](../attributes-registry/messaging.md) | string | It is essential for FIFO message. Messages that belong to the same message group are always processed one by one within the same consumer group. | `myMessageGroup` | Conditionally Required: If the message type is FIFO. |
-| [`messaging.rocketmq.message.keys`](../attributes-registry/messaging.md) | string[] | Key(s) of message, another way to mark message besides message id. | `[keyA, keyB]` | Recommended |
-| [`messaging.rocketmq.message.tag`](../attributes-registry/messaging.md) | string | The secondary classifier of message besides topic. | `tagA` | Recommended |
-| [`messaging.rocketmq.message.type`](../attributes-registry/messaging.md) | string | Type of message. | `normal` | Recommended |
-| [`messaging.rocketmq.namespace`](../attributes-registry/messaging.md) | string | Namespace of RocketMQ resources, resources in different namespaces are individual. | `myNamespace` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`messaging.rocketmq.client_group`](../attributes-registry/messaging.md) | string | Name of the RocketMQ producer/consumer group that is handling the message. The client type is identified by the SpanKind. | `myConsumerGroup` | `Required` |  |
+| [`messaging.rocketmq.namespace`](../attributes-registry/messaging.md) | string | Namespace of RocketMQ resources, resources in different namespaces are individual. | `myNamespace` | `Required` |  |
+| [`messaging.rocketmq.message.delay_time_level`](../attributes-registry/messaging.md) | int | The delay time level for delay message, which determines the message delay time. | `3` | `Conditionally Required` [1] |  |
+| [`messaging.rocketmq.message.delivery_timestamp`](../attributes-registry/messaging.md) | int | The timestamp in milliseconds that the delay message is expected to be delivered to consumer. | `1665987217045` | `Conditionally Required` [2] |  |
+| [`messaging.rocketmq.message.group`](../attributes-registry/messaging.md) | string | It is essential for FIFO message. Messages that belong to the same message group are always processed one by one within the same consumer group. | `myMessageGroup` | `Conditionally Required` If the message type is FIFO. |  |
+| [`messaging.rocketmq.consumption_model`](../attributes-registry/messaging.md) | string | Model of message consumption. This only applies to consumer spans. | `clustering` | `Recommended` |  |
+| [`messaging.rocketmq.message.keys`](../attributes-registry/messaging.md) | string[] | Key(s) of message, another way to mark message besides message id. | `[keyA, keyB]` | `Recommended` |  |
+| [`messaging.rocketmq.message.tag`](../attributes-registry/messaging.md) | string | The secondary classifier of message besides topic. | `tagA` | `Recommended` |  |
+| [`messaging.rocketmq.message.type`](../attributes-registry/messaging.md) | string | Type of message. | `normal` | `Recommended` |  |
**[1]:** If the message type is delay and delivery timestamp is not specified.
@@ -35,19 +36,19 @@ Specific attributes for Apache RocketMQ are defined below.
`messaging.rocketmq.consumption_model` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `clustering` | Clustering consumption model |
-| `broadcasting` | Broadcasting consumption model |
+| Value | Description | Stability |
+|---|---|---|
+| `clustering` | Clustering consumption model |  |
+| `broadcasting` | Broadcasting consumption model |  |
`messaging.rocketmq.message.type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `normal` | Normal message |
-| `fifo` | FIFO message |
-| `delay` | Delay message |
-| `transaction` | Transaction message |
+| Value | Description | Stability |
+|---|---|---|
+| `normal` | Normal message |  |
+| `fifo` | FIFO message |  |
+| `delay` | Delay message |  |
+| `transaction` | Transaction message |  |
`messaging.client_id` SHOULD be set to the client ID that is automatically generated by the Apache RocketMQ SDK.
diff --git a/docs/mobile/events.md b/docs/mobile/events.md
index e626f2c9c3..dd33a06cdd 100644
--- a/docs/mobile/events.md
+++ b/docs/mobile/events.md
@@ -26,21 +26,21 @@ mobile operating system (e.g. Android, iOS).
The event name MUST be `device.app.lifecycle`.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `ios.state` | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `active` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `ios.state` | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `active` | `Required` |  |
**[1]:** The iOS lifecycle states are defined in the [UIApplicationDelegate documentation](https://developer.apple.com/documentation/uikit/uiapplicationdelegate#1656902), and from which the `OS terminology` column values are derived.
`ios.state` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `active` | The app has become `active`. Associated with UIKit notification `applicationDidBecomeActive`. |
-| `inactive` | The app is now `inactive`. Associated with UIKit notification `applicationWillResignActive`. |
-| `background` | The app is now in the background. This value is associated with UIKit notification `applicationDidEnterBackground`. |
-| `foreground` | The app is now in the foreground. This value is associated with UIKit notification `applicationWillEnterForeground`. |
-| `terminate` | The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. |
+| Value | Description | Stability |
+|---|---|---|
+| `active` | The app has become `active`. Associated with UIKit notification `applicationDidBecomeActive`. |  |
+| `inactive` | The app is now `inactive`. Associated with UIKit notification `applicationWillResignActive`. |  |
+| `background` | The app is now in the background. This value is associated with UIKit notification `applicationDidEnterBackground`. |  |
+| `foreground` | The app is now in the foreground. This value is associated with UIKit notification `applicationWillEnterForeground`. |  |
+| `terminate` | The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`. |  |
### Android
@@ -48,19 +48,19 @@ The event name MUST be `device.app.lifecycle`.
The event name MUST be `device.app.lifecycle`.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `android.state` | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `created` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `android.state` | string | This attribute represents the state the application has transitioned into at the occurrence of the event. [1] | `created` | `Required` |  |
**[1]:** The Android lifecycle states are defined in [Activity lifecycle callbacks](https://developer.android.com/guide/components/activities/activity-lifecycle#lc), and from which the `OS identifiers` are derived.
`android.state` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `created` | Any time before Activity.onResume() or, if the app has no Activity, Context.startService() has been called in the app for the first time. |
-| `background` | Any time after Activity.onPause() or, if the app has no Activity, Context.stopService() has been called when the app was in the foreground state. |
-| `foreground` | Any time after Activity.onResume() or, if the app has no Activity, Context.startService() has been called when the app was in either the created or background states. |
+| Value | Description | Stability |
+|---|---|---|
+| `created` | Any time before Activity.onResume() or, if the app has no Activity, Context.startService() has been called in the app for the first time. |  |
+| `background` | Any time after Activity.onPause() or, if the app has no Activity, Context.stopService() has been called when the app was in the foreground state. |  |
+| `foreground` | Any time after Activity.onResume() or, if the app has no Activity, Context.startService() has been called when the app was in either the created or background states. |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.22.0/specification/document-status.md
diff --git a/docs/object-stores/s3.md b/docs/object-stores/s3.md
index 4b5a0f4dfd..9f157352f1 100644
--- a/docs/object-stores/s3.md
+++ b/docs/object-stores/s3.md
@@ -12,14 +12,14 @@ that describe common AWS SDK attributes in addition to the Semantic Conventions
described on this page.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.s3.bucket` | string | The S3 bucket name the request refers to. Corresponds to the `--bucket` parameter of the [S3 API](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html) operations. [1] | `some-bucket-name` | Recommended |
-| `aws.s3.copy_source` | string | The source object (in the form `bucket`/`key`) for the copy operation. [2] | `someFile.yml` | Recommended |
-| `aws.s3.delete` | string | The delete request container that specifies the objects to be deleted. [3] | `Objects=[{Key=string,VersionId=string},{Key=string,VersionId=string}],Quiet=boolean` | Recommended |
-| `aws.s3.key` | string | The S3 object key the request refers to. Corresponds to the `--key` parameter of the [S3 API](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html) operations. [4] | `someFile.yml` | Recommended |
-| `aws.s3.part_number` | int | The part number of the part being uploaded in a multipart-upload operation. This is a positive integer between 1 and 10,000. [5] | `3456` | Recommended |
-| `aws.s3.upload_id` | string | Upload ID that identifies the multipart upload. [6] | `dfRtDYWFbkRONycy.Yxwh66Yjlx.cph0gtNBtJ` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.s3.bucket` | string | The S3 bucket name the request refers to. Corresponds to the `--bucket` parameter of the [S3 API](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html) operations. [1] | `some-bucket-name` | `Recommended` |  |
+| `aws.s3.copy_source` | string | The source object (in the form `bucket`/`key`) for the copy operation. [2] | `someFile.yml` | `Recommended` |  |
+| `aws.s3.delete` | string | The delete request container that specifies the objects to be deleted. [3] | `Objects=[{Key=string,VersionId=string},{Key=string,VersionId=string}],Quiet=boolean` | `Recommended` |  |
+| `aws.s3.key` | string | The S3 object key the request refers to. Corresponds to the `--key` parameter of the [S3 API](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html) operations. [4] | `someFile.yml` | `Recommended` |  |
+| `aws.s3.part_number` | int | The part number of the part being uploaded in a multipart-upload operation. This is a positive integer between 1 and 10,000. [5] | `3456` | `Recommended` |  |
+| `aws.s3.upload_id` | string | Upload ID that identifies the multipart upload. [6] | `dfRtDYWFbkRONycy.Yxwh66Yjlx.cph0gtNBtJ` | `Recommended` |  |
**[1]:** The `bucket` attribute is applicable to all S3 operations that reference a bucket, i.e. that require the bucket name as a mandatory parameter.
This applies to almost all S3 operations except `list-buckets`.
diff --git a/docs/resource/README.md b/docs/resource/README.md
index 5c62168b6c..18e8e6dbb1 100644
--- a/docs/resource/README.md
+++ b/docs/resource/README.md
@@ -80,10 +80,10 @@ as specified in the [Resource SDK specification](https://github.com/open-telemet
**Description:** A service instance.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `service.name` | string | 
Logical name of the service. [1] | `shoppingcart` | Required |
-| `service.version` | string | 
The version string of the service API or implementation. The format is not defined by these conventions. | `2.0.0`; `a01dbef8a` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `service.name` | string | Logical name of the service. [1] | `shoppingcart` | `Required` |  |
+| `service.version` | string | The version string of the service API or implementation. The format is not defined by these conventions. | `2.0.0`; `a01dbef8a` | `Recommended` |  |
**[1]:** MUST be the same for all instances of horizontally scaled services. If the value was not specified, SDKs MUST fallback to `unknown_service:` concatenated with [`process.executable.name`](process.md#process), e.g. `unknown_service:bash`. If `process.executable.name` is not available, the value MUST be set to `unknown_service`.
@@ -97,10 +97,10 @@ as specified in the [Resource SDK specification](https://github.com/open-telemet
**Description:** Additions to service instance.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `service.instance.id` | string | The string ID of the service instance. [1] | `627cc493-f310-47de-96bd-71410b7dec09` | Recommended |
-| `service.namespace` | string | A namespace for `service.name`. [2] | `Shop` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `service.instance.id` | string | The string ID of the service instance. [1] | `627cc493-f310-47de-96bd-71410b7dec09` | `Recommended` |  |
+| `service.namespace` | string | A namespace for `service.name`. [2] | `Shop` | `Recommended` |  |
**[1]:** MUST be unique for each instance of the same `service.namespace,service.name` pair (in other words
`service.namespace,service.name,service.instance.id` triplet MUST be globally unique). The ID helps to
@@ -155,11 +155,11 @@ service.name = Shop.shoppingcart
**Description:** The telemetry SDK used to capture data recorded by the instrumentation libraries.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `telemetry.sdk.language` | string | 
The language of the telemetry SDK. | `cpp` | Required |
-| `telemetry.sdk.name` | string | 
The name of the telemetry SDK as defined above. [1] | `opentelemetry` | Required |
-| `telemetry.sdk.version` | string | 
The version string of the telemetry SDK. | `1.2.3` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `telemetry.sdk.language` | string | The language of the telemetry SDK. | `cpp` | `Required` |  |
+| `telemetry.sdk.name` | string | The name of the telemetry SDK as defined above. [1] | `opentelemetry` | `Required` |  |
+| `telemetry.sdk.version` | string | The version string of the telemetry SDK. | `1.2.3` | `Required` |  |
**[1]:** The OpenTelemetry SDK MUST set the `telemetry.sdk.name` attribute to `opentelemetry`.
If another SDK, like a fork or a vendor-provided implementation, is used, this SDK MUST set the
@@ -168,22 +168,22 @@ or another suitable identifier depending on the language.
The identifier `opentelemetry` is reserved and MUST NOT be used in this case.
All custom identifiers SHOULD be stable across different versions of an implementation.
-`telemetry.sdk.language` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `cpp` | cpp |
-| `dotnet` | dotnet |
-| `erlang` | erlang |
-| `go` | go |
-| `java` | java |
-| `nodejs` | nodejs |
-| `php` | php |
-| `python` | python |
-| `ruby` | ruby |
-| `rust` | rust |
-| `swift` | swift |
-| `webjs` | webjs |
+`telemetry.sdk.language` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `cpp` | cpp |  |
+| `dotnet` | dotnet |  |
+| `erlang` | erlang |  |
+| `go` | go |  |
+| `java` | java |  |
+| `nodejs` | nodejs |  |
+| `php` | php |  |
+| `python` | python |  |
+| `ruby` | ruby |  |
+| `rust` | rust |  |
+| `swift` | swift |  |
+| `webjs` | webjs |  |
## Telemetry SDK (Experimental)
@@ -195,10 +195,10 @@ All custom identifiers SHOULD be stable across different versions of an implemen
**Description:** Additions to the telemetry SDK.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `telemetry.distro.name` | string | The name of the auto instrumentation agent or distribution, if used. [1] | `parts-unlimited-java` | Recommended |
-| `telemetry.distro.version` | string | The version string of the auto instrumentation agent or distribution, if used. | `1.2.3` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `telemetry.distro.name` | string | The name of the auto instrumentation agent or distribution, if used. [1] | `parts-unlimited-java` | `Recommended` |  |
+| `telemetry.distro.version` | string | The version string of the auto instrumentation agent or distribution, if used. | `1.2.3` | `Recommended` |  |
**[1]:** Official auto instrumentation agents and distributions SHOULD set the `telemetry.distro.name` attribute to
a string starting with `opentelemetry-`, e.g. `opentelemetry-java-instrumentation`.
diff --git a/docs/resource/android.md b/docs/resource/android.md
index aa635d29ef..ab94f1cc98 100644
--- a/docs/resource/android.md
+++ b/docs/resource/android.md
@@ -7,9 +7,9 @@
**Description**: The Android platform on which the Android application is running.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`android.os.api_level`](../attributes-registry/android.md) | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`android.os.api_level`](../attributes-registry/android.md) | string | Uniquely identifies the framework API revision offered by a version (`os.version`) of the android operating system. More information can be found [here](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels). | `33`; `32` | `Recommended` |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/resource/browser.md b/docs/resource/browser.md
index da7818bb5f..4ab2541c1c 100644
--- a/docs/resource/browser.md
+++ b/docs/resource/browser.md
@@ -9,13 +9,13 @@
All of these attributes can be provided by the user agent itself in the form of an HTTP header (e.g. Sec-CH-UA, Sec-CH-Platform, User-Agent). However, the headers could be removed by proxy servers, and are tied to calls from individual clients. In order to support batching through services like the Collector and to prevent loss of data (e.g. due to proxy servers removing headers), these attributes should be used when possible.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`browser.brands`](../attributes-registry/browser.md) | string[] | Array of brand name and version separated by a space [1] | `[ Not A;Brand 99, Chromium 99, Chrome 99]` | Recommended |
-| [`browser.language`](../attributes-registry/browser.md) | string | Preferred language of the user using the browser [2] | `en`; `en-US`; `fr`; `fr-FR` | Recommended |
-| [`browser.mobile`](../attributes-registry/browser.md) | boolean | A boolean that is true if the browser is running on a mobile device [3] | | Recommended |
-| [`browser.platform`](../attributes-registry/browser.md) | string | The platform on which the browser is running [4] | `Windows`; `macOS`; `Android` | Recommended |
-| [`user_agent.original`](../attributes-registry/user-agent.md) | string | Full user-agent string provided by the browser [5] | `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`browser.brands`](../attributes-registry/browser.md) | string[] | Array of brand name and version separated by a space [1] | `[ Not A;Brand 99, Chromium 99, Chrome 99]` | `Recommended` |  |
+| [`browser.language`](../attributes-registry/browser.md) | string | Preferred language of the user using the browser [2] | `en`; `en-US`; `fr`; `fr-FR` | `Recommended` |  |
+| [`browser.mobile`](../attributes-registry/browser.md) | boolean | A boolean that is true if the browser is running on a mobile device [3] | | `Recommended` |  |
+| [`browser.platform`](../attributes-registry/browser.md) | string | The platform on which the browser is running [4] | `Windows`; `macOS`; `Android` | `Recommended` |  |
+| [`user_agent.original`](../attributes-registry/user-agent.md) | string | Full user-agent string provided by the browser [5] | `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36` | `Recommended` |  |
**[1]:** This value is intended to be taken from the [UA client hints API](https://wicg.github.io/ua-client-hints/#interface) (`navigator.userAgentData.brands`).
diff --git a/docs/resource/cloud-provider/aws/ecs.md b/docs/resource/cloud-provider/aws/ecs.md
index 2edafe56b9..a8fe3942bc 100644
--- a/docs/resource/cloud-provider/aws/ecs.md
+++ b/docs/resource/cloud-provider/aws/ecs.md
@@ -7,22 +7,22 @@
**Description:** Resources used by AWS Elastic Container Service (ECS).
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.ecs.cluster.arn` | string | The ARN of an [ECS cluster](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/clusters.html). | `arn:aws:ecs:us-west-2:123456789123:cluster/my-cluster` | Recommended |
-| `aws.ecs.container.arn` | string | The Amazon Resource Name (ARN) of an [ECS container instance](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_instances.html). | `arn:aws:ecs:us-west-1:123456789123:container/32624152-9086-4f0e-acae-1a75b14fe4d9` | Recommended |
-| `aws.ecs.launchtype` | string | The [launch type](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) for an ECS task. | `ec2` | Recommended |
-| `aws.ecs.task.arn` | string | The ARN of a running [ECS task](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids). | `arn:aws:ecs:us-west-1:123456789123:task/10838bed-421f-43ef-870a-f43feacbbb5b`; `arn:aws:ecs:us-west-1:123456789123:task/my-cluster/task-id/23ebb8ac-c18f-46c6-8bbe-d55d0e37cfbd` | Recommended |
-| `aws.ecs.task.family` | string | The family name of the [ECS task definition](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html) used to create the ECS task. | `opentelemetry-family` | Recommended |
-| `aws.ecs.task.id` | string | The ID of a running ECS task. The ID MUST be extracted from `task.arn`. | `10838bed-421f-43ef-870a-f43feacbbb5b`; `23ebb8ac-c18f-46c6-8bbe-d55d0e37cfbd` | Conditionally Required: If and only if `task.arn` is populated. |
-| `aws.ecs.task.revision` | string | The revision for the task definition used to create the ECS task. | `8`; `26` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.ecs.task.id` | string | The ID of a running ECS task. The ID MUST be extracted from `task.arn`. | `10838bed-421f-43ef-870a-f43feacbbb5b`; `23ebb8ac-c18f-46c6-8bbe-d55d0e37cfbd` | `Conditionally Required` If and only if `task.arn` is populated. |  |
+| `aws.ecs.cluster.arn` | string | The ARN of an [ECS cluster](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/clusters.html). | `arn:aws:ecs:us-west-2:123456789123:cluster/my-cluster` | `Recommended` |  |
+| `aws.ecs.container.arn` | string | The Amazon Resource Name (ARN) of an [ECS container instance](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ECS_instances.html). | `arn:aws:ecs:us-west-1:123456789123:container/32624152-9086-4f0e-acae-1a75b14fe4d9` | `Recommended` |  |
+| `aws.ecs.launchtype` | string | The [launch type](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) for an ECS task. | `ec2` | `Recommended` |  |
+| `aws.ecs.task.arn` | string | The ARN of a running [ECS task](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-account-settings.html#ecs-resource-ids). | `arn:aws:ecs:us-west-1:123456789123:task/10838bed-421f-43ef-870a-f43feacbbb5b`; `arn:aws:ecs:us-west-1:123456789123:task/my-cluster/task-id/23ebb8ac-c18f-46c6-8bbe-d55d0e37cfbd` | `Recommended` |  |
+| `aws.ecs.task.family` | string | The family name of the [ECS task definition](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task_definitions.html) used to create the ECS task. | `opentelemetry-family` | `Recommended` |  |
+| `aws.ecs.task.revision` | string | The revision for the task definition used to create the ECS task. | `8`; `26` | `Recommended` |  |
`aws.ecs.launchtype` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `ec2` | ec2 |
-| `fargate` | fargate |
+| Value | Description | Stability |
+|---|---|---|
+| `ec2` | ec2 |  |
+| `fargate` | fargate |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/resource/cloud-provider/aws/eks.md b/docs/resource/cloud-provider/aws/eks.md
index 9bc4e42500..a52ac56557 100644
--- a/docs/resource/cloud-provider/aws/eks.md
+++ b/docs/resource/cloud-provider/aws/eks.md
@@ -7,9 +7,9 @@
**Description:** Resources used by AWS Elastic Kubernetes Service (EKS).
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.eks.cluster.arn` | string | The ARN of an EKS cluster. | `arn:aws:ecs:us-west-2:123456789123:cluster/my-cluster` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.eks.cluster.arn` | string | The ARN of an EKS cluster. | `arn:aws:ecs:us-west-2:123456789123:cluster/my-cluster` | `Recommended` |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/resource/cloud-provider/aws/logs.md b/docs/resource/cloud-provider/aws/logs.md
index 6d7606664d..95558b7b77 100644
--- a/docs/resource/cloud-provider/aws/logs.md
+++ b/docs/resource/cloud-provider/aws/logs.md
@@ -7,12 +7,12 @@
**Description:** Log attributes for Amazon Web Services.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `aws.log.group.arns` | string[] | The Amazon Resource Name(s) (ARN) of the AWS log group(s). [1] | `[arn:aws:logs:us-west-1:123456789012:log-group:/aws/my/group:*]` | Recommended |
-| `aws.log.group.names` | string[] | The name(s) of the AWS log group(s) an application is writing to. [2] | `[/aws/lambda/my-function, opentelemetry-service]` | Recommended |
-| `aws.log.stream.arns` | string[] | The ARN(s) of the AWS log stream(s). [3] | `[arn:aws:logs:us-west-1:123456789012:log-group:/aws/my/group:log-stream:logs/main/10838bed-421f-43ef-870a-f43feacbbb5b]` | Recommended |
-| `aws.log.stream.names` | string[] | The name(s) of the AWS log stream(s) an application is writing to. | `[logs/main/10838bed-421f-43ef-870a-f43feacbbb5b]` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `aws.log.group.arns` | string[] | The Amazon Resource Name(s) (ARN) of the AWS log group(s). [1] | `[arn:aws:logs:us-west-1:123456789012:log-group:/aws/my/group:*]` | `Recommended` |  |
+| `aws.log.group.names` | string[] | The name(s) of the AWS log group(s) an application is writing to. [2] | `[/aws/lambda/my-function, opentelemetry-service]` | `Recommended` |  |
+| `aws.log.stream.arns` | string[] | The ARN(s) of the AWS log stream(s). [3] | `[arn:aws:logs:us-west-1:123456789012:log-group:/aws/my/group:log-stream:logs/main/10838bed-421f-43ef-870a-f43feacbbb5b]` | `Recommended` |  |
+| `aws.log.stream.names` | string[] | The name(s) of the AWS log stream(s) an application is writing to. | `[logs/main/10838bed-421f-43ef-870a-f43feacbbb5b]` | `Recommended` |  |
**[1]:** See the [log group ARN format documentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/iam-access-control-overview-cwl.html#CWL_ARN_Format).
diff --git a/docs/resource/cloud-provider/gcp/cloud-run.md b/docs/resource/cloud-provider/gcp/cloud-run.md
index 1f79773078..e188ddf688 100644
--- a/docs/resource/cloud-provider/gcp/cloud-run.md
+++ b/docs/resource/cloud-provider/gcp/cloud-run.md
@@ -9,10 +9,10 @@ These conventions are recommended for resources running on Cloud Run.
**Description:** Resource attributes for Cloud Run.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`gcp.cloud_run.job.execution`](../../../attributes-registry/gcp-cloud-run.md) | string | The name of the Cloud Run [execution](https://cloud.google.com/run/docs/managing/job-executions) being run for the Job, as set by the [`CLOUD_RUN_EXECUTION`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `job-name-xxxx`; `sample-job-mdw84` | Recommended |
-| [`gcp.cloud_run.job.task_index`](../../../attributes-registry/gcp-cloud-run.md) | int | The index for a task within an execution as provided by the [`CLOUD_RUN_TASK_INDEX`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `0`; `1` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`gcp.cloud_run.job.execution`](../../../attributes-registry/gcp-cloud-run.md) | string | The name of the Cloud Run [execution](https://cloud.google.com/run/docs/managing/job-executions) being run for the Job, as set by the [`CLOUD_RUN_EXECUTION`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `job-name-xxxx`; `sample-job-mdw84` | `Recommended` |  |
+| [`gcp.cloud_run.job.task_index`](../../../attributes-registry/gcp-cloud-run.md) | int | The index for a task within an execution as provided by the [`CLOUD_RUN_TASK_INDEX`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `0`; `1` | `Recommended` |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/resource/cloud-provider/gcp/gce.md b/docs/resource/cloud-provider/gcp/gce.md
index 4e2855ed76..347388be66 100644
--- a/docs/resource/cloud-provider/gcp/gce.md
+++ b/docs/resource/cloud-provider/gcp/gce.md
@@ -5,8 +5,8 @@
**Description:** Resource attributes for GCE instances.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`gcp.gce.instance.hostname`](../../../attributes-registry/gcp-gce.md) | string | The hostname of a GCE instance. This is the full value of the default or [custom hostname](https://cloud.google.com/compute/docs/instances/custom-hostname-vm). | `my-host1234.example.com`; `sample-vm.us-west1-b.c.my-project.internal` | Recommended |
-| [`gcp.gce.instance.name`](../../../attributes-registry/gcp-gce.md) | string | The instance name of a GCE instance. This is the value provided by `host.name`, the visible name of the instance in the Cloud Console UI, and the prefix for the default hostname of the instance as defined by the [default internal DNS name](https://cloud.google.com/compute/docs/internal-dns#instance-fully-qualified-domain-names). | `instance-1`; `my-vm-name` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`gcp.gce.instance.hostname`](../../../attributes-registry/gcp-gce.md) | string | The hostname of a GCE instance. This is the full value of the default or [custom hostname](https://cloud.google.com/compute/docs/instances/custom-hostname-vm). | `my-host1234.example.com`; `sample-vm.us-west1-b.c.my-project.internal` | `Recommended` |  |
+| [`gcp.gce.instance.name`](../../../attributes-registry/gcp-gce.md) | string | The instance name of a GCE instance. This is the value provided by `host.name`, the visible name of the instance in the Cloud Console UI, and the prefix for the default hostname of the instance as defined by the [default internal DNS name](https://cloud.google.com/compute/docs/internal-dns#instance-fully-qualified-domain-names). | `instance-1`; `my-vm-name` | `Recommended` |  |
diff --git a/docs/resource/cloud-provider/heroku.md b/docs/resource/cloud-provider/heroku.md
index 7e20ce9e47..244133673e 100644
--- a/docs/resource/cloud-provider/heroku.md
+++ b/docs/resource/cloud-provider/heroku.md
@@ -7,11 +7,11 @@
**Description:** [Heroku dyno metadata]
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `heroku.app.id` | string | Unique identifier for the application | `2daa2797-e42b-4624-9322-ec3f968df4da` | Opt-In |
-| `heroku.release.commit` | string | Commit hash for the current release | `e6134959463efd8966b20e75b913cafe3f5ec` | Opt-In |
-| `heroku.release.creation_timestamp` | string | Time and date the release was created | `2022-10-23T18:00:42Z` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `heroku.app.id` | string | Unique identifier for the application | `2daa2797-e42b-4624-9322-ec3f968df4da` | `Opt-In` |  |
+| `heroku.release.commit` | string | Commit hash for the current release | `e6134959463efd8966b20e75b913cafe3f5ec` | `Opt-In` |  |
+| `heroku.release.creation_timestamp` | string | Time and date the release was created | `2022-10-23T18:00:42Z` | `Opt-In` |  |
**Mapping:**
diff --git a/docs/resource/cloud.md b/docs/resource/cloud.md
index 8d047494b4..b112f948d5 100644
--- a/docs/resource/cloud.md
+++ b/docs/resource/cloud.md
@@ -7,14 +7,14 @@
**Description:** A cloud infrastructure (e.g. GCP, Azure, AWS).
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`cloud.account.id`](../attributes-registry/cloud.md) | string | The cloud account ID the resource is assigned to. | `111111111111`; `opentelemetry` | Recommended |
-| [`cloud.availability_zone`](../attributes-registry/cloud.md) | string | Cloud regions often have multiple, isolated locations known as zones to increase availability. Availability zone represents the zone where the resource is running. [1] | `us-east-1c` | Recommended |
-| [`cloud.platform`](../attributes-registry/cloud.md) | string | The cloud platform in use. [2] | `alibaba_cloud_ecs` | Recommended |
-| [`cloud.provider`](../attributes-registry/cloud.md) | string | Name of the cloud provider. | `alibaba_cloud` | Recommended |
-| [`cloud.region`](../attributes-registry/cloud.md) | string | The geographical region the resource is running. [3] | `us-central1`; `us-east-1` | Recommended |
-| [`cloud.resource_id`](../attributes-registry/cloud.md) | string | Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name) on GCP) [4] | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`cloud.account.id`](../attributes-registry/cloud.md) | string | The cloud account ID the resource is assigned to. | `111111111111`; `opentelemetry` | `Recommended` |  |
+| [`cloud.availability_zone`](../attributes-registry/cloud.md) | string | Cloud regions often have multiple, isolated locations known as zones to increase availability. Availability zone represents the zone where the resource is running. [1] | `us-east-1c` | `Recommended` |  |
+| [`cloud.platform`](../attributes-registry/cloud.md) | string | The cloud platform in use. [2] | `alibaba_cloud_ecs` | `Recommended` |  |
+| [`cloud.provider`](../attributes-registry/cloud.md) | string | Name of the cloud provider. | `alibaba_cloud` | `Recommended` |  |
+| [`cloud.region`](../attributes-registry/cloud.md) | string | The geographical region the resource is running. [3] | `us-central1`; `us-east-1` | `Recommended` |  |
+| [`cloud.resource_id`](../attributes-registry/cloud.md) | string | Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name) on GCP) [4] | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/` | `Recommended` |  |
**[1]:** Availability zones are called "zones" on Alibaba Cloud and Google Cloud.
@@ -40,50 +40,50 @@ The following well-known definitions MUST be used if you set this attribute and
This means that a span attribute MUST be used, as an Azure function app can host multiple functions that would usually share
a TracerProvider.
-`cloud.platform` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`cloud.platform` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `alibaba_cloud_ecs` | Alibaba Cloud Elastic Compute Service |
-| `alibaba_cloud_fc` | Alibaba Cloud Function Compute |
-| `alibaba_cloud_openshift` | Red Hat OpenShift on Alibaba Cloud |
-| `aws_ec2` | AWS Elastic Compute Cloud |
-| `aws_ecs` | AWS Elastic Container Service |
-| `aws_eks` | AWS Elastic Kubernetes Service |
-| `aws_lambda` | AWS Lambda |
-| `aws_elastic_beanstalk` | AWS Elastic Beanstalk |
-| `aws_app_runner` | AWS App Runner |
-| `aws_openshift` | Red Hat OpenShift on AWS (ROSA) |
-| `azure_vm` | Azure Virtual Machines |
-| `azure_container_apps` | Azure Container Apps |
-| `azure_container_instances` | Azure Container Instances |
-| `azure_aks` | Azure Kubernetes Service |
-| `azure_functions` | Azure Functions |
-| `azure_app_service` | Azure App Service |
-| `azure_openshift` | Azure Red Hat OpenShift |
-| `gcp_bare_metal_solution` | Google Bare Metal Solution (BMS) |
-| `gcp_compute_engine` | Google Cloud Compute Engine (GCE) |
-| `gcp_cloud_run` | Google Cloud Run |
-| `gcp_kubernetes_engine` | Google Cloud Kubernetes Engine (GKE) |
-| `gcp_cloud_functions` | Google Cloud Functions (GCF) |
-| `gcp_app_engine` | Google Cloud App Engine (GAE) |
-| `gcp_openshift` | Red Hat OpenShift on Google Cloud |
-| `ibm_cloud_openshift` | Red Hat OpenShift on IBM Cloud |
-| `tencent_cloud_cvm` | Tencent Cloud Cloud Virtual Machine (CVM) |
-| `tencent_cloud_eks` | Tencent Cloud Elastic Kubernetes Service (EKS) |
-| `tencent_cloud_scf` | Tencent Cloud Serverless Cloud Function (SCF) |
+| Value | Description | Stability |
+|---|---|---|
+| `alibaba_cloud_ecs` | Alibaba Cloud Elastic Compute Service |  |
+| `alibaba_cloud_fc` | Alibaba Cloud Function Compute |  |
+| `alibaba_cloud_openshift` | Red Hat OpenShift on Alibaba Cloud |  |
+| `aws_ec2` | AWS Elastic Compute Cloud |  |
+| `aws_ecs` | AWS Elastic Container Service |  |
+| `aws_eks` | AWS Elastic Kubernetes Service |  |
+| `aws_lambda` | AWS Lambda |  |
+| `aws_elastic_beanstalk` | AWS Elastic Beanstalk |  |
+| `aws_app_runner` | AWS App Runner |  |
+| `aws_openshift` | Red Hat OpenShift on AWS (ROSA) |  |
+| `azure_vm` | Azure Virtual Machines |  |
+| `azure_container_apps` | Azure Container Apps |  |
+| `azure_container_instances` | Azure Container Instances |  |
+| `azure_aks` | Azure Kubernetes Service |  |
+| `azure_functions` | Azure Functions |  |
+| `azure_app_service` | Azure App Service |  |
+| `azure_openshift` | Azure Red Hat OpenShift |  |
+| `gcp_bare_metal_solution` | Google Bare Metal Solution (BMS) |  |
+| `gcp_compute_engine` | Google Cloud Compute Engine (GCE) |  |
+| `gcp_cloud_run` | Google Cloud Run |  |
+| `gcp_kubernetes_engine` | Google Cloud Kubernetes Engine (GKE) |  |
+| `gcp_cloud_functions` | Google Cloud Functions (GCF) |  |
+| `gcp_app_engine` | Google Cloud App Engine (GAE) |  |
+| `gcp_openshift` | Red Hat OpenShift on Google Cloud |  |
+| `ibm_cloud_openshift` | Red Hat OpenShift on IBM Cloud |  |
+| `tencent_cloud_cvm` | Tencent Cloud Cloud Virtual Machine (CVM) |  |
+| `tencent_cloud_eks` | Tencent Cloud Elastic Kubernetes Service (EKS) |  |
+| `tencent_cloud_scf` | Tencent Cloud Serverless Cloud Function (SCF) |  |
-`cloud.provider` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`cloud.provider` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `alibaba_cloud` | Alibaba Cloud |
-| `aws` | Amazon Web Services |
-| `azure` | Microsoft Azure |
-| `gcp` | Google Cloud Platform |
-| `heroku` | Heroku Platform as a Service |
-| `ibm_cloud` | IBM Cloud |
-| `tencent_cloud` | Tencent Cloud |
+| Value | Description | Stability |
+|---|---|---|
+| `alibaba_cloud` | Alibaba Cloud |  |
+| `aws` | Amazon Web Services |  |
+| `azure` | Microsoft Azure |  |
+| `gcp` | Google Cloud Platform |  |
+| `heroku` | Heroku Platform as a Service |  |
+| `ibm_cloud` | IBM Cloud |  |
+| `tencent_cloud` | Tencent Cloud |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/resource/container.md b/docs/resource/container.md
index 7606ce6178..4f5ddb2211 100644
--- a/docs/resource/container.md
+++ b/docs/resource/container.md
@@ -7,31 +7,31 @@
**Description:** A container instance.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`container.command`](../attributes-registry/container.md) | string | The command used to run the container (i.e. the command name). [1] | `otelcontribcol` | Opt-In |
-| [`container.command_args`](../attributes-registry/container.md) | string[] | All the command arguments (including the command/executable itself) run by the container. [2] | `[otelcontribcol, --config, config.yaml]` | Opt-In |
-| [`container.command_line`](../attributes-registry/container.md) | string | The full command run by the container as a single string representing the full command. [2] | `otelcontribcol --config config.yaml` | Opt-In |
-| [`container.id`](../attributes-registry/container.md) | string | Container ID. Usually a UUID, as for example used to [identify Docker containers](https://docs.docker.com/engine/reference/run/#container-identification). The UUID might be abbreviated. | `a3bf90e006b2` | Recommended |
-| [`container.image.id`](../attributes-registry/container.md) | string | Runtime specific image identifier. Usually a hash algorithm followed by a UUID. [2] | `sha256:19c92d0a00d1b66d897bceaa7319bee0dd38a10a851c60bcec9474aa3f01e50f` | Recommended |
-| [`container.image.name`](../attributes-registry/container.md) | string | Name of the image the container was built on. | `gcr.io/opentelemetry/operator` | Recommended |
-| [`container.image.repo_digests`](../attributes-registry/container.md) | string[] | Repo digests of the container image as provided by the container runtime. [3] | `[example@sha256:afcc7f1ac1b49db317a7196c902e61c6c3c4607d63599ee1a82d702d249a0ccb, internal.registry.example.com:5000/example@sha256:b69959407d21e8a062e0416bf13405bb2b71ed7a84dde4158ebafacfa06f5578]` | Recommended |
-| [`container.image.tags`](../attributes-registry/container.md) | string[] | 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 `` section of the full name for example from `registry.example.com/my-org/my-image:`. | `[v1.27.1, 3.5.7-0]` | Recommended |
-| [`container.label.`](../attributes-registry/container.md) | string | Container labels, `` being the label name, the value being the label value. | `container.label.app=nginx` | Recommended |
-| [`container.name`](../attributes-registry/container.md) | string | Container name used by container runtime. | `opentelemetry-autoconf` | Recommended |
-| [`container.runtime`](../attributes-registry/container.md) | string | The container runtime managing this container. | `docker`; `containerd`; `rkt` | Recommended |
-| [`oci.manifest.digest`](../attributes-registry/oci.md) | string | The digest of the OCI image manifest. For container images specifically is the digest by which the container image is known. [4] | `sha256:e4ca62c0d62f3e886e684806dfe9d4e0cda60d54986898173c1083856cfda0f4` | Recommended |
-
-**[1]:** If using embedded credentials or sensitive data, it is recommended to remove them to prevent potential leakage.
-
-**[2]:** 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.
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`container.id`](../attributes-registry/container.md) | string | Container ID. Usually a UUID, as for example used to [identify Docker containers](https://docs.docker.com/engine/reference/run/#container-identification). The UUID might be abbreviated. | `a3bf90e006b2` | `Recommended` |  |
+| [`container.image.id`](../attributes-registry/container.md) | string | Runtime specific image identifier. Usually a hash algorithm followed by a UUID. [1] | `sha256:19c92d0a00d1b66d897bceaa7319bee0dd38a10a851c60bcec9474aa3f01e50f` | `Recommended` |  |
+| [`container.image.name`](../attributes-registry/container.md) | string | Name of the image the container was built on. | `gcr.io/opentelemetry/operator` | `Recommended` |  |
+| [`container.image.repo_digests`](../attributes-registry/container.md) | string[] | Repo digests of the container image as provided by the container runtime. [2] | `[example@sha256:afcc7f1ac1b49db317a7196c902e61c6c3c4607d63599ee1a82d702d249a0ccb, internal.registry.example.com:5000/example@sha256:b69959407d21e8a062e0416bf13405bb2b71ed7a84dde4158ebafacfa06f5578]` | `Recommended` |  |
+| [`container.image.tags`](../attributes-registry/container.md) | string[] | 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 `` section of the full name for example from `registry.example.com/my-org/my-image:`. | `[v1.27.1, 3.5.7-0]` | `Recommended` |  |
+| [`container.label.`](../attributes-registry/container.md) | string | Container labels, `` being the label name, the value being the label value. | `container.label.app=nginx` | `Recommended` |  |
+| [`container.name`](../attributes-registry/container.md) | string | Container name used by container runtime. | `opentelemetry-autoconf` | `Recommended` |  |
+| [`container.runtime`](../attributes-registry/container.md) | string | The container runtime managing this container. | `docker`; `containerd`; `rkt` | `Recommended` |  |
+| [`oci.manifest.digest`](../attributes-registry/oci.md) | string | The digest of the OCI image manifest. For container images specifically is the digest by which the container image is known. [3] | `sha256:e4ca62c0d62f3e886e684806dfe9d4e0cda60d54986898173c1083856cfda0f4` | `Recommended` |  |
+| [`container.command`](../attributes-registry/container.md) | string | The command used to run the container (i.e. the command name). [4] | `otelcontribcol` | `Opt-In` |  |
+| [`container.command_args`](../attributes-registry/container.md) | string[] | All the command arguments (including the command/executable itself) run by the container. [2] | `[otelcontribcol, --config, config.yaml]` | `Opt-In` |  |
+| [`container.command_line`](../attributes-registry/container.md) | string | The full command run by the container as a single string representing the full command. [2] | `otelcontribcol --config config.yaml` | `Opt-In` |  |
+
+**[1]:** 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.
K8s defines a link to the container registry repository with digest `"imageID": "registry.azurecr.io /namespace/service/dockerfile@sha256:bdeabd40c3a8a492eaf9e8e44d0ebbb84bac7ee25ac0cf8a7159d25f62555625"`.
The ID is assinged 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.
-**[3]:** [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.
+**[2]:** [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.
-**[4]:** Follows [OCI Image Manifest Specification](https://github.com/opencontainers/image-spec/blob/main/manifest.md), and specifically the [Digest property](https://github.com/opencontainers/image-spec/blob/main/descriptor.md#digests).
+**[3]:** Follows [OCI Image Manifest Specification](https://github.com/opencontainers/image-spec/blob/main/manifest.md), and specifically the [Digest property](https://github.com/opencontainers/image-spec/blob/main/descriptor.md#digests).
An example can be found in [Example Image Manifest](https://docs.docker.com/registry/spec/manifest-v2-2/#example-image-manifest).
+
+**[4]:** If using embedded credentials or sensitive data, it is recommended to remove them to prevent potential leakage.
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/resource/deployment-environment.md b/docs/resource/deployment-environment.md
index 12301f3ae5..7957a9a3ff 100644
--- a/docs/resource/deployment-environment.md
+++ b/docs/resource/deployment-environment.md
@@ -7,9 +7,9 @@
**Description:** The software deployment.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`deployment.environment`](../attributes-registry/deployment.md) | string | Name of the [deployment environment](https://wikipedia.org/wiki/Deployment_environment) (aka deployment tier). [1] | `staging`; `production` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`deployment.environment`](../attributes-registry/deployment.md) | string | Name of the [deployment environment](https://wikipedia.org/wiki/Deployment_environment) (aka deployment tier). [1] | `staging`; `production` | `Recommended` |  |
**[1]:** `deployment.environment` does not affect the uniqueness constraints defined through
the `service.namespace`, `service.name` and `service.instance.id` resource attributes.
diff --git a/docs/resource/device.md b/docs/resource/device.md
index 57bd6dea97..603ef93c51 100644
--- a/docs/resource/device.md
+++ b/docs/resource/device.md
@@ -7,12 +7,12 @@
**Description**: The device on which the process represented by this resource is running.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`device.id`](../attributes-registry/device.md) | string | A unique identifier representing the device [1] | `2ab2916d-a51f-4ac8-80ee-45ac31a28092` | Recommended |
-| [`device.manufacturer`](../attributes-registry/device.md) | string | The name of the device manufacturer [2] | `Apple`; `Samsung` | Recommended |
-| [`device.model.identifier`](../attributes-registry/device.md) | string | The model identifier for the device [3] | `iPhone3,4`; `SM-G920F` | Recommended |
-| [`device.model.name`](../attributes-registry/device.md) | string | The marketing name for the device model [4] | `iPhone 6s Plus`; `Samsung Galaxy S6` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`device.id`](../attributes-registry/device.md) | string | A unique identifier representing the device [1] | `2ab2916d-a51f-4ac8-80ee-45ac31a28092` | `Recommended` |  |
+| [`device.manufacturer`](../attributes-registry/device.md) | string | The name of the device manufacturer [2] | `Apple`; `Samsung` | `Recommended` |  |
+| [`device.model.identifier`](../attributes-registry/device.md) | string | The model identifier for the device [3] | `iPhone3,4`; `SM-G920F` | `Recommended` |  |
+| [`device.model.name`](../attributes-registry/device.md) | string | The marketing name for the device model [4] | `iPhone 6s Plus`; `Samsung Galaxy S6` | `Recommended` |  |
**[1]:** The device identifier MUST only be defined using the values outlined below. This value is not an advertising identifier and MUST NOT be used as such. On iOS (Swift or Objective-C), this value MUST be equal to the [vendor identifier](https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor). On Android (Java or Kotlin), this value MUST be equal to the Firebase Installation ID or a globally unique UUID which is persisted across sessions in your application. More information can be found [here](https://developer.android.com/training/articles/user-data-ids) on best practices and exact implementation details. Caution should be taken when storing personal data or anything which can identify a user. GDPR and data protection laws may apply, ensure you do your own due diligence.
diff --git a/docs/resource/faas.md b/docs/resource/faas.md
index b354c2fdad..c7c3bc76d5 100644
--- a/docs/resource/faas.md
+++ b/docs/resource/faas.md
@@ -14,15 +14,32 @@ See also:
## FaaS resource attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`cloud.resource_id`](../attributes-registry/cloud.md) | string | Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name) on GCP) [1] | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/` | Recommended |
-| [`faas.instance`](../attributes-registry/faas.md) | string | The execution environment ID as a string, that will be potentially reused for other invocations to the same function/function version. [2] | `2021/06/28/[$LATEST]2f399eb14537447da05ab2a2e39309de` | Recommended |
-| [`faas.max_memory`](../attributes-registry/faas.md) | int | The amount of memory available to the serverless function converted to Bytes. [3] | `134217728` | Recommended |
-| [`faas.name`](../attributes-registry/faas.md) | string | The name of the single function that this runtime instance executes. [4] | `my-function`; `myazurefunctionapp/some-function-name` | Required |
-| [`faas.version`](../attributes-registry/faas.md) | string | The immutable version of the function being executed. [5] | `26`; `pinkfroid-00002` | Recommended |
-
-**[1]:** On some cloud providers, it may not be possible to determine the full ID at startup,
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`faas.name`](../attributes-registry/faas.md) | string | The name of the single function that this runtime instance executes. [1] | `my-function`; `myazurefunctionapp/some-function-name` | `Required` |  |
+| [`cloud.resource_id`](../attributes-registry/cloud.md) | string | Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://cloud.google.com/apis/design/resource_names#full_resource_name) on GCP) [2] | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/` | `Recommended` |  |
+| [`faas.instance`](../attributes-registry/faas.md) | string | The execution environment ID as a string, that will be potentially reused for other invocations to the same function/function version. [3] | `2021/06/28/[$LATEST]2f399eb14537447da05ab2a2e39309de` | `Recommended` |  |
+| [`faas.max_memory`](../attributes-registry/faas.md) | int | The amount of memory available to the serverless function converted to Bytes. [4] | `134217728` | `Recommended` |  |
+| [`faas.version`](../attributes-registry/faas.md) | string | The immutable version of the function being executed. [5] | `26`; `pinkfroid-00002` | `Recommended` |  |
+
+**[1]:** This is the name of the function as configured/deployed on the FaaS
+platform and is usually different from the name of the callback
+function (which may be stored in the
+[`code.namespace`/`code.function`](/docs/general/attributes.md#source-code-attributes)
+span attributes).
+
+For some cloud providers, the above definition is ambiguous. The following
+definition of function name MUST be used for this attribute
+(and consequently the span name) for the listed cloud providers/products:
+
+* **Azure:** The full name `/`, i.e., function app name
+ followed by a forward slash followed by the function name (this form
+ can also be seen in the resource JSON for the function).
+ This means that a span attribute MUST be used, as an Azure function
+ app can host multiple functions that would usually share
+ a TracerProvider (see also the `cloud.resource_id` attribute).
+
+**[2]:** On some cloud providers, it may not be possible to determine the full ID at startup,
so it may be necessary to set `cloud.resource_id` as a span attribute instead.
The exact value to use for `cloud.resource_id` depends on the cloud provider.
@@ -40,26 +57,9 @@ The following well-known definitions MUST be used if you set this attribute and
This means that a span attribute MUST be used, as an Azure function app can host multiple functions that would usually share
a TracerProvider.
-**[2]:** * **AWS Lambda:** Use the (full) log stream name.
+**[3]:** * **AWS Lambda:** Use the (full) log stream name.
-**[3]:** It's recommended to set this attribute since e.g. too little memory can easily stop a Java AWS Lambda function from working correctly. On AWS Lambda, the environment variable `AWS_LAMBDA_FUNCTION_MEMORY_SIZE` provides this information (which must be multiplied by 1,048,576).
-
-**[4]:** This is the name of the function as configured/deployed on the FaaS
-platform and is usually different from the name of the callback
-function (which may be stored in the
-[`code.namespace`/`code.function`](/docs/general/attributes.md#source-code-attributes)
-span attributes).
-
-For some cloud providers, the above definition is ambiguous. The following
-definition of function name MUST be used for this attribute
-(and consequently the span name) for the listed cloud providers/products:
-
-* **Azure:** The full name `/`, i.e., function app name
- followed by a forward slash followed by the function name (this form
- can also be seen in the resource JSON for the function).
- This means that a span attribute MUST be used, as an Azure function
- app can host multiple functions that would usually share
- a TracerProvider (see also the `cloud.resource_id` attribute).
+**[4]:** It's recommended to set this attribute since e.g. too little memory can easily stop a Java AWS Lambda function from working correctly. On AWS Lambda, the environment variable `AWS_LAMBDA_FUNCTION_MEMORY_SIZE` provides this information (which must be multiplied by 1,048,576).
**[5]:** Depending on the cloud provider and platform, use:
diff --git a/docs/resource/host.md b/docs/resource/host.md
index da04a28970..7eb33feb17 100644
--- a/docs/resource/host.md
+++ b/docs/resource/host.md
@@ -10,47 +10,47 @@ The `host.*` namespace SHOULD be exclusively used to capture resource attributes
To report host metrics, the `system.*` namespace SHOULD be used.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`host.arch`](../attributes-registry/host.md) | string | The CPU architecture the host system is running on. | `amd64` | Recommended |
-| [`host.id`](../attributes-registry/host.md) | string | Unique host ID. For Cloud, this must be the instance_id assigned by the cloud provider. For non-containerized systems, this should be the `machine-id`. See the table below for the sources to use to determine the `machine-id` based on operating system. | `fdbf79e8af94cb7f9e8df36789187052` | Recommended |
-| [`host.image.id`](../attributes-registry/host.md) | string | VM image ID or host OS image ID. For Cloud, this value is from the provider. | `ami-07b06b442921831e5` | Recommended |
-| [`host.image.name`](../attributes-registry/host.md) | string | Name of the VM image or OS install the host was instantiated from. | `infra-ami-eks-worker-node-7d4ec78312`; `CentOS-8-x86_64-1905` | Recommended |
-| [`host.image.version`](../attributes-registry/host.md) | string | The version string of the VM image or host OS as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `0.1` | Recommended |
-| [`host.ip`](../attributes-registry/host.md) | string[] | Available IP addresses of the host, excluding loopback interfaces. [1] | `[192.168.1.140, fe80::abc2:4a28:737a:609e]` | Opt-In |
-| [`host.mac`](../attributes-registry/host.md) | string[] | Available MAC addresses of the host, excluding loopback interfaces. [2] | `[AC-DE-48-23-45-67, AC-DE-48-23-45-67-01-9F]` | Opt-In |
-| [`host.name`](../attributes-registry/host.md) | string | Name of the host. On Unix systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user. | `opentelemetry-test` | Recommended |
-| [`host.type`](../attributes-registry/host.md) | string | Type of host. For Cloud, this must be the machine type. | `n1-standard-1` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`host.arch`](../attributes-registry/host.md) | string | The CPU architecture the host system is running on. | `amd64` | `Recommended` |  |
+| [`host.id`](../attributes-registry/host.md) | string | Unique host ID. For Cloud, this must be the instance_id assigned by the cloud provider. For non-containerized systems, this should be the `machine-id`. See the table below for the sources to use to determine the `machine-id` based on operating system. | `fdbf79e8af94cb7f9e8df36789187052` | `Recommended` |  |
+| [`host.image.id`](../attributes-registry/host.md) | string | VM image ID or host OS image ID. For Cloud, this value is from the provider. | `ami-07b06b442921831e5` | `Recommended` |  |
+| [`host.image.name`](../attributes-registry/host.md) | string | Name of the VM image or OS install the host was instantiated from. | `infra-ami-eks-worker-node-7d4ec78312`; `CentOS-8-x86_64-1905` | `Recommended` |  |
+| [`host.image.version`](../attributes-registry/host.md) | string | The version string of the VM image or host OS as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `0.1` | `Recommended` |  |
+| [`host.name`](../attributes-registry/host.md) | string | Name of the host. On Unix systems, it may contain what the hostname command returns, or the fully qualified hostname, or another name specified by the user. | `opentelemetry-test` | `Recommended` |  |
+| [`host.type`](../attributes-registry/host.md) | string | Type of host. For Cloud, this must be the machine type. | `n1-standard-1` | `Recommended` |  |
+| [`host.ip`](../attributes-registry/host.md) | string[] | Available IP addresses of the host, excluding loopback interfaces. [1] | `[192.168.1.140, fe80::abc2:4a28:737a:609e]` | `Opt-In` |  |
+| [`host.mac`](../attributes-registry/host.md) | string[] | Available MAC addresses of the host, excluding loopback interfaces. [2] | `[AC-DE-48-23-45-67, AC-DE-48-23-45-67-01-9F]` | `Opt-In` |  |
**[1]:** IPv4 Addresses MUST be specified in dotted-quad notation. IPv6 addresses MUST be specified in the [RFC 5952](https://www.rfc-editor.org/rfc/rfc5952.html) format.
**[2]:** MAC Addresses MUST be represented in [IEEE RA hexadecimal form](https://standards.ieee.org/wp-content/uploads/import/documents/tutorials/eui.pdf): as hyphen-separated octets in uppercase hexadecimal form from most to least significant.
-`host.arch` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `amd64` | AMD64 |
-| `arm32` | ARM32 |
-| `arm64` | ARM64 |
-| `ia64` | Itanium |
-| `ppc32` | 32-bit PowerPC |
-| `ppc64` | 64-bit PowerPC |
-| `s390x` | IBM z/Architecture |
-| `x86` | 32-bit x86 |
+`host.arch` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `amd64` | AMD64 |  |
+| `arm32` | ARM32 |  |
+| `arm64` | ARM64 |  |
+| `ia64` | Itanium |  |
+| `ppc32` | 32-bit PowerPC |  |
+| `ppc64` | 64-bit PowerPC |  |
+| `s390x` | IBM z/Architecture |  |
+| `x86` | 32-bit x86 |  |
**type:** `host.cpu`
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`host.cpu.cache.l2.size`](../attributes-registry/host.md) | int | The amount of level 2 memory cache available to the processor (in Bytes). | `12288000` | Opt-In |
-| [`host.cpu.family`](../attributes-registry/host.md) | string | Family or generation of the CPU. | `6`; `PA-RISC 1.1e` | Opt-In |
-| [`host.cpu.model.id`](../attributes-registry/host.md) | string | Model identifier. It provides more granular information about the CPU, distinguishing it from other CPUs within the same family. | `6`; `9000/778/B180L` | Opt-In |
-| [`host.cpu.model.name`](../attributes-registry/host.md) | string | Model designation of the processor. | `11th Gen Intel(R) Core(TM) i7-1185G7 @ 3.00GHz` | Opt-In |
-| [`host.cpu.stepping`](../attributes-registry/host.md) | string | Stepping or core revisions. | `1`; `r1p1` | Opt-In |
-| [`host.cpu.vendor.id`](../attributes-registry/host.md) | string | Processor manufacturer identifier. A maximum 12-character string. [1] | `GenuineIntel` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`host.cpu.cache.l2.size`](../attributes-registry/host.md) | int | The amount of level 2 memory cache available to the processor (in Bytes). | `12288000` | `Opt-In` |  |
+| [`host.cpu.family`](../attributes-registry/host.md) | string | Family or generation of the CPU. | `6`; `PA-RISC 1.1e` | `Opt-In` |  |
+| [`host.cpu.model.id`](../attributes-registry/host.md) | string | Model identifier. It provides more granular information about the CPU, distinguishing it from other CPUs within the same family. | `6`; `9000/778/B180L` | `Opt-In` |  |
+| [`host.cpu.model.name`](../attributes-registry/host.md) | string | Model designation of the processor. | `11th Gen Intel(R) Core(TM) i7-1185G7 @ 3.00GHz` | `Opt-In` |  |
+| [`host.cpu.stepping`](../attributes-registry/host.md) | string | Stepping or core revisions. | `1`; `r1p1` | `Opt-In` |  |
+| [`host.cpu.vendor.id`](../attributes-registry/host.md) | string | Processor manufacturer identifier. A maximum 12-character string. [1] | `GenuineIntel` | `Opt-In` |  |
**[1]:** [CPUID](https://wiki.osdev.org/CPUID) command returns the vendor ID string in EBX, EDX and ECX registers. Writing these to memory in this order results in a 12-character string.
diff --git a/docs/resource/k8s.md b/docs/resource/k8s.md
index 1dd9a9fdee..f67ad0957b 100644
--- a/docs/resource/k8s.md
+++ b/docs/resource/k8s.md
@@ -22,10 +22,10 @@ Kubernetes object, but "name" is usually more user friendly so can be also set.
**Description:** A Kubernetes Cluster.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`k8s.cluster.name`](../attributes-registry/k8s.md) | string | The name of the cluster. | `opentelemetry-cluster` | Recommended |
-| [`k8s.cluster.uid`](../attributes-registry/k8s.md) | string | A pseudo-ID for the cluster, set to the UID of the `kube-system` namespace. [1] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`k8s.cluster.name`](../attributes-registry/k8s.md) | string | The name of the cluster. | `opentelemetry-cluster` | `Recommended` |  |
+| [`k8s.cluster.uid`](../attributes-registry/k8s.md) | string | A pseudo-ID for the cluster, set to the UID of the `kube-system` namespace. [1] | `218fc5a9-a5f1-4b54-aa05-46717d0ab26d` | `Recommended` |  |
**[1]:** K8s doesn't have support for obtaining a cluster ID. If this is ever
added, we will recommend collecting the `k8s.cluster.uid` through the
@@ -58,10 +58,10 @@ conflict.
**Description:** A Kubernetes Node.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`k8s.node.name`](../attributes-registry/k8s.md) | string | The name of the Node. | `node-1` | Recommended |
-| [`k8s.node.uid`](../attributes-registry/k8s.md) | string | The UID of the Node. | `1eb3a0c6-0477-4080-a9cb-0cb7db65c6a2` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`k8s.node.name`](../attributes-registry/k8s.md) | string | The name of the Node. | `node-1` | `Recommended` |  |
+| [`k8s.node.uid`](../attributes-registry/k8s.md) | string | The UID of the Node. | `1eb3a0c6-0477-4080-a9cb-0cb7db65c6a2` | `Recommended` |  |
## Namespace
@@ -74,9 +74,9 @@ a namespace, but not across namespaces.
**Description:** A Kubernetes Namespace.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`k8s.namespace.name`](../attributes-registry/k8s.md) | string | The name of the namespace that the pod is running in. | `default` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`k8s.namespace.name`](../attributes-registry/k8s.md) | string | The name of the namespace that the pod is running in. | `default` | `Recommended` |  |
## Pod
@@ -89,12 +89,12 @@ containers on your cluster.
**Description:** A Kubernetes Pod object.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`k8s.pod.annotation.`](../attributes-registry/k8s.md) | string | The annotation key-value pairs placed on the Pod, the `` being the annotation name, the value being the annotation value. | `k8s.pod.annotation.kubernetes.io/enforce-mountable-secrets=true`; `k8s.pod.annotation.mycompany.io/arch=x64`; `k8s.pod.annotation.data=` | Opt-In |
-| [`k8s.pod.label.`](../attributes-registry/k8s.md) | string | The label key-value pairs placed on the Pod, the `` being the label name, the value being the label value. | `k8s.pod.label.app=my-app`; `k8s.pod.label.mycompany.io/arch=x64`; `k8s.pod.label.data=` | Recommended |
-| [`k8s.pod.name`](../attributes-registry/k8s.md) | string | The name of the Pod. | `opentelemetry-pod-autoconf` | Recommended |
-| [`k8s.pod.uid`](../attributes-registry/k8s.md) | string | The UID of the Pod. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`k8s.pod.label.`](../attributes-registry/k8s.md) | string | The label key-value pairs placed on the Pod, the `` being the label name, the value being the label value. | `k8s.pod.label.app=my-app`; `k8s.pod.label.mycompany.io/arch=x64`; `k8s.pod.label.data=` | `Recommended` |  |
+| [`k8s.pod.name`](../attributes-registry/k8s.md) | string | The name of the Pod. | `opentelemetry-pod-autoconf` | `Recommended` |  |
+| [`k8s.pod.uid`](../attributes-registry/k8s.md) | string | The UID of the Pod. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | `Recommended` |  |
+| [`k8s.pod.annotation.`](../attributes-registry/k8s.md) | string | The annotation key-value pairs placed on the Pod, the `` being the annotation name, the value being the annotation value. | `k8s.pod.annotation.kubernetes.io/enforce-mountable-secrets=true`; `k8s.pod.annotation.mycompany.io/arch=x64`; `k8s.pod.annotation.data=` | `Opt-In` |  |
## Container
@@ -111,10 +111,10 @@ to a running container.
**Description:** A container in a [PodTemplate](https://kubernetes.io/docs/concepts/workloads/pods/#pod-templates).
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`k8s.container.name`](../attributes-registry/k8s.md) | string | The name of the Container from Pod specification, must be unique within a Pod. Container runtime usually uses different globally unique name (`container.name`). | `redis` | Recommended |
-| [`k8s.container.restart_count`](../attributes-registry/k8s.md) | int | Number of times the container was restarted. This attribute can be used to identify a particular container (running or stopped) within a container spec. | `0`; `2` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`k8s.container.name`](../attributes-registry/k8s.md) | string | The name of the Container from Pod specification, must be unique within a Pod. Container runtime usually uses different globally unique name (`container.name`). | `redis` | `Recommended` |  |
+| [`k8s.container.restart_count`](../attributes-registry/k8s.md) | int | Number of times the container was restarted. This attribute can be used to identify a particular container (running or stopped) within a container spec. | `0`; `2` | `Recommended` |  |
## ReplicaSet
@@ -127,10 +127,10 @@ any given time.
**Description:** A Kubernetes ReplicaSet object.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`k8s.replicaset.name`](../attributes-registry/k8s.md) | string | The name of the ReplicaSet. | `opentelemetry` | Recommended |
-| [`k8s.replicaset.uid`](../attributes-registry/k8s.md) | string | The UID of the ReplicaSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`k8s.replicaset.name`](../attributes-registry/k8s.md) | string | The name of the ReplicaSet. | `opentelemetry` | `Recommended` |  |
+| [`k8s.replicaset.uid`](../attributes-registry/k8s.md) | string | The UID of the ReplicaSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | `Recommended` |  |
## Deployment
@@ -144,10 +144,10 @@ distributed among the nodes of a cluster.
**Description:** A Kubernetes Deployment object.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`k8s.deployment.name`](../attributes-registry/k8s.md) | string | The name of the Deployment. | `opentelemetry` | Recommended |
-| [`k8s.deployment.uid`](../attributes-registry/k8s.md) | string | The UID of the Deployment. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`k8s.deployment.name`](../attributes-registry/k8s.md) | string | The name of the Deployment. | `opentelemetry` | `Recommended` |  |
+| [`k8s.deployment.uid`](../attributes-registry/k8s.md) | string | The UID of the Deployment. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | `Recommended` |  |
## StatefulSet
@@ -160,10 +160,10 @@ about the ordering and uniqueness of these Pods.
**Description:** A Kubernetes StatefulSet object.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`k8s.statefulset.name`](../attributes-registry/k8s.md) | string | The name of the StatefulSet. | `opentelemetry` | Recommended |
-| [`k8s.statefulset.uid`](../attributes-registry/k8s.md) | string | The UID of the StatefulSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`k8s.statefulset.name`](../attributes-registry/k8s.md) | string | The name of the StatefulSet. | `opentelemetry` | `Recommended` |  |
+| [`k8s.statefulset.uid`](../attributes-registry/k8s.md) | string | The UID of the StatefulSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | `Recommended` |  |
## DaemonSet
@@ -175,10 +175,10 @@ A DaemonSet ensures that all (or some) Nodes run a copy of a Pod.
**Description:** A Kubernetes DaemonSet object.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`k8s.daemonset.name`](../attributes-registry/k8s.md) | string | The name of the DaemonSet. | `opentelemetry` | Recommended |
-| [`k8s.daemonset.uid`](../attributes-registry/k8s.md) | string | The UID of the DaemonSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`k8s.daemonset.name`](../attributes-registry/k8s.md) | string | The name of the DaemonSet. | `opentelemetry` | `Recommended` |  |
+| [`k8s.daemonset.uid`](../attributes-registry/k8s.md) | string | The UID of the DaemonSet. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | `Recommended` |  |
## Job
@@ -191,10 +191,10 @@ successfully terminate.
**Description:** A Kubernetes Job object.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`k8s.job.name`](../attributes-registry/k8s.md) | string | The name of the Job. | `opentelemetry` | Recommended |
-| [`k8s.job.uid`](../attributes-registry/k8s.md) | string | The UID of the Job. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`k8s.job.name`](../attributes-registry/k8s.md) | string | The name of the Job. | `opentelemetry` | `Recommended` |  |
+| [`k8s.job.uid`](../attributes-registry/k8s.md) | string | The UID of the Job. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | `Recommended` |  |
## CronJob
@@ -206,10 +206,10 @@ A CronJob creates Jobs on a repeating schedule.
**Description:** A Kubernetes CronJob object.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`k8s.cronjob.name`](../attributes-registry/k8s.md) | string | The name of the CronJob. | `opentelemetry` | Recommended |
-| [`k8s.cronjob.uid`](../attributes-registry/k8s.md) | string | The UID of the CronJob. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`k8s.cronjob.name`](../attributes-registry/k8s.md) | string | The name of the CronJob. | `opentelemetry` | `Recommended` |  |
+| [`k8s.cronjob.uid`](../attributes-registry/k8s.md) | string | The UID of the CronJob. | `275ecb36-5aa8-4c2a-9c47-d8bb681b9aff` | `Recommended` |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/resource/os.md b/docs/resource/os.md
index 4b681018d9..02fb418bea 100644
--- a/docs/resource/os.md
+++ b/docs/resource/os.md
@@ -9,29 +9,29 @@
In case of virtualized environments, this is the operating system as it is observed by the process, i.e., the virtualized guest rather than the underlying host.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`os.build_id`](../attributes-registry/os.md) | string | Unique identifier for a particular build or compilation of the operating system. | `TQ3C.230805.001.B2`; `20E247`; `22621` | Recommended |
-| [`os.description`](../attributes-registry/os.md) | string | Human readable (not intended to be parsed) OS version information, like e.g. reported by `ver` or `lsb_release -a` commands. | `Microsoft Windows [Version 10.0.18363.778]`; `Ubuntu 18.04.1 LTS` | Recommended |
-| [`os.name`](../attributes-registry/os.md) | string | Human readable operating system name. | `iOS`; `Android`; `Ubuntu` | Recommended |
-| [`os.type`](../attributes-registry/os.md) | string | The operating system type. | `windows` | Required |
-| [`os.version`](../attributes-registry/os.md) | string | The version string of the operating system as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `14.2.1`; `18.04.1` | Recommended |
-
-`os.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
-
-| Value | Description |
-|---|---|
-| `windows` | Microsoft Windows |
-| `linux` | Linux |
-| `darwin` | Apple Darwin |
-| `freebsd` | FreeBSD |
-| `netbsd` | NetBSD |
-| `openbsd` | OpenBSD |
-| `dragonflybsd` | DragonFly BSD |
-| `hpux` | HP-UX (Hewlett Packard Unix) |
-| `aix` | AIX (Advanced Interactive eXecutive) |
-| `solaris` | SunOS, Oracle Solaris |
-| `z_os` | IBM z/OS |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`os.type`](../attributes-registry/os.md) | string | The operating system type. | `windows` | `Required` |  |
+| [`os.build_id`](../attributes-registry/os.md) | string | Unique identifier for a particular build or compilation of the operating system. | `TQ3C.230805.001.B2`; `20E247`; `22621` | `Recommended` |  |
+| [`os.description`](../attributes-registry/os.md) | string | Human readable (not intended to be parsed) OS version information, like e.g. reported by `ver` or `lsb_release -a` commands. | `Microsoft Windows [Version 10.0.18363.778]`; `Ubuntu 18.04.1 LTS` | `Recommended` |  |
+| [`os.name`](../attributes-registry/os.md) | string | Human readable operating system name. | `iOS`; `Android`; `Ubuntu` | `Recommended` |  |
+| [`os.version`](../attributes-registry/os.md) | string | The version string of the operating system as defined in [Version Attributes](/docs/resource/README.md#version-attributes). | `14.2.1`; `18.04.1` | `Recommended` |  |
+
+`os.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
+
+| Value | Description | Stability |
+|---|---|---|
+| `windows` | Microsoft Windows |  |
+| `linux` | Linux |  |
+| `darwin` | Apple Darwin |  |
+| `freebsd` | FreeBSD |  |
+| `netbsd` | NetBSD |  |
+| `openbsd` | OpenBSD |  |
+| `dragonflybsd` | DragonFly BSD |  |
+| `hpux` | HP-UX (Hewlett Packard Unix) |  |
+| `aix` | AIX (Advanced Interactive eXecutive) |  |
+| `solaris` | SunOS, Oracle Solaris |  |
+| `z_os` | IBM z/OS |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/resource/process.md b/docs/resource/process.md
index 36403a2de4..f52861ee86 100644
--- a/docs/resource/process.md
+++ b/docs/resource/process.md
@@ -25,16 +25,16 @@
**Description:** An operating system process.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`process.command`](../attributes-registry/process.md) | string | The command used to launch the process (i.e. the command name). On Linux based systems, can be set to the zeroth string in `proc/[pid]/cmdline`. On Windows, can be set to the first parameter extracted from `GetCommandLineW`. | `cmd/otelcol` | Conditionally Required: See alternative attributes below. |
-| [`process.command_args`](../attributes-registry/process.md) | string[] | All the command arguments (including the command/executable itself) as received by the process. On Linux-based systems (and some other Unixoid systems supporting procfs), can be set according to the list of null-delimited strings extracted from `proc/[pid]/cmdline`. For libc-based executables, this would be the full argv vector passed to `main`. | `[cmd/otecol, --config=config.yaml]` | Conditionally Required: See alternative attributes below. |
-| [`process.command_line`](../attributes-registry/process.md) | string | The full command used to launch the process as a single string representing the full command. On Windows, can be set to the result of `GetCommandLineW`. Do not set this if you have to assemble it just for monitoring; use `process.command_args` instead. | `C:\cmd\otecol --config="my directory\config.yaml"` | Conditionally Required: See alternative attributes below. |
-| [`process.executable.name`](../attributes-registry/process.md) | string | The name of the process executable. On Linux based systems, can be set to the `Name` in `proc/[pid]/status`. On Windows, can be set to the base name of `GetProcessImageFileNameW`. | `otelcol` | Conditionally Required: See alternative attributes below. |
-| [`process.executable.path`](../attributes-registry/process.md) | string | The full path to the process executable. On Linux based systems, can be set to the target of `proc/[pid]/exe`. On Windows, can be set to the result of `GetProcessImageFileNameW`. | `/usr/bin/cmd/otelcol` | Conditionally Required: See alternative attributes below. |
-| [`process.owner`](../attributes-registry/process.md) | string | The username of the user that owns the process. | `root` | Recommended |
-| [`process.parent_pid`](../attributes-registry/process.md) | int | Parent Process identifier (PPID). | `111` | Recommended |
-| [`process.pid`](../attributes-registry/process.md) | int | Process identifier (PID). | `1234` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`process.command`](../attributes-registry/process.md) | string | The command used to launch the process (i.e. the command name). On Linux based systems, can be set to the zeroth string in `proc/[pid]/cmdline`. On Windows, can be set to the first parameter extracted from `GetCommandLineW`. | `cmd/otelcol` | `Conditionally Required` See alternative attributes below. |  |
+| [`process.command_args`](../attributes-registry/process.md) | string[] | All the command arguments (including the command/executable itself) as received by the process. On Linux-based systems (and some other Unixoid systems supporting procfs), can be set according to the list of null-delimited strings extracted from `proc/[pid]/cmdline`. For libc-based executables, this would be the full argv vector passed to `main`. | `[cmd/otecol, --config=config.yaml]` | `Conditionally Required` See alternative attributes below. |  |
+| [`process.command_line`](../attributes-registry/process.md) | string | The full command used to launch the process as a single string representing the full command. On Windows, can be set to the result of `GetCommandLineW`. Do not set this if you have to assemble it just for monitoring; use `process.command_args` instead. | `C:\cmd\otecol --config="my directory\config.yaml"` | `Conditionally Required` See alternative attributes below. |  |
+| [`process.executable.name`](../attributes-registry/process.md) | string | The name of the process executable. On Linux based systems, can be set to the `Name` in `proc/[pid]/status`. On Windows, can be set to the base name of `GetProcessImageFileNameW`. | `otelcol` | `Conditionally Required` See alternative attributes below. |  |
+| [`process.executable.path`](../attributes-registry/process.md) | string | The full path to the process executable. On Linux based systems, can be set to the target of `proc/[pid]/exe`. On Windows, can be set to the result of `GetProcessImageFileNameW`. | `/usr/bin/cmd/otelcol` | `Conditionally Required` See alternative attributes below. |  |
+| [`process.owner`](../attributes-registry/process.md) | string | The username of the user that owns the process. | `root` | `Recommended` |  |
+| [`process.parent_pid`](../attributes-registry/process.md) | int | Parent Process identifier (PPID). | `111` | `Recommended` |  |
+| [`process.pid`](../attributes-registry/process.md) | int | Process identifier (PID). | `1234` | `Recommended` |  |
**Additional attribute requirements:** At least one of the following sets of attributes is required:
@@ -60,11 +60,11 @@ In that case it MUST be interpreted as if it was `process.command_args`.
**Description:** The single (language) runtime instance which is monitored.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`process.runtime.description`](../attributes-registry/process.md) | string | An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment. | `Eclipse OpenJ9 Eclipse OpenJ9 VM openj9-0.21.0` | Recommended |
-| [`process.runtime.name`](../attributes-registry/process.md) | string | The name of the runtime of this process. For compiled native binaries, this SHOULD be the name of the compiler. | `OpenJDK Runtime Environment` | Recommended |
-| [`process.runtime.version`](../attributes-registry/process.md) | string | The version of the runtime of this process, as returned by the runtime without modification. | `14.0.2` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`process.runtime.description`](../attributes-registry/process.md) | string | An additional description about the runtime of the process, for example a specific vendor customization of the runtime environment. | `Eclipse OpenJ9 Eclipse OpenJ9 VM openj9-0.21.0` | `Recommended` |  |
+| [`process.runtime.name`](../attributes-registry/process.md) | string | The name of the runtime of this process. For compiled native binaries, this SHOULD be the name of the compiler. | `OpenJDK Runtime Environment` | `Recommended` |  |
+| [`process.runtime.version`](../attributes-registry/process.md) | string | The version of the runtime of this process, as returned by the runtime without modification. | `14.0.2` | `Recommended` |  |
How to set these attributes for particular runtime kinds is described in the following subsections.
diff --git a/docs/resource/webengine.md b/docs/resource/webengine.md
index 0d23bbdd1b..6589e85faf 100644
--- a/docs/resource/webengine.md
+++ b/docs/resource/webengine.md
@@ -7,11 +7,11 @@
**Description:** Resource describing the packaged software running the application code. Web engines are typically executed using process.runtime.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `webengine.description` | string | Additional description of the web engine (e.g. detailed version and edition information). | `WildFly Full 21.0.0.Final (WildFly Core 13.0.1.Final) - 2.2.2.Final` | Recommended |
-| `webengine.name` | string | The name of the web engine. | `WildFly` | Required |
-| `webengine.version` | string | The version of the web engine. | `21.0.0` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `webengine.name` | string | The name of the web engine. | `WildFly` | `Required` |  |
+| `webengine.description` | string | Additional description of the web engine (e.g. detailed version and edition information). | `WildFly Full 21.0.0.Final (WildFly Core 13.0.1.Final) - 2.2.2.Final` | `Recommended` |  |
+| `webengine.version` | string | The version of the web engine. | `21.0.0` | `Recommended` |  |
Information describing the web engine SHOULD be captured using the values acquired from the API provided by the web engine, preferably during runtime, to avoid maintenance burden on engine version upgrades. As an example - Java engines are often but not always packaged as application servers. For Java application servers supporting Servlet API the required information MAY be captured by invoking `ServletContext.getServerInfo()` during runtime and parsing the result.
diff --git a/docs/rpc/connect-rpc.md b/docs/rpc/connect-rpc.md
index dd590f75dd..8cebaabebf 100644
--- a/docs/rpc/connect-rpc.md
+++ b/docs/rpc/connect-rpc.md
@@ -17,11 +17,11 @@ described on this page.
Below is a table of attributes that SHOULD be included on client and server Connect RPC measurements.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`rpc.connect_rpc.error_code`](../attributes-registry/rpc.md) | string | The [error codes](https://connect.build/docs/protocol/#error-codes) of the Connect request. Error codes are always string values. | `cancelled` | Conditionally Required: [1] |
-| [`rpc.connect_rpc.request.metadata.`](../attributes-registry/rpc.md) | string[] | Connect request metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [2] | `rpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` | Opt-In |
-| [`rpc.connect_rpc.response.metadata.`](../attributes-registry/rpc.md) | string[] | Connect response metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [3] | `rpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`rpc.connect_rpc.error_code`](../attributes-registry/rpc.md) | string | The [error codes](https://connect.build/docs/protocol/#error-codes) of the Connect request. Error codes are always string values. | `cancelled` | `Conditionally Required` [1] |  |
+| [`rpc.connect_rpc.request.metadata.`](../attributes-registry/rpc.md) | string[] | Connect request metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [2] | `rpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` | `Opt-In` |  |
+| [`rpc.connect_rpc.response.metadata.`](../attributes-registry/rpc.md) | string[] | Connect response metadata, `` being the normalized Connect Metadata key (lowercase), the value being the metadata values. [3] | `rpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` | `Opt-In` |  |
**[1]:** If response is not successful and if error code available.
@@ -31,24 +31,24 @@ Below is a table of attributes that SHOULD be included on client and server Conn
`rpc.connect_rpc.error_code` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `cancelled` | cancelled |
-| `unknown` | unknown |
-| `invalid_argument` | invalid_argument |
-| `deadline_exceeded` | deadline_exceeded |
-| `not_found` | not_found |
-| `already_exists` | already_exists |
-| `permission_denied` | permission_denied |
-| `resource_exhausted` | resource_exhausted |
-| `failed_precondition` | failed_precondition |
-| `aborted` | aborted |
-| `out_of_range` | out_of_range |
-| `unimplemented` | unimplemented |
-| `internal` | internal |
-| `unavailable` | unavailable |
-| `data_loss` | data_loss |
-| `unauthenticated` | unauthenticated |
+| Value | Description | Stability |
+|---|---|---|
+| `cancelled` | cancelled |  |
+| `unknown` | unknown |  |
+| `invalid_argument` | invalid_argument |  |
+| `deadline_exceeded` | deadline_exceeded |  |
+| `not_found` | not_found |  |
+| `already_exists` | already_exists |  |
+| `permission_denied` | permission_denied |  |
+| `resource_exhausted` | resource_exhausted |  |
+| `failed_precondition` | failed_precondition |  |
+| `aborted` | aborted |  |
+| `out_of_range` | out_of_range |  |
+| `unimplemented` | unimplemented |  |
+| `internal` | internal |  |
+| `unavailable` | unavailable |  |
+| `data_loss` | data_loss |  |
+| `unauthenticated` | unauthenticated |  |
## Connect RPC Status
diff --git a/docs/rpc/grpc.md b/docs/rpc/grpc.md
index 100f17dc4b..32ce3d5f7a 100644
--- a/docs/rpc/grpc.md
+++ b/docs/rpc/grpc.md
@@ -17,11 +17,11 @@ described on this page.
Below is a table of attributes that SHOULD be included on client and server gRPC measurements.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`rpc.grpc.request.metadata.`](../attributes-registry/rpc.md) | string[] | gRPC request metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [1] | `rpc.grpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` | Opt-In |
-| [`rpc.grpc.response.metadata.`](../attributes-registry/rpc.md) | string[] | gRPC response metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [2] | `rpc.grpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` | Opt-In |
-| [`rpc.grpc.status_code`](../attributes-registry/rpc.md) | int | The [numeric status code](https://github.com/grpc/grpc/blob/v1.33.2/doc/statuscodes.md) of the gRPC request. | `0` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`rpc.grpc.status_code`](../attributes-registry/rpc.md) | int | The [numeric status code](https://github.com/grpc/grpc/blob/v1.33.2/doc/statuscodes.md) of the gRPC request. | `0` | `Required` |  |
+| [`rpc.grpc.request.metadata.`](../attributes-registry/rpc.md) | string[] | gRPC request metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [1] | `rpc.grpc.request.metadata.my-custom-metadata-attribute=["1.2.3.4", "1.2.3.5"]` | `Opt-In` |  |
+| [`rpc.grpc.response.metadata.`](../attributes-registry/rpc.md) | string[] | gRPC response metadata, `` being the normalized gRPC Metadata key (lowercase), the value being the metadata values. [2] | `rpc.grpc.response.metadata.my-custom-metadata-attribute=["attribute_value"]` | `Opt-In` |  |
**[1]:** Instrumentations SHOULD require an explicit configuration of which metadata values are to be captured. Including all request metadata values can be a security risk - explicit configuration helps avoid leaking sensitive information.
@@ -29,25 +29,25 @@ Below is a table of attributes that SHOULD be included on client and server gRPC
`rpc.grpc.status_code` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `0` | OK |
-| `1` | CANCELLED |
-| `2` | UNKNOWN |
-| `3` | INVALID_ARGUMENT |
-| `4` | DEADLINE_EXCEEDED |
-| `5` | NOT_FOUND |
-| `6` | ALREADY_EXISTS |
-| `7` | PERMISSION_DENIED |
-| `8` | RESOURCE_EXHAUSTED |
-| `9` | FAILED_PRECONDITION |
-| `10` | ABORTED |
-| `11` | OUT_OF_RANGE |
-| `12` | UNIMPLEMENTED |
-| `13` | INTERNAL |
-| `14` | UNAVAILABLE |
-| `15` | DATA_LOSS |
-| `16` | UNAUTHENTICATED |
+| Value | Description | Stability |
+|---|---|---|
+| `0` | OK |  |
+| `1` | CANCELLED |  |
+| `2` | UNKNOWN |  |
+| `3` | INVALID_ARGUMENT |  |
+| `4` | DEADLINE_EXCEEDED |  |
+| `5` | NOT_FOUND |  |
+| `6` | ALREADY_EXISTS |  |
+| `7` | PERMISSION_DENIED |  |
+| `8` | RESOURCE_EXHAUSTED |  |
+| `9` | FAILED_PRECONDITION |  |
+| `10` | ABORTED |  |
+| `11` | OUT_OF_RANGE |  |
+| `12` | UNIMPLEMENTED |  |
+| `13` | INTERNAL |  |
+| `14` | UNAVAILABLE |  |
+| `15` | DATA_LOSS |  |
+| `16` | UNAUTHENTICATED |  |
## gRPC Status
diff --git a/docs/rpc/json-rpc.md b/docs/rpc/json-rpc.md
index dbf79fca70..e0978e3e06 100644
--- a/docs/rpc/json-rpc.md
+++ b/docs/rpc/json-rpc.md
@@ -15,13 +15,13 @@ described on this page.
`rpc.system` MUST be set to `"jsonrpc"`.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`rpc.jsonrpc.error_code`](../attributes-registry/rpc.md) | int | `error.code` property of response if it is an error response. | `-32700`; `100` | Conditionally Required: If response is not successful. |
-| [`rpc.jsonrpc.error_message`](../attributes-registry/rpc.md) | string | `error.message` property of response if it is an error response. | `Parse error`; `User already exists` | Recommended |
-| [`rpc.jsonrpc.request_id`](../attributes-registry/rpc.md) | string | `id` property of request or response. Since protocol allows id to be int, string, `null` or missing (for notifications), value is expected to be cast to string for simplicity. Use empty string in case of `null` value. Omit entirely if this is a notification. | `10`; `request-7`; `` | Recommended |
-| [`rpc.jsonrpc.version`](../attributes-registry/rpc.md) | string | Protocol version as in `jsonrpc` property of request/response. Since JSON-RPC 1.0 doesn't specify this, the value can be omitted. | `2.0`; `1.0` | Conditionally Required: If other than the default version (`1.0`) |
-| [`rpc.method`](../attributes-registry/rpc.md) | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [1] | `exampleMethod` | Required |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`rpc.method`](../attributes-registry/rpc.md) | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [1] | `exampleMethod` | `Required` |  |
+| [`rpc.jsonrpc.error_code`](../attributes-registry/rpc.md) | int | `error.code` property of response if it is an error response. | `-32700`; `100` | `Conditionally Required` If response is not successful. |  |
+| [`rpc.jsonrpc.version`](../attributes-registry/rpc.md) | string | Protocol version as in `jsonrpc` property of request/response. Since JSON-RPC 1.0 doesn't specify this, the value can be omitted. | `2.0`; `1.0` | `Conditionally Required` If other than the default version (`1.0`) |  |
+| [`rpc.jsonrpc.error_message`](../attributes-registry/rpc.md) | string | `error.message` property of response if it is an error response. | `Parse error`; `User already exists` | `Recommended` |  |
+| [`rpc.jsonrpc.request_id`](../attributes-registry/rpc.md) | string | `id` property of request or response. Since protocol allows id to be int, string, `null` or missing (for notifications), value is expected to be cast to string for simplicity. Use empty string in case of `null` value. Omit entirely if this is a notification. | `10`; `request-7`; `` | `Recommended` |  |
**[1]:** This is always required for jsonrpc. See the note in the general RPC conventions for more information.
diff --git a/docs/rpc/rpc-metrics.md b/docs/rpc/rpc-metrics.md
index 6369eb4461..4c8e433fff 100644
--- a/docs/rpc/rpc-metrics.md
+++ b/docs/rpc/rpc-metrics.md
@@ -77,9 +77,9 @@ Below is a list of RPC server metric instruments.
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `rpc.server.duration` | Histogram | `ms` | Measures the duration of inbound RPC. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `rpc.server.duration` | Histogram | `ms` | Measures the duration of inbound RPC. [1] |  |
**[1]:** While streaming RPCs may record this metric as start-of-batch
to end-of-batch, it's hard to interpret in practice.
@@ -92,9 +92,9 @@ to end-of-batch, it's hard to interpret in practice.
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `rpc.server.request.size` | Histogram | `By` | Measures the size of RPC request messages (uncompressed). [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `rpc.server.request.size` | Histogram | `By` | Measures the size of RPC request messages (uncompressed). [1] |  |
**[1]:** **Streaming**: Recorded per message in a streaming batch
@@ -104,9 +104,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `rpc.server.response.size` | Histogram | `By` | Measures the size of RPC response messages (uncompressed). [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `rpc.server.response.size` | Histogram | `By` | Measures the size of RPC response messages (uncompressed). [1] |  |
**[1]:** **Streaming**: Recorded per response in a streaming batch
@@ -116,9 +116,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `rpc.server.requests_per_rpc` | Histogram | `{count}` | Measures the number of messages received per RPC. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `rpc.server.requests_per_rpc` | Histogram | `{count}` | Measures the number of messages received per RPC. [1] |  |
**[1]:** Should be 1 for all non-streaming RPCs.
@@ -130,9 +130,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `rpc.server.responses_per_rpc` | Histogram | `{count}` | Measures the number of messages sent per RPC. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `rpc.server.responses_per_rpc` | Histogram | `{count}` | Measures the number of messages sent per RPC. [1] |  |
**[1]:** Should be 1 for all non-streaming RPCs.
@@ -149,9 +149,9 @@ These apply to traditional RPC usage, not streaming RPCs.
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `rpc.client.duration` | Histogram | `ms` | Measures the duration of outbound RPC. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `rpc.client.duration` | Histogram | `ms` | Measures the duration of outbound RPC. [1] |  |
**[1]:** While streaming RPCs may record this metric as start-of-batch
to end-of-batch, it's hard to interpret in practice.
@@ -164,9 +164,9 @@ to end-of-batch, it's hard to interpret in practice.
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `rpc.client.request.size` | Histogram | `By` | Measures the size of RPC request messages (uncompressed). [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `rpc.client.request.size` | Histogram | `By` | Measures the size of RPC request messages (uncompressed). [1] |  |
**[1]:** **Streaming**: Recorded per message in a streaming batch
@@ -176,9 +176,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `rpc.client.response.size` | Histogram | `By` | Measures the size of RPC response messages (uncompressed). [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `rpc.client.response.size` | Histogram | `By` | Measures the size of RPC response messages (uncompressed). [1] |  |
**[1]:** **Streaming**: Recorded per response in a streaming batch
@@ -188,9 +188,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `rpc.client.requests_per_rpc` | Histogram | `{count}` | Measures the number of messages received per RPC. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `rpc.client.requests_per_rpc` | Histogram | `{count}` | Measures the number of messages received per RPC. [1] |  |
**[1]:** Should be 1 for all non-streaming RPCs.
@@ -202,9 +202,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `rpc.client.responses_per_rpc` | Histogram | `{count}` | Measures the number of messages sent per RPC. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `rpc.client.responses_per_rpc` | Histogram | `{count}` | Measures the number of messages sent per RPC. [1] |  |
**[1]:** Should be 1 for all non-streaming RPCs.
@@ -217,15 +217,15 @@ Below is a table of attributes that SHOULD be included on client and server RPC
measurements.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `udp` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | Recommended |
-| [`rpc.method`](../attributes-registry/rpc.md) | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [3] | `exampleMethod` | Recommended |
-| [`rpc.service`](../attributes-registry/rpc.md) | string | The full (logical) name of the service being called, including its package name, if applicable. [4] | `myservice.EchoService` | Recommended |
-| [`rpc.system`](../attributes-registry/rpc.md) | string | A string identifying the remoting system. See below for a list of well-known identifiers. | `grpc` | Required |
-| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [5] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [6] | `80`; `8080`; `443` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`rpc.system`](../attributes-registry/rpc.md) | string | A string identifying the remoting system. See below for a list of well-known identifiers. | `grpc` | `Required` |  |
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `udp` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | `Recommended` |  |
+| [`rpc.method`](../attributes-registry/rpc.md) | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [3] | `exampleMethod` | `Recommended` |  |
+| [`rpc.service`](../attributes-registry/rpc.md) | string | The full (logical) name of the service being called, including its package name, if applicable. [4] | `myservice.EchoService` | `Recommended` |  |
+| [`server.address`](../attributes-registry/server.md) | string | Server domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [5] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [6] | `80`; `8080`; `443` | `Recommended` |  |
**[1]:** The value SHOULD be normalized to lowercase.
@@ -243,31 +243,31 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
**[6]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`rpc.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `grpc` | gRPC |  |
+| `java_rmi` | Java RMI |  |
+| `dotnet_wcf` | .NET WCF |  |
+| `apache_dubbo` | Apache Dubbo |  |
+| `connect_rpc` | Connect RPC |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`rpc.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `grpc` | gRPC |
-| `java_rmi` | Java RMI |
-| `dotnet_wcf` | .NET WCF |
-| `apache_dubbo` | Apache Dubbo |
-| `connect_rpc` | Connect RPC |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
For client-side metrics `server.port` is required if the connection is IP-based and the port is available (it describes the server port they are connecting to).
diff --git a/docs/rpc/rpc-spans.md b/docs/rpc/rpc-spans.md
index 0fc18c483d..b91d7cbd21 100644
--- a/docs/rpc/rpc-spans.md
+++ b/docs/rpc/rpc-spans.md
@@ -82,59 +82,59 @@ Examples of span names:
### Common attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `udp` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [2] | `ipv4`; `ipv6` | Recommended |
-| [`rpc.method`](../attributes-registry/rpc.md) | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [3] | `exampleMethod` | Recommended |
-| [`rpc.service`](../attributes-registry/rpc.md) | string | The full (logical) name of the service being called, including its package name, if applicable. [4] | `myservice.EchoService` | Recommended |
-| [`rpc.system`](../attributes-registry/rpc.md) | string | A string identifying the remoting system. See below for a list of well-known identifiers. | `grpc` | Required |
-| [`server.address`](../attributes-registry/server.md) | string | RPC server [host name](https://grpc.github.io/grpc/core/md_doc_naming.html). [5] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | Required |
-| [`server.port`](../attributes-registry/server.md) | int | Server port number. [6] | `80`; `8080`; `443` | Conditionally Required: [7] |
-
-**[1]:** The value SHOULD be normalized to lowercase.
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`rpc.system`](../attributes-registry/rpc.md) | string | A string identifying the remoting system. See below for a list of well-known identifiers. | `grpc` | `Required` |  |
+| [`server.address`](../attributes-registry/server.md) | string | RPC server [host name](https://grpc.github.io/grpc/core/md_doc_naming.html). [1] | `example.com`; `10.1.2.80`; `/tmp/my.sock` | `Required` |  |
+| [`server.port`](../attributes-registry/server.md) | int | Server port number. [2] | `80`; `8080`; `443` | `Conditionally Required` [3] |  |
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [4] | `tcp`; `udp` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [5] | `ipv4`; `ipv6` | `Recommended` |  |
+| [`rpc.method`](../attributes-registry/rpc.md) | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [6] | `exampleMethod` | `Recommended` |  |
+| [`rpc.service`](../attributes-registry/rpc.md) | string | The full (logical) name of the service being called, including its package name, if applicable. [7] | `myservice.EchoService` | `Recommended` |  |
-Consider always setting the transport when setting a port number, since
-a port number is ambiguous without knowing the transport. For example
-different processes could be listening on TCP port 12345 and UDP port 12345.
+**[1]:** May contain server IP address, DNS name, or local socket name. When host component is an IP address, instrumentations SHOULD NOT do a reverse proxy lookup to obtain DNS name and SHOULD set `server.address` to the IP address provided in the host component.
+
+**[2]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
-**[2]:** The value SHOULD be normalized to lowercase.
+**[3]:** if the port is supported by the network transport used for communication.
-**[3]:** This is the logical name of the method from the RPC interface perspective, which can be different from the name of any implementing method/function. The `code.function` attribute may be used to store the latter (e.g., method actually executing the call on the server side, RPC client stub method on the client side).
+**[4]:** The value SHOULD be normalized to lowercase.
-**[4]:** This is the logical name of the service from the RPC interface perspective, which can be different from the name of any implementing class. The `code.namespace` attribute may be used to store the latter (despite the attribute name, it may include a class name; e.g., class with method actually executing the call on the server side, RPC client stub class on the client side).
+Consider always setting the transport when setting a port number, since
+a port number is ambiguous without knowing the transport. For example
+different processes could be listening on TCP port 12345 and UDP port 12345.
-**[5]:** May contain server IP address, DNS name, or local socket name. When host component is an IP address, instrumentations SHOULD NOT do a reverse proxy lookup to obtain DNS name and SHOULD set `server.address` to the IP address provided in the host component.
+**[5]:** The value SHOULD be normalized to lowercase.
-**[6]:** When observed from the client side, and when communicating through an intermediary, `server.port` SHOULD represent the server port behind any intermediaries, for example proxies, if it's available.
+**[6]:** This is the logical name of the method from the RPC interface perspective, which can be different from the name of any implementing method/function. The `code.function` attribute may be used to store the latter (e.g., method actually executing the call on the server side, RPC client stub method on the client side).
-**[7]:** if the port is supported by the network transport used for communication.
+**[7]:** This is the logical name of the service from the RPC interface perspective, which can be different from the name of any implementing class. The `code.namespace` attribute may be used to store the latter (despite the attribute name, it may include a class name; e.g., class with method actually executing the call on the server side, RPC client stub class on the client side).
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`rpc.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `grpc` | gRPC |  |
+| `java_rmi` | Java RMI |  |
+| `dotnet_wcf` | .NET WCF |  |
+| `apache_dubbo` | Apache Dubbo |  |
+| `connect_rpc` | Connect RPC |  |
-`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `ipv4` | IPv4 |
-| `ipv6` | IPv6 |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
-`rpc.system` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `grpc` | gRPC |
-| `java_rmi` | Java RMI |
-| `dotnet_wcf` | .NET WCF |
-| `apache_dubbo` | Apache Dubbo |
-| `connect_rpc` | Connect RPC |
+| Value | Description | Stability |
+|---|---|---|
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
#### Service name
@@ -154,23 +154,23 @@ Generally, a user SHOULD NOT set `peer.service` to a fully qualified RPC service
### Client attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | Recommended: If `network.peer.address` is set. |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | `Recommended` If `network.peer.address` is set. |  |
### Server attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`client.address`](../attributes-registry/client.md) | string | Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `client.example.com`; `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`client.port`](../attributes-registry/client.md) | int | Client port number. [2] | `65123` | Recommended |
-| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | Recommended |
-| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | Recommended: If `network.peer.address` is set. |
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `udp` | Recommended |
-| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [4] | `ipv4`; `ipv6` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`client.address`](../attributes-registry/client.md) | string | Client address - domain name if available without reverse DNS lookup; otherwise, IP address or Unix domain socket name. [1] | `client.example.com`; `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`client.port`](../attributes-registry/client.md) | int | Client port number. [2] | `65123` | `Recommended` |  |
+| [`network.peer.address`](../attributes-registry/network.md) | string | Peer address of the network connection - IP address or Unix domain socket name. | `10.1.2.80`; `/tmp/my.sock` | `Recommended` |  |
+| [`network.peer.port`](../attributes-registry/network.md) | int | Peer port number of the network connection. | `65123` | `Recommended` If `network.peer.address` is set. |  |
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `udp` | `Recommended` |  |
+| [`network.type`](../attributes-registry/network.md) | string | [OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent. [4] | `ipv4`; `ipv6` | `Recommended` |  |
**[1]:** When observed from the server side, and when communicating through an intermediary, `client.address` SHOULD represent the client address behind any intermediaries, for example proxies, if it's available.
@@ -194,21 +194,21 @@ and one received message will be recorded for both client and server spans.
The event name MUST be `message`.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `message.compressed_size` | int | Compressed size of the message in bytes. | | Recommended |
-| `message.id` | int | MUST be calculated as two different counters starting from `1` one for sent messages and one for received message. [1] | | Recommended |
-| `message.type` | string | Whether this is a received or sent message. | `SENT` | Recommended |
-| `message.uncompressed_size` | int | Uncompressed size of the message in bytes. | | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `message.compressed_size` | int | Compressed size of the message in bytes. | | `Recommended` |  |
+| `message.id` | int | MUST be calculated as two different counters starting from `1` one for sent messages and one for received message. [1] | | `Recommended` |  |
+| `message.type` | string | Whether this is a received or sent message. | `SENT` | `Recommended` |  |
+| `message.uncompressed_size` | int | Uncompressed size of the message in bytes. | | `Recommended` |  |
**[1]:** This way we guarantee that the values will be consistent between different implementations.
`message.type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `SENT` | sent |
-| `RECEIVED` | received |
+| Value | Description | Stability |
+|---|---|---|
+| `SENT` | sent |  |
+| `RECEIVED` | received |  |
### Distinction from HTTP spans
diff --git a/docs/runtime/jvm-metrics.md b/docs/runtime/jvm-metrics.md
index 7d2d27d148..8128f8371c 100644
--- a/docs/runtime/jvm-metrics.md
+++ b/docs/runtime/jvm-metrics.md
@@ -51,25 +51,25 @@ This metric is [recommended][MetricRecommended].
This metric is obtained from [`MemoryPoolMXBean#getUsage()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/MemoryPoolMXBean.html#getUsage--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.memory.used` | UpDownCounter | `By` | Measure of memory used. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.memory.used` | UpDownCounter | `By` | Measure of memory used. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `jvm.memory.pool.name` | string | 
Name of the memory pool. [1] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` | Recommended |
-| `jvm.memory.type` | string | 
The type of memory. | `heap`; `non_heap` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `jvm.memory.pool.name` | string | Name of the memory pool. [1] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` | `Recommended` |  |
+| `jvm.memory.type` | string | The type of memory. | `heap`; `non_heap` | `Recommended` |  |
**[1]:** Pool names are generally obtained via [MemoryPoolMXBean#getName()](https://docs.oracle.com/en/java/javase/11/docs/api/java.management/java/lang/management/MemoryPoolMXBean.html#getName()).
`jvm.memory.type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `heap` | Heap memory. |
-| `non_heap` | Non-heap memory |
+| Value | Description | Stability |
+|---|---|---|
+| `heap` | Heap memory. |  |
+| `non_heap` | Non-heap memory |  |
### Metric: `jvm.memory.committed`
@@ -78,25 +78,25 @@ This metric is [recommended][MetricRecommended].
This metric is obtained from [`MemoryPoolMXBean#getUsage()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/MemoryPoolMXBean.html#getUsage--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.memory.committed` | UpDownCounter | `By` | Measure of memory committed. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.memory.committed` | UpDownCounter | `By` | Measure of memory committed. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `jvm.memory.pool.name` | string | 
Name of the memory pool. [1] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` | Recommended |
-| `jvm.memory.type` | string | 
The type of memory. | `heap`; `non_heap` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `jvm.memory.pool.name` | string | Name of the memory pool. [1] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` | `Recommended` |  |
+| `jvm.memory.type` | string | The type of memory. | `heap`; `non_heap` | `Recommended` |  |
**[1]:** Pool names are generally obtained via [MemoryPoolMXBean#getName()](https://docs.oracle.com/en/java/javase/11/docs/api/java.management/java/lang/management/MemoryPoolMXBean.html#getName()).
`jvm.memory.type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `heap` | Heap memory. |
-| `non_heap` | Non-heap memory |
+| Value | Description | Stability |
+|---|---|---|
+| `heap` | Heap memory. |  |
+| `non_heap` | Non-heap memory |  |
### Metric: `jvm.memory.limit`
@@ -105,25 +105,25 @@ This metric is [recommended][MetricRecommended].
This metric is obtained from [`MemoryPoolMXBean#getUsage()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/MemoryPoolMXBean.html#getUsage--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.memory.limit` | UpDownCounter | `By` | Measure of max obtainable memory. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.memory.limit` | UpDownCounter | `By` | Measure of max obtainable memory. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `jvm.memory.pool.name` | string | 
Name of the memory pool. [1] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` | Recommended |
-| `jvm.memory.type` | string | 
The type of memory. | `heap`; `non_heap` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `jvm.memory.pool.name` | string | Name of the memory pool. [1] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` | `Recommended` |  |
+| `jvm.memory.type` | string | The type of memory. | `heap`; `non_heap` | `Recommended` |  |
**[1]:** Pool names are generally obtained via [MemoryPoolMXBean#getName()](https://docs.oracle.com/en/java/javase/11/docs/api/java.management/java/lang/management/MemoryPoolMXBean.html#getName()).
`jvm.memory.type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `heap` | Heap memory. |
-| `non_heap` | Non-heap memory |
+| Value | Description | Stability |
+|---|---|---|
+| `heap` | Heap memory. |  |
+| `non_heap` | Non-heap memory |  |
### Metric: `jvm.memory.used_after_last_gc`
@@ -132,25 +132,25 @@ This metric is [recommended][MetricRecommended].
This metric is obtained from [`MemoryPoolMXBean#getCollectionUsage()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/MemoryPoolMXBean.html#getCollectionUsage--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.memory.used_after_last_gc` | UpDownCounter | `By` | Measure of memory used, as measured after the most recent garbage collection event on this pool. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.memory.used_after_last_gc` | UpDownCounter | `By` | Measure of memory used, as measured after the most recent garbage collection event on this pool. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `jvm.memory.pool.name` | string | 
Name of the memory pool. [1] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` | Recommended |
-| `jvm.memory.type` | string | 
The type of memory. | `heap`; `non_heap` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `jvm.memory.pool.name` | string | Name of the memory pool. [1] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` | `Recommended` |  |
+| `jvm.memory.type` | string | The type of memory. | `heap`; `non_heap` | `Recommended` |  |
**[1]:** Pool names are generally obtained via [MemoryPoolMXBean#getName()](https://docs.oracle.com/en/java/javase/11/docs/api/java.management/java/lang/management/MemoryPoolMXBean.html#getName()).
`jvm.memory.type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `heap` | Heap memory. |
-| `non_heap` | Non-heap memory |
+| Value | Description | Stability |
+|---|---|---|
+| `heap` | Heap memory. |  |
+| `non_heap` | Non-heap memory |  |
## JVM Garbage Collection
@@ -170,16 +170,16 @@ This metric SHOULD be specified with
of `[ 0.01, 0.1, 1, 10 ]`.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.gc.duration` | Histogram | `s` | Duration of JVM garbage collection actions. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.gc.duration` | Histogram | `s` | Duration of JVM garbage collection actions. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `jvm.gc.action` | string | 
Name of the garbage collector action. [1] | `end of minor GC`; `end of major GC` | Recommended |
-| `jvm.gc.name` | string | 
Name of the garbage collector. [2] | `G1 Young Generation`; `G1 Old Generation` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `jvm.gc.action` | string | Name of the garbage collector action. [1] | `end of minor GC`; `end of major GC` | `Recommended` |  |
+| `jvm.gc.name` | string | Name of the garbage collector. [2] | `G1 Young Generation`; `G1 Old Generation` | `Recommended` |  |
**[1]:** Garbage collector action is generally obtained via [GarbageCollectionNotificationInfo#getGcAction()](https://docs.oracle.com/en/java/javase/11/docs/api/jdk.management/com/sun/management/GarbageCollectionNotificationInfo.html#getGcAction()).
@@ -205,27 +205,27 @@ This metric is obtained from a combination of
Note that this is the number of platform threads (as opposed to virtual threads).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.thread.count` | UpDownCounter | `{thread}` | Number of executing platform threads. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.thread.count` | UpDownCounter | `{thread}` | Number of executing platform threads. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `jvm.thread.daemon` | boolean | 
Whether the thread is daemon or not. | | Recommended |
-| `jvm.thread.state` | string | 
State of the thread. | `runnable`; `blocked` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `jvm.thread.daemon` | boolean | Whether the thread is daemon or not. | | `Recommended` |  |
+| `jvm.thread.state` | string | State of the thread. | `runnable`; `blocked` | `Recommended` |  |
`jvm.thread.state` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `new` | A thread that has not yet started is in this state. |
-| `runnable` | A thread executing in the Java virtual machine is in this state. |
-| `blocked` | A thread that is blocked waiting for a monitor lock is in this state. |
-| `waiting` | A thread that is waiting indefinitely for another thread to perform a particular action is in this state. |
-| `timed_waiting` | A thread that is waiting for another thread to perform an action for up to a specified waiting time is in this state. |
-| `terminated` | A thread that has exited is in this state. |
+| Value | Description | Stability |
+|---|---|---|
+| `new` | A thread that has not yet started is in this state. |  |
+| `runnable` | A thread executing in the Java virtual machine is in this state. |  |
+| `blocked` | A thread that is blocked waiting for a monitor lock is in this state. |  |
+| `waiting` | A thread that is waiting indefinitely for another thread to perform a particular action is in this state. |  |
+| `timed_waiting` | A thread that is waiting for another thread to perform an action for up to a specified waiting time is in this state. |  |
+| `terminated` | A thread that has exited is in this state. |  |
## JVM Classes
@@ -240,9 +240,9 @@ This metric is [recommended][MetricRecommended].
This metric is obtained from [`ClassLoadingMXBean#getTotalLoadedClassCount()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/ClassLoadingMXBean.html#getTotalLoadedClassCount--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.class.loaded` | Counter | `{class}` | Number of classes loaded since JVM start. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.class.loaded` | Counter | `{class}` | Number of classes loaded since JVM start. |  |
@@ -254,9 +254,9 @@ This metric is [recommended][MetricRecommended].
This metric is obtained from [`ClassLoadingMXBean#getUnloadedClassCount()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/ClassLoadingMXBean.html#getUnloadedClassCount--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.class.unloaded` | Counter | `{class}` | Number of classes unloaded since JVM start. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.class.unloaded` | Counter | `{class}` | Number of classes unloaded since JVM start. |  |
@@ -268,9 +268,9 @@ This metric is [recommended][MetricRecommended].
This metric is obtained from [`ClassLoadingMXBean#getLoadedClassCount()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/ClassLoadingMXBean.html#getLoadedClassCount--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.class.count` | UpDownCounter | `{class}` | Number of classes currently loaded. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.class.count` | UpDownCounter | `{class}` | Number of classes currently loaded. |  |
@@ -290,9 +290,9 @@ This metric is obtained from [`com.sun.management.OperatingSystemMXBean#getProce
and [`com.ibm.lang.management.OperatingSystemMXBean#getProcessCpuTime()`](https://www.ibm.com/docs/api/v1/content/SSYKE2_8.0.0/openj9/api/jdk8/jre/management/extension/com/ibm/lang/management/OperatingSystemMXBean.html#getProcessCpuTime--) on OpenJ9.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.cpu.time` | Counter | `s` | CPU time used by the process as reported by the JVM. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.cpu.time` | Counter | `s` | CPU time used by the process as reported by the JVM. |  |
@@ -305,9 +305,9 @@ This metric is obtained from [`Runtime#availableProcessors()`](https://docs.orac
Note that this is always an integer value (i.e. fractional or millicores are not represented).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.cpu.count` | UpDownCounter | `{cpu}` | Number of processors available to the Java virtual machine. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.cpu.count` | UpDownCounter | `{cpu}` | Number of processors available to the Java virtual machine. |  |
@@ -321,9 +321,9 @@ and [`com.ibm.lang.management.OperatingSystemMXBean#getProcessCpuLoad()`](https:
Note that the JVM does not provide a definition of what "recent" means.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.cpu.recent_utilization` | Gauge | `1` | Recent CPU utilization for the process as reported by the JVM. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.cpu.recent_utilization` | Gauge | `1` | Recent CPU utilization for the process as reported by the JVM. [1] |  |
**[1]:** The value range is [0.0,1.0]. This utilization is not defined as being for the specific interval since last measurement (unlike `system.cpu.utilization`). [Reference](https://docs.oracle.com/en/java/javase/17/docs/api/jdk.management/com/sun/management/OperatingSystemMXBean.html#getProcessCpuLoad()).
@@ -343,25 +343,25 @@ This metric is [recommended][MetricRecommended].
This metric is obtained from [`MemoryPoolMXBean#getUsage()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/MemoryPoolMXBean.html#getUsage--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.memory.init` | UpDownCounter | `By` | Measure of initial memory requested. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.memory.init` | UpDownCounter | `By` | Measure of initial memory requested. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `jvm.memory.pool.name` | string | 
Name of the memory pool. [1] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` | Recommended |
-| `jvm.memory.type` | string | 
The type of memory. | `heap`; `non_heap` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `jvm.memory.pool.name` | string | Name of the memory pool. [1] | `G1 Old Gen`; `G1 Eden space`; `G1 Survivor Space` | `Recommended` |  |
+| `jvm.memory.type` | string | The type of memory. | `heap`; `non_heap` | `Recommended` |  |
**[1]:** Pool names are generally obtained via [MemoryPoolMXBean#getName()](https://docs.oracle.com/en/java/javase/11/docs/api/java.management/java/lang/management/MemoryPoolMXBean.html#getName()).
`jvm.memory.type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `heap` | Heap memory. |
-| `non_heap` | Non-heap memory |
+| Value | Description | Stability |
+|---|---|---|
+| `heap` | Heap memory. |  |
+| `non_heap` | Non-heap memory |  |
### Metric: `jvm.system.cpu.utilization`
@@ -371,9 +371,9 @@ This metric is obtained from [`com.sun.management.OperatingSystemMXBean#getSyste
and [`com.ibm.lang.management.OperatingSystemMXBean#getSystemCpuLoad()`](https://www.ibm.com/docs/api/v1/content/SSYKE2_8.0.0/openj9/api/jdk8/jre/management/extension/com/ibm/lang/management/OperatingSystemMXBean.html) on OpenJ9.
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.system.cpu.utilization` | Gauge | `1` | Recent CPU utilization for the whole system as reported by the JVM. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.system.cpu.utilization` | Gauge | `1` | Recent CPU utilization for the whole system as reported by the JVM. [1] |  |
**[1]:** The value range is [0.0,1.0]. This utilization is not defined as being for the specific interval since last measurement (unlike `system.cpu.utilization`). [Reference](https://docs.oracle.com/en/java/javase/17/docs/api/jdk.management/com/sun/management/OperatingSystemMXBean.html#getCpuLoad()).
@@ -387,9 +387,9 @@ This metric is [Opt-In][MetricOptIn].
This metric is obtained from [`OperatingSystemMXBean#getSystemLoadAverage()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/OperatingSystemMXBean.html#getSystemLoadAverage--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.system.cpu.load_1m` | Gauge | `{run_queue_item}` | Average CPU load of the whole system for the last minute as reported by the JVM. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.system.cpu.load_1m` | Gauge | `{run_queue_item}` | Average CPU load of the whole system for the last minute as reported by the JVM. [1] |  |
**[1]:** The value range is [0,n], where n is the number of CPU cores - or a negative number if the value is not available. This utilization is not defined as being for the specific interval since last measurement (unlike `system.cpu.utilization`). [Reference](https://docs.oracle.com/en/java/javase/17/docs/api/java.management/java/lang/management/OperatingSystemMXBean.html#getSystemLoadAverage()).
@@ -403,15 +403,15 @@ This metric is [recommended][MetricRecommended].
This metric is obtained from [`BufferPoolMXBean#getMemoryUsed()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/BufferPoolMXBean.html#getMemoryUsed--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.buffer.memory.usage` | UpDownCounter | `By` | Measure of memory used by buffers. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.buffer.memory.usage` | UpDownCounter | `By` | Measure of memory used by buffers. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `jvm.buffer.pool.name` | string | Name of the buffer pool. [1] | `mapped`; `direct` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `jvm.buffer.pool.name` | string | Name of the buffer pool. [1] | `mapped`; `direct` | `Recommended` |  |
**[1]:** Pool names are generally obtained via [BufferPoolMXBean#getName()](https://docs.oracle.com/en/java/javase/11/docs/api/java.management/java/lang/management/BufferPoolMXBean.html#getName()).
@@ -422,15 +422,15 @@ This metric is [recommended][MetricRecommended].
This metric is obtained from [`BufferPoolMXBean#getTotalCapacity()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/BufferPoolMXBean.html#getTotalCapacity--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.buffer.memory.limit` | UpDownCounter | `By` | Measure of total memory capacity of buffers. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.buffer.memory.limit` | UpDownCounter | `By` | Measure of total memory capacity of buffers. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `jvm.buffer.pool.name` | string | Name of the buffer pool. [1] | `mapped`; `direct` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `jvm.buffer.pool.name` | string | Name of the buffer pool. [1] | `mapped`; `direct` | `Recommended` |  |
**[1]:** Pool names are generally obtained via [BufferPoolMXBean#getName()](https://docs.oracle.com/en/java/javase/11/docs/api/java.management/java/lang/management/BufferPoolMXBean.html#getName()).
@@ -441,15 +441,15 @@ This metric is [recommended][MetricRecommended].
This metric is obtained from [`BufferPoolMXBean#getCount()`](https://docs.oracle.com/javase/8/docs/api/java/lang/management/BufferPoolMXBean.html#getCount--).
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `jvm.buffer.count` | UpDownCounter | `{buffer}` | Number of buffers in the pool. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `jvm.buffer.count` | UpDownCounter | `{buffer}` | Number of buffers in the pool. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `jvm.buffer.pool.name` | string | Name of the buffer pool. [1] | `mapped`; `direct` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `jvm.buffer.pool.name` | string | Name of the buffer pool. [1] | `mapped`; `direct` | `Recommended` |  |
**[1]:** Pool names are generally obtained via [BufferPoolMXBean#getName()](https://docs.oracle.com/en/java/javase/11/docs/api/java.management/java/lang/management/BufferPoolMXBean.html#getName()).
diff --git a/docs/system/container-metrics.md b/docs/system/container-metrics.md
index d5df4933b2..4879ff95f0 100644
--- a/docs/system/container-metrics.md
+++ b/docs/system/container-metrics.md
@@ -13,25 +13,25 @@ linkTitle: Container
This metric is [opt-in][MetricOptIn].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `container.cpu.time` | Counter | `s` | Total CPU time consumed [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `container.cpu.time` | Counter | `s` | Total CPU time consumed [1] |  |
**[1]:** Total CPU time consumed by the specific container on all available CPU cores
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`container.cpu.state`](../attributes-registry/container.md) | string | The CPU state for this data point. A container SHOULD be characterized _either_ by data points with no `state` labels, _or only_ data points with `state` labels. | `user`; `kernel` | Opt-In |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`container.cpu.state`](../attributes-registry/container.md) | string | The CPU state for this data point. A container SHOULD be characterized _either_ by data points with no `state` labels, _or only_ data points with `state` labels. | `user`; `kernel` | `Opt-In` |  |
-`container.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`container.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `user` | When tasks of the cgroup are in user mode (Linux). When all container processes are in user mode (Windows). |
-| `system` | When CPU is used by the system (host OS) |
-| `kernel` | When tasks of the cgroup are in kernel mode (Linux). When all container processes are in kernel mode (Windows). |
+| Value | Description | Stability |
+|---|---|---|
+| `user` | When tasks of the cgroup are in user mode (Linux). When all container processes are in user mode (Windows). |  |
+| `system` | When CPU is used by the system (host OS) |  |
+| `kernel` | When tasks of the cgroup are in kernel mode (Linux). When all container processes are in kernel mode (Windows). |  |
### Metric: `container.memory.usage`
@@ -39,9 +39,9 @@ This metric is [opt-in][MetricOptIn].
This metric is [opt-in][MetricOptIn].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `container.memory.usage` | Counter | `By` | Memory usage of the container. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `container.memory.usage` | Counter | `By` | Memory usage of the container. [1] |  |
**[1]:** Memory usage of the container.
@@ -54,25 +54,25 @@ This metric is [opt-in][MetricOptIn].
This metric is [opt-in][MetricOptIn].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `container.disk.io` | Counter | `By` | Disk bytes for the container. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `container.disk.io` | Counter | `By` | Disk bytes for the container. [1] |  |
**[1]:** The total number of bytes read/written successfully (aggregated from all disks).
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | Recommended |
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | `Recommended` |  |
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
`disk.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `read` | read |
-| `write` | write |
+| Value | Description | Stability |
+|---|---|---|
+| `read` | read |  |
+| `write` | write |  |
### Metric: `container.network.io`
@@ -80,25 +80,25 @@ This metric is [opt-in][MetricOptIn].
This metric is [opt-in][MetricOptIn].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `container.network.io` | Counter | `By` | Network bytes for the container. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `container.network.io` | Counter | `By` | Network bytes for the container. [1] |  |
**[1]:** The number of bytes sent/received on all network interfaces by the container.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | Recommended |
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | `Recommended` |  |
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
`network.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `transmit` | transmit |
-| `receive` | receive |
+| Value | Description | Stability |
+|---|---|---|
+| `transmit` | transmit |  |
+| `receive` | receive |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.22.0/specification/document-status.md
diff --git a/docs/system/process-metrics.md b/docs/system/process-metrics.md
index 3feb662a15..6c28dde6a8 100644
--- a/docs/system/process-metrics.md
+++ b/docs/system/process-metrics.md
@@ -50,23 +50,23 @@ metrics](/docs/runtime/README.md#metrics).
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `process.cpu.time` | Counter | `s` | Total CPU seconds broken down by different states. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `process.cpu.time` | Counter | `s` | Total CPU seconds broken down by different states. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `process.cpu.state` | string | The CPU state for this data point. A process SHOULD be characterized _either_ by data points with no `state` labels, _or only_ data points with `state` labels. | `system` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `process.cpu.state` | string | The CPU state for this data point. A process SHOULD be characterized _either_ by data points with no `state` labels, _or only_ data points with `state` labels. | `system` | `Recommended` |  |
-`process.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`process.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `system` | system |
-| `user` | user |
-| `wait` | wait |
+| Value | Description | Stability |
+|---|---|---|
+| `system` | system |  |
+| `user` | user |  |
+| `wait` | wait |  |
### Metric: `process.cpu.utilization`
@@ -74,23 +74,23 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `process.cpu.utilization` | Gauge | `1` | Difference in process.cpu.time since the last measurement, divided by the elapsed time and number of CPUs available to the process. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `process.cpu.utilization` | Gauge | `1` | Difference in process.cpu.time since the last measurement, divided by the elapsed time and number of CPUs available to the process. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `process.cpu.state` | string | The CPU state for this data point. A process SHOULD be characterized _either_ by data points with no `state` labels, _or only_ data points with `state` labels. | `system` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `process.cpu.state` | string | The CPU state for this data point. A process SHOULD be characterized _either_ by data points with no `state` labels, _or only_ data points with `state` labels. | `system` | `Recommended` |  |
-`process.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`process.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `system` | system |
-| `user` | user |
-| `wait` | wait |
+| Value | Description | Stability |
+|---|---|---|
+| `system` | system |  |
+| `user` | user |  |
+| `wait` | wait |  |
### Metric: `process.memory.usage`
@@ -98,9 +98,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `process.memory.usage` | UpDownCounter | `By` | The amount of physical memory in use. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `process.memory.usage` | UpDownCounter | `By` | The amount of physical memory in use. |  |
@@ -111,9 +111,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `process.memory.virtual` | UpDownCounter | `By` | The amount of committed virtual memory. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `process.memory.virtual` | UpDownCounter | `By` | The amount of committed virtual memory. |  |
@@ -124,22 +124,22 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `process.disk.io` | Counter | `By` | Disk bytes transferred. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `process.disk.io` | Counter | `By` | Disk bytes transferred. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | `Recommended` |  |
`disk.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `read` | read |
-| `write` | write |
+| Value | Description | Stability |
+|---|---|---|
+| `read` | read |  |
+| `write` | write |  |
### Metric: `process.network.io`
@@ -147,22 +147,22 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `process.network.io` | Counter | `By` | Network bytes transferred. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `process.network.io` | Counter | `By` | Network bytes transferred. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | `Recommended` |  |
`network.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `transmit` | transmit |
-| `receive` | receive |
+| Value | Description | Stability |
+|---|---|---|
+| `transmit` | transmit |  |
+| `receive` | receive |  |
### Metric: `process.thread.count`
@@ -170,9 +170,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `process.thread.count` | UpDownCounter | `{thread}` | Process threads count. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `process.thread.count` | UpDownCounter | `{thread}` | Process threads count. |  |
@@ -183,9 +183,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `process.open_file_descriptor.count` | UpDownCounter | `{count}` | Number of file descriptors in use by the process. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `process.open_file_descriptor.count` | UpDownCounter | `{count}` | Number of file descriptors in use by the process. |  |
@@ -196,22 +196,22 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `process.context_switches` | Counter | `{count}` | Number of times the process has been context switched. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `process.context_switches` | Counter | `{count}` | Number of times the process has been context switched. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `process.context_switch_type` | string | Specifies whether the context switches for this data point were voluntary or involuntary. | `voluntary` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `process.context_switch_type` | string | Specifies whether the context switches for this data point were voluntary or involuntary. | `voluntary` | `Recommended` |  |
-`process.context_switch_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`process.context_switch_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `voluntary` | voluntary |
-| `involuntary` | involuntary |
+| Value | Description | Stability |
+|---|---|---|
+| `voluntary` | voluntary |  |
+| `involuntary` | involuntary |  |
### Metric: `process.paging.faults`
@@ -219,22 +219,22 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `process.paging.faults` | Counter | `{fault}` | Number of page faults the process has made. |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `process.paging.faults` | Counter | `{fault}` | Number of page faults the process has made. |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `process.paging.fault_type` | string | The type of page fault for this data point. Type `major` is for major/hard page faults, and `minor` is for minor/soft page faults. | `major` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `process.paging.fault_type` | string | The type of page fault for this data point. Type `major` is for major/hard page faults, and `minor` is for minor/soft page faults. | `major` | `Recommended` |  |
-`process.paging.fault_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`process.paging.fault_type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `major` | major |
-| `minor` | minor |
+| Value | Description | Stability |
+|---|---|---|
+| `major` | major |  |
+| `minor` | minor |  |
[DocumentStatus]: https://github.com/open-telemetry/opentelemetry-specification/tree/v1.26.0/specification/document-status.md
diff --git a/docs/system/system-metrics.md b/docs/system/system-metrics.md
index 7bc0a81a2c..af298da177 100644
--- a/docs/system/system-metrics.md
+++ b/docs/system/system-metrics.md
@@ -78,28 +78,28 @@ Resource attributes related to a host, SHOULD be reported under the `host.*` nam
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.cpu.time` | Counter | `s` | Seconds each logical CPU spent on each mode |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.cpu.time` | Counter | `s` | Seconds each logical CPU spent on each mode |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.cpu.logical_number` | int | The logical CPU number [0..n-1] | `1` | Recommended |
-| `system.cpu.state` | string | The CPU state for this data point. A system's CPU SHOULD be characterized *either* by data points with no `state` labels, *or only* data points with `state` labels. | `idle`; `interrupt` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.cpu.logical_number` | int | The logical CPU number [0..n-1] | `1` | `Recommended` |  |
+| `system.cpu.state` | string | The CPU state for this data point. A system's CPU SHOULD be characterized *either* by data points with no `state` labels, *or only* data points with `state` labels. | `idle`; `interrupt` | `Recommended` |  |
-`system.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`system.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `user` | user |
-| `system` | system |
-| `nice` | nice |
-| `idle` | idle |
-| `iowait` | iowait |
-| `interrupt` | interrupt |
-| `steal` | steal |
+| Value | Description | Stability |
+|---|---|---|
+| `user` | user |  |
+| `system` | system |  |
+| `nice` | nice |  |
+| `idle` | idle |  |
+| `iowait` | iowait |  |
+| `interrupt` | interrupt |  |
+| `steal` | steal |  |
### Metric: `system.cpu.utilization`
@@ -107,28 +107,28 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.cpu.utilization` | Gauge | `1` | Difference in system.cpu.time since the last measurement, divided by the elapsed time and number of logical CPUs |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.cpu.utilization` | Gauge | `1` | Difference in system.cpu.time since the last measurement, divided by the elapsed time and number of logical CPUs |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.cpu.logical_number` | int | The logical CPU number [0..n-1] | `1` | Recommended |
-| `system.cpu.state` | string | The CPU state for this data point. A system's CPU SHOULD be characterized *either* by data points with no `state` labels, *or only* data points with `state` labels. | `idle`; `interrupt` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.cpu.logical_number` | int | The logical CPU number [0..n-1] | `1` | `Recommended` |  |
+| `system.cpu.state` | string | The CPU state for this data point. A system's CPU SHOULD be characterized *either* by data points with no `state` labels, *or only* data points with `state` labels. | `idle`; `interrupt` | `Recommended` |  |
-`system.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`system.cpu.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `user` | user |
-| `system` | system |
-| `nice` | nice |
-| `idle` | idle |
-| `iowait` | iowait |
-| `interrupt` | interrupt |
-| `steal` | steal |
+| Value | Description | Stability |
+|---|---|---|
+| `user` | user |  |
+| `system` | system |  |
+| `nice` | nice |  |
+| `idle` | idle |  |
+| `iowait` | iowait |  |
+| `interrupt` | interrupt |  |
+| `steal` | steal |  |
### Metric: `system.cpu.physical.count`
@@ -136,9 +136,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.cpu.physical.count` | UpDownCounter | `{cpu}` | Reports the number of actual physical processor cores on the hardware |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.cpu.physical.count` | UpDownCounter | `{cpu}` | Reports the number of actual physical processor cores on the hardware |  |
@@ -149,9 +149,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.cpu.logical.count` | UpDownCounter | `{cpu}` | Reports the number of logical (virtual) processor cores created by the operating system to manage multitasking |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.cpu.logical.count` | UpDownCounter | `{cpu}` | Reports the number of logical (virtual) processor cores created by the operating system to manage multitasking |  |
@@ -162,15 +162,15 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.cpu.frequency` | Gauge | `{Hz}` | Reports the current frequency of the CPU in Hz |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.cpu.frequency` | Gauge | `{Hz}` | Reports the current frequency of the CPU in Hz |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.cpu.logical_number` | int | The logical CPU number [0..n-1] | `1` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.cpu.logical_number` | int | The logical CPU number [0..n-1] | `1` | `Recommended` |  |
## Memory Metrics
@@ -183,28 +183,28 @@ This does not include [paging/swap memory](#pagingswap-metrics).
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.memory.usage` | UpDownCounter | `By` | Reports memory in use by state. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.memory.usage` | UpDownCounter | `By` | Reports memory in use by state. [1] |  |
**[1]:** The sum over all `system.memory.state` values SHOULD equal the total memory
available on the system, that is `system.memory.limit`.
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.memory.state` | string | The memory state | `free`; `cached` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.memory.state` | string | The memory state | `free`; `cached` | `Recommended` |  |
-`system.memory.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`system.memory.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `used` | used |
-| `free` | free |
-| `shared` | shared |
-| `buffers` | buffers |
-| `cached` | cached |
+| Value | Description | Stability |
+|---|---|---|
+| `used` | used |  |
+| `free` | free |  |
+| `shared` | shared |  |
+| `buffers` | buffers |  |
+| `cached` | cached |  |
### Metric: `system.memory.limit`
@@ -212,9 +212,9 @@ available on the system, that is `system.memory.limit`.
This metric is [opt-in][MetricOptIn].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.memory.limit` | UpDownCounter | `By` | Total memory available in the system. [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.memory.limit` | UpDownCounter | `By` | Total memory available in the system. [1] |  |
**[1]:** Its value SHOULD equal the sum of `system.memory.state` over all states.
@@ -227,25 +227,25 @@ This metric is [opt-in][MetricOptIn].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.memory.utilization` | Gauge | `1` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.memory.utilization` | Gauge | `1` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.memory.state` | string | The memory state | `free`; `cached` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.memory.state` | string | The memory state | `free`; `cached` | `Recommended` |  |
-`system.memory.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`system.memory.state` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `used` | used |
-| `free` | free |
-| `shared` | shared |
-| `buffers` | buffers |
-| `cached` | cached |
+| Value | Description | Stability |
+|---|---|---|
+| `used` | used |  |
+| `free` | free |  |
+| `shared` | shared |  |
+| `buffers` | buffers |  |
+| `cached` | cached |  |
## Paging/Swap Metrics
@@ -257,22 +257,22 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.paging.usage` | UpDownCounter | `By` | Unix swap or windows pagefile usage |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.paging.usage` | UpDownCounter | `By` | Unix swap or windows pagefile usage |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.paging.state` | string | The memory paging state | `free` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.paging.state` | string | The memory paging state | `free` | `Recommended` |  |
`system.paging.state` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `used` | used |
-| `free` | free |
+| Value | Description | Stability |
+|---|---|---|
+| `used` | used |  |
+| `free` | free |  |
### Metric: `system.paging.utilization`
@@ -280,22 +280,22 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.paging.utilization` | Gauge | `1` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.paging.utilization` | Gauge | `1` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.paging.state` | string | The memory paging state | `free` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.paging.state` | string | The memory paging state | `free` | `Recommended` |  |
`system.paging.state` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `used` | used |
-| `free` | free |
+| Value | Description | Stability |
+|---|---|---|
+| `used` | used |  |
+| `free` | free |  |
### Metric: `system.paging.faults`
@@ -303,22 +303,22 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.paging.faults` | Counter | `{fault}` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.paging.faults` | Counter | `{fault}` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.paging.type` | string | The memory paging type | `minor` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.paging.type` | string | The memory paging type | `minor` | `Recommended` |  |
`system.paging.type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `major` | major |
-| `minor` | minor |
+| Value | Description | Stability |
+|---|---|---|
+| `major` | major |  |
+| `minor` | minor |  |
### Metric: `system.paging.operations`
@@ -326,30 +326,30 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.paging.operations` | Counter | `{operation}` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.paging.operations` | Counter | `{operation}` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.paging.direction` | string | The paging access direction | `in` | Recommended |
-| `system.paging.type` | string | The memory paging type | `minor` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.paging.direction` | string | The paging access direction | `in` | `Recommended` |  |
+| `system.paging.type` | string | The memory paging type | `minor` | `Recommended` |  |
`system.paging.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `in` | in |
-| `out` | out |
+| Value | Description | Stability |
+|---|---|---|
+| `in` | in |  |
+| `out` | out |  |
`system.paging.type` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `major` | major |
-| `minor` | minor |
+| Value | Description | Stability |
+|---|---|---|
+| `major` | major |  |
+| `minor` | minor |  |
## Disk Controller Metrics
@@ -361,23 +361,23 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.disk.io` | Counter | `By` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.disk.io` | Counter | `By` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | Recommended |
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | `Recommended` |  |
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
`disk.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `read` | read |
-| `write` | write |
+| Value | Description | Stability |
+|---|---|---|
+| `read` | read |  |
+| `write` | write |  |
### Metric: `system.disk.operations`
@@ -385,23 +385,23 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.disk.operations` | Counter | `{operation}` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.disk.operations` | Counter | `{operation}` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | Recommended |
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | `Recommended` |  |
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
`disk.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `read` | read |
-| `write` | write |
+| Value | Description | Stability |
+|---|---|---|
+| `read` | read |  |
+| `write` | write |  |
### Metric: `system.disk.io_time`
@@ -409,9 +409,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.disk.io_time` | Counter | `s` | Time disk spent activated [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.disk.io_time` | Counter | `s` | Time disk spent activated [1] |  |
**[1]:** The real elapsed time ("wall clock") used in the I/O path (time from operations running in parallel are not counted). Measured as:
@@ -422,9 +422,9 @@ This metric is [recommended][MetricRecommended].
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
### Metric: `system.disk.operation_time`
@@ -432,9 +432,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.disk.operation_time` | Counter | `s` | Sum of the time each operation took to complete [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.disk.operation_time` | Counter | `s` | Sum of the time each operation took to complete [1] |  |
**[1]:** Because it is the sum of time each request took, parallel-issued requests each contribute to make the count grow. Measured as:
@@ -443,17 +443,17 @@ This metric is [recommended][MetricRecommended].
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | Recommended |
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | `Recommended` |  |
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
`disk.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `read` | read |
-| `write` | write |
+| Value | Description | Stability |
+|---|---|---|
+| `read` | read |  |
+| `write` | write |  |
### Metric: `system.disk.merged`
@@ -461,23 +461,23 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.disk.merged` | Counter | `{operation}` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.disk.merged` | Counter | `{operation}` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | Recommended |
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`disk.io.direction`](../attributes-registry/disk.md) | string | The disk IO operation direction. | `read` | `Recommended` |  |
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
`disk.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `read` | read |
-| `write` | write |
+| Value | Description | Stability |
+|---|---|---|
+| `read` | read |  |
+| `write` | write |  |
## Filesystem Metrics
@@ -489,38 +489,38 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.filesystem.usage` | UpDownCounter | `By` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.filesystem.usage` | UpDownCounter | `By` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
-| `system.filesystem.mode` | string | The filesystem mode | `rw, ro` | Recommended |
-| `system.filesystem.mountpoint` | string | The filesystem mount path | `/mnt/data` | Recommended |
-| `system.filesystem.state` | string | The filesystem state | `used` | Recommended |
-| `system.filesystem.type` | string | The filesystem type | `ext4` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
+| `system.filesystem.mode` | string | The filesystem mode | `rw, ro` | `Recommended` |  |
+| `system.filesystem.mountpoint` | string | The filesystem mount path | `/mnt/data` | `Recommended` |  |
+| `system.filesystem.state` | string | The filesystem state | `used` | `Recommended` |  |
+| `system.filesystem.type` | string | The filesystem type | `ext4` | `Recommended` |  |
`system.filesystem.state` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `used` | used |
-| `free` | free |
-| `reserved` | reserved |
+| Value | Description | Stability |
+|---|---|---|
+| `used` | used |  |
+| `free` | free |  |
+| `reserved` | reserved |  |
-`system.filesystem.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`system.filesystem.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `fat32` | fat32 |
-| `exfat` | exfat |
-| `ntfs` | ntfs |
-| `refs` | refs |
-| `hfsplus` | hfsplus |
-| `ext4` | ext4 |
+| Value | Description | Stability |
+|---|---|---|
+| `fat32` | fat32 |  |
+| `exfat` | exfat |  |
+| `ntfs` | ntfs |  |
+| `refs` | refs |  |
+| `hfsplus` | hfsplus |  |
+| `ext4` | ext4 |  |
### Metric: `system.filesystem.utilization`
@@ -528,38 +528,38 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.filesystem.utilization` | Gauge | `1` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.filesystem.utilization` | Gauge | `1` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
-| `system.filesystem.mode` | string | The filesystem mode | `rw, ro` | Recommended |
-| `system.filesystem.mountpoint` | string | The filesystem mount path | `/mnt/data` | Recommended |
-| `system.filesystem.state` | string | The filesystem state | `used` | Recommended |
-| `system.filesystem.type` | string | The filesystem type | `ext4` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
+| `system.filesystem.mode` | string | The filesystem mode | `rw, ro` | `Recommended` |  |
+| `system.filesystem.mountpoint` | string | The filesystem mount path | `/mnt/data` | `Recommended` |  |
+| `system.filesystem.state` | string | The filesystem state | `used` | `Recommended` |  |
+| `system.filesystem.type` | string | The filesystem type | `ext4` | `Recommended` |  |
`system.filesystem.state` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `used` | used |
-| `free` | free |
-| `reserved` | reserved |
+| Value | Description | Stability |
+|---|---|---|
+| `used` | used |  |
+| `free` | free |  |
+| `reserved` | reserved |  |
-`system.filesystem.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`system.filesystem.type` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `fat32` | fat32 |
-| `exfat` | exfat |
-| `ntfs` | ntfs |
-| `refs` | refs |
-| `hfsplus` | hfsplus |
-| `ext4` | ext4 |
+| Value | Description | Stability |
+|---|---|---|
+| `fat32` | fat32 |  |
+| `exfat` | exfat |  |
+| `ntfs` | ntfs |  |
+| `refs` | refs |  |
+| `hfsplus` | hfsplus |  |
+| `ext4` | ext4 |  |
## Network Metrics
@@ -571,9 +571,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.network.dropped` | Counter | `{packet}` | Count of packets that are dropped or discarded even though there was no error [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.network.dropped` | Counter | `{packet}` | Count of packets that are dropped or discarded even though there was no error [1] |  |
**[1]:** Measured as:
@@ -583,17 +583,17 @@ This metric is [recommended][MetricRecommended].
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | Recommended |
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | `Recommended` |  |
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
`network.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `transmit` | transmit |
-| `receive` | receive |
+| Value | Description | Stability |
+|---|---|---|
+| `transmit` | transmit |  |
+| `receive` | receive |  |
### Metric: `system.network.packets`
@@ -601,23 +601,23 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.network.packets` | Counter | `{packet}` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.network.packets` | Counter | `{packet}` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | Recommended |
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | `Recommended` |  |
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
`network.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `transmit` | transmit |
-| `receive` | receive |
+| Value | Description | Stability |
+|---|---|---|
+| `transmit` | transmit |  |
+| `receive` | receive |  |
### Metric: `system.network.errors`
@@ -625,9 +625,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.network.errors` | Counter | `{error}` | Count of network errors detected [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.network.errors` | Counter | `{error}` | Count of network errors detected [1] |  |
**[1]:** Measured as:
@@ -637,17 +637,17 @@ This metric is [recommended][MetricRecommended].
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | Recommended |
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | `Recommended` |  |
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
`network.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `transmit` | transmit |
-| `receive` | receive |
+| Value | Description | Stability |
+|---|---|---|
+| `transmit` | transmit |  |
+| `receive` | receive |  |
### Metric: `system.network.io`
@@ -655,23 +655,23 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.network.io` | Counter | `By` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.network.io` | Counter | `By` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | Recommended |
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.io.direction`](../attributes-registry/network.md) | string | The network IO operation direction. | `transmit` | `Recommended` |  |
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
`network.io.direction` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `transmit` | transmit |
-| `receive` | receive |
+| Value | Description | Stability |
+|---|---|---|
+| `transmit` | transmit |  |
+| `receive` | receive |  |
### Metric: `system.network.connections`
@@ -679,17 +679,17 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.network.connections` | UpDownCounter | `{connection}` | |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.network.connections` | UpDownCounter | `{connection}` | |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `udp` | Recommended |
-| `system.device` | string | The device identifier | `(identifier)` | Recommended |
-| `system.network.state` | string | A stateless protocol MUST NOT set this attribute | `close_wait` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`network.transport`](../attributes-registry/network.md) | string | [OSI transport layer](https://osi-model.com/transport-layer/) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [1] | `tcp`; `udp` | `Recommended` |  |
+| `system.device` | string | The device identifier | `(identifier)` | `Recommended` |  |
+| `system.network.state` | string | A stateless protocol MUST NOT set this attribute | `close_wait` | `Recommended` |  |
**[1]:** The value SHOULD be normalized to lowercase.
@@ -697,31 +697,31 @@ Consider always setting the transport when setting a port number, since
a port number is ambiguous without knowing the transport. For example
different processes could be listening on TCP port 12345 and UDP port 12345.
-`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`network.transport` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `tcp` | TCP |
-| `udp` | UDP |
-| `pipe` | Named or anonymous pipe. |
-| `unix` | Unix domain socket |
+| Value | Description | Stability |
+|---|---|---|
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `pipe` | Named or anonymous pipe. |  |
+| `unix` | Unix domain socket |  |
`system.network.state` MUST be one of the following:
-| Value | Description |
-|---|---|
-| `close` | close |
-| `close_wait` | close_wait |
-| `closing` | closing |
-| `delete` | delete |
-| `established` | established |
-| `fin_wait_1` | fin_wait_1 |
-| `fin_wait_2` | fin_wait_2 |
-| `last_ack` | last_ack |
-| `listen` | listen |
-| `syn_recv` | syn_recv |
-| `syn_sent` | syn_sent |
-| `time_wait` | time_wait |
+| Value | Description | Stability |
+|---|---|---|
+| `close` | close |  |
+| `close_wait` | close_wait |  |
+| `closing` | closing |  |
+| `delete` | delete |  |
+| `established` | established |  |
+| `fin_wait_1` | fin_wait_1 |  |
+| `fin_wait_2` | fin_wait_2 |  |
+| `last_ack` | last_ack |  |
+| `listen` | listen |  |
+| `syn_recv` | syn_recv |  |
+| `syn_sent` | syn_sent |  |
+| `time_wait` | time_wait |  |
## Aggregate System Process Metrics
@@ -733,24 +733,24 @@ For metrics at the individual process level, see [process metrics](process-metri
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.process.count` | UpDownCounter | `{process}` | Total number of processes in each state |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.process.count` | UpDownCounter | `{process}` | Total number of processes in each state |  |
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| `system.process.status` | string | The process state, e.g., [Linux Process State Codes](https://man7.org/linux/man-pages/man1/ps.1.html#PROCESS_STATE_CODES) | `running` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| `system.process.status` | string | The process state, e.g., [Linux Process State Codes](https://man7.org/linux/man-pages/man1/ps.1.html#PROCESS_STATE_CODES) | `running` | `Recommended` |  |
-`system.process.status` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.
+`system.process.status` has the following list of well-known values. If one of them applies, then the respective value MUST be used; otherwise, a custom value MAY be used.
-| Value | Description |
-|---|---|
-| `running` | running |
-| `sleeping` | sleeping |
-| `stopped` | stopped |
-| `defunct` | defunct |
+| Value | Description | Stability |
+|---|---|---|
+| `running` | running |  |
+| `sleeping` | sleeping |  |
+| `stopped` | stopped |  |
+| `defunct` | defunct |  |
### Metric: `system.process.created`
@@ -758,9 +758,9 @@ This metric is [recommended][MetricRecommended].
This metric is [recommended][MetricRecommended].
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.process.created` | Counter | `{process}` | Total number of processes created over uptime of the host |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.process.created` | Counter | `{process}` | Total number of processes created over uptime of the host |  |
@@ -801,9 +801,9 @@ an `{os}` prefix to split this metric across OSes.
### Metric: `system.linux.memory.available`
-| Name | Instrument Type | Unit (UCUM) | Description |
-| -------- | --------------- | ----------- | -------------- |
-| `system.linux.memory.available` | UpDownCounter | `By` | An estimate of how much memory is available for starting new applications, without causing swapping [1] |
+| Name | Instrument Type | Unit (UCUM) | Description | Stability |
+| -------- | --------------- | ----------- | -------------- | --------- |
+| `system.linux.memory.available` | UpDownCounter | `By` | An estimate of how much memory is available for starting new applications, without causing swapping [1] |  |
**[1]:** This is an alternative to `system.memory.usage` metric with `state=free`.
Linux starting from 3.14 exports "available" memory. It takes "free" memory as a baseline, and then factors in kernel-specific values.
diff --git a/docs/url/url.md b/docs/url/url.md
index 77cdbf1109..28db25cab4 100644
--- a/docs/url/url.md
+++ b/docs/url/url.md
@@ -23,13 +23,13 @@ This document defines semantic conventions that describe URL and its components.
## Attributes
-| Attribute | Type | Description | Examples | Requirement Level |
-|---|---|---|---|---|
-| [`url.fragment`](../attributes-registry/url.md) | string | The [URI fragment](https://www.rfc-editor.org/rfc/rfc3986#section-3.5) component | `SemConv` | Recommended |
-| [`url.full`](../attributes-registry/url.md) | string | Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986) [1] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `//localhost` | Recommended |
-| [`url.path`](../attributes-registry/url.md) | string | The [URI path](https://www.rfc-editor.org/rfc/rfc3986#section-3.3) component [2] | `/search` | Recommended |
-| [`url.query`](../attributes-registry/url.md) | string | The [URI query](https://www.rfc-editor.org/rfc/rfc3986#section-3.4) component [3] | `q=OpenTelemetry` | Recommended |
-| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `https`; `ftp`; `telnet` | Recommended |
+| Attribute | Type | Description | Examples | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
+|---|---|---|---|---|---|
+| [`url.fragment`](../attributes-registry/url.md) | string | The [URI fragment](https://www.rfc-editor.org/rfc/rfc3986#section-3.5) component | `SemConv` | `Recommended` |  |
+| [`url.full`](../attributes-registry/url.md) | string | Absolute URL describing a network resource according to [RFC3986](https://www.rfc-editor.org/rfc/rfc3986) [1] | `https://www.foo.bar/search?q=OpenTelemetry#SemConv`; `//localhost` | `Recommended` |  |
+| [`url.path`](../attributes-registry/url.md) | string | The [URI path](https://www.rfc-editor.org/rfc/rfc3986#section-3.3) component [2] | `/search` | `Recommended` |  |
+| [`url.query`](../attributes-registry/url.md) | string | The [URI query](https://www.rfc-editor.org/rfc/rfc3986#section-3.4) component [3] | `q=OpenTelemetry` | `Recommended` |  |
+| [`url.scheme`](../attributes-registry/url.md) | string | The [URI scheme](https://www.rfc-editor.org/rfc/rfc3986#section-3.1) component identifying the used protocol. | `https`; `ftp`; `telnet` | `Recommended` |  |
**[1]:** For network calls, URL usually has `scheme://host[:port][path][?query][#fragment]` format, where the fragment is not transmitted over HTTP, but if it is known, it SHOULD be included nevertheless.
`url.full` MUST NOT contain credentials passed via URL in form of `https://username:password@www.example.com/`. In such case username and password SHOULD be redacted and attribute's value SHOULD be `https://REDACTED:REDACTED@www.example.com/`.
diff --git a/internal/tools/schema_check.sh b/internal/tools/schema_check.sh
index 801fcee04f..e71451ef7c 100755
--- a/internal/tools/schema_check.sh
+++ b/internal/tools/schema_check.sh
@@ -6,7 +6,7 @@
set -e
-BUILD_TOOL_SCHEMAS_VERSION=0.23.0
+BUILD_TOOL_SCHEMAS_VERSION=0.24.0
# List of versions that do not require or have a schema.
declare -a skip_versions=("1.0.0" "1.0.1" "1.1.0" "1.2.0" "1.3.0" "1.6.0")
diff --git a/model/README.md b/model/README.md
index f5968affd5..dd1886f0ed 100644
--- a/model/README.md
+++ b/model/README.md
@@ -14,12 +14,12 @@ Semantic conventions for the spec MUST adhere to the
[attribute requirement level](../docs/general/attribute-requirement-level.md),
and [metric requirement level](../docs/general/metric-requirement-level.md) conventions.
-Refer to the [syntax](https://github.com/open-telemetry/build-tools/tree/v0.23.0/semantic-conventions/syntax.md)
+Refer to the [syntax](https://github.com/open-telemetry/build-tools/tree/v0.24.0/semantic-conventions/syntax.md)
for how to write the YAML files for semantic conventions and what the YAML properties mean.
A schema file for VS code is configured in the `/.vscode/settings.json` of this
repository, enabling auto-completion and additional checks. Refer to
-[the generator README](https://github.com/open-telemetry/build-tools/tree/v0.23.0/semantic-conventions/README.md) for what extension you need.
+[the generator README](https://github.com/open-telemetry/build-tools/tree/v0.24.0/semantic-conventions/README.md) for what extension you need.
## Generating markdown
@@ -30,7 +30,7 @@ formatted Markdown tables for all semantic conventions in the specification. Run
make table-generation
```
-For more information, see the [semantic convention generator](https://github.com/open-telemetry/build-tools/tree/v0.23.0/semantic-conventions)
+For more information, see the [semantic convention generator](https://github.com/open-telemetry/build-tools/tree/v0.24.0/semantic-conventions)
in the OpenTelemetry build tools repository.
Using this build tool, it is also possible to generate code for use in OpenTelemetry
language projects.
diff --git a/model/logs/media.yaml b/model/logs/media.yaml
index d2ac89f470..b6bfea89d4 100644
--- a/model/logs/media.yaml
+++ b/model/logs/media.yaml
@@ -15,9 +15,11 @@ groups:
- id: stdout
value: 'stdout'
brief: 'Logs from stdout stream'
+ stability: experimental
- id: stderr
value: 'stderr'
brief: 'Events from stderr stream'
+ stability: experimental
- id: attributes.log.file
prefix: log.file
type: attribute_group
diff --git a/model/logs/mobile-events.yaml b/model/logs/mobile-events.yaml
index 0ae14ca975..7fee308596 100644
--- a/model/logs/mobile-events.yaml
+++ b/model/logs/mobile-events.yaml
@@ -21,24 +21,29 @@ groups:
value: 'active'
brief: >
The app has become `active`. Associated with UIKit notification `applicationDidBecomeActive`.
+ stability: experimental
- id: inactive
value: 'inactive'
brief: >
The app is now `inactive`. Associated with UIKit notification `applicationWillResignActive`.
+ stability: experimental
- id: background
value: 'background'
brief: >
The app is now in the background.
This value is associated with UIKit notification `applicationDidEnterBackground`.
+ stability: experimental
- id: foreground
value: 'foreground'
brief: >
The app is now in the foreground.
This value is associated with UIKit notification `applicationWillEnterForeground`.
+ stability: experimental
- id: terminate
value: 'terminate'
brief: >
The app is about to terminate. Associated with UIKit notification `applicationWillTerminate`.
+ stability: experimental
- id: android.lifecycle.events
type: event
prefix: android
@@ -62,13 +67,16 @@ groups:
brief: >
Any time before Activity.onResume() or, if the app has no Activity, Context.startService()
has been called in the app for the first time.
+ stability: experimental
- id: background
value: 'background'
brief: >
Any time after Activity.onPause() or, if the app has no Activity,
Context.stopService() has been called when the app was in the foreground state.
+ stability: experimental
- id: foreground
value: 'foreground'
brief: >
Any time after Activity.onResume() or, if the app has no Activity,
Context.startService() has been called when the app was in either the created or background states.
+ stability: experimental
diff --git a/model/metrics/container.yaml b/model/metrics/container.yaml
index 3904f168be..f0e15ed596 100644
--- a/model/metrics/container.yaml
+++ b/model/metrics/container.yaml
@@ -3,6 +3,7 @@ groups:
- id: metric.container.cpu.time
type: metric
metric_name: container.cpu.time
+ stability: experimental
brief: "Total CPU time consumed"
note: >
Total CPU time consumed by the specific container on all available CPU cores
@@ -17,6 +18,7 @@ groups:
- id: metric.container.memory.usage
type: metric
metric_name: container.memory.usage
+ stability: experimental
brief: "Memory usage of the container."
note: >
Memory usage of the container.
@@ -27,6 +29,7 @@ groups:
- id: metric.container.disk.io
type: metric
metric_name: container.disk.io
+ stability: experimental
brief: "Disk bytes for the container."
note: >
The total number of bytes read/written
@@ -41,6 +44,7 @@ groups:
- id: metric.container.network.io
type: metric
metric_name: container.network.io
+ stability: experimental
brief: "Network bytes for the container."
note: >
The number of bytes sent/received
diff --git a/model/metrics/database-metrics.yaml b/model/metrics/database-metrics.yaml
index bfcc7020ec..d172d9e4b6 100644
--- a/model/metrics/database-metrics.yaml
+++ b/model/metrics/database-metrics.yaml
@@ -10,8 +10,10 @@ groups:
members:
- id: idle
value: 'idle'
+ stability: experimental
- id: used
value: 'used'
+ stability: experimental
requirement_level: required
brief: "The state of a connection in the pool"
examples: ["idle"]
diff --git a/model/metrics/dotnet/dotnet-aspnetcore.yaml b/model/metrics/dotnet/dotnet-aspnetcore.yaml
index 89ce151d2d..da851f57fb 100644
--- a/model/metrics/dotnet/dotnet-aspnetcore.yaml
+++ b/model/metrics/dotnet/dotnet-aspnetcore.yaml
@@ -18,15 +18,19 @@ groups:
- id: acquired
value: 'acquired'
brief: "Lease was acquired"
+ stability: stable
- id: endpoint_limiter
value: 'endpoint_limiter'
brief: "Lease request was rejected by the endpoint limiter"
+ stability: stable
- id: global_limiter
value: 'global_limiter'
brief: "Lease request was rejected by the global limiter"
+ stability: stable
- id: request_canceled
value: 'request_canceled'
brief: "Lease request was canceled"
+ stability: stable
stability: stable
brief: Rate-limiting result, shows whether the lease was acquired or contains a rejection reason
examples: ["acquired", "request_canceled"]
@@ -78,9 +82,11 @@ groups:
- id: success
value: 'success'
brief: 'Match succeeded'
+ stability: stable
- id: failure
value: 'failure'
brief: 'Match failed'
+ stability: stable
stability: stable
requirement_level: required
brief: Match result - success or failure
@@ -108,15 +114,19 @@ groups:
- id: handled
value: 'handled'
brief: "Exception was handled by the exception handling middleware."
+ stability: stable
- id: unhandled
value: 'unhandled'
brief: "Exception was not handled by the exception handling middleware."
+ stability: stable
- id: skipped
value: 'skipped'
brief: "Exception handling was skipped because the response had started."
+ stability: stable
- id: aborted
value: 'aborted'
brief: "Exception handling didn't run because the request was aborted."
+ stability: stable
stability: stable
requirement_level: required
brief: ASP.NET Core exception middleware handling result
diff --git a/model/metrics/dotnet/dotnet-kestrel.yaml b/model/metrics/dotnet/dotnet-kestrel.yaml
index 9a4a231f51..0d1499a34c 100644
--- a/model/metrics/dotnet/dotnet-kestrel.yaml
+++ b/model/metrics/dotnet/dotnet-kestrel.yaml
@@ -38,7 +38,6 @@ groups:
- ref: network.protocol.version
examples: ["1.1", "2"]
- ref: tls.protocol.version
- stability: experimental
- ref: error.type
brief: The full name of exception type.
requirement_level:
@@ -110,7 +109,6 @@ groups:
extends: common.kestrel.attributes
attributes:
- ref: tls.protocol.version
- stability: experimental
- ref: error.type
brief: The full name of exception type.
note: "Captures the exception type when a TLS handshake fails."
diff --git a/model/metrics/dotnet/dotnet-signalr.yaml b/model/metrics/dotnet/dotnet-signalr.yaml
index b47ebf6908..e6233fc3cd 100644
--- a/model/metrics/dotnet/dotnet-signalr.yaml
+++ b/model/metrics/dotnet/dotnet-signalr.yaml
@@ -10,12 +10,15 @@ groups:
- id: normal_closure
value: 'normal_closure'
brief: "The connection was closed normally."
+ stability: stable
- id: timeout
value: 'timeout'
brief: "The connection was closed due to a timeout."
+ stability: stable
- id: app_shutdown
value: 'app_shutdown'
brief: "The connection was closed because the app is shutting down."
+ stability: stable
stability: stable
brief: SignalR HTTP connection closure status.
examples: ["app_shutdown", "timeout"]
@@ -27,12 +30,15 @@ groups:
- id: server_sent_events
value: 'server_sent_events'
brief: "ServerSentEvents protocol"
+ stability: stable
- id: long_polling
value: 'long_polling'
brief: "LongPolling protocol"
+ stability: stable
- id: web_sockets
value: 'web_sockets'
brief: "WebSockets protocol"
+ stability: stable
stability: stable
examples: ["web_sockets", "long_polling"]
diff --git a/model/metrics/jvm-metrics.yaml b/model/metrics/jvm-metrics.yaml
index b28b175130..5247f4165e 100644
--- a/model/metrics/jvm-metrics.yaml
+++ b/model/metrics/jvm-metrics.yaml
@@ -12,9 +12,11 @@ groups:
- id: heap
value: 'heap'
brief: 'Heap memory.'
+ stability: stable
- id: non_heap
value: 'non_heap'
brief: 'Non-heap memory'
+ stability: stable
requirement_level: recommended
brief: The type of memory.
examples: ["heap", "non_heap"]
@@ -113,21 +115,27 @@ groups:
- id: new
value: 'new'
brief: 'A thread that has not yet started is in this state.'
+ stability: stable
- id: runnable
value: 'runnable'
brief: 'A thread executing in the Java virtual machine is in this state.'
+ stability: stable
- id: blocked
value: 'blocked'
brief: 'A thread that is blocked waiting for a monitor lock is in this state.'
+ stability: stable
- id: waiting
value: 'waiting'
brief: 'A thread that is waiting indefinitely for another thread to perform a particular action is in this state.'
+ stability: stable
- id: timed_waiting
value: 'timed_waiting'
brief: 'A thread that is waiting for another thread to perform an action for up to a specified waiting time is in this state.'
+ stability: stable
- id: terminated
value: 'terminated'
brief: 'A thread that has exited is in this state.'
+ stability: stable
brief: "State of the thread."
examples: ["runnable", "blocked"]
stability: stable
diff --git a/model/metrics/process-metrics.yaml b/model/metrics/process-metrics.yaml
index d6735399a1..b6e99ed9f0 100644
--- a/model/metrics/process-metrics.yaml
+++ b/model/metrics/process-metrics.yaml
@@ -11,10 +11,13 @@ groups:
members:
- id: system
value: 'system'
+ stability: experimental
- id: user
value: 'user'
+ stability: experimental
- id: wait
value: 'wait'
+ stability: experimental
stability: experimental
- id: metric.process.cpu.time
type: metric
@@ -106,8 +109,10 @@ groups:
members:
- id: voluntary
value: 'voluntary'
+ stability: experimental
- id: involuntary
value: 'involuntary'
+ stability: experimental
stability: experimental
- id: metric.process.paging.faults
type: metric
@@ -124,6 +129,8 @@ groups:
members:
- id: major
value: 'major'
+ stability: experimental
- id: minor
value: 'minor'
+ stability: experimental
stability: experimental
diff --git a/model/metrics/system-metrics.yaml b/model/metrics/system-metrics.yaml
index 2424b1aa41..e567fb8a41 100644
--- a/model/metrics/system-metrics.yaml
+++ b/model/metrics/system-metrics.yaml
@@ -23,18 +23,25 @@ groups:
members:
- id: user
value: 'user'
+ stability: experimental
- id: system
value: 'system'
+ stability: experimental
- id: nice
value: 'nice'
+ stability: experimental
- id: idle
value: 'idle'
+ stability: experimental
- id: iowait
value: 'iowait'
+ stability: experimental
- id: interrupt
value: 'interrupt'
+ stability: experimental
- id: steal
value: 'steal'
+ stability: experimental
brief: "The CPU state for this data point. A system's CPU SHOULD be characterized *either* by data points with no `state` labels, *or only* data points with `state` labels."
stability: experimental
examples: ["idle", "interrupt"]
@@ -106,14 +113,19 @@ groups:
members:
- id: used
value: 'used'
+ stability: experimental
- id: free
value: 'free'
+ stability: experimental
- id: shared
value: 'shared'
+ stability: experimental
- id: buffers
value: 'buffers'
+ stability: experimental
- id: cached
value: 'cached'
+ stability: experimental
stability: experimental
brief: "The memory state"
examples: ["free", "cached"]
@@ -163,8 +175,10 @@ groups:
members:
- id: used
value: 'used'
+ stability: experimental
- id: free
value: 'free'
+ stability: experimental
stability: experimental
brief: "The memory paging state"
examples: ["free"]
@@ -174,8 +188,10 @@ groups:
members:
- id: major
value: 'major'
+ stability: experimental
- id: minor
value: 'minor'
+ stability: experimental
stability: experimental
brief: "The memory paging type"
examples: ["minor"]
@@ -185,8 +201,10 @@ groups:
members:
- id: in
value: 'in'
+ stability: experimental
- id: out
value: 'out'
+ stability: experimental
stability: experimental
brief: "The paging access direction"
examples: ["in"]
@@ -311,10 +329,13 @@ groups:
members:
- id: used
value: 'used'
+ stability: experimental
- id: free
value: 'free'
+ stability: experimental
- id: reserved
value: 'reserved'
+ stability: experimental
stability: experimental
examples: ["used"]
- id: type
@@ -323,16 +344,22 @@ groups:
members:
- id: fat32
value: 'fat32'
+ stability: experimental
- id: exfat
value: 'exfat'
+ stability: experimental
- id: ntfs
value: 'ntfs'
+ stability: experimental
- id: refs
value: 'refs'
+ stability: experimental
- id: hfsplus
value: 'hfsplus'
+ stability: experimental
- id: ext4
value: 'ext4'
+ stability: experimental
stability: experimental
brief: "The filesystem type"
examples: ["ext4"]
@@ -389,28 +416,40 @@ groups:
members:
- id: close
value: 'close'
+ stability: experimental
- id: close_wait
value: 'close_wait'
+ stability: experimental
- id: closing
value: 'closing'
+ stability: experimental
- id: delete
value: 'delete'
+ stability: experimental
- id: established
value: 'established'
+ stability: experimental
- id: fin_wait_1
value: 'fin_wait_1'
+ stability: experimental
- id: fin_wait_2
value: 'fin_wait_2'
+ stability: experimental
- id: last_ack
value: 'last_ack'
+ stability: experimental
- id: listen
value: 'listen'
+ stability: experimental
- id: syn_recv
value: 'syn_recv'
+ stability: experimental
- id: syn_sent
value: 'syn_sent'
+ stability: experimental
- id: time_wait
value: 'time_wait'
+ stability: experimental
stability: experimental
brief: "A stateless protocol MUST NOT set this attribute"
examples: ["close_wait"]
@@ -495,12 +534,16 @@ groups:
members:
- id: running
value: 'running'
+ stability: experimental
- id: sleeping
value: 'sleeping'
+ stability: experimental
- id: stopped
value: 'stopped'
+ stability: experimental
- id: defunct
value: 'defunct'
+ stability: experimental
stability: experimental
brief: >
The process state, e.g., [Linux Process State Codes](https://man7.org/linux/man-pages/man1/ps.1.html#PROCESS_STATE_CODES)
diff --git a/model/registry/cloud.yaml b/model/registry/cloud.yaml
index e3ce26b0e4..1fa9ba3982 100644
--- a/model/registry/cloud.yaml
+++ b/model/registry/cloud.yaml
@@ -12,24 +12,31 @@ groups:
- id: 'alibaba_cloud'
value: 'alibaba_cloud'
brief: 'Alibaba Cloud'
+ stability: experimental
- id: 'aws'
value: 'aws'
brief: 'Amazon Web Services'
+ stability: experimental
- id: 'azure'
value: 'azure'
brief: 'Microsoft Azure'
+ stability: experimental
- id: 'gcp'
value: 'gcp'
brief: 'Google Cloud Platform'
+ stability: experimental
- id: 'heroku'
value: 'heroku'
brief: 'Heroku Platform as a Service'
+ stability: experimental
- id: 'ibm_cloud'
value: 'ibm_cloud'
brief: 'IBM Cloud'
+ stability: experimental
- id: 'tencent_cloud'
value: 'tencent_cloud'
brief: 'Tencent Cloud'
+ stability: experimental
stability: experimental
brief: >
Name of the cloud provider.
@@ -99,87 +106,115 @@ groups:
- id: alibaba_cloud_ecs
value: 'alibaba_cloud_ecs'
brief: Alibaba Cloud Elastic Compute Service
+ stability: experimental
- id: alibaba_cloud_fc
value: 'alibaba_cloud_fc'
brief: Alibaba Cloud Function Compute
+ stability: experimental
- id: alibaba_cloud_openshift
value: 'alibaba_cloud_openshift'
brief: Red Hat OpenShift on Alibaba Cloud
+ stability: experimental
- id: aws_ec2
value: 'aws_ec2'
brief: AWS Elastic Compute Cloud
+ stability: experimental
- id: aws_ecs
value: 'aws_ecs'
brief: AWS Elastic Container Service
+ stability: experimental
- id: aws_eks
value: 'aws_eks'
brief: AWS Elastic Kubernetes Service
+ stability: experimental
- id: aws_lambda
value: 'aws_lambda'
brief: AWS Lambda
+ stability: experimental
- id: aws_elastic_beanstalk
value: 'aws_elastic_beanstalk'
brief: AWS Elastic Beanstalk
+ stability: experimental
- id: aws_app_runner
value: 'aws_app_runner'
brief: AWS App Runner
+ stability: experimental
- id: aws_openshift
value: 'aws_openshift'
brief: Red Hat OpenShift on AWS (ROSA)
+ stability: experimental
- id: azure_vm
value: 'azure_vm'
brief: Azure Virtual Machines
+ stability: experimental
- id: azure_container_apps
value: 'azure_container_apps'
brief: Azure Container Apps
+ stability: experimental
- id: azure_container_instances
value: 'azure_container_instances'
brief: Azure Container Instances
+ stability: experimental
- id: azure_aks
value: 'azure_aks'
brief: Azure Kubernetes Service
+ stability: experimental
- id: azure_functions
value: 'azure_functions'
brief: Azure Functions
+ stability: experimental
- id: azure_app_service
value: 'azure_app_service'
brief: Azure App Service
+ stability: experimental
- id: azure_openshift
value: 'azure_openshift'
brief: Azure Red Hat OpenShift
+ stability: experimental
- id: gcp_bare_metal_solution
value: 'gcp_bare_metal_solution'
brief: Google Bare Metal Solution (BMS)
+ stability: experimental
- id: gcp_compute_engine
value: 'gcp_compute_engine'
brief: Google Cloud Compute Engine (GCE)
+ stability: experimental
- id: gcp_cloud_run
value: 'gcp_cloud_run'
brief: Google Cloud Run
+ stability: experimental
- id: gcp_kubernetes_engine
value: 'gcp_kubernetes_engine'
brief: Google Cloud Kubernetes Engine (GKE)
+ stability: experimental
- id: gcp_cloud_functions
value: 'gcp_cloud_functions'
brief: Google Cloud Functions (GCF)
+ stability: experimental
- id: gcp_app_engine
value: 'gcp_app_engine'
brief: Google Cloud App Engine (GAE)
+ stability: experimental
- id: gcp_openshift
value: 'gcp_openshift'
brief: Red Hat OpenShift on Google Cloud
+ stability: experimental
- id: ibm_cloud_openshift
value: 'ibm_cloud_openshift'
brief: Red Hat OpenShift on IBM Cloud
+ stability: experimental
- id: tencent_cloud_cvm
value: 'tencent_cloud_cvm'
brief: Tencent Cloud Cloud Virtual Machine (CVM)
+ stability: experimental
- id: tencent_cloud_eks
value: 'tencent_cloud_eks'
brief: Tencent Cloud Elastic Kubernetes Service (EKS)
+ stability: experimental
- id: tencent_cloud_scf
value: 'tencent_cloud_scf'
brief: Tencent Cloud Serverless Cloud Function (SCF)
+ stability: experimental
stability: experimental
brief: >
The cloud platform in use.
diff --git a/model/registry/container.yaml b/model/registry/container.yaml
index 2878766b66..e04514e57a 100644
--- a/model/registry/container.yaml
+++ b/model/registry/container.yaml
@@ -103,10 +103,14 @@ groups:
- id: user
value: 'user'
brief: "When tasks of the cgroup are in user mode (Linux). When all container processes are in user mode (Windows)."
+ stability: experimental
- id: system
value: 'system'
brief: "When CPU is used by the system (host OS)"
+ stability: experimental
- id: kernel
value: 'kernel'
brief: "When tasks of the cgroup are in kernel mode (Linux). When all container processes are in kernel mode (Windows)."
+ stability: experimental
+ stability: experimental
examples: ["user", "kernel"]
diff --git a/model/registry/db.yaml b/model/registry/db.yaml
index 781cc68f9f..f56a830fcb 100644
--- a/model/registry/db.yaml
+++ b/model/registry/db.yaml
@@ -26,26 +26,37 @@ groups:
members:
- id: all
value: 'all'
+ stability: experimental
- id: each_quorum
value: 'each_quorum'
+ stability: experimental
- id: quorum
value: 'quorum'
+ stability: experimental
- id: local_quorum
value: 'local_quorum'
+ stability: experimental
- id: one
value: 'one'
+ stability: experimental
- id: two
value: 'two'
+ stability: experimental
- id: three
value: 'three'
+ stability: experimental
- id: local_one
value: 'local_one'
+ stability: experimental
- id: any
value: 'any'
+ stability: experimental
- id: serial
value: 'serial'
+ stability: experimental
- id: local_serial
value: 'local_serial'
+ stability: experimental
stability: experimental
tag: tech-specific-cassandra
- id: cassandra.idempotence
@@ -94,9 +105,11 @@ groups:
- id: gateway
value: 'gateway'
brief: Gateway (HTTP) connections mode
+ stability: experimental
- id: direct
value: 'direct'
brief: Direct connection.
+ stability: experimental
stability: experimental
brief: Cosmos client connection mode.
tag: tech-specific-cosmosdb
@@ -112,34 +125,49 @@ groups:
members:
- id: invalid
value: 'Invalid'
+ stability: experimental
- id: create
value: 'Create'
+ stability: experimental
- id: patch
value: 'Patch'
+ stability: experimental
- id: read
value: 'Read'
+ stability: experimental
- id: read_feed
value: 'ReadFeed'
+ stability: experimental
- id: delete
value: 'Delete'
+ stability: experimental
- id: replace
value: 'Replace'
+ stability: experimental
- id: execute
value: 'Execute'
+ stability: experimental
- id: query
value: 'Query'
+ stability: experimental
- id: head
value: 'Head'
+ stability: experimental
- id: head_feed
value: 'HeadFeed'
+ stability: experimental
- id: upsert
value: 'Upsert'
+ stability: experimental
- id: batch
value: 'Batch'
+ stability: experimental
- id: query_plan
value: 'QueryPlan'
+ stability: experimental
- id: execute_javascript
value: 'ExecuteJavaScript'
+ stability: experimental
stability: experimental
brief: CosmosDB Operation Type.
tag: tech-specific-cosmosdb
@@ -267,159 +295,211 @@ groups:
- id: other_sql
value: 'other_sql'
brief: 'Some other SQL database. Fallback only. See notes.'
+ stability: experimental
- id: mssql
value: 'mssql'
brief: 'Microsoft SQL Server'
+ stability: experimental
- id: mssqlcompact
value: 'mssqlcompact'
brief: 'Microsoft SQL Server Compact'
+ stability: experimental
- id: mysql
value: 'mysql'
brief: 'MySQL'
+ stability: experimental
- id: oracle
value: 'oracle'
brief: 'Oracle Database'
+ stability: experimental
- id: db2
value: 'db2'
brief: 'IBM Db2'
+ stability: experimental
- id: postgresql
value: 'postgresql'
brief: 'PostgreSQL'
+ stability: experimental
- id: redshift
value: 'redshift'
brief: 'Amazon Redshift'
+ stability: experimental
- id: hive
value: 'hive'
brief: 'Apache Hive'
+ stability: experimental
- id: cloudscape
value: 'cloudscape'
brief: 'Cloudscape'
+ stability: experimental
- id: hsqldb
value: 'hsqldb'
brief: 'HyperSQL DataBase'
+ stability: experimental
- id: progress
value: 'progress'
brief: 'Progress Database'
+ stability: experimental
- id: maxdb
value: 'maxdb'
brief: 'SAP MaxDB'
+ stability: experimental
- id: hanadb
value: 'hanadb'
brief: 'SAP HANA'
+ stability: experimental
- id: ingres
value: 'ingres'
brief: 'Ingres'
+ stability: experimental
- id: firstsql
value: 'firstsql'
brief: 'FirstSQL'
+ stability: experimental
- id: edb
value: 'edb'
brief: 'EnterpriseDB'
+ stability: experimental
- id: cache
value: 'cache'
brief: 'InterSystems Caché'
+ stability: experimental
- id: adabas
value: 'adabas'
brief: 'Adabas (Adaptable Database System)'
+ stability: experimental
- id: firebird
value: 'firebird'
brief: 'Firebird'
+ stability: experimental
- id: derby
value: 'derby'
brief: 'Apache Derby'
+ stability: experimental
- id: filemaker
value: 'filemaker'
brief: 'FileMaker'
+ stability: experimental
- id: informix
value: 'informix'
brief: 'Informix'
+ stability: experimental
- id: instantdb
value: 'instantdb'
brief: 'InstantDB'
+ stability: experimental
- id: interbase
value: 'interbase'
brief: 'InterBase'
+ stability: experimental
- id: mariadb
value: 'mariadb'
brief: 'MariaDB'
+ stability: experimental
- id: netezza
value: 'netezza'
brief: 'Netezza'
+ stability: experimental
- id: pervasive
value: 'pervasive'
brief: 'Pervasive PSQL'
+ stability: experimental
- id: pointbase
value: 'pointbase'
brief: 'PointBase'
+ stability: experimental
- id: sqlite
value: 'sqlite'
brief: 'SQLite'
+ stability: experimental
- id: sybase
value: 'sybase'
brief: 'Sybase'
+ stability: experimental
- id: teradata
value: 'teradata'
brief: 'Teradata'
+ stability: experimental
- id: vertica
value: 'vertica'
brief: 'Vertica'
+ stability: experimental
- id: h2
value: 'h2'
brief: 'H2'
+ stability: experimental
- id: coldfusion
value: 'coldfusion'
brief: 'ColdFusion IMQ'
+ stability: experimental
- id: cassandra
value: 'cassandra'
brief: 'Apache Cassandra'
+ stability: experimental
- id: hbase
value: 'hbase'
brief: 'Apache HBase'
+ stability: experimental
- id: mongodb
value: 'mongodb'
brief: 'MongoDB'
+ stability: experimental
- id: redis
value: 'redis'
brief: 'Redis'
+ stability: experimental
- id: couchbase
value: 'couchbase'
brief: 'Couchbase'
+ stability: experimental
- id: couchdb
value: 'couchdb'
brief: 'CouchDB'
+ stability: experimental
- id: cosmosdb
value: 'cosmosdb'
brief: 'Microsoft Azure Cosmos DB'
+ stability: experimental
- id: dynamodb
value: 'dynamodb'
brief: 'Amazon DynamoDB'
+ stability: experimental
- id: neo4j
value: 'neo4j'
brief: 'Neo4j'
+ stability: experimental
- id: geode
value: 'geode'
brief: 'Apache Geode'
+ stability: experimental
- id: elasticsearch
value: 'elasticsearch'
brief: 'Elasticsearch'
+ stability: experimental
- id: memcached
value: 'memcached'
brief: 'Memcached'
+ stability: experimental
- id: cockroachdb
value: 'cockroachdb'
brief: 'CockroachDB'
+ stability: experimental
- id: opensearch
value: 'opensearch'
brief: 'OpenSearch'
+ stability: experimental
- id: clickhouse
value: 'clickhouse'
brief: 'ClickHouse'
+ stability: experimental
- id: spanner
value: 'spanner'
brief: 'Cloud Spanner'
+ stability: experimental
- id: trino
value: 'trino'
brief: 'Trino'
+ stability: experimental
stability: experimental
tag: db-generic
- id: user
diff --git a/model/registry/deprecated/container.yaml b/model/registry/deprecated/container.yaml
index 8c19e64f8b..49190f6918 100644
--- a/model/registry/deprecated/container.yaml
+++ b/model/registry/deprecated/container.yaml
@@ -7,4 +7,5 @@ groups:
type: template[string]
examples: [ 'container.label.app=nginx' ]
brief: "Deprecated, use `container.label` instead."
+ stability: experimental
deprecated: "Replaced by `container.label`."
diff --git a/model/registry/deprecated/db.yaml b/model/registry/deprecated/db.yaml
index 76430d1b1b..c2f94cfe22 100644
--- a/model/registry/deprecated/db.yaml
+++ b/model/registry/deprecated/db.yaml
@@ -8,16 +8,19 @@ groups:
- id: connection_string
type: string
brief: 'Deprecated, use `server.address`, `server.port` attributes instead.'
+ stability: experimental
deprecated: >
"Replaced by `server.address` and `server.port`."
examples: Server=(localdb)\v11.0;Integrated Security=true;
- id: jdbc.driver_classname
type: string
brief: 'Removed, no replacement at this time.'
+ stability: experimental
deprecated: 'Removed as not used.'
examples: ['org.postgresql.Driver', 'com.microsoft.sqlserver.jdbc.SQLServerDriver']
- id: elasticsearch.node.name
type: string
brief: 'Deprecated, use `db.instance.id` instead.'
deprecated: "Replaced by `db.instance.id`."
+ stability: experimental
examples: ["instance-0000000001"]
diff --git a/model/registry/deprecated/http.yaml b/model/registry/deprecated/http.yaml
index 9c255eb9f2..746d8f1db4 100644
--- a/model/registry/deprecated/http.yaml
+++ b/model/registry/deprecated/http.yaml
@@ -7,36 +7,43 @@ groups:
- id: method
type: string
brief: 'Deprecated, use `http.request.method` instead.'
+ stability: experimental
deprecated: "Replaced by `http.request.method`."
examples: ["GET", "POST", "HEAD"]
- id: status_code
type: int
brief: 'Deprecated, use `http.response.status_code` instead.'
+ stability: experimental
deprecated: "Replaced by `http.response.status_code`."
examples: [200]
- id: scheme
type: string
brief: 'Deprecated, use `url.scheme` instead.'
+ stability: experimental
deprecated: "Replaced by `url.scheme` instead."
examples: ['http', 'https']
- id: url
type: string
brief: 'Deprecated, use `url.full` instead.'
+ stability: experimental
deprecated: "Replaced by `url.full`."
examples: ['https://www.foo.bar/search?q=OpenTelemetry#SemConv']
- id: target
type: string
brief: 'Deprecated, use `url.path` and `url.query` instead.'
+ stability: experimental
deprecated: "Split to `url.path` and `url.query."
examples: ['/search?q=OpenTelemetry#SemConv']
- id: request_content_length
type: int
brief: 'Deprecated, use `http.request.header.content-length` instead.'
+ stability: experimental
deprecated: "Replaced by `http.request.header.content-length`."
examples: 3495
- id: response_content_length
type: int
brief: 'Deprecated, use `http.response.header.content-length` instead.'
+ stability: experimental
deprecated: "Replaced by `http.response.header.content-length`."
examples: 3495
- id: flavor
@@ -46,26 +53,34 @@ groups:
- id: http_1_0
value: '1.0'
brief: 'HTTP/1.0'
+ stability: experimental
- id: http_1_1
value: '1.1'
brief: 'HTTP/1.1'
+ stability: experimental
- id: http_2_0
value: '2.0'
brief: 'HTTP/2'
+ stability: experimental
- id: http_3_0
value: '3.0'
brief: 'HTTP/3'
+ stability: experimental
- id: spdy
value: 'SPDY'
brief: 'SPDY protocol.'
+ stability: experimental
- id: quic
value: 'QUIC'
brief: 'QUIC protocol.'
+ stability: experimental
brief: 'Deprecated, use `network.protocol.name` instead.'
deprecated: "Replaced by `network.protocol.name`."
+ stability: experimental
- id: user_agent
type: string
brief: 'Deprecated, use `user_agent.original` instead.'
examples: ['CERN-LineMode/2.15 libwww/2.17b3',
'Mozilla/5.0 (iPhone; CPU iPhone OS 14_7_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.1.2 Mobile/15E148 Safari/604.1']
deprecated: "Replaced by `user_agent.original`."
+ stability: experimental
diff --git a/model/registry/deprecated/k8s.yaml b/model/registry/deprecated/k8s.yaml
index 5793257d7f..ae471dd896 100644
--- a/model/registry/deprecated/k8s.yaml
+++ b/model/registry/deprecated/k8s.yaml
@@ -7,4 +7,5 @@ groups:
type: template[string]
examples: ['k8s.pod.label.app=my-app']
brief: "Deprecated, use `k8s.pod.label` instead."
+ stability: experimental
deprecated: "Replaced by `k8s.pod.label`."
diff --git a/model/registry/deprecated/messaging.yaml b/model/registry/deprecated/messaging.yaml
index 015f428818..97da3c55bb 100644
--- a/model/registry/deprecated/messaging.yaml
+++ b/model/registry/deprecated/messaging.yaml
@@ -9,3 +9,4 @@ groups:
"Deprecated, use `messaging.destination.partition.id` instead."
examples: 2
deprecated: "Replaced by `messaging.destination.partition.id`."
+ stability: experimental
diff --git a/model/registry/deprecated/network.yaml b/model/registry/deprecated/network.yaml
index 63e3959d7e..8377f727e6 100644
--- a/model/registry/deprecated/network.yaml
+++ b/model/registry/deprecated/network.yaml
@@ -8,46 +8,55 @@ groups:
- id: sock.peer.name
type: string
deprecated: "Removed."
+ stability: experimental
brief: Deprecated, no replacement at this time.
examples: ['/var/my.sock']
- id: sock.peer.addr
type: string
deprecated: "Replaced by `network.peer.address`."
+ stability: experimental
brief: Deprecated, use `network.peer.address`.
examples: ['192.168.0.1']
- id: sock.peer.port
type: int
deprecated: "Replaced by `network.peer.port`."
+ stability: experimental
examples: [65531]
brief: Deprecated, use `network.peer.port`.
- id: peer.name
type: string
deprecated: "Replaced by `server.address` on client spans and `client.address` on server spans."
+ stability: experimental
brief: Deprecated, use `server.address` on client spans and `client.address` on server spans.
examples: ['example.com']
- id: peer.port
type: int
deprecated: "Replaced by `server.port` on client spans and `client.port` on server spans."
+ stability: experimental
brief: Deprecated, use `server.port` on client spans and `client.port` on server spans.
examples: [8080]
- id: host.name
type: string
deprecated: "Replaced by `server.address`."
+ stability: experimental
brief: Deprecated, use `server.address`.
examples: ['example.com']
- id: host.port
type: int
deprecated: "Replaced by `server.port`."
+ stability: experimental
brief: Deprecated, use `server.port`.
examples: [8080]
- id: sock.host.addr
type: string
deprecated: "Replaced by `network.local.address`."
+ stability: experimental
brief: Deprecated, use `network.local.address`.
examples: ['/var/my.sock']
- id: sock.host.port
type: int
deprecated: "Replaced by `network.local.port`."
+ stability: experimental
brief: Deprecated, use `network.local.port`.
examples: [8080]
- id: transport
@@ -56,31 +65,39 @@ groups:
members:
- id: ip_tcp
value: "ip_tcp"
+ stability: experimental
- id: ip_udp
value: "ip_udp"
+ stability: experimental
- id: pipe
value: "pipe"
brief: 'Named or anonymous pipe.'
+ stability: experimental
- id: inproc
value: "inproc"
brief: 'In-process communication.'
+ stability: experimental
note: >
Signals that there is only in-process communication not using a "real" network protocol
in cases where network attributes would normally be expected. Usually all other network
attributes can be left out in that case.
- id: other
value: "other"
+ stability: experimental
brief: 'Something else (non IP-based).'
deprecated: "Replaced by `network.transport`."
+ stability: experimental
brief: Deprecated, use `network.transport`.
- id: protocol.name
type: string
deprecated: "Replaced by `network.protocol.name`."
+ stability: experimental
brief: Deprecated, use `network.protocol.name`.
examples: ['amqp', 'http', 'mqtt']
- id: protocol.version
type: string
deprecated: "Replaced by `network.protocol.version`."
+ stability: experimental
brief: Deprecated, use `network.protocol.version`.
examples: '3.1.1'
- id: sock.family
@@ -90,11 +107,15 @@ groups:
- id: inet
value: 'inet'
brief: "IPv4 address"
+ stability: experimental
- id: inet6
value: 'inet6'
brief: "IPv6 address"
+ stability: experimental
- id: unix
value: 'unix'
brief: "Unix domain socket path"
+ stability: experimental
deprecated: "Split to `network.transport` and `network.type`."
+ stability: experimental
brief: Deprecated, use `network.transport` and `network.type`.
diff --git a/model/registry/deprecated/system.yaml b/model/registry/deprecated/system.yaml
index 2356ebc562..bda1dc0e9b 100644
--- a/model/registry/deprecated/system.yaml
+++ b/model/registry/deprecated/system.yaml
@@ -9,12 +9,17 @@ groups:
members:
- id: running
value: 'running'
+ stability: experimental
- id: sleeping
value: 'sleeping'
+ stability: experimental
- id: stopped
value: 'stopped'
+ stability: experimental
- id: defunct
value: 'defunct'
+ stability: experimental
brief: "Deprecated, use `system.process.status` instead."
deprecated: "Replaced by `system.process.status`."
+ stability: experimental
examples: ["running"]
diff --git a/model/registry/disk.yaml b/model/registry/disk.yaml
index d8aba1e251..aa8c091135 100644
--- a/model/registry/disk.yaml
+++ b/model/registry/disk.yaml
@@ -11,8 +11,10 @@ groups:
members:
- id: read
value: 'read'
+ stability: experimental
- id: write
value: 'write'
+ stability: experimental
stability: experimental
brief: "The disk IO operation direction."
examples: ["read"]
diff --git a/model/registry/error.yaml b/model/registry/error.yaml
index 683012e361..9864db9ce3 100644
--- a/model/registry/error.yaml
+++ b/model/registry/error.yaml
@@ -14,6 +14,7 @@ groups:
members:
- id: other
value: "_OTHER"
+ stability: stable
brief: >
A fallback error value to be used when the instrumentation doesn't define a custom value.
examples: ['timeout', 'java.net.UnknownHostException', 'server_certificate_invalid', '500']
diff --git a/model/registry/faas.yaml b/model/registry/faas.yaml
index 12c5816a20..a4fc8a3d55 100644
--- a/model/registry/faas.yaml
+++ b/model/registry/faas.yaml
@@ -72,18 +72,23 @@ groups:
- id: datasource
value: 'datasource'
brief: 'A response to some data source operation such as a database or filesystem read/write'
+ stability: experimental
- id: http
value: 'http'
brief: 'To provide an answer to an inbound HTTP request'
+ stability: experimental
- id: pubsub
value: 'pubsub'
brief: 'A function is set to be executed when messages are sent to a messaging system'
+ stability: experimental
- id: timer
value: 'timer'
brief: 'A function is scheduled to be executed regularly'
+ stability: experimental
- id: other
value: 'other'
brief: 'If none of the others apply'
+ stability: experimental
- id: invoked_name
type: string
stability: experimental
@@ -101,18 +106,23 @@ groups:
- id: 'alibaba_cloud'
value: 'alibaba_cloud'
brief: 'Alibaba Cloud'
+ stability: experimental
- id: 'aws'
value: 'aws'
brief: 'Amazon Web Services'
+ stability: experimental
- id: 'azure'
value: 'azure'
brief: 'Microsoft Azure'
+ stability: experimental
- id: 'gcp'
value: 'gcp'
brief: 'Google Cloud Platform'
+ stability: experimental
- id: 'tencent_cloud'
value: 'tencent_cloud'
brief: 'Tencent Cloud'
+ stability: experimental
brief: >
The cloud provider of the invoked function.
note: >
@@ -170,12 +180,15 @@ groups:
- id: insert
value: 'insert'
brief: 'When a new object is created.'
+ stability: experimental
- id: edit
value: 'edit'
brief: 'When an object is modified.'
+ stability: experimental
- id: delete
value: 'delete'
brief: 'When an object is deleted.'
+ stability: experimental
brief: 'Describes the type of the operation that was performed on the data.'
- id: document.time
type: string
diff --git a/model/registry/file.yaml b/model/registry/file.yaml
index 6a86aa9f9b..bbe0f99fd2 100644
--- a/model/registry/file.yaml
+++ b/model/registry/file.yaml
@@ -8,11 +8,13 @@ groups:
type: string
brief: >
Directory where the file is located. It should include the drive letter, when appropriate.
+ stability: experimental
examples: ['/home/user', 'C:\Program Files\MyApp']
- id: extension
type: string
brief: >
File extension, excluding the leading dot.
+ stability: experimental
examples: ['png', 'gz']
note: >
When the file name has multiple extensions (example.tar.gz), only the last one should
@@ -21,13 +23,16 @@ groups:
type: string
brief: >
Name of the file including the extension, without the directory.
+ stability: experimental
examples: ['example.png']
- id: path
type: string
brief: >
Full path to the file, including the file name. It should include the drive letter, when appropriate.
+ stability: experimental
examples: ['/home/alice/example.png', 'C:\Program Files\MyApp\myapp.exe']
- id: size
type: int
brief: >
File size in bytes.
+ stability: experimental
diff --git a/model/registry/host.yaml b/model/registry/host.yaml
index f427266375..332ea01f9c 100644
--- a/model/registry/host.yaml
+++ b/model/registry/host.yaml
@@ -34,27 +34,35 @@ groups:
- id: amd64
value: 'amd64'
brief: "AMD64"
+ stability: experimental
- id: arm32
value: 'arm32'
brief: "ARM32"
+ stability: experimental
- id: arm64
value: 'arm64'
brief: "ARM64"
+ stability: experimental
- id: ia64
value: 'ia64'
brief: "Itanium"
+ stability: experimental
- id: ppc32
value: 'ppc32'
brief: "32-bit PowerPC"
+ stability: experimental
- id: ppc64
value: 'ppc64'
brief: "64-bit PowerPC"
+ stability: experimental
- id: s390x
value: 's390x'
brief: "IBM z/Architecture"
+ stability: experimental
- id: x86
value: 'x86'
brief: "32-bit x86"
+ stability: experimental
stability: experimental
brief: >
The CPU architecture the host system is running on.
diff --git a/model/registry/http.yaml b/model/registry/http.yaml
index ee0ff93293..e013704a49 100644
--- a/model/registry/http.yaml
+++ b/model/registry/http.yaml
@@ -36,33 +36,43 @@ groups:
- id: connect
value: "CONNECT"
brief: 'CONNECT method.'
+ stability: stable
- id: delete
value: "DELETE"
brief: 'DELETE method.'
+ stability: stable
- id: get
value: "GET"
brief: 'GET method.'
+ stability: stable
- id: head
value: "HEAD"
brief: 'HEAD method.'
+ stability: stable
- id: options
value: "OPTIONS"
brief: 'OPTIONS method.'
+ stability: stable
- id: patch
value: "PATCH"
brief: 'PATCH method.'
+ stability: stable
- id: post
value: "POST"
brief: 'POST method.'
+ stability: stable
- id: put
value: "PUT"
brief: 'PUT method.'
+ stability: stable
- id: trace
value: "TRACE"
brief: 'TRACE method.'
+ stability: stable
- id: other
value: "_OTHER"
brief: 'Any HTTP method that the instrumentation has no prior knowledge of.'
+ stability: stable
brief: 'HTTP request method.'
examples: ["GET", "POST", "HEAD"]
note: |
@@ -154,9 +164,11 @@ groups:
- id: active
value: "active"
brief: 'active state.'
+ stability: experimental
- id: idle
value: "idle"
brief: 'idle state.'
+ stability: experimental
brief: State of the HTTP connection in the HTTP connection pool.
stability: experimental
examples: ["active", "idle"]
diff --git a/model/registry/messaging.yaml b/model/registry/messaging.yaml
index 5e6846abd7..4938ddd045 100644
--- a/model/registry/messaging.yaml
+++ b/model/registry/messaging.yaml
@@ -148,24 +148,29 @@ groups:
brief: >
One or more messages are provided for publishing to an intermediary.
If a single message is published, the context of the "Publish" span can be used as the creation context and no "Create" span needs to be created.
+ stability: experimental
- id: create
value: "create"
brief: >
A message is created.
"Create" spans always refer to a single message and are used to provide a unique creation context for messages in batch publishing scenarios.
+ stability: experimental
- id: receive
value: "receive"
brief: >
One or more messages are requested by a consumer.
This operation refers to pull-based scenarios, where consumers explicitly call methods of messaging SDKs to receive messages.
+ stability: experimental
- id: deliver
value: "process"
brief: >
One or more messages are delivered to or processed by a consumer.
+ stability: experimental
- id: settle
value: "settle"
brief: >
One or more messages are settled.
+ stability: experimental
stability: experimental
brief: >
A string identifying the kind of messaging operation.
@@ -200,9 +205,11 @@ groups:
- id: clustering
value: 'clustering'
brief: 'Clustering consumption model'
+ stability: experimental
- id: broadcasting
value: 'broadcasting'
brief: 'Broadcasting consumption model'
+ stability: experimental
stability: experimental
brief: >
Model of message consumption. This only applies to consumer spans.
@@ -249,15 +256,19 @@ groups:
- id: normal
value: 'normal'
brief: "Normal message"
+ stability: experimental
- id: fifo
value: 'fifo'
brief: 'FIFO message'
+ stability: experimental
- id: delay
value: 'delay'
brief: 'Delay message'
+ stability: experimental
- id: transaction
value: 'transaction'
brief: 'Transaction message'
+ stability: experimental
stability: experimental
brief: >
Type of message.
@@ -285,33 +296,43 @@ groups:
- id: activemq
value: 'activemq'
brief: 'Apache ActiveMQ'
+ stability: experimental
- id: aws_sqs
value: 'aws_sqs'
brief: 'Amazon Simple Queue Service (SQS)'
+ stability: experimental
- id: eventgrid
value: 'eventgrid'
brief: 'Azure Event Grid'
+ stability: experimental
- id: eventhubs
value: 'eventhubs'
brief: 'Azure Event Hubs'
+ stability: experimental
- id: servicebus
value: 'servicebus'
brief: 'Azure Service Bus'
+ stability: experimental
- id: gcp_pubsub
value: 'gcp_pubsub'
brief: 'Google Cloud Pub/Sub'
+ stability: experimental
- id: jms
value: 'jms'
brief: 'Java Message Service'
+ stability: experimental
- id: kafka
value: 'kafka'
brief: 'Apache Kafka'
+ stability: experimental
- id: rabbitmq
value: 'rabbitmq'
brief: 'RabbitMQ'
+ stability: experimental
- id: rocketmq
value: 'rocketmq'
brief: 'Apache RocketMQ'
+ stability: experimental
stability: experimental
tag: messaging-generic
- id: servicebus.message.delivery_count
@@ -344,15 +365,19 @@ groups:
- id: complete
value: 'complete'
brief: 'Message is completed'
+ stability: experimental
- id: abandon
value: 'abandon'
brief: 'Message is abandoned'
+ stability: experimental
- id: dead_letter
value: 'dead_letter'
brief: 'Message is sent to dead letter queue'
+ stability: experimental
- id: defer
value: 'defer'
brief: 'Message is deferred'
+ stability: experimental
stability: experimental
tag: tech-specific-servicebus
- id: eventhubs.message.enqueued_time
diff --git a/model/registry/network.yaml b/model/registry/network.yaml
index 0c1da314c4..2f3f19576c 100644
--- a/model/registry/network.yaml
+++ b/model/registry/network.yaml
@@ -32,66 +32,87 @@ groups:
- id: gprs
brief: GPRS
value: "gprs"
+ stability: experimental
- id: edge
brief: EDGE
value: "edge"
+ stability: experimental
- id: umts
brief: UMTS
value: "umts"
+ stability: experimental
- id: cdma
brief: CDMA
value: "cdma"
+ stability: experimental
- id: evdo_0
brief: EVDO Rel. 0
value: "evdo_0"
+ stability: experimental
- id: evdo_a
brief: "EVDO Rev. A"
value: "evdo_a"
+ stability: experimental
- id: cdma2000_1xrtt
brief: CDMA2000 1XRTT
value: "cdma2000_1xrtt"
+ stability: experimental
- id: hsdpa
brief: HSDPA
value: "hsdpa"
+ stability: experimental
- id: hsupa
brief: HSUPA
value: "hsupa"
+ stability: experimental
- id: hspa
brief: HSPA
value: "hspa"
+ stability: experimental
- id: iden
brief: IDEN
value: "iden"
+ stability: experimental
- id: evdo_b
brief: "EVDO Rev. B"
value: "evdo_b"
+ stability: experimental
- id: lte
brief: LTE
value: "lte"
+ stability: experimental
- id: ehrpd
brief: EHRPD
value: "ehrpd"
+ stability: experimental
- id: hspap
brief: HSPAP
value: "hspap"
+ stability: experimental
- id: gsm
brief: GSM
value: "gsm"
+ stability: experimental
- id: td_scdma
brief: TD-SCDMA
value: "td_scdma"
+ stability: experimental
- id: iwlan
brief: IWLAN
value: "iwlan"
+ stability: experimental
- id: nr
brief: "5G NR (New Radio)"
value: "nr"
+ stability: experimental
- id: nrnsa
brief: "5G NRNSA (New Radio Non-Standalone)"
value: "nrnsa"
+ stability: experimental
- id: lte_ca
brief: LTE CA
value: "lte_ca"
+ stability: experimental
stability: experimental
brief: 'This describes more details regarding the connection.type. It may be the type of cell technology connection, but it could be used for describing details about a wifi connection.'
examples: 'LTE'
@@ -101,14 +122,19 @@ groups:
members:
- id: wifi
value: "wifi"
+ stability: experimental
- id: wired
value: "wired"
+ stability: experimental
- id: cell
value: "cell"
+ stability: experimental
- id: unavailable
value: "unavailable"
+ stability: experimental
- id: unknown
value: "unknown"
+ stability: experimental
stability: experimental
brief: 'The internet connection type.'
examples: 'wifi'
@@ -155,15 +181,19 @@ groups:
- id: tcp
value: 'tcp'
brief: "TCP"
+ stability: stable
- id: udp
value: 'udp'
brief: "UDP"
+ stability: stable
- id: pipe
value: "pipe"
brief: 'Named or anonymous pipe.'
+ stability: stable
- id: unix
value: 'unix'
brief: "Unix domain socket"
+ stability: stable
brief: >
[OSI transport layer](https://osi-model.com/transport-layer/) or
[inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication).
@@ -182,9 +212,11 @@ groups:
- id: ipv4
value: 'ipv4'
brief: "IPv4"
+ stability: stable
- id: ipv6
value: 'ipv6'
brief: "IPv6"
+ stability: stable
brief: '[OSI network layer](https://osi-model.com/network-layer/) or non-OSI equivalent.'
note: The value SHOULD be normalized to lowercase.
examples: ['ipv4', 'ipv6']
@@ -194,8 +226,10 @@ groups:
members:
- id: transmit
value: 'transmit'
+ stability: experimental
- id: receive
value: 'receive'
+ stability: experimental
stability: experimental
brief: "The network IO operation direction."
examples: ["transmit"]
diff --git a/model/registry/os.yaml b/model/registry/os.yaml
index 113901906a..3317958f16 100644
--- a/model/registry/os.yaml
+++ b/model/registry/os.yaml
@@ -15,36 +15,47 @@ groups:
- id: windows
value: 'windows'
brief: "Microsoft Windows"
+ stability: experimental
- id: linux
value: 'linux'
brief: "Linux"
+ stability: experimental
- id: darwin
value: 'darwin'
brief: "Apple Darwin"
+ stability: experimental
- id: freebsd
value: 'freebsd'
brief: "FreeBSD"
+ stability: experimental
- id: netbsd
value: 'netbsd'
brief: "NetBSD"
+ stability: experimental
- id: openbsd
value: 'openbsd'
brief: "OpenBSD"
+ stability: experimental
- id: dragonflybsd
value: 'dragonflybsd'
brief: "DragonFly BSD"
+ stability: experimental
- id: hpux
value: 'hpux'
brief: "HP-UX (Hewlett Packard Unix)"
+ stability: experimental
- id: aix
value: 'aix'
brief: "AIX (Advanced Interactive eXecutive)"
+ stability: experimental
- id: solaris
value: 'solaris'
brief: "SunOS, Oracle Solaris"
+ stability: experimental
- id: z_os
value: 'z_os'
brief: "IBM z/OS"
+ stability: experimental
brief: >
The operating system type.
stability: experimental
diff --git a/model/registry/rpc.yaml b/model/registry/rpc.yaml
index cfc1e45017..e7400d540e 100644
--- a/model/registry/rpc.yaml
+++ b/model/registry/rpc.yaml
@@ -9,36 +9,52 @@ groups:
members:
- id: cancelled
value: cancelled
+ stability: experimental
- id: unknown
value: unknown
+ stability: experimental
- id: invalid_argument
value: invalid_argument
+ stability: experimental
- id: deadline_exceeded
value: deadline_exceeded
+ stability: experimental
- id: not_found
value: not_found
+ stability: experimental
- id: already_exists
value: already_exists
+ stability: experimental
- id: permission_denied
value: permission_denied
+ stability: experimental
- id: resource_exhausted
value: resource_exhausted
+ stability: experimental
- id: failed_precondition
value: failed_precondition
+ stability: experimental
- id: aborted
value: aborted
+ stability: experimental
- id: out_of_range
value: out_of_range
+ stability: experimental
- id: unimplemented
value: unimplemented
+ stability: experimental
- id: internal
value: internal
+ stability: experimental
- id: unavailable
value: unavailable
+ stability: experimental
- id: data_loss
value: data_loss
+ stability: experimental
- id: unauthenticated
value: unauthenticated
+ stability: experimental
stability: experimental
brief: "The [error codes](https://connect.build/docs/protocol/#error-codes) of the Connect request. Error codes are always string values."
- id: connect_rpc.request.metadata
@@ -64,54 +80,71 @@ groups:
members:
- id: ok
brief: OK
+ stability: experimental
value: 0
- id: cancelled
brief: CANCELLED
+ stability: experimental
value: 1
- id: unknown
brief: UNKNOWN
+ stability: experimental
value: 2
- id: invalid_argument
brief: INVALID_ARGUMENT
+ stability: experimental
value: 3
- id: deadline_exceeded
brief: DEADLINE_EXCEEDED
+ stability: experimental
value: 4
- id: not_found
brief: NOT_FOUND
+ stability: experimental
value: 5
- id: already_exists
brief: ALREADY_EXISTS
+ stability: experimental
value: 6
- id: permission_denied
brief: PERMISSION_DENIED
+ stability: experimental
value: 7
- id: resource_exhausted
brief: RESOURCE_EXHAUSTED
+ stability: experimental
value: 8
- id: failed_precondition
brief: FAILED_PRECONDITION
+ stability: experimental
value: 9
- id: aborted
brief: ABORTED
+ stability: experimental
value: 10
- id: out_of_range
brief: OUT_OF_RANGE
+ stability: experimental
value: 11
- id: unimplemented
brief: UNIMPLEMENTED
+ stability: experimental
value: 12
- id: internal
brief: INTERNAL
+ stability: experimental
value: 13
- id: unavailable
brief: UNAVAILABLE
+ stability: experimental
value: 14
- id: data_loss
brief: DATA_LOSS
+ stability: experimental
value: 15
- id: unauthenticated
brief: UNAUTHENTICATED
+ stability: experimental
value: 16
stability: experimental
brief: "The [numeric status code](https://github.com/grpc/grpc/blob/v1.33.2/doc/statuscodes.md) of the gRPC request."
@@ -188,16 +221,21 @@ groups:
- id: grpc
value: 'grpc'
brief: 'gRPC'
+ stability: experimental
- id: java_rmi
value: 'java_rmi'
brief: 'Java RMI'
+ stability: experimental
- id: dotnet_wcf
value: 'dotnet_wcf'
brief: '.NET WCF'
+ stability: experimental
- id: apache_dubbo
value: 'apache_dubbo'
brief: 'Apache Dubbo'
+ stability: experimental
- id: connect_rpc
value: 'connect_rpc'
brief: 'Connect RPC'
+ stability: experimental
stability: experimental
diff --git a/model/registry/tls.yaml b/model/registry/tls.yaml
index 1f0c880bc2..d327cf5005 100644
--- a/model/registry/tls.yaml
+++ b/model/registry/tls.yaml
@@ -117,8 +117,10 @@ groups:
members:
- id: ssl
value: ssl
+ stability: experimental
- id: tls
value: tls
+ stability: experimental
stability: experimental
- id: protocol.version
brief: >
diff --git a/model/resource/cloud_provider/aws/ecs.yaml b/model/resource/cloud_provider/aws/ecs.yaml
index a3c4b3f8b1..af24faf1ca 100644
--- a/model/resource/cloud_provider/aws/ecs.yaml
+++ b/model/resource/cloud_provider/aws/ecs.yaml
@@ -23,8 +23,10 @@ groups:
members:
- id: ec2
value: "ec2"
+ stability: experimental
- id: fargate
value: "fargate"
+ stability: experimental
stability: experimental
brief: >
The [launch type](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) for an ECS task.
diff --git a/model/resource/telemetry.yaml b/model/resource/telemetry.yaml
index 9b57a7afd2..be016372b7 100644
--- a/model/resource/telemetry.yaml
+++ b/model/resource/telemetry.yaml
@@ -25,28 +25,40 @@ groups:
members:
- id: cpp
value: "cpp"
+ stability: stable
- id: dotnet
value: "dotnet"
+ stability: stable
- id: erlang
value: "erlang"
+ stability: stable
- id: go
value: "go"
+ stability: stable
- id: java
value: "java"
+ stability: stable
- id: nodejs
value: "nodejs"
+ stability: stable
- id: php
value: "php"
+ stability: stable
- id: python
value: "python"
+ stability: stable
- id: ruby
value: "ruby"
+ stability: stable
- id: rust
value: "rust"
+ stability: stable
- id: swift
value: "swift"
+ stability: stable
- id: webjs
value: "webjs"
+ stability: stable
stability: stable
requirement_level: required
brief: >
diff --git a/model/scope/exporter/exporter.yaml b/model/scope/exporter/exporter.yaml
index 259061d3ad..41b27571b4 100644
--- a/model/scope/exporter/exporter.yaml
+++ b/model/scope/exporter/exporter.yaml
@@ -23,10 +23,12 @@ groups:
- id: name
type: string
deprecated: use the `otel.scope.name` attribute.
+ stability: experimental
brief:
examples: ['io.opentelemetry.contrib.mongodb']
- id: version
type: string
deprecated: use the `otel.scope.version` attribute.
+ stability: experimental
brief:
examples: ['1.0.0']
diff --git a/model/trace/compatibility.yaml b/model/trace/compatibility.yaml
index b24b39a339..2ed1de06b4 100644
--- a/model/trace/compatibility.yaml
+++ b/model/trace/compatibility.yaml
@@ -17,6 +17,8 @@ groups:
- id: child_of
value: 'child_of'
brief: "The parent Span depends on the child Span in some capacity"
+ stability: experimental
- id: follows_from
value: 'follows_from'
brief: "The parent Span doesn't depend in any way on the result of the child Span"
+ stability: experimental
diff --git a/model/trace/exporter/exporter.yaml b/model/trace/exporter/exporter.yaml
index 23b5f921b3..124c5da191 100644
--- a/model/trace/exporter/exporter.yaml
+++ b/model/trace/exporter/exporter.yaml
@@ -11,9 +11,11 @@ groups:
- id: ok
value: OK
brief: 'The operation has been validated by an Application developer or Operator to have completed successfully.'
+ stability: experimental
- id: error
value: ERROR
brief: 'The operation contains an error.'
+ stability: experimental
brief: Name of the code, either "OK" or "ERROR". MUST NOT be set if the status code is UNSET.
stability: stable
- id: status_description
diff --git a/model/trace/instrumentation/graphql.yml b/model/trace/instrumentation/graphql.yml
index f3f28d1585..6e311afa69 100644
--- a/model/trace/instrumentation/graphql.yml
+++ b/model/trace/instrumentation/graphql.yml
@@ -20,12 +20,15 @@ groups:
- id: query
value: "query"
brief: "GraphQL query"
+ stability: experimental
- id: mutation
value: "mutation"
brief: "GraphQL mutation"
+ stability: experimental
- id: subscription
value: "subscription"
brief: "GraphQL subscription"
+ stability: experimental
examples: ['query', 'mutation', 'subscription']
- id: document
brief: "The GraphQL document being executed."
diff --git a/model/trace/rpc.yaml b/model/trace/rpc.yaml
index 42a3211d26..7e259966f8 100644
--- a/model/trace/rpc.yaml
+++ b/model/trace/rpc.yaml
@@ -98,8 +98,10 @@ groups:
members:
- id: sent
value: "SENT"
+ stability: experimental
- id: received
value: "RECEIVED"
+ stability: experimental
stability: experimental
brief: "Whether this is a received or sent message."
- id: id