Skip to content

Commit e0ce9d7

Browse files
authored
Avoid using "infrastructure" terminology for all cloud (open-telemetry#1530)
* Avoid using "infrastructure" terminology for all cloud Infrastructure in cloud has a specific connotation for concepts explained in Infrastructure-as-a-Service (IaaS). Avoid this termilogy because it's exclusive of some other services/platforms that is represented by the "cloud" namespace. Renaming "infrastructure_service" to "service" also due to the new key length limits we are considering and infrastructure_service is a lengthy choice.
1 parent 1268268 commit e0ce9d7

File tree

3 files changed

+6
-5
lines changed

3 files changed

+6
-5
lines changed

CHANGELOG.md

+1
Original file line numberDiff line numberDiff line change
@@ -59,6 +59,7 @@ Google products under `cloud.infrastructure_service` ([#1496](https://github.com
5959
- `http.url` MUST NOT contain credentials ([#1502](https://github.com/open-telemetry/opentelemetry-specification/pull/1502))
6060
- Add `aws.eks.cluster.arn` to EKS specific semantic conventions ([#1484](https://github.com/open-telemetry/opentelemetry-specification/pull/1484))
6161
- Rename `zone` to `availability_zone` in `cloud` semantic conventions ([#1495](https://github.com/open-telemetry/opentelemetry-specification/pull/1495))
62+
- Rename `cloud.infrastructure_service` to `cloud.platform` ([#1530](https://github.com/open-telemetry/opentelemetry-specification/pull/1530))
6263
- Add section describing that libraries and the collector should autogenerate
6364
the semantic convention keys. ([#1515](https://github.com/open-telemetry/opentelemetry-specification/pull/1515))
6465

semantic_conventions/resource/cloud.yaml

+3-3
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ groups:
22
- id: cloud
33
prefix: cloud
44
brief: >
5-
A cloud infrastructure (e.g. GCP, Azure, AWS)
5+
A cloud environment (e.g. GCP, Azure, AWS)
66
attributes:
77
- id: provider
88
type:
@@ -42,7 +42,7 @@ groups:
4242
note: >
4343
Availability zones are called "zones" on Google Cloud.
4444
examples: ['us-east-1c']
45-
- id: infrastructure_service
45+
- id: platform
4646
type:
4747
allow_custom_values: true
4848
members:
@@ -92,7 +92,7 @@ groups:
9292
value: 'gcp_app_engine'
9393
brief: Google Cloud App Engine (GAE)
9494
brief: >
95-
The cloud infrastructure resource in use.
95+
The cloud platform in use.
9696
note: >
9797
The prefix of the service SHOULD match the one specified in `cloud.provider`.
9898
examples: ['aws_ec2', 'azure_vm', 'gcp_compute_engine']

specification/resource/semantic_conventions/cloud.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
| `cloud.account.id` | string | The cloud account ID the resource is assigned to. | `111111111111`; `opentelemetry` | No |
1414
| `cloud.region` | string | The geographical region the resource is running. Refer to your provider's docs to see the available regions, for example [AWS regions](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/), [Azure regions](https://azure.microsoft.com/en-us/global-infrastructure/geographies/), or [Google Cloud regions](https://cloud.google.com/about/locations). | `us-central1`; `us-east-1` | No |
1515
| `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` | No |
16-
| `cloud.infrastructure_service` | string | The cloud infrastructure resource in use. [2] | `aws_ec2`; `azure_vm`; `gcp_compute_engine` | No |
16+
| `cloud.platform` | string | The cloud platform in use. [2] | `aws_ec2`; `azure_vm`; `gcp_compute_engine` | No |
1717

1818
**[1]:** Availability zones are called "zones" on Google Cloud.
1919

@@ -27,7 +27,7 @@
2727
| `azure` | Microsoft Azure |
2828
| `gcp` | Google Cloud Platform |
2929

30-
`cloud.infrastructure_service` MUST be one of the following or, if none of the listed values apply, a custom value:
30+
`cloud.platform` MUST be one of the following or, if none of the listed values apply, a custom value:
3131

3232
| Value | Description |
3333
|---|---|

0 commit comments

Comments
 (0)