From eaf4a67acaeba4f1289518a3d0aab936b1e6d48c Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Tue, 7 Jul 2026 14:22:34 -0400 Subject: [PATCH 01/13] add semantic conventions for azure container apps replica name --- .../add-azure-container-app-instance-id.yaml | 9 ++++++ docs/registry/attributes/azure.md | 17 ++++++++-- docs/registry/entities/README.md | 2 ++ docs/registry/entities/azure.md | 20 ++++++++++++ docs/resource/cloud-provider/README.md | 1 + docs/resource/cloud-provider/azure.md | 32 +++++++++++++++++++ model/azure/entities.yaml | 11 +++++++ model/azure/registry.yaml | 16 ++++++++++ 8 files changed, 106 insertions(+), 2 deletions(-) create mode 100644 .chloggen/add-azure-container-app-instance-id.yaml create mode 100644 docs/registry/entities/azure.md create mode 100644 docs/resource/cloud-provider/azure.md create mode 100644 model/azure/entities.yaml diff --git a/.chloggen/add-azure-container-app-instance-id.yaml b/.chloggen/add-azure-container-app-instance-id.yaml new file mode 100644 index 0000000000..87a4e0fc95 --- /dev/null +++ b/.chloggen/add-azure-container-app-instance-id.yaml @@ -0,0 +1,9 @@ +change_type: enhancement + +component: azure + +note: Add `azure.container_app` entity and `azure.container_app.instance.id` attribute for the replica name of an Azure Container App. + +issues: [3857] + +subtext: diff --git a/docs/registry/attributes/azure.md b/docs/registry/attributes/azure.md index 1e23cd5fa2..8b8946cd90 100644 --- a/docs/registry/attributes/azure.md +++ b/docs/registry/attributes/azure.md @@ -5,6 +5,7 @@ - [General Azure Attributes](#general-azure-attributes) - [Azure Client Library Attributes](#azure-client-library-attributes) +- [Azure Container Apps Attributes](#azure-container-apps-attributes) - [Azure Cosmos DB Attributes](#azure-cosmos-db-attributes) - [Deprecated Azure Attributes](#deprecated-azure-attributes) @@ -30,6 +31,18 @@ This section defines generic attributes used by Azure Client Libraries. | `azure.resource_provider.namespace` | ![Development](https://img.shields.io/badge/-development-blue) | 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` | | `azure.service.request.id` | ![Development](https://img.shields.io/badge/-development-blue) | 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` | +## Azure Container Apps Attributes + +This section defines attributes for Azure Container Apps. + +**Attributes:** + +| Key | Stability | Value Type | Description | Example Values | +| --- | --- | --- | --- | --- | +| `azure.container_app.instance.id` | ![Development](https://img.shields.io/badge/-development-blue) | string | The name of the replica of an Azure Container App. [1] | `my-containerapp--20mh1s9-86c8c4b497-zx9bq` | + +**[1] `azure.container_app.instance.id`:** The value should be set to the [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. + ## Azure Cosmos DB Attributes This section defines attributes for Azure Cosmos DB. @@ -40,12 +53,12 @@ This section defines attributes for Azure Cosmos DB. | --- | --- | --- | --- | --- | | `azure.cosmosdb.connection.mode` | ![Development](https://img.shields.io/badge/-development-blue) | string | Cosmos client connection mode. | `gateway`; `direct` | | `azure.cosmosdb.consistency.level` | ![Development](https://img.shields.io/badge/-development-blue) | string | Account or request [consistency level](https://learn.microsoft.com/azure/cosmos-db/consistency-levels). | `Eventual`; `ConsistentPrefix`; `BoundedStaleness`; `Strong`; `Session` | -| `azure.cosmosdb.operation.contacted_regions` | ![Development](https://img.shields.io/badge/-development-blue) | string[] | List of regions contacted during operation in the order that they were contacted. If there is more than one region listed, it indicates that the operation was performed on multiple regions i.e. cross-regional call. [1] | `["North Central US", "Australia East", "Australia Southeast"]` | +| `azure.cosmosdb.operation.contacted_regions` | ![Development](https://img.shields.io/badge/-development-blue) | string[] | List of regions contacted during operation in the order that they were contacted. If there is more than one region listed, it indicates that the operation was performed on multiple regions i.e. cross-regional call. [2] | `["North Central US", "Australia East", "Australia Southeast"]` | | `azure.cosmosdb.operation.request_charge` | ![Development](https://img.shields.io/badge/-development-blue) | double | The number of request units consumed by the operation. | `46.18`; `1.0` | | `azure.cosmosdb.request.body.size` | ![Development](https://img.shields.io/badge/-development-blue) | int | Request payload size in bytes. | | | `azure.cosmosdb.response.sub_status_code` | ![Development](https://img.shields.io/badge/-development-blue) | int | Cosmos DB sub status code. | `1000`; `1002` | -**[1] `azure.cosmosdb.operation.contacted_regions`:** Region name matches the format of `displayName` in [Azure Location API](https://learn.microsoft.com/rest/api/resources/subscriptions/list-locations) +**[2] `azure.cosmosdb.operation.contacted_regions`:** Region name matches the format of `displayName` in [Azure Location API](https://learn.microsoft.com/rest/api/resources/subscriptions/list-locations) --- diff --git a/docs/registry/entities/README.md b/docs/registry/entities/README.md index 21d8fa5f7d..d0e905167f 100644 --- a/docs/registry/entities/README.md +++ b/docs/registry/entities/README.md @@ -27,6 +27,8 @@ Currently, the following namespaces exist: | | [aws.ecs](aws.md#aws-ecs) | ![Development](https://img.shields.io/badge/-development-blue) | | | [aws.eks](aws.md#aws-eks) | ![Development](https://img.shields.io/badge/-development-blue) | | | [aws.log](aws.md#aws-log) | ![Development](https://img.shields.io/badge/-development-blue) | +| Azure | | | +| | [azure.container_app](azure.md#azure-container-app) | ![Development](https://img.shields.io/badge/-development-blue) | | Browser | | | | | [browser](browser.md#browser) | ![Development](https://img.shields.io/badge/-development-blue) | | | [browser.document](browser.md#browser-document) | ![Development](https://img.shields.io/badge/-development-blue) | diff --git a/docs/registry/entities/azure.md b/docs/registry/entities/azure.md new file mode 100644 index 0000000000..ebd8d00809 --- /dev/null +++ b/docs/registry/entities/azure.md @@ -0,0 +1,20 @@ + + + +# Azure + +## Azure Container App + +**Status:** ![Development](https://img.shields.io/badge/-development-blue) + +**type:** `azure.container_app` + +**Description:** Resource used by Azure Container Apps. + +**Attributes:** + +| Role | Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | +| --- | --- | --- | --- | --- | --- | --- | +| Identity | [`azure.container_app.instance.id`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the replica of an Azure Container App. [1] | `my-containerapp--20mh1s9-86c8c4b497-zx9bq` | + +**[1] `azure.container_app.instance.id`:** The value should be set to the [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. diff --git a/docs/resource/cloud-provider/README.md b/docs/resource/cloud-provider/README.md index 1525e63e33..a4f74f99f6 100644 --- a/docs/resource/cloud-provider/README.md +++ b/docs/resource/cloud-provider/README.md @@ -5,6 +5,7 @@ This document defines semantic conventions for resource cloud providers. * [AWS](aws/README.md): Semantic Conventions for Amazon Web Services. +* [Azure](azure.md): Semantic Conventions for Azure. * [GCP](gcp/README.md): Semantic Conventions for Google Cloud Platform. * [Heroku](heroku.md): Semantic Conventions for Heroku. diff --git a/docs/resource/cloud-provider/azure.md b/docs/resource/cloud-provider/azure.md new file mode 100644 index 0000000000..9caf5b5b4f --- /dev/null +++ b/docs/resource/cloud-provider/azure.md @@ -0,0 +1,32 @@ +# Azure Container Apps + +**Status**: [Development][DocumentStatus] + +These conventions are recommended for resources running on +[Azure Container Apps](https://learn.microsoft.com/azure/container-apps/overview). + + + + + + +**Status:** ![Development](https://img.shields.io/badge/-development-blue) + +**type:** `azure.container_app` + +**Description:** Resource used by Azure Container Apps. + +**Attributes:** + +| Role | Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | +| --- | --- | --- | --- | --- | --- | --- | +| Identity | [`azure.container_app.instance.id`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the replica of an Azure Container App. [1] | `my-containerapp--20mh1s9-86c8c4b497-zx9bq` | + +**[1] `azure.container_app.instance.id`:** The value should be set to the [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. + + + + +Additionally, [the `cloud.provider` resource attribute MUST be set to `azure`](../cloud.md). + +[DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status diff --git a/model/azure/entities.yaml b/model/azure/entities.yaml new file mode 100644 index 0000000000..4737b922e0 --- /dev/null +++ b/model/azure/entities.yaml @@ -0,0 +1,11 @@ +groups: + - id: entity.azure.container_app + type: entity + stability: development + name: azure.container_app + brief: > + Resource used by Azure Container Apps. + attributes: + - ref: azure.container_app.instance.id + role: identifying + requirement_level: required diff --git a/model/azure/registry.yaml b/model/azure/registry.yaml index aebfe1d3e3..ac3ea6534a 100644 --- a/model/azure/registry.yaml +++ b/model/azure/registry.yaml @@ -37,6 +37,22 @@ groups: stability: development brief: The unique identifier of the client instance. examples: ["3ba4827d-4422-483f-b59f-85b74211c11d", "storage-client-1"] + - id: registry.azure.container_apps + type: attribute_group + display_name: Azure Container Apps Attributes + brief: > + This section defines attributes for Azure Container Apps. + attributes: + - id: azure.container_app.instance.id + type: string + stability: development + brief: > + The name of the replica of an Azure Container App. + note: > + The value should be set to the + [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) + environment variable. + examples: ["my-containerapp--20mh1s9-86c8c4b497-zx9bq"] - id: registry.azure.cosmosdb type: attribute_group display_name: Azure Cosmos DB Attributes From 2063e7baf280a8f3e12a66b3d652135b656a2797 Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Tue, 7 Jul 2026 15:44:16 -0400 Subject: [PATCH 02/13] clarify scope --- docs/registry/attributes/azure.md | 2 +- docs/registry/entities/azure.md | 2 +- docs/resource/cloud-provider/azure.md | 4 ++-- model/azure/entities.yaml | 2 +- model/azure/registry.yaml | 2 +- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/registry/attributes/azure.md b/docs/registry/attributes/azure.md index 8b8946cd90..d3b574c7c9 100644 --- a/docs/registry/attributes/azure.md +++ b/docs/registry/attributes/azure.md @@ -33,7 +33,7 @@ This section defines generic attributes used by Azure Client Libraries. ## Azure Container Apps Attributes -This section defines attributes for Azure Container Apps. +This section defines attributes for Azure Container Apps. Does not apply to Azure Container Apps Jobs. **Attributes:** diff --git a/docs/registry/entities/azure.md b/docs/registry/entities/azure.md index ebd8d00809..a4be72243e 100644 --- a/docs/registry/entities/azure.md +++ b/docs/registry/entities/azure.md @@ -9,7 +9,7 @@ **type:** `azure.container_app` -**Description:** Resource used by Azure Container Apps. +**Description:** Resource used by Azure Container Apps. Does not apply to Azure Container Apps Jobs. **Attributes:** diff --git a/docs/resource/cloud-provider/azure.md b/docs/resource/cloud-provider/azure.md index 9caf5b5b4f..24301bba84 100644 --- a/docs/resource/cloud-provider/azure.md +++ b/docs/resource/cloud-provider/azure.md @@ -3,7 +3,7 @@ **Status**: [Development][DocumentStatus] These conventions are recommended for resources running on -[Azure Container Apps](https://learn.microsoft.com/azure/container-apps/overview). +[Azure Container Apps](https://learn.microsoft.com/azure/container-apps/overview). They do not apply to Azure Container Apps Jobs. @@ -14,7 +14,7 @@ These conventions are recommended for resources running on **type:** `azure.container_app` -**Description:** Resource used by Azure Container Apps. +**Description:** Resource used by Azure Container Apps. Does not apply to Azure Container Apps Jobs. **Attributes:** diff --git a/model/azure/entities.yaml b/model/azure/entities.yaml index 4737b922e0..a88afd2c72 100644 --- a/model/azure/entities.yaml +++ b/model/azure/entities.yaml @@ -4,7 +4,7 @@ groups: stability: development name: azure.container_app brief: > - Resource used by Azure Container Apps. + Resource used by Azure Container Apps. Does not apply to Azure Container Apps Jobs. attributes: - ref: azure.container_app.instance.id role: identifying diff --git a/model/azure/registry.yaml b/model/azure/registry.yaml index ac3ea6534a..4833d0c214 100644 --- a/model/azure/registry.yaml +++ b/model/azure/registry.yaml @@ -41,7 +41,7 @@ groups: type: attribute_group display_name: Azure Container Apps Attributes brief: > - This section defines attributes for Azure Container Apps. + This section defines attributes for Azure Container Apps. Does not apply to Azure Container Apps Jobs. attributes: - id: azure.container_app.instance.id type: string From 678259d4f98e78f5a4d1c7d105d62fd69d8406ce Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Wed, 8 Jul 2026 10:15:58 -0400 Subject: [PATCH 03/13] rename entity.azure.container_app to entity.azure.container_app.instance and fold azure.container_app.instance.id into general azure group --- docs/registry/attributes/azure.md | 16 +++------------- docs/registry/entities/README.md | 2 +- docs/registry/entities/azure.md | 6 +++--- docs/resource/cloud-provider/azure.md | 6 +++--- model/azure/entities.yaml | 7 ++++--- model/azure/registry.yaml | 26 ++++++++++---------------- 6 files changed, 24 insertions(+), 39 deletions(-) diff --git a/docs/registry/attributes/azure.md b/docs/registry/attributes/azure.md index d3b574c7c9..73053fb924 100644 --- a/docs/registry/attributes/azure.md +++ b/docs/registry/attributes/azure.md @@ -5,7 +5,6 @@ - [General Azure Attributes](#general-azure-attributes) - [Azure Client Library Attributes](#azure-client-library-attributes) -- [Azure Container Apps Attributes](#azure-container-apps-attributes) - [Azure Cosmos DB Attributes](#azure-cosmos-db-attributes) - [Deprecated Azure Attributes](#deprecated-azure-attributes) @@ -17,8 +16,11 @@ This section defines generic attributes for Azure services. | Key | Stability | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | +| `azure.container_app.instance.id` | ![Development](https://img.shields.io/badge/-development-blue) | string | The name of the replica of an Azure Container App. [1] | `my-containerapp--20mh1s9-86c8c4b497-zx9bq` | | `azure.resource_group.name` | ![Development](https://img.shields.io/badge/-development-blue) | string | The name of the Azure [resource group](https://learn.microsoft.com/azure/azure-resource-manager/management/manage-resource-groups-portal) the resource belongs to. | `my-resource-group`; `rg-myapp-prod` | +**[1] `azure.container_app.instance.id`:** The value should be set to the [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. + ## Azure Client Library Attributes This section defines generic attributes used by Azure Client Libraries. @@ -31,18 +33,6 @@ This section defines generic attributes used by Azure Client Libraries. | `azure.resource_provider.namespace` | ![Development](https://img.shields.io/badge/-development-blue) | 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` | | `azure.service.request.id` | ![Development](https://img.shields.io/badge/-development-blue) | 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` | -## Azure Container Apps Attributes - -This section defines attributes for Azure Container Apps. Does not apply to Azure Container Apps Jobs. - -**Attributes:** - -| Key | Stability | Value Type | Description | Example Values | -| --- | --- | --- | --- | --- | -| `azure.container_app.instance.id` | ![Development](https://img.shields.io/badge/-development-blue) | string | The name of the replica of an Azure Container App. [1] | `my-containerapp--20mh1s9-86c8c4b497-zx9bq` | - -**[1] `azure.container_app.instance.id`:** The value should be set to the [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. - ## Azure Cosmos DB Attributes This section defines attributes for Azure Cosmos DB. diff --git a/docs/registry/entities/README.md b/docs/registry/entities/README.md index d0e905167f..71bbdfa253 100644 --- a/docs/registry/entities/README.md +++ b/docs/registry/entities/README.md @@ -28,7 +28,7 @@ Currently, the following namespaces exist: | | [aws.eks](aws.md#aws-eks) | ![Development](https://img.shields.io/badge/-development-blue) | | | [aws.log](aws.md#aws-log) | ![Development](https://img.shields.io/badge/-development-blue) | | Azure | | | -| | [azure.container_app](azure.md#azure-container-app) | ![Development](https://img.shields.io/badge/-development-blue) | +| | [azure.container_app.instance](azure.md#azure-container-app-instance) | ![Development](https://img.shields.io/badge/-development-blue) | | Browser | | | | | [browser](browser.md#browser) | ![Development](https://img.shields.io/badge/-development-blue) | | | [browser.document](browser.md#browser-document) | ![Development](https://img.shields.io/badge/-development-blue) | diff --git a/docs/registry/entities/azure.md b/docs/registry/entities/azure.md index a4be72243e..b48cf2b544 100644 --- a/docs/registry/entities/azure.md +++ b/docs/registry/entities/azure.md @@ -3,13 +3,13 @@ # Azure -## Azure Container App +## Azure Container App Instance **Status:** ![Development](https://img.shields.io/badge/-development-blue) -**type:** `azure.container_app` +**type:** `azure.container_app.instance` -**Description:** Resource used by Azure Container Apps. Does not apply to Azure Container Apps Jobs. +**Description:** Resource used by an Azure Container App replica. Does not apply to Azure Container Apps Jobs. **Attributes:** diff --git a/docs/resource/cloud-provider/azure.md b/docs/resource/cloud-provider/azure.md index 24301bba84..aee0535508 100644 --- a/docs/resource/cloud-provider/azure.md +++ b/docs/resource/cloud-provider/azure.md @@ -5,16 +5,16 @@ These conventions are recommended for resources running on [Azure Container Apps](https://learn.microsoft.com/azure/container-apps/overview). They do not apply to Azure Container Apps Jobs. - + **Status:** ![Development](https://img.shields.io/badge/-development-blue) -**type:** `azure.container_app` +**type:** `azure.container_app.instance` -**Description:** Resource used by Azure Container Apps. Does not apply to Azure Container Apps Jobs. +**Description:** Resource used by an Azure Container App replica. Does not apply to Azure Container Apps Jobs. **Attributes:** diff --git a/model/azure/entities.yaml b/model/azure/entities.yaml index a88afd2c72..8c62434733 100644 --- a/model/azure/entities.yaml +++ b/model/azure/entities.yaml @@ -1,10 +1,11 @@ groups: - - id: entity.azure.container_app + - id: entity.azure.container_app.instance type: entity stability: development - name: azure.container_app + name: azure.container_app.instance brief: > - Resource used by Azure Container Apps. Does not apply to Azure Container Apps Jobs. + Resource used by an Azure Container App replica. Does not apply to + Azure Container Apps Jobs. attributes: - ref: azure.container_app.instance.id role: identifying diff --git a/model/azure/registry.yaml b/model/azure/registry.yaml index 4833d0c214..e68582bd09 100644 --- a/model/azure/registry.yaml +++ b/model/azure/registry.yaml @@ -13,6 +13,16 @@ groups: [resource group](https://learn.microsoft.com/azure/azure-resource-manager/management/manage-resource-groups-portal) the resource belongs to. examples: ["my-resource-group", "rg-myapp-prod"] + - id: azure.container_app.instance.id + type: string + stability: development + brief: > + The name of the replica of an Azure Container App. + note: > + The value should be set to the + [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) + environment variable. + examples: ["my-containerapp--20mh1s9-86c8c4b497-zx9bq"] - id: registry.azure.client.sdk type: attribute_group display_name: Azure Client Library Attributes @@ -37,22 +47,6 @@ groups: stability: development brief: The unique identifier of the client instance. examples: ["3ba4827d-4422-483f-b59f-85b74211c11d", "storage-client-1"] - - id: registry.azure.container_apps - type: attribute_group - display_name: Azure Container Apps Attributes - brief: > - This section defines attributes for Azure Container Apps. Does not apply to Azure Container Apps Jobs. - attributes: - - id: azure.container_app.instance.id - type: string - stability: development - brief: > - The name of the replica of an Azure Container App. - note: > - The value should be set to the - [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) - environment variable. - examples: ["my-containerapp--20mh1s9-86c8c4b497-zx9bq"] - id: registry.azure.cosmosdb type: attribute_group display_name: Azure Cosmos DB Attributes From 2177547a8a62a9edc48d726c005b3a6dbd95133b Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Wed, 8 Jul 2026 10:55:17 -0400 Subject: [PATCH 04/13] remove comment about azure container apps jobs in entities.yaml now that the entity is scoped to an instance --- docs/registry/entities/azure.md | 2 +- docs/resource/cloud-provider/azure.md | 2 +- model/azure/entities.yaml | 3 +-- 3 files changed, 3 insertions(+), 4 deletions(-) diff --git a/docs/registry/entities/azure.md b/docs/registry/entities/azure.md index b48cf2b544..8b0071479b 100644 --- a/docs/registry/entities/azure.md +++ b/docs/registry/entities/azure.md @@ -9,7 +9,7 @@ **type:** `azure.container_app.instance` -**Description:** Resource used by an Azure Container App replica. Does not apply to Azure Container Apps Jobs. +**Description:** Resource used by an Azure Container App replica. **Attributes:** diff --git a/docs/resource/cloud-provider/azure.md b/docs/resource/cloud-provider/azure.md index aee0535508..faddf19a5d 100644 --- a/docs/resource/cloud-provider/azure.md +++ b/docs/resource/cloud-provider/azure.md @@ -14,7 +14,7 @@ These conventions are recommended for resources running on **type:** `azure.container_app.instance` -**Description:** Resource used by an Azure Container App replica. Does not apply to Azure Container Apps Jobs. +**Description:** Resource used by an Azure Container App replica. **Attributes:** diff --git a/model/azure/entities.yaml b/model/azure/entities.yaml index 8c62434733..20eea8a445 100644 --- a/model/azure/entities.yaml +++ b/model/azure/entities.yaml @@ -4,8 +4,7 @@ groups: stability: development name: azure.container_app.instance brief: > - Resource used by an Azure Container App replica. Does not apply to - Azure Container Apps Jobs. + Resource used by an Azure Container App replica. attributes: - ref: azure.container_app.instance.id role: identifying From b57beda4d54550bcee4cb506033bfeb51db78347 Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Wed, 8 Jul 2026 11:09:06 -0400 Subject: [PATCH 05/13] add azure container app revision convention --- .../add-azure-container-app-instance-id.yaml | 2 +- docs/registry/attributes/azure.md | 7 +++++-- docs/registry/entities/README.md | 1 + docs/registry/entities/azure.md | 16 ++++++++++++++++ model/azure/entities.yaml | 11 +++++++++++ model/azure/registry.yaml | 10 ++++++++++ 6 files changed, 44 insertions(+), 3 deletions(-) diff --git a/.chloggen/add-azure-container-app-instance-id.yaml b/.chloggen/add-azure-container-app-instance-id.yaml index 87a4e0fc95..44515dafcc 100644 --- a/.chloggen/add-azure-container-app-instance-id.yaml +++ b/.chloggen/add-azure-container-app-instance-id.yaml @@ -2,7 +2,7 @@ change_type: enhancement component: azure -note: Add `azure.container_app` entity and `azure.container_app.instance.id` attribute for the replica name of an Azure Container App. +note: Add `azure.container_app.instance` and `azure.container_app.revision` entities, and `azure.container_app.instance.id` and `azure.container_app.revision` attributes, for identifying replicas and revisions of an Azure Container App. issues: [3857] diff --git a/docs/registry/attributes/azure.md b/docs/registry/attributes/azure.md index 73053fb924..eaea8f5230 100644 --- a/docs/registry/attributes/azure.md +++ b/docs/registry/attributes/azure.md @@ -17,10 +17,13 @@ This section defines generic attributes for Azure services. | Key | Stability | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | | `azure.container_app.instance.id` | ![Development](https://img.shields.io/badge/-development-blue) | string | The name of the replica of an Azure Container App. [1] | `my-containerapp--20mh1s9-86c8c4b497-zx9bq` | +| `azure.container_app.revision` | ![Development](https://img.shields.io/badge/-development-blue) | string | The name of the revision of an Azure Container App. [2] | `my-containerapp--20mh1s9` | | `azure.resource_group.name` | ![Development](https://img.shields.io/badge/-development-blue) | string | The name of the Azure [resource group](https://learn.microsoft.com/azure/azure-resource-manager/management/manage-resource-groups-portal) the resource belongs to. | `my-resource-group`; `rg-myapp-prod` | **[1] `azure.container_app.instance.id`:** The value should be set to the [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. +**[2] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. + ## Azure Client Library Attributes This section defines generic attributes used by Azure Client Libraries. @@ -43,12 +46,12 @@ This section defines attributes for Azure Cosmos DB. | --- | --- | --- | --- | --- | | `azure.cosmosdb.connection.mode` | ![Development](https://img.shields.io/badge/-development-blue) | string | Cosmos client connection mode. | `gateway`; `direct` | | `azure.cosmosdb.consistency.level` | ![Development](https://img.shields.io/badge/-development-blue) | string | Account or request [consistency level](https://learn.microsoft.com/azure/cosmos-db/consistency-levels). | `Eventual`; `ConsistentPrefix`; `BoundedStaleness`; `Strong`; `Session` | -| `azure.cosmosdb.operation.contacted_regions` | ![Development](https://img.shields.io/badge/-development-blue) | string[] | List of regions contacted during operation in the order that they were contacted. If there is more than one region listed, it indicates that the operation was performed on multiple regions i.e. cross-regional call. [2] | `["North Central US", "Australia East", "Australia Southeast"]` | +| `azure.cosmosdb.operation.contacted_regions` | ![Development](https://img.shields.io/badge/-development-blue) | string[] | List of regions contacted during operation in the order that they were contacted. If there is more than one region listed, it indicates that the operation was performed on multiple regions i.e. cross-regional call. [3] | `["North Central US", "Australia East", "Australia Southeast"]` | | `azure.cosmosdb.operation.request_charge` | ![Development](https://img.shields.io/badge/-development-blue) | double | The number of request units consumed by the operation. | `46.18`; `1.0` | | `azure.cosmosdb.request.body.size` | ![Development](https://img.shields.io/badge/-development-blue) | int | Request payload size in bytes. | | | `azure.cosmosdb.response.sub_status_code` | ![Development](https://img.shields.io/badge/-development-blue) | int | Cosmos DB sub status code. | `1000`; `1002` | -**[2] `azure.cosmosdb.operation.contacted_regions`:** Region name matches the format of `displayName` in [Azure Location API](https://learn.microsoft.com/rest/api/resources/subscriptions/list-locations) +**[3] `azure.cosmosdb.operation.contacted_regions`:** Region name matches the format of `displayName` in [Azure Location API](https://learn.microsoft.com/rest/api/resources/subscriptions/list-locations) --- diff --git a/docs/registry/entities/README.md b/docs/registry/entities/README.md index 71bbdfa253..6b63cd5e67 100644 --- a/docs/registry/entities/README.md +++ b/docs/registry/entities/README.md @@ -29,6 +29,7 @@ Currently, the following namespaces exist: | | [aws.log](aws.md#aws-log) | ![Development](https://img.shields.io/badge/-development-blue) | | Azure | | | | | [azure.container_app.instance](azure.md#azure-container-app-instance) | ![Development](https://img.shields.io/badge/-development-blue) | +| | [azure.container_app.revision](azure.md#azure-container-app-revision) | ![Development](https://img.shields.io/badge/-development-blue) | | Browser | | | | | [browser](browser.md#browser) | ![Development](https://img.shields.io/badge/-development-blue) | | | [browser.document](browser.md#browser-document) | ![Development](https://img.shields.io/badge/-development-blue) | diff --git a/docs/registry/entities/azure.md b/docs/registry/entities/azure.md index 8b0071479b..80f368506a 100644 --- a/docs/registry/entities/azure.md +++ b/docs/registry/entities/azure.md @@ -18,3 +18,19 @@ | Identity | [`azure.container_app.instance.id`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the replica of an Azure Container App. [1] | `my-containerapp--20mh1s9-86c8c4b497-zx9bq` | **[1] `azure.container_app.instance.id`:** The value should be set to the [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. + +## Azure Container App Revision + +**Status:** ![Development](https://img.shields.io/badge/-development-blue) + +**type:** `azure.container_app.revision` + +**Description:** Resource used by a revision of an Azure Container App. + +**Attributes:** + +| Role | Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | +| --- | --- | --- | --- | --- | --- | --- | +| Identity | [`azure.container_app.revision`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the revision of an Azure Container App. [2] | `my-containerapp--20mh1s9` | + +**[2] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. diff --git a/model/azure/entities.yaml b/model/azure/entities.yaml index 20eea8a445..ac2a7f61fb 100644 --- a/model/azure/entities.yaml +++ b/model/azure/entities.yaml @@ -9,3 +9,14 @@ groups: - ref: azure.container_app.instance.id role: identifying requirement_level: required + + - id: entity.azure.container_app.revision + type: entity + stability: development + name: azure.container_app.revision + brief: > + Resource used by a revision of an Azure Container App. + attributes: + - ref: azure.container_app.revision + role: identifying + requirement_level: required diff --git a/model/azure/registry.yaml b/model/azure/registry.yaml index e68582bd09..c0c22bd095 100644 --- a/model/azure/registry.yaml +++ b/model/azure/registry.yaml @@ -23,6 +23,16 @@ groups: [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. examples: ["my-containerapp--20mh1s9-86c8c4b497-zx9bq"] + - id: azure.container_app.revision + type: string + stability: development + brief: > + The name of the revision of an Azure Container App. + note: > + The value should be set to the + [`CONTAINER_APP_REVISION_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) + environment variable. + examples: ["my-containerapp--20mh1s9"] - id: registry.azure.client.sdk type: attribute_group display_name: Azure Client Library Attributes From 185a9bed17b8902e63ac54bb9051d0e7d3cd0d0b Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Wed, 8 Jul 2026 11:14:33 -0400 Subject: [PATCH 06/13] environment variable for revision should be CONTAINER_APP_REVISION --- docs/registry/attributes/azure.md | 2 +- docs/registry/entities/azure.md | 2 +- model/azure/registry.yaml | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/registry/attributes/azure.md b/docs/registry/attributes/azure.md index eaea8f5230..6fea3f31ba 100644 --- a/docs/registry/attributes/azure.md +++ b/docs/registry/attributes/azure.md @@ -22,7 +22,7 @@ This section defines generic attributes for Azure services. **[1] `azure.container_app.instance.id`:** The value should be set to the [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. -**[2] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. +**[2] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. ## Azure Client Library Attributes diff --git a/docs/registry/entities/azure.md b/docs/registry/entities/azure.md index 80f368506a..e01461f9f5 100644 --- a/docs/registry/entities/azure.md +++ b/docs/registry/entities/azure.md @@ -33,4 +33,4 @@ | --- | --- | --- | --- | --- | --- | --- | | Identity | [`azure.container_app.revision`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the revision of an Azure Container App. [2] | `my-containerapp--20mh1s9` | -**[2] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. +**[2] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. diff --git a/model/azure/registry.yaml b/model/azure/registry.yaml index c0c22bd095..dad15eb313 100644 --- a/model/azure/registry.yaml +++ b/model/azure/registry.yaml @@ -30,7 +30,7 @@ groups: The name of the revision of an Azure Container App. note: > The value should be set to the - [`CONTAINER_APP_REVISION_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) + [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. examples: ["my-containerapp--20mh1s9"] - id: registry.azure.client.sdk From 9f428be22797da1e76bd359b92b3de4dc9053b3d Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Wed, 8 Jul 2026 13:10:03 -0400 Subject: [PATCH 07/13] fix yamllint check --- .chloggen/add-azure-container-app-instance-id.yaml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/.chloggen/add-azure-container-app-instance-id.yaml b/.chloggen/add-azure-container-app-instance-id.yaml index 44515dafcc..4047e0d405 100644 --- a/.chloggen/add-azure-container-app-instance-id.yaml +++ b/.chloggen/add-azure-container-app-instance-id.yaml @@ -2,7 +2,10 @@ change_type: enhancement component: azure -note: Add `azure.container_app.instance` and `azure.container_app.revision` entities, and `azure.container_app.instance.id` and `azure.container_app.revision` attributes, for identifying replicas and revisions of an Azure Container App. +note: > + Add `azure.container_app.instance` and `azure.container_app.revision` entities, and + `azure.container_app.instance.id` and `azure.container_app.revision` attributes, for + identifying replicas and revisions of an Azure Container App. issues: [3857] From 766334e4fd684b21733cf1d198f46431031c63a6 Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Thu, 9 Jul 2026 08:01:42 -0700 Subject: [PATCH 08/13] create azure.container_app entity rather than azure.container_app.revision entity --- .../add-azure-container-app-instance-id.yaml | 2 +- docs/registry/entities/README.md | 2 +- docs/registry/entities/azure.md | 20 ++++++++--------- docs/resource/cloud-provider/azure.md | 22 +++++++++++++++++++ model/azure/entities.yaml | 4 ++-- 5 files changed, 36 insertions(+), 14 deletions(-) diff --git a/.chloggen/add-azure-container-app-instance-id.yaml b/.chloggen/add-azure-container-app-instance-id.yaml index 4047e0d405..85595e378f 100644 --- a/.chloggen/add-azure-container-app-instance-id.yaml +++ b/.chloggen/add-azure-container-app-instance-id.yaml @@ -3,7 +3,7 @@ change_type: enhancement component: azure note: > - Add `azure.container_app.instance` and `azure.container_app.revision` entities, and + Add `azure.container_app.instance` and `azure.container_app` entities, and `azure.container_app.instance.id` and `azure.container_app.revision` attributes, for identifying replicas and revisions of an Azure Container App. diff --git a/docs/registry/entities/README.md b/docs/registry/entities/README.md index 6b63cd5e67..9d6355fa7f 100644 --- a/docs/registry/entities/README.md +++ b/docs/registry/entities/README.md @@ -28,8 +28,8 @@ Currently, the following namespaces exist: | | [aws.eks](aws.md#aws-eks) | ![Development](https://img.shields.io/badge/-development-blue) | | | [aws.log](aws.md#aws-log) | ![Development](https://img.shields.io/badge/-development-blue) | | Azure | | | +| | [azure.container_app](azure.md#azure-container-app) | ![Development](https://img.shields.io/badge/-development-blue) | | | [azure.container_app.instance](azure.md#azure-container-app-instance) | ![Development](https://img.shields.io/badge/-development-blue) | -| | [azure.container_app.revision](azure.md#azure-container-app-revision) | ![Development](https://img.shields.io/badge/-development-blue) | | Browser | | | | | [browser](browser.md#browser) | ![Development](https://img.shields.io/badge/-development-blue) | | | [browser.document](browser.md#browser-document) | ![Development](https://img.shields.io/badge/-development-blue) | diff --git a/docs/registry/entities/azure.md b/docs/registry/entities/azure.md index e01461f9f5..50bdb90587 100644 --- a/docs/registry/entities/azure.md +++ b/docs/registry/entities/azure.md @@ -3,34 +3,34 @@ # Azure -## Azure Container App Instance +## Azure Container App **Status:** ![Development](https://img.shields.io/badge/-development-blue) -**type:** `azure.container_app.instance` +**type:** `azure.container_app` -**Description:** Resource used by an Azure Container App replica. +**Description:** Resource used by a revision of an Azure Container App. **Attributes:** | Role | Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | --- | -| Identity | [`azure.container_app.instance.id`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the replica of an Azure Container App. [1] | `my-containerapp--20mh1s9-86c8c4b497-zx9bq` | +| Identity | [`azure.container_app.revision`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the revision of an Azure Container App. [1] | `my-containerapp--20mh1s9` | -**[1] `azure.container_app.instance.id`:** The value should be set to the [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. +**[1] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. -## Azure Container App Revision +## Azure Container App Instance **Status:** ![Development](https://img.shields.io/badge/-development-blue) -**type:** `azure.container_app.revision` +**type:** `azure.container_app.instance` -**Description:** Resource used by a revision of an Azure Container App. +**Description:** Resource used by an Azure Container App replica. **Attributes:** | Role | Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | --- | -| Identity | [`azure.container_app.revision`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the revision of an Azure Container App. [2] | `my-containerapp--20mh1s9` | +| Identity | [`azure.container_app.instance.id`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the replica of an Azure Container App. [2] | `my-containerapp--20mh1s9-86c8c4b497-zx9bq` | -**[2] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. +**[2] `azure.container_app.instance.id`:** The value should be set to the [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. diff --git a/docs/resource/cloud-provider/azure.md b/docs/resource/cloud-provider/azure.md index faddf19a5d..83fe5e76fb 100644 --- a/docs/resource/cloud-provider/azure.md +++ b/docs/resource/cloud-provider/azure.md @@ -27,6 +27,28 @@ These conventions are recommended for resources running on + + + + + +**Status:** ![Development](https://img.shields.io/badge/-development-blue) + +**type:** `azure.container_app` + +**Description:** Resource used by a revision of an Azure Container App. + +**Attributes:** + +| Role | Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | +| --- | --- | --- | --- | --- | --- | --- | +| Identity | [`azure.container_app.revision`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the revision of an Azure Container App. [1] | `my-containerapp--20mh1s9` | + +**[1] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. + + + + Additionally, [the `cloud.provider` resource attribute MUST be set to `azure`](../cloud.md). [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status diff --git a/model/azure/entities.yaml b/model/azure/entities.yaml index ac2a7f61fb..5fa4743ea0 100644 --- a/model/azure/entities.yaml +++ b/model/azure/entities.yaml @@ -10,10 +10,10 @@ groups: role: identifying requirement_level: required - - id: entity.azure.container_app.revision + - id: entity.azure.container_app type: entity stability: development - name: azure.container_app.revision + name: azure.container_app brief: > Resource used by a revision of an Azure Container App. attributes: From 184abe6558dbd06e24930577ec8eab662b584ed3 Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Thu, 9 Jul 2026 21:29:48 -0700 Subject: [PATCH 09/13] drop identifying role from azure.container_app.revision attribute --- model/azure/entities.yaml | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/model/azure/entities.yaml b/model/azure/entities.yaml index 5fa4743ea0..814d20fcd1 100644 --- a/model/azure/entities.yaml +++ b/model/azure/entities.yaml @@ -15,8 +15,7 @@ groups: stability: development name: azure.container_app brief: > - Resource used by a revision of an Azure Container App. + Resource used by Azure Container Apps. attributes: - ref: azure.container_app.revision - role: identifying - requirement_level: required + requirement_level: recommended From e28ea7c578d8b51698a2646c748aa79e7b8fe652 Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Tue, 14 Jul 2026 08:42:42 -0700 Subject: [PATCH 10/13] Revert "drop identifying role from azure.container_app.revision attribute" This reverts commit 184abe6558dbd06e24930577ec8eab662b584ed3. --- model/azure/entities.yaml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/model/azure/entities.yaml b/model/azure/entities.yaml index 814d20fcd1..5fa4743ea0 100644 --- a/model/azure/entities.yaml +++ b/model/azure/entities.yaml @@ -15,7 +15,8 @@ groups: stability: development name: azure.container_app brief: > - Resource used by Azure Container Apps. + Resource used by a revision of an Azure Container App. attributes: - ref: azure.container_app.revision - requirement_level: recommended + role: identifying + requirement_level: required From cedbf9301673cdf62f0875309959d96ffb820af8 Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Mon, 20 Jul 2026 09:16:58 -0700 Subject: [PATCH 11/13] clarify scope for azure container app entity --- docs/registry/entities/azure.md | 2 +- docs/resource/cloud-provider/azure.md | 2 +- model/azure/entities.yaml | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/registry/entities/azure.md b/docs/registry/entities/azure.md index 50bdb90587..939c2fff97 100644 --- a/docs/registry/entities/azure.md +++ b/docs/registry/entities/azure.md @@ -9,7 +9,7 @@ **type:** `azure.container_app` -**Description:** Resource used by a revision of an Azure Container App. +**Description:** Resource used by a revision of an Azure Container App. Does not apply to Azure Container Apps Jobs. **Attributes:** diff --git a/docs/resource/cloud-provider/azure.md b/docs/resource/cloud-provider/azure.md index 83fe5e76fb..a0abac29d9 100644 --- a/docs/resource/cloud-provider/azure.md +++ b/docs/resource/cloud-provider/azure.md @@ -36,7 +36,7 @@ These conventions are recommended for resources running on **type:** `azure.container_app` -**Description:** Resource used by a revision of an Azure Container App. +**Description:** Resource used by a revision of an Azure Container App. Does not apply to Azure Container Apps Jobs. **Attributes:** diff --git a/model/azure/entities.yaml b/model/azure/entities.yaml index 5fa4743ea0..86296d61d8 100644 --- a/model/azure/entities.yaml +++ b/model/azure/entities.yaml @@ -15,7 +15,7 @@ groups: stability: development name: azure.container_app brief: > - Resource used by a revision of an Azure Container App. + Resource used by a revision of an Azure Container App. Does not apply to Azure Container Apps Jobs. attributes: - ref: azure.container_app.revision role: identifying From 1d19c64f37b0d92f993a532ec9025331046aa6c6 Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Mon, 20 Jul 2026 10:56:19 -0700 Subject: [PATCH 12/13] rename azure.container_app.revision to azure.container_app.revision.name --- .chloggen/add-azure-container-app-instance-id.yaml | 2 +- docs/registry/attributes/azure.md | 4 ++-- docs/registry/entities/azure.md | 4 ++-- docs/resource/cloud-provider/azure.md | 4 ++-- model/azure/entities.yaml | 2 +- model/azure/registry.yaml | 2 +- 6 files changed, 9 insertions(+), 9 deletions(-) diff --git a/.chloggen/add-azure-container-app-instance-id.yaml b/.chloggen/add-azure-container-app-instance-id.yaml index 85595e378f..d38ce6958d 100644 --- a/.chloggen/add-azure-container-app-instance-id.yaml +++ b/.chloggen/add-azure-container-app-instance-id.yaml @@ -4,7 +4,7 @@ component: azure note: > Add `azure.container_app.instance` and `azure.container_app` entities, and - `azure.container_app.instance.id` and `azure.container_app.revision` attributes, for + `azure.container_app.instance.id` and `azure.container_app.revision.name` attributes, for identifying replicas and revisions of an Azure Container App. issues: [3857] diff --git a/docs/registry/attributes/azure.md b/docs/registry/attributes/azure.md index 6fea3f31ba..ac15e84fd1 100644 --- a/docs/registry/attributes/azure.md +++ b/docs/registry/attributes/azure.md @@ -17,12 +17,12 @@ This section defines generic attributes for Azure services. | Key | Stability | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | | `azure.container_app.instance.id` | ![Development](https://img.shields.io/badge/-development-blue) | string | The name of the replica of an Azure Container App. [1] | `my-containerapp--20mh1s9-86c8c4b497-zx9bq` | -| `azure.container_app.revision` | ![Development](https://img.shields.io/badge/-development-blue) | string | The name of the revision of an Azure Container App. [2] | `my-containerapp--20mh1s9` | +| `azure.container_app.revision.name` | ![Development](https://img.shields.io/badge/-development-blue) | string | The name of the revision of an Azure Container App. [2] | `my-containerapp--20mh1s9` | | `azure.resource_group.name` | ![Development](https://img.shields.io/badge/-development-blue) | string | The name of the Azure [resource group](https://learn.microsoft.com/azure/azure-resource-manager/management/manage-resource-groups-portal) the resource belongs to. | `my-resource-group`; `rg-myapp-prod` | **[1] `azure.container_app.instance.id`:** The value should be set to the [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. -**[2] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. +**[2] `azure.container_app.revision.name`:** The value should be set to the [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. ## Azure Client Library Attributes diff --git a/docs/registry/entities/azure.md b/docs/registry/entities/azure.md index 939c2fff97..6afa143011 100644 --- a/docs/registry/entities/azure.md +++ b/docs/registry/entities/azure.md @@ -15,9 +15,9 @@ | Role | Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | --- | -| Identity | [`azure.container_app.revision`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the revision of an Azure Container App. [1] | `my-containerapp--20mh1s9` | +| Identity | [`azure.container_app.revision.name`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the revision of an Azure Container App. [1] | `my-containerapp--20mh1s9` | -**[1] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. +**[1] `azure.container_app.revision.name`:** The value should be set to the [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. ## Azure Container App Instance diff --git a/docs/resource/cloud-provider/azure.md b/docs/resource/cloud-provider/azure.md index a0abac29d9..8bc4fb2d38 100644 --- a/docs/resource/cloud-provider/azure.md +++ b/docs/resource/cloud-provider/azure.md @@ -42,9 +42,9 @@ These conventions are recommended for resources running on | Role | Key | Stability | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values | | --- | --- | --- | --- | --- | --- | --- | -| Identity | [`azure.container_app.revision`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the revision of an Azure Container App. [1] | `my-containerapp--20mh1s9` | +| Identity | [`azure.container_app.revision.name`](/docs/registry/attributes/azure.md) | ![Development](https://img.shields.io/badge/-development-blue) | `Required` | string | The name of the revision of an Azure Container App. [1] | `my-containerapp--20mh1s9` | -**[1] `azure.container_app.revision`:** The value should be set to the [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. +**[1] `azure.container_app.revision.name`:** The value should be set to the [`CONTAINER_APP_REVISION`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. diff --git a/model/azure/entities.yaml b/model/azure/entities.yaml index 86296d61d8..90d4fa92db 100644 --- a/model/azure/entities.yaml +++ b/model/azure/entities.yaml @@ -17,6 +17,6 @@ groups: brief: > Resource used by a revision of an Azure Container App. Does not apply to Azure Container Apps Jobs. attributes: - - ref: azure.container_app.revision + - ref: azure.container_app.revision.name role: identifying requirement_level: required diff --git a/model/azure/registry.yaml b/model/azure/registry.yaml index dad15eb313..f082cd7125 100644 --- a/model/azure/registry.yaml +++ b/model/azure/registry.yaml @@ -23,7 +23,7 @@ groups: [`CONTAINER_APP_REPLICA_NAME`](https://learn.microsoft.com/azure/container-apps/environment-variables) environment variable. examples: ["my-containerapp--20mh1s9-86c8c4b497-zx9bq"] - - id: azure.container_app.revision + - id: azure.container_app.revision.name type: string stability: development brief: > From 6d57de336148a34535fcaec5041ac9a446aa424e Mon Sep 17 00:00:00 2001 From: Kathie Huang Date: Mon, 20 Jul 2026 11:28:02 -0700 Subject: [PATCH 13/13] introduce azure/README.md page --- docs/resource/cloud-provider/README.md | 2 +- docs/resource/cloud-provider/azure/README.md | 20 +++++++++++++++++++ .../{azure.md => azure/container-apps.md} | 2 +- 3 files changed, 22 insertions(+), 2 deletions(-) create mode 100644 docs/resource/cloud-provider/azure/README.md rename docs/resource/cloud-provider/{azure.md => azure/container-apps.md} (98%) diff --git a/docs/resource/cloud-provider/README.md b/docs/resource/cloud-provider/README.md index a4f74f99f6..490a81611a 100644 --- a/docs/resource/cloud-provider/README.md +++ b/docs/resource/cloud-provider/README.md @@ -5,7 +5,7 @@ This document defines semantic conventions for resource cloud providers. * [AWS](aws/README.md): Semantic Conventions for Amazon Web Services. -* [Azure](azure.md): Semantic Conventions for Azure. +* [Azure](azure/README.md): Semantic Conventions for Azure. * [GCP](gcp/README.md): Semantic Conventions for Google Cloud Platform. * [Heroku](heroku.md): Semantic Conventions for Heroku. diff --git a/docs/resource/cloud-provider/azure/README.md b/docs/resource/cloud-provider/azure/README.md new file mode 100644 index 0000000000..d09290a9af --- /dev/null +++ b/docs/resource/cloud-provider/azure/README.md @@ -0,0 +1,20 @@ + + +# Azure semantic conventions + +**Status**: [Development][DocumentStatus] + +This directory defines standards for resource attributes that only apply to +Azure resources. If an attribute could apply to resources from more than one +cloud provider (like account ID, operating system, etc), it belongs in the +parent `model` directory. + +## Services + +Attributes that relate to an individual Azure service: + +- [Container Apps](./container-apps.md) + +[DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status diff --git a/docs/resource/cloud-provider/azure.md b/docs/resource/cloud-provider/azure/container-apps.md similarity index 98% rename from docs/resource/cloud-provider/azure.md rename to docs/resource/cloud-provider/azure/container-apps.md index 8bc4fb2d38..abd36a37e0 100644 --- a/docs/resource/cloud-provider/azure.md +++ b/docs/resource/cloud-provider/azure/container-apps.md @@ -49,6 +49,6 @@ These conventions are recommended for resources running on -Additionally, [the `cloud.provider` resource attribute MUST be set to `azure`](../cloud.md). +Additionally, [the `cloud.provider` resource attribute MUST be set to `azure`](../../cloud.md). [DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status