diff --git a/Makefile b/Makefile
index f18cb59..0da607f 100644
--- a/Makefile
+++ b/Makefile
@@ -184,12 +184,12 @@ fix-format:
# Run all checks in order of speed / likely failure.
.PHONY: check
-check: misspell markdownlint attribute-registry-generation markdown-link-check check-format check-policies
+check: misspell markdownlint check-format attribute-registry-generation markdown-link-check check-policies
@echo "All checks complete"
# Attempt to fix issues / regenerate tables.
.PHONY: fix
-fix: table-generation attribute-registry-generation misspell-correction fix-format
+fix: table-generation attribute-registry-generation misspell-correction fix-format markdown-toc
@echo "All autofixes complete"
.PHONY: install-tools
diff --git a/docs/attributes-registry/azure.md b/docs/attributes-registry/azure.md
index 78cd3a0..278423c 100644
--- a/docs/attributes-registry/azure.md
+++ b/docs/attributes-registry/azure.md
@@ -10,7 +10,7 @@
This document defines generic attributes for Azure SDK.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `az.namespace` | string | [Azure Resource Provider Namespace](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers) as recognized by the client. | `Microsoft.Storage`; `Microsoft.KeyVault`; `Microsoft.ServiceBus` |  |
-| `az.service_request_id` | string | The unique identifier of the service request. It's generated by the Azure service and returned with the response. | `00000000-0000-0000-0000-000000000000` |  |
+| Attribute | Type | Description | Examples | Stability |
+| --------------------------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `az.namespace` | string | [Azure Resource Provider Namespace](https://learn.microsoft.com/azure/azure-resource-manager/management/azure-services-resource-providers) as recognized by the client. | `Microsoft.Storage`; `Microsoft.KeyVault`; `Microsoft.ServiceBus` |  |
+| `az.service_request_id` | string | The unique identifier of the service request. It's generated by the Azure service and returned with the response. | `00000000-0000-0000-0000-000000000000` |  |
diff --git a/docs/attributes-registry/browser.md b/docs/attributes-registry/browser.md
index 7c8829e..972a7d9 100644
--- a/docs/attributes-registry/browser.md
+++ b/docs/attributes-registry/browser.md
@@ -10,12 +10,12 @@
The web browser attributes
-| 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` |  |
+| 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] `browser.brands`:** 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 0420cf3..d89b2f4 100644
--- a/docs/attributes-registry/client.md
+++ b/docs/attributes-registry/client.md
@@ -10,11 +10,11 @@
These attributes may be used to describe the client in a connection-based network interaction where there is one side that initiates the connection (the client is the side that initiates the connection). This covers all TCP network interactions since TCP is connection-based and one side initiates the connection (an exception is made for peer-to-peer communication over TCP where the "user-facing" surface of the protocol / API doesn't 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 | Stability |
-|---|---|---|---|---|
+| 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` |  |
+| `client.port` | int | Client port number. [2] | `65123` |  |
-**[1] `client.address`:** 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.
+**[1] `client.address`:** 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.
-**[2] `client.port`:** 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.
+**[2] `client.port`:** 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.
diff --git a/docs/attributes-registry/cloud.md b/docs/attributes-registry/cloud.md
index 0a2dfd2..05ef776 100644
--- a/docs/attributes-registry/cloud.md
+++ b/docs/attributes-registry/cloud.md
@@ -10,14 +10,14 @@
A cloud environment (e.g. GCP, Azure, AWS).
-| 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`; `alibaba_cloud_fc`; `alibaba_cloud_openshift` |  |
-| `cloud.provider` | string | Name of the cloud provider. | `alibaba_cloud`; `aws`; `azure` |  |
-| `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`; `alibaba_cloud_fc`; `alibaba_cloud_openshift` |  |
+| `cloud.provider` | string | Name of the cloud provider. | `alibaba_cloud`; `aws`; `azure` |  |
+| `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] `cloud.availability_zone`:** Availability zones are called "zones" on Alibaba Cloud and Google Cloud.
@@ -38,52 +38,52 @@ The following well-known definitions MUST be used if you set this attribute and
multiple different aliases.
- **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)
- **Azure:** The [Fully Qualified Resource ID](https://docs.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,
- *not* the function app, having the form
+ _not_ the function app, having the form
`/subscriptions//resourceGroups//providers/Microsoft.Web/sites//functions/`.
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.
-| 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_app_runner` | AWS App Runner |  |
-| `aws_ec2` | AWS Elastic Compute Cloud |  |
-| `aws_ecs` | AWS Elastic Container Service |  |
-| `aws_eks` | AWS Elastic Kubernetes Service |  |
-| `aws_elastic_beanstalk` | AWS Elastic Beanstalk |  |
-| `aws_lambda` | AWS Lambda |  |
-| `aws_openshift` | Red Hat OpenShift on AWS (ROSA) |  |
-| `azure_aks` | Azure Kubernetes Service |  |
-| `azure_app_service` | Azure App Service |  |
-| `azure_container_apps` | Azure Container Apps |  |
-| `azure_container_instances` | Azure Container Instances |  |
-| `azure_functions` | Azure Functions |  |
-| `azure_openshift` | Azure Red Hat OpenShift |  |
-| `azure_vm` | Azure Virtual Machines |  |
-| `gcp_app_engine` | Google Cloud App Engine (GAE) |  |
-| `gcp_bare_metal_solution` | Google Bare Metal Solution (BMS) |  |
-| `gcp_cloud_functions` | Google Cloud Functions (GCF) |  |
-| `gcp_cloud_run` | Google Cloud Run |  |
-| `gcp_compute_engine` | Google Cloud Compute Engine (GCE) |  |
-| `gcp_kubernetes_engine` | Google Cloud Kubernetes Engine (GKE) |  |
-| `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_app_runner` | AWS App Runner |  |
+| `aws_ec2` | AWS Elastic Compute Cloud |  |
+| `aws_ecs` | AWS Elastic Container Service |  |
+| `aws_eks` | AWS Elastic Kubernetes Service |  |
+| `aws_elastic_beanstalk` | AWS Elastic Beanstalk |  |
+| `aws_lambda` | AWS Lambda |  |
+| `aws_openshift` | Red Hat OpenShift on AWS (ROSA) |  |
+| `azure_aks` | Azure Kubernetes Service |  |
+| `azure_app_service` | Azure App Service |  |
+| `azure_container_apps` | Azure Container Apps |  |
+| `azure_container_instances` | Azure Container Instances |  |
+| `azure_functions` | Azure Functions |  |
+| `azure_openshift` | Azure Red Hat OpenShift |  |
+| `azure_vm` | Azure Virtual Machines |  |
+| `gcp_app_engine` | Google Cloud App Engine (GAE) |  |
+| `gcp_bare_metal_solution` | Google Bare Metal Solution (BMS) |  |
+| `gcp_cloud_functions` | Google Cloud Functions (GCF) |  |
+| `gcp_cloud_run` | Google Cloud Run |  |
+| `gcp_compute_engine` | Google Cloud Compute Engine (GCE) |  |
+| `gcp_kubernetes_engine` | Google Cloud Kubernetes Engine (GKE) |  |
+| `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.
-| 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 |  |
+| 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 |  |
diff --git a/docs/attributes-registry/code.md b/docs/attributes-registry/code.md
index 8621728..32650b3 100644
--- a/docs/attributes-registry/code.md
+++ b/docs/attributes-registry/code.md
@@ -10,11 +10,11 @@
These attributes allow to report this unit of code and therefore to provide more context about the span.
-| 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)` |  |
+| 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)` |  |
diff --git a/docs/attributes-registry/contrast.md b/docs/attributes-registry/contrast.md
index 97e51a6..e142177 100644
--- a/docs/attributes-registry/contrast.md
+++ b/docs/attributes-registry/contrast.md
@@ -14,49 +14,49 @@
This document defines semantic convention attributes in the Contrast namespace
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| Attribute | Type | Description | Examples | Stability |
+| --------------------------------------------------------------------- | ------ | ------------------------------------- | ----------------------------------- | ---------------------------------------------------------------- |
| `contrast.action` | string | The type of action that was observed. | `file-open-create`; `authn-request` |  |
`contrast.action` 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 |
-|---|---|---|
-| `authn-request` | Functions that perform authentication actions |  |
-| `authz-request` | Functions that perform authorization actions |  |
-| `el-execution` | Spring expression language execution |  |
-| `file-open-create` | file open or create action |  |
-| `host-cmd-exec` | system shell command execution |  |
-| `ldap-query` | Functions that result in and ldap query operation |  |
-| `ognl-execution` | Object-Graph Navigation Language expression execution. |  |
-| `outbound-service-call` | Functions that result in external calls to other services |  |
-| `smtp-exec` | Functions that result in an SMTP command execution |  |
-| `storage-query` | Functions that execute queries |  |
-| `url-forward` | Any function designed to forward a request to another URL |  |
-| `url-redirect` | Function that result in an http 302 redirect code sent to the client |  |
+| Value | Description | Stability |
+| ----------------------- | -------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `authn-request` | Functions that perform authentication actions |  |
+| `authz-request` | Functions that perform authorization actions |  |
+| `el-execution` | Spring expression language execution |  |
+| `file-open-create` | file open or create action |  |
+| `host-cmd-exec` | system shell command execution |  |
+| `ldap-query` | Functions that result in and ldap query operation |  |
+| `ognl-execution` | Object-Graph Navigation Language expression execution. |  |
+| `outbound-service-call` | Functions that result in external calls to other services |  |
+| `smtp-exec` | Functions that result in an SMTP command execution |  |
+| `storage-query` | Functions that execute queries |  |
+| `url-forward` | Any function designed to forward a request to another URL |  |
+| `url-redirect` | Function that result in an http 302 redirect code sent to the client |  |
## Contrast Host Cmd Exec Attributes
Describes attributes for Contrast Action span of type host-cmd-exec.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| Attribute | Type | Description | Examples | Stability |
+| ------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------- | ------------------------------------------------ | ---------------------------------------------------------------- |
| `contrast.host-cmd-exec.cmd` | string | String of executed command with its arguments. | `ls /foo`; `bash -c somebin`; `chmod 755 foobar` |  |
## Contrast Resource Attributes
contrast defined resources for observability data
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `contrast.deployment` | string | deployment environment | `QA`; `DEVELOPMENT`; `PRODUCTION` |  |
-| `contrast.semconv.version` | string | The version of contrast semantic conventions that the data adheres to. | `0.1.0` |  |
-| `otel.semconv.version` | string | The version of otel semantic conventions that the data adheres to. | `1.22.0` |  |
+| Attribute | Type | Description | Examples | Stability |
+| ------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------------------------------- | --------------------------------- | ---------------------------------------------------------------- |
+| `contrast.deployment` | string | deployment environment | `QA`; `DEVELOPMENT`; `PRODUCTION` |  |
+| `contrast.semconv.version` | string | The version of contrast semantic conventions that the data adheres to. | `0.1.0` |  |
+| `otel.semconv.version` | string | The version of otel semantic conventions that the data adheres to. | `1.22.0` |  |
`contrast.deployment` 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 |
-|---|---|---|
-| `DEVELOPMENT` | development environment |  |
-| `PRODUCTION` | production environment |  |
-| `QA` | quality assurance environment |  |
+| Value | Description | Stability |
+| ------------- | ----------------------------- | ---------------------------------------------------------------- |
+| `DEVELOPMENT` | development environment |  |
+| `PRODUCTION` | production environment |  |
+| `QA` | quality assurance environment |  |
diff --git a/docs/attributes-registry/destination.md b/docs/attributes-registry/destination.md
index 5eac27f..b4fb236 100644
--- a/docs/attributes-registry/destination.md
+++ b/docs/attributes-registry/destination.md
@@ -10,9 +10,9 @@
These attributes may be used to describe the receiver of a network exchange/packet. These should be used when there is no client/server relationship between the two sides, or when that relationship is unknown. This covers low-level network interactions (e.g. packet tracing) where you don't know if there was a connection or which side initiated it. This also covers unidirectional UDP flows and peer-to-peer communication where the "user-facing" surface of the protocol / API doesn't expose a clear notion of client and server.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| 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` |  |
+| `destination.port` | int | Destination port number | `3389`; `2888` |  |
**[1] `destination.address`:** 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/enduser.md b/docs/attributes-registry/enduser.md
index a8df586..f7b78bc 100644
--- a/docs/attributes-registry/enduser.md
+++ b/docs/attributes-registry/enduser.md
@@ -10,8 +10,8 @@
Describes deprecated enduser attributes. Complete enduser namespace has been deprecated
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `enduser.id` | string | Deprecated, use `user.id` instead. | `username` | 
Replaced by `user.id` attribute. |
-| `enduser.role` | string | Deprecated, use `user.roles` instead. | `admin` | 
Replaced by `user.roles` attribute. |
-| `enduser.scope` | string | Deprecated, no replacement at this time. | `read:message, write:files` | 
Removed. |
+| Attribute | Type | Description | Examples | Stability |
+| --------------------------------------------------------------- | ------ | ---------------------------------------- | --------------------------- | -------------------------------------------------------------------------------------------------- |
+| `enduser.id` | string | Deprecated, use `user.id` instead. | `username` | 
Replaced by `user.id` attribute. |
+| `enduser.role` | string | Deprecated, use `user.roles` instead. | `admin` | 
Replaced by `user.roles` attribute. |
+| `enduser.scope` | string | Deprecated, no replacement at this time. | `read:message, write:files` | 
Removed. |
diff --git a/docs/attributes-registry/error.md b/docs/attributes-registry/error.md
index 3867e83..c597852 100644
--- a/docs/attributes-registry/error.md
+++ b/docs/attributes-registry/error.md
@@ -10,8 +10,8 @@
This document defines the shared attributes used to report an error.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| 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] `error.type`:** The `error.type` SHOULD be predictable, and SHOULD have low cardinality.
@@ -36,6 +36,6 @@ it's RECOMMENDED to:
`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 |
-|---|---|---|
+| Value | Description | Stability |
+| -------- | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `_OTHER` | A fallback error value to be used when the instrumentation doesn't define a custom value. |  |
diff --git a/docs/attributes-registry/event.md b/docs/attributes-registry/event.md
index 4489039..7366295 100644
--- a/docs/attributes-registry/event.md
+++ b/docs/attributes-registry/event.md
@@ -10,8 +10,8 @@
Attributes for Events represented using Log Records.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| Attribute | Type | Description | Examples | Stability |
+| ------------------------------------------------------ | ------ | ----------------------------------------- | --------------------------------------------- | ---------------------------------------------------------------- |
| `event.name` | string | Identifies the class / type of event. [1] | `browser.mouse.click`; `device.app.lifecycle` |  |
**[1] `event.name`:** Event names are subject to the same rules as [attribute names](/docs/general/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/attributes-registry/exception.md b/docs/attributes-registry/exception.md
index be9b732..1b6fc42 100644
--- a/docs/attributes-registry/exception.md
+++ b/docs/attributes-registry/exception.md
@@ -10,12 +10,12 @@
This document defines the shared attributes used to report a single exception associated with a span or log.
-| 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` |  |
+| 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] `exception.escaped`:** 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/feature-flag.md b/docs/attributes-registry/feature-flag.md
index d61da8e..5e75590 100644
--- a/docs/attributes-registry/feature-flag.md
+++ b/docs/attributes-registry/feature-flag.md
@@ -13,16 +13,16 @@
This document defines attributes for Feature Flags.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `feature_flag.context.id` | string | The unique identifier for the flag evaluation context. For example, the targeting key. | `5157782b-2203-4c80-a857-dbbd5e7761db` |  |
-| `feature_flag.evaluation.error.message` | string | A message explaining the nature of an error occurring during flag evaluation. | `Flag `header-color` expected type `string` but found type `number`` |  |
-| `feature_flag.evaluation.reason` | string | The reason code which shows how a feature flag value was determined. | `static`; `targeting_match`; `error`; `default` |  |
-| `feature_flag.key` | string | The lookup key of the feature flag. | `logo-color` |  |
-| `feature_flag.set.id` | string | The identifier of the [flag set](https://openfeature.dev/specification/glossary/#flag-set) to which the feature flag belongs. | `proj-1`; `ab98sgs`; `service1/dev` |  |
-| `feature_flag.system` | string | Identifies the feature flag provider. | `Flag Manager` |  |
-| `feature_flag.variant` | string | A semantic identifier for an evaluated flag value. [1] | `red`; `true`; `on` |  |
-| `feature_flag.version` | string | The version of the ruleset used during the evaluation. This may be any stable value which uniquely identifies the ruleset. | `1`; `01ABCDEF` |  |
+| Attribute | Type | Description | Examples | Stability |
+| --------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `feature_flag.context.id` | string | The unique identifier for the flag evaluation context. For example, the targeting key. | `5157782b-2203-4c80-a857-dbbd5e7761db` |  |
+| `feature_flag.evaluation.error.message` | string | A message explaining the nature of an error occurring during flag evaluation. | `Flag `header-color`expected type`string`but found type`number`` |  |
+| `feature_flag.evaluation.reason` | string | The reason code which shows how a feature flag value was determined. | `static`; `targeting_match`; `error`; `default` |  |
+| `feature_flag.key` | string | The lookup key of the feature flag. | `logo-color` |  |
+| `feature_flag.set.id` | string | The identifier of the [flag set](https://openfeature.dev/specification/glossary/#flag-set) to which the feature flag belongs. | `proj-1`; `ab98sgs`; `service1/dev` |  |
+| `feature_flag.system` | string | Identifies the feature flag provider. | `Flag Manager` |  |
+| `feature_flag.variant` | string | A semantic identifier for an evaluated flag value. [1] | `red`; `true`; `on` |  |
+| `feature_flag.version` | string | The version of the ruleset used during the evaluation. This may be any stable value which uniquely identifies the ruleset. | `1`; `01ABCDEF` |  |
**[1] `feature_flag.variant`:** A semantic identifier, commonly referred to as a variant, provides a means
for referring to a value without including the value itself. This can
@@ -31,22 +31,22 @@ For example, the variant `red` maybe be used for the value `#c05543`.
`feature_flag.evaluation.reason` 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 |
-|---|---|---|
-| `cached` | The resolved value was retrieved from cache. |  |
-| `default` | The resolved value fell back to a pre-configured value (no dynamic evaluation occurred or dynamic evaluation yielded no result). |  |
-| `disabled` | The resolved value was the result of the flag being disabled in the management system. |  |
-| `error` | The resolved value was the result of an error. |  |
-| `split` | The resolved value was the result of pseudorandom assignment. |  |
-| `stale` | The resolved value is non-authoritative or possibly out of date |  |
-| `static` | The resolved value is static (no dynamic evaluation). |  |
-| `targeting_match` | The resolved value was the result of a dynamic evaluation, such as a rule or specific user-targeting. |  |
-| `unknown` | The reason for the resolved value could not be determined. |  |
+| Value | Description | Stability |
+| ----------------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `cached` | The resolved value was retrieved from cache. |  |
+| `default` | The resolved value fell back to a pre-configured value (no dynamic evaluation occurred or dynamic evaluation yielded no result). |  |
+| `disabled` | The resolved value was the result of the flag being disabled in the management system. |  |
+| `error` | The resolved value was the result of an error. |  |
+| `split` | The resolved value was the result of pseudorandom assignment. |  |
+| `stale` | The resolved value is non-authoritative or possibly out of date |  |
+| `static` | The resolved value is static (no dynamic evaluation). |  |
+| `targeting_match` | The resolved value was the result of a dynamic evaluation, such as a rule or specific user-targeting. |  |
+| `unknown` | The reason for the resolved value could not be determined. |  |
## Deprecated Feature Flag Attributes
Describes deprecated Feature Flag attributes.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| Attribute | Type | Description | Examples | Stability |
+| ------------------------------------------------------------------------------------------------------ | ------ | ---------------------------------------------- | -------------- | ------------------------------------------------------------------------------------------------- |
| `feature_flag.provider_name` | string | Deprecated, use `feature_flag.system` instead. | `Flag Manager` | 
Replaced by `feature_flag.system`. |
diff --git a/docs/attributes-registry/host.md b/docs/attributes-registry/host.md
index 4a21ab9..16a8cfa 100644
--- a/docs/attributes-registry/host.md
+++ b/docs/attributes-registry/host.md
@@ -10,23 +10,23 @@
A host is defined as a computing instance. For example, physical servers, virtual machines, switches or disk array.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `host.arch` | string | The CPU architecture the host system is running on. | `amd64`; `arm32`; `arm64` |  |
-| `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`; `arm32`; `arm64` |  |
+| `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] `host.cpu.vendor.id`:** [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.
@@ -36,13 +36,13 @@ A host is defined as a computing instance. For example, physical servers, virtua
`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 |  |
+| 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 |  |
+| `x86` | 32-bit x86 |  |
diff --git a/docs/attributes-registry/http.md b/docs/attributes-registry/http.md
index 2647e8e..cfed07a 100644
--- a/docs/attributes-registry/http.md
+++ b/docs/attributes-registry/http.md
@@ -10,17 +10,17 @@
This document defines semantic convention attributes in the HTTP namespace.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `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` |  |
-| | string[] | HTTP request headers, `` being the normalized HTTP Header name (lowercase, with `-` characters replaced by `_`), 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.resend_count` | int | The ordinal number of request resending attempt (for any reason, including redirects). [3] | `3` |  |
-| `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` |  |
-| | string[] | HTTP response headers, `` being the normalized HTTP Header name (lowercase, with `-` characters replaced by `_`), the value being the header values. [4] | `http.response.header.content_type=["application/json"]`; `http.response.header.my_custom_header=["abc", "def"]` |  |
-| `http.response.status_code` | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` |  |
-| `http.route` | string | The matched route (path template in the format used by the respective server framework). See note below [5] | `/users/:userID?`; `{controller}/{action}/{id?}` |  |
+| Attribute | Type | Description | Examples | Stability |
+| ------------------------------------------------------------------------------------------------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `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` |  |
+| | string[] | HTTP request headers, `` being the normalized HTTP Header name (lowercase, with `-` characters replaced by `_`), 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.resend_count` | int | The ordinal number of request resending attempt (for any reason, including redirects). [3] | `3` |  |
+| `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` |  |
+| | string[] | HTTP response headers, `` being the normalized HTTP Header name (lowercase, with `-` characters replaced by `_`), the value being the header values. [4] | `http.response.header.content_type=["application/json"]`; `http.response.header.my_custom_header=["abc", "def"]` |  |
+| `http.response.status_code` | int | [HTTP response status code](https://tools.ietf.org/html/rfc7231#section-6). | `200` |  |
+| `http.route` | string | The matched route (path template in the format used by the respective server framework). See note below [5] | `/users/:userID?`; `{controller}/{action}/{id?}` |  |
**[1] `http.request.header`:** 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.
@@ -52,15 +52,15 @@ SHOULD include the [application root](/docs/http/http-spans.md#http-server-defin
`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 |
-|---|---|---|
-| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
-| `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. |  |
+| Value | Description | Stability |
+| --------- | ------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `_OTHER` | Any HTTP method that the instrumentation has no prior knowledge of. |  |
+| `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. |  |
diff --git a/docs/attributes-registry/log.md b/docs/attributes-registry/log.md
index c6ebd18..7acf557 100644
--- a/docs/attributes-registry/log.md
+++ b/docs/attributes-registry/log.md
@@ -14,36 +14,36 @@
This document defines log attributes
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| Attribute | Type | Description | Examples | Stability |
+| ------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------ | ------------------ | ---------------------------------------------------------------- |
| `log.iostream` | string | The stream associated with the log. See below for a list of well-known values. | `stdout`; `stderr` |  |
`log.iostream` 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 |
-|---|---|---|
+| Value | Description | Stability |
+| -------- | ------------------------- | ---------------------------------------------------------------- |
| `stderr` | Events from stderr stream |  |
-| `stdout` | Logs from stdout stream |  |
+| `stdout` | Logs from stdout stream |  |
## Log File Attributes
Attributes for a file to which log was emitted.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `log.file.name` | string | The basename of the file. | `audit.log` |  |
-| `log.file.name_resolved` | string | The basename of the file, with symlinks resolved. | `uuid.log` |  |
-| `log.file.path` | string | The full path to the file. | `/var/log/mysql/audit.log` |  |
+| Attribute | Type | Description | Examples | Stability |
+| ------------------------------------------------------------------------------------------ | ------ | -------------------------------------------------- | -------------------------- | ---------------------------------------------------------------- |
+| `log.file.name` | string | The basename of the file. | `audit.log` |  |
+| `log.file.name_resolved` | string | The basename of the file, with symlinks resolved. | `uuid.log` |  |
+| `log.file.path` | string | The full path to the file. | `/var/log/mysql/audit.log` |  |
| `log.file.path_resolved` | string | The full path to the file, with symlinks resolved. | `/var/lib/docker/uuid.log` |  |
## Log Record Attributes
This document defines the generic attributes that may be used in any Log Record.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `log.record.original` | string | The complete original Log Record. [1] | `77 <86>1 2015-08-06T21:58:59.694Z 192.168.2.133 inactive - - - Something happened`; `[INFO] 8/3/24 12:34:56 Something happened` |  |
-| `log.record.uid` | string | A unique identifier for the Log Record. [2] | `01ARZ3NDEKTSV4RRFFQ69G5FAV` |  |
+| Attribute | Type | Description | Examples | Stability |
+| --------------------------------------------------------------------------------- | ------ | ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `log.record.original` | string | The complete original Log Record. [1] | `77 <86>1 2015-08-06T21:58:59.694Z 192.168.2.133 inactive - - - Something happened`; `[INFO] 8/3/24 12:34:56 Something happened` |  |
+| `log.record.uid` | string | A unique identifier for the Log Record. [2] | `01ARZ3NDEKTSV4RRFFQ69G5FAV` |  |
**[1] `log.record.original`:** This value MAY be added when processing a Log Record which was originally transmitted as a string or equivalent data type AND the Body field of the Log Record does not contain the same value. (e.g. a syslog or a log record read from a file.)
diff --git a/docs/attributes-registry/network.md b/docs/attributes-registry/network.md
index 9b4e353..bc9b95b 100644
--- a/docs/attributes-registry/network.md
+++ b/docs/attributes-registry/network.md
@@ -10,24 +10,24 @@
These attributes may be used for any network related operation.
-| 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.interface.name` | string | The network interface name. | `lo`; `eth0` |  |
-| `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://wikipedia.org/wiki/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://wikipedia.org/wiki/Transport_layer) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `udp` |  |
-| `network.type` | string | [OSI network layer](https://wikipedia.org/wiki/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.interface.name` | string | The network interface name. | `lo`; `eth0` |  |
+| `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://wikipedia.org/wiki/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://wikipedia.org/wiki/Transport_layer) or [inter-process communication method](https://wikipedia.org/wiki/Inter-process_communication). [3] | `tcp`; `udp` |  |
+| `network.type` | string | [OSI network layer](https://wikipedia.org/wiki/Network_layer) or non-OSI equivalent. [4] | `ipv4`; `ipv6` |  |
**[1] `network.protocol.name`:** The value SHOULD be normalized to lowercase.
@@ -43,60 +43,60 @@ different processes could be listening on TCP port 12345 and UDP port 12345.
`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 |
-|---|---|---|
-| `cdma` | CDMA |  |
-| `cdma2000_1xrtt` | CDMA2000 1XRTT |  |
-| `edge` | EDGE |  |
-| `ehrpd` | EHRPD |  |
-| `evdo_0` | EVDO Rel. 0 |  |
-| `evdo_a` | EVDO Rev. A |  |
-| `evdo_b` | EVDO Rev. B |  |
-| `gprs` | GPRS |  |
-| `gsm` | GSM |  |
-| `hsdpa` | HSDPA |  |
-| `hspa` | HSPA |  |
-| `hspap` | HSPAP |  |
-| `hsupa` | HSUPA |  |
-| `iden` | IDEN |  |
-| `iwlan` | IWLAN |  |
-| `lte` | LTE |  |
-| `lte_ca` | LTE CA |  |
-| `nr` | 5G NR (New Radio) |  |
-| `nrnsa` | 5G NRNSA (New Radio Non-Standalone) |  |
-| `td_scdma` | TD-SCDMA |  |
-| `umts` | UMTS |  |
+| Value | Description | Stability |
+| ---------------- | ----------------------------------- | ---------------------------------------------------------------- |
+| `cdma` | CDMA |  |
+| `cdma2000_1xrtt` | CDMA2000 1XRTT |  |
+| `edge` | EDGE |  |
+| `ehrpd` | EHRPD |  |
+| `evdo_0` | EVDO Rel. 0 |  |
+| `evdo_a` | EVDO Rev. A |  |
+| `evdo_b` | EVDO Rev. B |  |
+| `gprs` | GPRS |  |
+| `gsm` | GSM |  |
+| `hsdpa` | HSDPA |  |
+| `hspa` | HSPA |  |
+| `hspap` | HSPAP |  |
+| `hsupa` | HSUPA |  |
+| `iden` | IDEN |  |
+| `iwlan` | IWLAN |  |
+| `lte` | LTE |  |
+| `lte_ca` | LTE CA |  |
+| `nr` | 5G NR (New Radio) |  |
+| `nrnsa` | 5G NRNSA (New Radio Non-Standalone) |  |
+| `td_scdma` | TD-SCDMA |  |
+| `umts` | UMTS |  |
`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 |
-|---|---|---|
-| `cell` | cell |  |
+| Value | Description | Stability |
+| ------------- | ----------- | ---------------------------------------------------------------- |
+| `cell` | cell |  |
| `unavailable` | unavailable |  |
-| `unknown` | unknown |  |
-| `wifi` | wifi |  |
-| `wired` | wired |  |
+| `unknown` | unknown |  |
+| `wifi` | wifi |  |
+| `wired` | wired |  |
`network.io.direction` 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 |
-|---|---|---|
-| `receive` | receive |  |
-| `transmit` | transmit |  |
+| Value | Description | Stability |
+| ---------- | ----------- | ---------------------------------------------------------------- |
+| `receive` | receive |  |
+| `transmit` | transmit |  |
`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 |
-|---|---|---|
-| `pipe` | Named or anonymous pipe. |  |
-| `quic` | QUIC |  |
-| `tcp` | TCP |  |
-| `udp` | UDP |  |
-| `unix` | Unix domain socket |  |
+| Value | Description | Stability |
+| ------ | ------------------------ | ---------------------------------------------------------------- |
+| `pipe` | Named or anonymous pipe. |  |
+| `quic` | QUIC |  |
+| `tcp` | TCP |  |
+| `udp` | UDP |  |
+| `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.
-| Value | Description | Stability |
-|---|---|---|
-| `ipv4` | IPv4 |  |
-| `ipv6` | IPv6 |  |
+| Value | Description | Stability |
+| ------ | ----------- | ---------------------------------------------------------- |
+| `ipv4` | IPv4 |  |
+| `ipv6` | IPv6 |  |
diff --git a/docs/attributes-registry/opentracing.md b/docs/attributes-registry/opentracing.md
index ec1deb4..3a63b6d 100644
--- a/docs/attributes-registry/opentracing.md
+++ b/docs/attributes-registry/opentracing.md
@@ -10,15 +10,15 @@
Attributes used by the OpenTracing Shim layer.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| Attribute | Type | Description | Examples | Stability |
+| ------------------------------------------------------------------------------------ | ------ | ------------------------------- | -------------------------- | ---------------------------------------------------------------- |
| `opentracing.ref_type` | string | Parent-child Reference type [1] | `child_of`; `follows_from` |  |
**[1] `opentracing.ref_type`:** The causal relationship between a child Span and a parent Span.
`opentracing.ref_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 |
-|---|---|---|
-| `child_of` | The parent Span depends on the child Span in some capacity |  |
+| 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 |  |
diff --git a/docs/attributes-registry/os.md b/docs/attributes-registry/os.md
index 9c1a841..8ff113a 100644
--- a/docs/attributes-registry/os.md
+++ b/docs/attributes-registry/os.md
@@ -10,26 +10,26 @@
The operating system (OS) on which the process represented by this resource is running.
-| 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` |  |
+| 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`; `linux`; `darwin` |  |
-| `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.name` | string | Human readable operating system name. | `iOS`; `Android`; `Ubuntu` |  |
+| `os.type` | string | The operating system type. | `windows`; `linux`; `darwin` |  |
+| `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.
-| Value | Description | Stability |
-|---|---|---|
-| `aix` | AIX (Advanced Interactive eXecutive) |  |
-| `darwin` | Apple Darwin |  |
-| `dragonflybsd` | DragonFly BSD |  |
-| `freebsd` | FreeBSD |  |
-| `hpux` | HP-UX (Hewlett Packard Unix) |  |
-| `linux` | Linux |  |
-| `netbsd` | NetBSD |  |
-| `openbsd` | OpenBSD |  |
-| `solaris` | SunOS, Oracle Solaris |  |
-| `windows` | Microsoft Windows |  |
-| `z_os` | IBM z/OS |  |
+| Value | Description | Stability |
+| -------------- | ------------------------------------ | ---------------------------------------------------------------- |
+| `aix` | AIX (Advanced Interactive eXecutive) |  |
+| `darwin` | Apple Darwin |  |
+| `dragonflybsd` | DragonFly BSD |  |
+| `freebsd` | FreeBSD |  |
+| `hpux` | HP-UX (Hewlett Packard Unix) |  |
+| `linux` | Linux |  |
+| `netbsd` | NetBSD |  |
+| `openbsd` | OpenBSD |  |
+| `solaris` | SunOS, Oracle Solaris |  |
+| `windows` | Microsoft Windows |  |
+| `z_os` | IBM z/OS |  |
diff --git a/docs/attributes-registry/peer.md b/docs/attributes-registry/peer.md
index d4bb3bc..0daab14 100644
--- a/docs/attributes-registry/peer.md
+++ b/docs/attributes-registry/peer.md
@@ -10,6 +10,6 @@
Operations that access some remote service.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| Attribute | Type | Description | Examples | 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` |  |
diff --git a/docs/attributes-registry/process.md b/docs/attributes-registry/process.md
index d030205..5c7e091 100644
--- a/docs/attributes-registry/process.md
+++ b/docs/attributes-registry/process.md
@@ -13,40 +13,40 @@
An operating system process.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `process.args_count` | int | Length of the process.command_args array [1] | `4` |  |
-| `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.context_switch_type` | string | Specifies whether the context switches for this data point were voluntary or involuntary. | `voluntary`; `involuntary` |  |
-| `process.creation.time` | string | The date and time the process was created, in ISO 8601 format. | `2023-11-21T09:25:34.853Z` |  |
-| `process.executable.build_id.gnu` | string | The GNU build ID as found in the `.note.gnu.build-id` ELF section (hex string). | `c89b11207f6479603b0d49bf291c092c2b719293` |  |
-| `process.executable.build_id.go` | string | The Go build ID as retrieved by `go tool buildid `. | `foh3mEXu7BLZjsN9pOwG/kATcXlYVCDEFouRMQed_/WwRFB1hPo9LBkekthSPG/x8hMC8emW2cCjXD0_1aY` |  |
-| `process.executable.build_id.htlhash` | string | Profiling specific build ID for executables. See the OTel specification for Profiles for more information. | `600DCAFE4A110000F2BF38C493F5FB92` |  |
-| `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.exit.code` | int | The exit code of the process. | `127` |  |
-| `process.exit.time` | string | The date and time the process exited, in ISO 8601 format. | `2023-11-21T09:26:12.315Z` |  |
-| `process.group_leader.pid` | int | The PID of the process's group leader. This is also the process group ID (PGID) of the process. | `23` |  |
-| `process.interactive` | boolean | Whether the process is connected to an interactive shell. | |  |
-| `process.owner` | string | The username of the user that owns the process. | `root` |  |
-| `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`; `minor` |  |
-| `process.parent_pid` | int | Parent Process identifier (PPID). | `111` |  |
-| `process.pid` | int | Process identifier (PID). | `1234` |  |
-| `process.real_user.id` | int | The real user ID (RUID) of the process. | `1000` |  |
-| `process.real_user.name` | string | The username of the real user of the process. | `operator` |  |
-| `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. | `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` |  |
-| `process.saved_user.id` | int | The saved user ID (SUID) of the process. | `1002` |  |
-| `process.saved_user.name` | string | The username of the saved user. | `operator` |  |
-| `process.session_leader.pid` | int | The PID of the process's session leader. This is also the session ID (SID) of the process. | `14` |  |
-| `process.title` | string | Process title (proctitle) [2] | `cat /etc/hostname`; `xfce4-session`; `bash` |  |
-| `process.user.id` | int | The effective user ID (EUID) of the process. | `1001` |  |
-| `process.user.name` | string | The username of the effective user of the process. | `root` |  |
-| `process.vpid` | int | Virtual process identifier. [3] | `12` |  |
-| `process.working_directory` | string | The working directory of the process. | `/root` |  |
+| Attribute | Type | Description | Examples | Stability |
+| --------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `process.args_count` | int | Length of the process.command_args array [1] | `4` |  |
+| `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.context_switch_type` | string | Specifies whether the context switches for this data point were voluntary or involuntary. | `voluntary`; `involuntary` |  |
+| `process.creation.time` | string | The date and time the process was created, in ISO 8601 format. | `2023-11-21T09:25:34.853Z` |  |
+| `process.executable.build_id.gnu` | string | The GNU build ID as found in the `.note.gnu.build-id` ELF section (hex string). | `c89b11207f6479603b0d49bf291c092c2b719293` |  |
+| `process.executable.build_id.go` | string | The Go build ID as retrieved by `go tool buildid `. | `foh3mEXu7BLZjsN9pOwG/kATcXlYVCDEFouRMQed_/WwRFB1hPo9LBkekthSPG/x8hMC8emW2cCjXD0_1aY` |  |
+| `process.executable.build_id.htlhash` | string | Profiling specific build ID for executables. See the OTel specification for Profiles for more information. | `600DCAFE4A110000F2BF38C493F5FB92` |  |
+| `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.exit.code` | int | The exit code of the process. | `127` |  |
+| `process.exit.time` | string | The date and time the process exited, in ISO 8601 format. | `2023-11-21T09:26:12.315Z` |  |
+| `process.group_leader.pid` | int | The PID of the process's group leader. This is also the process group ID (PGID) of the process. | `23` |  |
+| `process.interactive` | boolean | Whether the process is connected to an interactive shell. | |  |
+| `process.owner` | string | The username of the user that owns the process. | `root` |  |
+| `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`; `minor` |  |
+| `process.parent_pid` | int | Parent Process identifier (PPID). | `111` |  |
+| `process.pid` | int | Process identifier (PID). | `1234` |  |
+| `process.real_user.id` | int | The real user ID (RUID) of the process. | `1000` |  |
+| `process.real_user.name` | string | The username of the real user of the process. | `operator` |  |
+| `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. | `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` |  |
+| `process.saved_user.id` | int | The saved user ID (SUID) of the process. | `1002` |  |
+| `process.saved_user.name` | string | The username of the saved user. | `operator` |  |
+| `process.session_leader.pid` | int | The PID of the process's session leader. This is also the session ID (SID) of the process. | `14` |  |
+| `process.title` | string | Process title (proctitle) [2] | `cat /etc/hostname`; `xfce4-session`; `bash` |  |
+| `process.user.id` | int | The effective user ID (EUID) of the process. | `1001` |  |
+| `process.user.name` | string | The username of the effective user of the process. | `root` |  |
+| `process.vpid` | int | Virtual process identifier. [3] | `12` |  |
+| `process.working_directory` | string | The working directory of the process. | `/root` |  |
**[1] `process.args_count`:** This field can be useful for querying or performing bucket analysis on how many arguments were provided to start a process. More arguments may be an indication of suspicious activity.
@@ -56,31 +56,31 @@ An operating system process.
`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 | Stability |
-|---|---|---|
+| Value | Description | Stability |
+| ------------- | ----------- | ---------------------------------------------------------------- |
| `involuntary` | involuntary |  |
-| `voluntary` | voluntary |  |
+| `voluntary` | voluntary |  |
`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 | Stability |
-|---|---|---|
-| `major` | major |  |
-| `minor` | minor |  |
+| Value | Description | Stability |
+| ------- | ----------- | ---------------------------------------------------------------- |
+| `major` | major |  |
+| `minor` | minor |  |
## Deprecated Process Attributes
Deprecated process attributes.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `process.cpu.state` | string | Deprecated, use `cpu.mode` instead. | `system`; `user`; `wait` | 
Replaced by `cpu.mode` |
+| Attribute | Type | Description | Examples | Stability |
+| --------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
+| `process.cpu.state` | string | Deprecated, use `cpu.mode` instead. | `system`; `user`; `wait` | 
Replaced by `cpu.mode` |
| `process.executable.build_id.profiling` | string | "Deprecated, use `process.executable.build_id.htlhash` instead." | `600DCAFE4A110000F2BF38C493F5FB92` | 
Replaced by `process.executable.build_id.htlhash` |
`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 | Stability |
-|---|---|---|
-| `system` | system |  |
-| `user` | user |  |
-| `wait` | wait |  |
+| Value | Description | Stability |
+| -------- | ----------- | ---------------------------------------------------------------- |
+| `system` | system |  |
+| `user` | user |  |
+| `wait` | wait |  |
diff --git a/docs/attributes-registry/profile.md b/docs/attributes-registry/profile.md
index cb21193..1703ada 100644
--- a/docs/attributes-registry/profile.md
+++ b/docs/attributes-registry/profile.md
@@ -10,20 +10,20 @@
Describes the origin of a single frame in a Profile.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| Attribute | Type | Description | Examples | Stability |
+| ------------------------------------------------------------------------------ | ------ | -------------------------------------------------------- | --------- | ---------------------------------------------------------------- |
| `profile.frame.type` | string | Describes the interpreter or compiler of a single frame. | `cpython` |  |
`profile.frame.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 |
-|---|---|---|
-| `cpython` | [Python](https://wikipedia.org/wiki/Python_(programming_language)) |  |
-| `dotnet` | [.NET](https://wikipedia.org/wiki/.NET) |  |
-| `jvm` | [JVM](https://wikipedia.org/wiki/Java_virtual_machine) |  |
-| `kernel` | [Kernel](https://wikipedia.org/wiki/Kernel_(operating_system)) |  |
-| `native` | [C](https://wikipedia.org/wiki/C_(programming_language)), [C++](https://wikipedia.org/wiki/C%2B%2B), [Go](https://wikipedia.org/wiki/Go_(programming_language)), [Rust](https://wikipedia.org/wiki/Rust_(programming_language)) |  |
-| `perl` | [Perl](https://wikipedia.org/wiki/Perl) |  |
-| `php` | [PHP](https://wikipedia.org/wiki/PHP) |  |
-| `ruby` | [Ruby](https://wikipedia.org/wiki/Ruby_(programming_language)) |  |
-| `v8js` | [V8JS](https://wikipedia.org/wiki/V8_(JavaScript_engine)) |  |
+| Value | Description | Stability |
+| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
+| `cpython` | [Python]() |  |
+| `dotnet` | [.NET](https://wikipedia.org/wiki/.NET) |  |
+| `jvm` | [JVM](https://wikipedia.org/wiki/Java_virtual_machine) |  |
+| `kernel` | [Kernel]() |  |
+| `native` | [C](), [C++](https://wikipedia.org/wiki/C%2B%2B), [Go](), [Rust]() |  |
+| `perl` | [Perl](https://wikipedia.org/wiki/Perl) |  |
+| `php` | [PHP](https://wikipedia.org/wiki/PHP) |  |
+| `ruby` | [Ruby]() |  |
+| `v8js` | [V8JS]() |  |
diff --git a/docs/attributes-registry/rpc.md b/docs/attributes-registry/rpc.md
index 1639adb..60f677f 100644
--- a/docs/attributes-registry/rpc.md
+++ b/docs/attributes-registry/rpc.md
@@ -13,25 +13,25 @@
This document defines attributes for remote procedure calls.
-| 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`; `unknown`; `invalid_argument` |  |
-| `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`; `1`; `2` |  |
-| `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.message.compressed_size` | int | Compressed size of the message in bytes. | |  |
-| `rpc.message.id` | int | MUST be calculated as two different counters starting from `1` one for sent messages and one for received message. [5] | |  |
-| `rpc.message.type` | string | Whether this is a received or sent message. | `SENT`; `RECEIVED` |  |
-| `rpc.message.uncompressed_size` | int | Uncompressed size of the message in bytes. | |  |
-| `rpc.method` | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [6] | `exampleMethod` |  |
-| `rpc.service` | string | The full (logical) name of the service being called, including its package name, if applicable. [7] | `myservice.EchoService` |  |
-| `rpc.system` | string | A string identifying the remoting system. See below for a list of well-known identifiers. | `grpc`; `java_rmi`; `dotnet_wcf` |  |
+| 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`; `unknown`; `invalid_argument` |  |
+| `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`; `1`; `2` |  |
+| `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.message.compressed_size` | int | Compressed size of the message in bytes. | |  |
+| `rpc.message.id` | int | MUST be calculated as two different counters starting from `1` one for sent messages and one for received message. [5] | |  |
+| `rpc.message.type` | string | Whether this is a received or sent message. | `SENT`; `RECEIVED` |  |
+| `rpc.message.uncompressed_size` | int | Uncompressed size of the message in bytes. | |  |
+| `rpc.method` | string | The name of the (logical) method being called, must be equal to the $method part in the span name. [6] | `exampleMethod` |  |
+| `rpc.service` | string | The full (logical) name of the service being called, including its package name, if applicable. [7] | `myservice.EchoService` |  |
+| `rpc.system` | string | A string identifying the remoting system. See below for a list of well-known identifiers. | `grpc`; `java_rmi`; `dotnet_wcf` |  |
**[1] `rpc.connect_rpc.request.metadata`:** 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.
@@ -49,78 +49,78 @@ This document defines attributes for remote procedure calls.
`rpc.connect_rpc.error_code` 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 |
-|---|---|---|
-| `aborted` | aborted |  |
-| `already_exists` | already_exists |  |
-| `cancelled` | cancelled |  |
-| `data_loss` | data_loss |  |
-| `deadline_exceeded` | deadline_exceeded |  |
+| Value | Description | Stability |
+| --------------------- | ------------------- | ---------------------------------------------------------------- |
+| `aborted` | aborted |  |
+| `already_exists` | already_exists |  |
+| `cancelled` | cancelled |  |
+| `data_loss` | data_loss |  |
+| `deadline_exceeded` | deadline_exceeded |  |
| `failed_precondition` | failed_precondition |  |
-| `internal` | internal |  |
-| `invalid_argument` | invalid_argument |  |
-| `not_found` | not_found |  |
-| `out_of_range` | out_of_range |  |
-| `permission_denied` | permission_denied |  |
-| `resource_exhausted` | resource_exhausted |  |
-| `unauthenticated` | unauthenticated |  |
-| `unavailable` | unavailable |  |
-| `unimplemented` | unimplemented |  |
-| `unknown` | unknown |  |
+| `internal` | internal |  |
+| `invalid_argument` | invalid_argument |  |
+| `not_found` | not_found |  |
+| `out_of_range` | out_of_range |  |
+| `permission_denied` | permission_denied |  |
+| `resource_exhausted` | resource_exhausted |  |
+| `unauthenticated` | unauthenticated |  |
+| `unavailable` | unavailable |  |
+| `unimplemented` | unimplemented |  |
+| `unknown` | unknown |  |
`rpc.grpc.status_code` 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 |
-|---|---|---|
-| `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 |  |
`rpc.message.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 |
-|---|---|---|
-| `RECEIVED` | received |  |
-| `SENT` | sent |  |
+| Value | Description | Stability |
+| ---------- | ----------- | ---------------------------------------------------------------- |
+| `RECEIVED` | received |  |
+| `SENT` | sent |  |
`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 |
-|---|---|---|
+| Value | Description | Stability |
+| -------------- | ------------ | ---------------------------------------------------------------- |
| `apache_dubbo` | Apache Dubbo |  |
-| `connect_rpc` | Connect RPC |  |
-| `dotnet_wcf` | .NET WCF |  |
-| `grpc` | gRPC |  |
-| `java_rmi` | Java RMI |  |
+| `connect_rpc` | Connect RPC |  |
+| `dotnet_wcf` | .NET WCF |  |
+| `grpc` | gRPC |  |
+| `java_rmi` | Java RMI |  |
## Deprecated RPC Attributes
Deprecated rpc message attributes.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `message.compressed_size` | int | Deprecated, use `rpc.message.compressed_size` instead. | | 
Replaced by `rpc.message.compressed_size`. |
-| `message.id` | int | Deprecated, use `rpc.message.id` instead. | | 
Replaced by `rpc.message.id`. |
-| `message.type` | string | Deprecated, use `rpc.message.type` instead. | `SENT`; `RECEIVED` | 
Replaced by `rpc.message.type`. |
-| `message.uncompressed_size` | int | Deprecated, use `rpc.message.uncompressed_size` instead. | | 
Replaced by `rpc.message.uncompressed_size`. |
+| Attribute | Type | Description | Examples | Stability |
+| --------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------- | ------------------ | ----------------------------------------------------------------------------------------------------------- |
+| `message.compressed_size` | int | Deprecated, use `rpc.message.compressed_size` instead. | | 
Replaced by `rpc.message.compressed_size`. |
+| `message.id` | int | Deprecated, use `rpc.message.id` instead. | | 
Replaced by `rpc.message.id`. |
+| `message.type` | string | Deprecated, use `rpc.message.type` instead. | `SENT`; `RECEIVED` | 
Replaced by `rpc.message.type`. |
+| `message.uncompressed_size` | int | Deprecated, use `rpc.message.uncompressed_size` instead. | | 
Replaced by `rpc.message.uncompressed_size`. |
`message.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 |
-|---|---|---|
-| `RECEIVED` | received |  |
-| `SENT` | sent |  |
+| Value | Description | Stability |
+| ---------- | ----------- | ---------------------------------------------------------------- |
+| `RECEIVED` | received |  |
+| `SENT` | sent |  |
diff --git a/docs/attributes-registry/server.md b/docs/attributes-registry/server.md
index 6f45185..6635fc4 100644
--- a/docs/attributes-registry/server.md
+++ b/docs/attributes-registry/server.md
@@ -10,10 +10,10 @@
These attributes may be used to describe the server in a connection-based network interaction where there is one side that initiates the connection (the client is the side that initiates the connection). This covers all TCP network interactions since TCP is connection-based and one side initiates the connection (an exception is made for peer-to-peer communication over TCP where the "user-facing" surface of the protocol / API doesn't 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 | Stability |
-|---|---|---|---|---|
+| 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` |  |
+| `server.port` | int | Server port number. [2] | `80`; `8080`; `443` |  |
**[1] `server.address`:** 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/service.md b/docs/attributes-registry/service.md
index e922f57..0391005 100644
--- a/docs/attributes-registry/service.md
+++ b/docs/attributes-registry/service.md
@@ -10,12 +10,12 @@
A service instance.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `service.instance.id` | string | The string ID of the service instance. [1] | `627cc493-f310-47de-96bd-71410b7dec09` |  |
-| `service.name` | string | Logical name of the service. [2] | `shoppingcart` |  |
-| `service.namespace` | string | A namespace for `service.name`. [3] | `Shop` |  |
-| `service.version` | string | The version string of the service API or implementation. The format is not defined by these conventions. | `2.0.0`; `a01dbef8a` |  |
+| Attribute | Type | Description | Examples | Stability |
+| --------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
+| `service.instance.id` | string | The string ID of the service instance. [1] | `627cc493-f310-47de-96bd-71410b7dec09` |  |
+| `service.name` | string | Logical name of the service. [2] | `shoppingcart` |  |
+| `service.namespace` | string | A namespace for `service.name`. [3] | `Shop` |  |
+| `service.version` | string | The version string of the service API or implementation. The format is not defined by these conventions. | `2.0.0`; `a01dbef8a` |  |
**[1] `service.instance.id`:** 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
diff --git a/docs/attributes-registry/session.md b/docs/attributes-registry/session.md
index 2505a28..c0774c9 100644
--- a/docs/attributes-registry/session.md
+++ b/docs/attributes-registry/session.md
@@ -12,7 +12,7 @@ Session is defined as the period of time encompassing all activities performed b
Consequently, a Session is represented as a collection of Logs, Events, and Spans emitted by the Client Application throughout the Session's duration. Each Session is assigned a unique identifier, which is included as an attribute in the Logs, Events, and Spans generated during the Session's lifecycle.
When a session reaches end of life, typically due to user inactivity or session timeout, a new session identifier will be assigned. The previous session identifier may be provided by the instrumentation so that telemetry backends can link the two sessions.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `session.id` | string | A unique id to identify a session. | `00112233-4455-6677-8899-aabbccddeeff` |  |
+| Attribute | Type | Description | Examples | Stability |
+| --------------------------------------------------------------------------------- | ------ | ---------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------- |
+| `session.id` | string | A unique id to identify a session. | `00112233-4455-6677-8899-aabbccddeeff` |  |
| `session.previous_id` | string | The previous `session.id` for this user, when known. | `00112233-4455-6677-8899-aabbccddeeff` |  |
diff --git a/docs/attributes-registry/source.md b/docs/attributes-registry/source.md
index 5d61475..e24ab93 100644
--- a/docs/attributes-registry/source.md
+++ b/docs/attributes-registry/source.md
@@ -10,9 +10,9 @@
These attributes may be used to describe the sender of a network exchange/packet. These should be used when there is no client/server relationship between the two sides, or when that relationship is unknown. This covers low-level network interactions (e.g. packet tracing) where you don't know if there was a connection or which side initiated it. This also covers unidirectional UDP flows and peer-to-peer communication where the "user-facing" surface of the protocol / API doesn't expose a clear notion of client and server.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| 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` |  |
+| `source.port` | int | Source port number | `3389`; `2888` |  |
**[1] `source.address`:** 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.
diff --git a/docs/attributes-registry/telemetry.md b/docs/attributes-registry/telemetry.md
index 6d619bb..ecf8602 100644
--- a/docs/attributes-registry/telemetry.md
+++ b/docs/attributes-registry/telemetry.md
@@ -10,13 +10,13 @@
This document defines attributes for telemetry SDK.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
-| `telemetry.distro.name` | string | The name of the auto instrumentation agent or distribution, if used. [1] | `parts-unlimited-java` |  |
-| `telemetry.distro.version` | string | The version string of the auto instrumentation agent or distribution, if used. | `1.2.3` |  |
-| `telemetry.sdk.language` | string | The language of the telemetry SDK. | `cpp`; `dotnet`; `erlang` |  |
-| `telemetry.sdk.name` | string | The name of the telemetry SDK as defined above. [2] | `opentelemetry` |  |
-| `telemetry.sdk.version` | string | The version string of the telemetry SDK. | `1.2.3` |  |
+| Attribute | Type | Description | Examples | Stability |
+| ------------------------------------------------------------------------------------------------ | ------ | ------------------------------------------------------------------------------ | ------------------------- | ---------------------------------------------------------------- |
+| `telemetry.distro.name` | string | The name of the auto instrumentation agent or distribution, if used. [1] | `parts-unlimited-java` |  |
+| `telemetry.distro.version` | string | The version string of the auto instrumentation agent or distribution, if used. | `1.2.3` |  |
+| `telemetry.sdk.language` | string | The language of the telemetry SDK. | `cpp`; `dotnet`; `erlang` |  |
+| `telemetry.sdk.name` | string | The name of the telemetry SDK as defined above. [2] | `opentelemetry` |  |
+| `telemetry.sdk.version` | string | The version string of the telemetry SDK. | `1.2.3` |  |
**[1] `telemetry.distro.name`:** Official auto instrumentation agents and distributions SHOULD set the `telemetry.distro.name` attribute to
a string starting with `opentelemetry-`, e.g. `opentelemetry-java-instrumentation`.
@@ -30,17 +30,17 @@ All custom identifiers SHOULD be stable across different versions of an implemen
`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 |  |
+| 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 |  |
diff --git a/docs/attributes-registry/thread.md b/docs/attributes-registry/thread.md
index ed1cf73..a820153 100644
--- a/docs/attributes-registry/thread.md
+++ b/docs/attributes-registry/thread.md
@@ -10,7 +10,7 @@
These attributes may be used for any operation to store information about a thread that started a span.
-| 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` |  |
+| 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` |  |
diff --git a/docs/attributes-registry/url.md b/docs/attributes-registry/url.md
index 963184f..060935a 100644
--- a/docs/attributes-registry/url.md
+++ b/docs/attributes-registry/url.md
@@ -10,21 +10,21 @@
Attributes describing URL.
-| 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.template` | string | The low-cardinality template of an [absolute path reference](https://www.rfc-editor.org/rfc/rfc3986#section-4.2). | `/users/{id}`; `/users/:id`; `/users?id={id}` |  |
-| `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.template` | string | The low-cardinality template of an [absolute path reference](https://www.rfc-editor.org/rfc/rfc3986#section-4.2). | `/users/{id}`; `/users/:id`; `/users?id={id}` |  |
+| `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] `url.domain`:** 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.
@@ -44,10 +44,10 @@ Sensitive content provided in `url.full` SHOULD be scrubbed when instrumentation
Query string values for the following keys SHOULD be redacted by default and replaced by the
value `REDACTED`:
-* [`AWSAccessKeyId`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
-* [`Signature`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
-* [`sig`](https://learn.microsoft.com/en-us/azure/storage/common/storage-sas-overview#sas-token)
-* [`X-Goog-Signature`](https://cloud.google.com/storage/docs/access-control/signed-urls)
+- [`AWSAccessKeyId`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
+- [`Signature`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
+- [`sig`](https://learn.microsoft.com/en-us/azure/storage/common/storage-sas-overview#sas-token)
+- [`X-Goog-Signature`](https://cloud.google.com/storage/docs/access-control/signed-urls)
This list is subject to change over time.
@@ -64,10 +64,10 @@ When a query string value is redacted, the query string key SHOULD still be pres
Query string values for the following keys SHOULD be redacted by default and replaced by the value `REDACTED`:
-* [`AWSAccessKeyId`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
-* [`Signature`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
-* [`sig`](https://learn.microsoft.com/en-us/azure/storage/common/storage-sas-overview#sas-token)
-* [`X-Goog-Signature`](https://cloud.google.com/storage/docs/access-control/signed-urls)
+- [`AWSAccessKeyId`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
+- [`Signature`](https://docs.aws.amazon.com/AmazonS3/latest/userguide/RESTAuthentication.html#RESTAuthenticationQueryStringAuth)
+- [`sig`](https://learn.microsoft.com/en-us/azure/storage/common/storage-sas-overview#sas-token)
+- [`X-Goog-Signature`](https://cloud.google.com/storage/docs/access-control/signed-urls)
This list is subject to change over time.
diff --git a/docs/attributes-registry/user-agent.md b/docs/attributes-registry/user-agent.md
index 37be972..b4df31f 100644
--- a/docs/attributes-registry/user-agent.md
+++ b/docs/attributes-registry/user-agent.md
@@ -10,11 +10,11 @@
Describes user-agent attributes.
-| 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` |  |
+| 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] `user_agent.name`:** [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/attributes-registry/webengine.md b/docs/attributes-registry/webengine.md
index 602fdb0..2b88051 100644
--- a/docs/attributes-registry/webengine.md
+++ b/docs/attributes-registry/webengine.md
@@ -10,8 +10,8 @@
This document defines the attributes used to describe the packaged software running the application code.
-| Attribute | Type | Description | Examples | Stability |
-|---|---|---|---|---|
+| Attribute | Type | Description | Examples | Stability |
+| --------------------------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------- |
| `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` |  |
-| `webengine.name` | string | The name of the web engine. | `WildFly` |  |
-| `webengine.version` | string | The version of the web engine. | `21.0.0` |  |
+| `webengine.name` | string | The name of the web engine. | `WildFly` |  |
+| `webengine.version` | string | The version of the web engine. | `21.0.0` |  |
diff --git a/docs/contrast/README.md b/docs/contrast/README.md
index abad5b2..8cd6798 100644
--- a/docs/contrast/README.md
+++ b/docs/contrast/README.md
@@ -30,7 +30,7 @@ action nor will it contain enough information to determine the action execution
## Resource additions from Contrast
-
+
@@ -40,7 +40,7 @@ action nor will it contain enough information to determine the action execution
**Status:** 
-**type:** `none`
+**type:** `contrast`
**Description:** Additional attributes for Contrast Sensors to provide
diff --git a/docs/resource/README.md b/docs/resource/README.md
index e1cfdc1..b7d9c69 100644
--- a/docs/resource/README.md
+++ b/docs/resource/README.md
@@ -225,7 +225,7 @@ a string starting with `opentelemetry-`, e.g. `opentelemetry-java-instrumentatio
## Contrast Resource Additions
-
+
@@ -235,7 +235,7 @@ a string starting with `opentelemetry-`, e.g. `opentelemetry-java-instrumentatio
**Status:** 
-**type:** `none`
+**type:** `contrast`
**Description:** Additional attributes for Contrast Sensors to provide
diff --git a/docs/resource/contrast-resources.md b/docs/resource/contrast-resources.md
index 6d81dd2..6af01e4 100644
--- a/docs/resource/contrast-resources.md
+++ b/docs/resource/contrast-resources.md
@@ -1,6 +1,6 @@
# Contrast Resource data
-
+
@@ -10,7 +10,7 @@
**Status:** 
-**type:** `none`
+**type:** `contrast`
**Description:** Additional attributes for Contrast Sensors to provide
diff --git a/model/contrast/resources.yaml b/model/contrast/resources.yaml
index 7b687e1..460716d 100644
--- a/model/contrast/resources.yaml
+++ b/model/contrast/resources.yaml
@@ -1,5 +1,6 @@
groups:
- - id: contrast.resource
+ - id: resource.contrast
+ name: contrast
type: resource
brief: >
Additional attributes for Contrast Sensors to provide