diff --git a/CHANGELOG.md b/CHANGELOG.md index 1b5f1f7b9d5..83e3c5669ac 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -32,6 +32,8 @@ release. ### Resource +- Add GCP-specific resource attributes for Compute Engine under `gcp.gce` ([#3384](https://github.com/open-telemetry/opentelemetry-specification/pull/3384)) + ### Semantic Conventions - Clarify the scope of the HTTP client span. diff --git a/semantic_conventions/resource/cloud_provider/gcp/gce.yaml b/semantic_conventions/resource/cloud_provider/gcp/gce.yaml new file mode 100644 index 00000000000..879d0ea3885 --- /dev/null +++ b/semantic_conventions/resource/cloud_provider/gcp/gce.yaml @@ -0,0 +1,22 @@ +groups: + - id: gcp.gce + prefix: gcp.gce + type: resource + brief: > + Resources used by Google Compute Engine (GCE). + attributes: + - id: instance.name + type: string + brief: > + The instance name of a GCE instance. This is the value + provided by `host.name`, the visible name of the instance in + the Cloud Console UI, and the prefix for the default + hostname of the instance as defined by the [default internal + DNS + name](https://cloud.google.com/compute/docs/internal-dns#instance-fully-qualified-domain-names). + examples: ['instance-1', 'my-vm-name'] + - id: instance.hostname + type: string + brief: > + The hostname of a GCE instance. This is the full value of the default or [custom hostname](https://cloud.google.com/compute/docs/instances/custom-hostname-vm). + examples: ['my-host1234.example.com', 'sample-vm.us-west1-b.c.my-project.internal'] diff --git a/specification/resource/semantic_conventions/README.md b/specification/resource/semantic_conventions/README.md index cd311dbf7d8..e6aeba57e92 100644 --- a/specification/resource/semantic_conventions/README.md +++ b/specification/resource/semantic_conventions/README.md @@ -220,7 +220,7 @@ Valid cloud providers are: - [Alibaba Cloud](https://www.alibabacloud.com/) (`alibaba_cloud`) - [Amazon Web Services](https://aws.amazon.com/) ([`aws`](cloud_provider/aws/README.md)) -- [Google Cloud Platform](https://cloud.google.com/) (`gcp`) +- [Google Cloud Platform](https://cloud.google.com/) ([`gcp`](cloud_provider/gcp/README.md)) - [Microsoft Azure](https://azure.microsoft.com/) (`azure`) - [Tencent Cloud](https://www.tencentcloud.com/) (`tencent_cloud`) - [Heroku dyno](./cloud_provider/heroku.md) diff --git a/specification/resource/semantic_conventions/cloud_provider/gcp/README.md b/specification/resource/semantic_conventions/cloud_provider/gcp/README.md new file mode 100644 index 00000000000..3de71998997 --- /dev/null +++ b/specification/resource/semantic_conventions/cloud_provider/gcp/README.md @@ -0,0 +1,10 @@ +# GCP Semantic Conventions + +This directory defines standards for resource attributes that only apply to +Google Cloud Platform (GCP). If an attribute could apply to resources from more than one cloud +provider (like account ID, operating system, etc), it belongs in the parent +`semantic_conventions` directory. + +## Services + +- [Google Compute Engine](./gce.md) diff --git a/specification/resource/semantic_conventions/cloud_provider/gcp/gce.md b/specification/resource/semantic_conventions/cloud_provider/gcp/gce.md new file mode 100644 index 00000000000..49d9954643a --- /dev/null +++ b/specification/resource/semantic_conventions/cloud_provider/gcp/gce.md @@ -0,0 +1,12 @@ +# Google Compute Engine + +**Type:** `gcp.gce` + +**Description:** Resource attributes for GCE instances. + + +| Attribute | Type | Description | Examples | Requirement Level | +|---|---|---|---|---| +| `gcp.gce.instance.name` | string | The instance name of a GCE instance. This is the value provided by `host.name`, the visible name of the instance in the Cloud Console UI, and the prefix for the default hostname of the instance as defined by the [default internal DNS name](https://cloud.google.com/compute/docs/internal-dns#instance-fully-qualified-domain-names). | `instance-1`; `my-vm-name` | Recommended | +| `gcp.gce.instance.hostname` | string | The hostname of a GCE instance. This is the full value of the default or [custom hostname](https://cloud.google.com/compute/docs/instances/custom-hostname-vm). | `my-host1234.example.com`; `sample-vm.us-west1-b.c.my-project.internal` | Recommended | +