> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/resource/cloud/


# Cloud

<!-- semconv entity.cloud -->
<!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
<!-- see templates/registry/markdown/snippet.md.j2 -->
<!-- prettier-ignore-start -->

**Status:** ![Development](https://img.shields.io/badge/-development-blue)

**type:** `cloud`

**Description:** クラウド環境（GCP、Azure、AWSなど）。

> [!warning]
> このEntity定義には、roleを持たない属性が含まれています。
> 安定版のEntityは、roleが定義されていない属性を持ってはなりません（MUST NOT）。

**Attributes:**

| Role | Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- | --- |
| Other | [`cloud.account.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloud/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | そのリソースが割り当てられているクラウドアカウントID。[1] | `111111111111`; `opentelemetry`; `22222222-2222-2222-2222-222222222222` |
| Other | [`cloud.availability_zone`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloud/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | クラウドのリージョンには、可用性を高めるために、ゾーンと呼ばれる複数の分離されたロケーションがあることがよくあります。可用性ゾーンは、そのリソースが実行されているゾーンを表します。[2] | `us-east-1c` |
| Other | [`cloud.platform`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloud/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 使用しているクラウドプラットフォーム。[3] | `akamai_cloud.compute`; `alibaba_cloud_ecs`; `alibaba_cloud_fc` |
| Other | [`cloud.provider`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloud/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | クラウドプロバイダーの名前。 | `akamai_cloud`; `alibaba_cloud`; `aws` |
| Other | [`cloud.region`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloud/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | クラウドプロバイダー内の地理的リージョン。リソースに関連付けられた場合、この属性はそのリソースが動作するリージョンを指定します。クラウド上にデプロイされたサービスやAPIを呼び出す場合、この属性は呼び出し先がデプロイされているリージョンを識別します。[4] | `us-central1`; `us-east-1` |
| Other | [`cloud.resource_id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloud/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 監視対象のクラウドリソースに対する、クラウドプロバイダー固有のネイティブ識別子（AWSの[ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)、Azureの[完全修飾リソースID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id)、GCPの[完全なリソース名](https://google.aip.dev/122#full-resource-names)など）。[5] | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions/<SUBSCRIPTION_GUID>/resourceGroups/<RG>/providers/Microsoft.Web/sites/<FUNCAPP>/functions/<FUNC>` |

**[1] `cloud.account.id`:** Azureの場合、これはサブスクリプションIDです。

**[2] `cloud.availability_zone`:** 可用性ゾーンは、Alibaba CloudとGoogle Cloudでは「zone」と呼ばれます。

**[3] `cloud.platform`:** サービスのプレフィックスは、`cloud.provider`で指定されたものと一致すべきです（SHOULD）。

**[4] `cloud.region`:** 利用可能なリージョンについては、プロバイダーの文書を参照してください。例えば[Alibaba Cloudのリージョン](https://www.alibabacloud.com/help/doc-detail/40654.htm)、[AWSのリージョン](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/)、[Azureのリージョン](https://azure.microsoft.com/global-infrastructure/geographies/)、[Google Cloudのリージョン](https://cloud.google.com/about/locations)、[Tencent Cloudのリージョン](https://www.tencentcloud.com/document/product/213/6091)です。

**[5] `cloud.resource_id`:** 一部のクラウドプロバイダーでは、起動時に完全なIDを決定できない場合があるため、代わりに`cloud.resource_id`をスパン属性として設定する必要があるかもしれません。

`cloud.resource_id`に使用する正確な値は、クラウドプロバイダーによって異なります。
この属性を設定する場合、当てはまるのであれば次のよく知られた定義を使用しなければなりません（MUST）。

- **AWS Lambda:** 関数の[ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)。
  同じランタイムインスタンスが複数の異なるエイリアスから呼び出し可能である場合があるため、「呼び出されたARN」を直接使用せず、[エイリアスのサフィックス](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)を、解決済みの関数バージョンに置き換えるように注意してください。
- **GCP:** [リソースのURI](https://cloud.google.com/iam/docs/full-resource-names)
- **Azure:** 呼び出された関数（function app *ではなく*）の[完全修飾リソースID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id)で、次の形式を持ちます。
  `/subscriptions/<SUBSCRIPTION_GUID>/resourceGroups/<RG>/providers/Microsoft.Web/sites/<FUNCAPP>/functions/<FUNC>`。
  これは、Azureのfunction appが通常TracerProviderを共有する複数の関数をホストできるため、スパン属性を使用しなければならないことを意味します（MUST）。

---

`cloud.platform`には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず（MUST）、それ以外の場合は独自の値を使ってもかまいません（MAY）。

| Value | Description | Stability |
| --- | --- | --- |
| `akamai_cloud.compute` | Akamai Cloud Compute | ![Development](https://img.shields.io/badge/-development-blue) |
| `alibaba_cloud_ecs` | Alibaba Cloud Elastic Compute Service | ![Development](https://img.shields.io/badge/-development-blue) |
| `alibaba_cloud_fc` | Alibaba Cloud Function Compute | ![Development](https://img.shields.io/badge/-development-blue) |
| `alibaba_cloud_openshift` | Red Hat OpenShift on Alibaba Cloud | ![Development](https://img.shields.io/badge/-development-blue) |
| `aws_app_runner` | AWS App Runner | ![Development](https://img.shields.io/badge/-development-blue) |
| `aws_ec2` | AWS Elastic Compute Cloud | ![Development](https://img.shields.io/badge/-development-blue) |
| `aws_ecs` | AWS Elastic Container Service | ![Development](https://img.shields.io/badge/-development-blue) |
| `aws_eks` | AWS Elastic Kubernetes Service | ![Development](https://img.shields.io/badge/-development-blue) |
| `aws_elastic_beanstalk` | AWS Elastic Beanstalk | ![Development](https://img.shields.io/badge/-development-blue) |
| `aws_lambda` | AWS Lambda | ![Development](https://img.shields.io/badge/-development-blue) |
| `aws_openshift` | Red Hat OpenShift on AWS (ROSA) | ![Development](https://img.shields.io/badge/-development-blue) |
| `azure.aks` | Azure Kubernetes Service | ![Development](https://img.shields.io/badge/-development-blue) |
| `azure.app_service` | Azure App Service | ![Development](https://img.shields.io/badge/-development-blue) |
| `azure.container_apps` | Azure Container Apps | ![Development](https://img.shields.io/badge/-development-blue) |
| `azure.container_instances` | Azure Container Instances | ![Development](https://img.shields.io/badge/-development-blue) |
| `azure.functions` | Azure Functions | ![Development](https://img.shields.io/badge/-development-blue) |
| `azure.openshift` | Azure Red Hat OpenShift | ![Development](https://img.shields.io/badge/-development-blue) |
| `azure.vm` | Azure Virtual Machines | ![Development](https://img.shields.io/badge/-development-blue) |
| `gcp.agent_engine` | Google Vertex AI Agent Engine | ![Development](https://img.shields.io/badge/-development-blue) |
| `gcp_app_engine` | Google Cloud App Engine (GAE) | ![Development](https://img.shields.io/badge/-development-blue) |
| `gcp_bare_metal_solution` | Google Bare Metal Solution (BMS) | ![Development](https://img.shields.io/badge/-development-blue) |
| `gcp_cloud_functions` | Google Cloud Functions (GCF) | ![Development](https://img.shields.io/badge/-development-blue) |
| `gcp_cloud_run` | Google Cloud Run | ![Development](https://img.shields.io/badge/-development-blue) |
| `gcp_compute_engine` | Google Cloud Compute Engine (GCE) | ![Development](https://img.shields.io/badge/-development-blue) |
| `gcp_kubernetes_engine` | Google Cloud Kubernetes Engine (GKE) | ![Development](https://img.shields.io/badge/-development-blue) |
| `gcp_openshift` | Red Hat OpenShift on Google Cloud | ![Development](https://img.shields.io/badge/-development-blue) |
| `hetzner.cloud_server` | Server on Hetzner Cloud | ![Development](https://img.shields.io/badge/-development-blue) |
| `ibm_cloud_openshift` | Red Hat OpenShift on IBM Cloud | ![Development](https://img.shields.io/badge/-development-blue) |
| `oracle_cloud_compute` | Compute on Oracle Cloud Infrastructure (OCI) | ![Development](https://img.shields.io/badge/-development-blue) |
| `oracle_cloud_oke` | Kubernetes Engine (OKE) on Oracle Cloud Infrastructure (OCI) | ![Development](https://img.shields.io/badge/-development-blue) |
| `scaleway_cloud_compute` | Compute on Scaleway Cloud | ![Development](https://img.shields.io/badge/-development-blue) |
| `tencent_cloud_cvm` | Tencent Cloud Cloud Virtual Machine (CVM) | ![Development](https://img.shields.io/badge/-development-blue) |
| `tencent_cloud_eks` | Tencent Cloud Elastic Kubernetes Service (EKS) | ![Development](https://img.shields.io/badge/-development-blue) |
| `tencent_cloud_scf` | Tencent Cloud Serverless Cloud Function (SCF) | ![Development](https://img.shields.io/badge/-development-blue) |
| `vultr.cloud_compute` | Vultr Cloud Compute | ![Development](https://img.shields.io/badge/-development-blue) |

---

`cloud.provider`には、次のよく知られた値の一覧があります。いずれかが該当する場合はその値を使用しなければならず（MUST）、それ以外の場合は独自の値を使ってもかまいません（MAY）。

| Value | Description | Stability |
| --- | --- | --- |
| `akamai_cloud` | Akamai Cloud | ![Development](https://img.shields.io/badge/-development-blue) |
| `alibaba_cloud` | Alibaba Cloud | ![Development](https://img.shields.io/badge/-development-blue) |
| `aws` | Amazon Web Services | ![Development](https://img.shields.io/badge/-development-blue) |
| `azure` | Microsoft Azure | ![Development](https://img.shields.io/badge/-development-blue) |
| `gcp` | Google Cloud Platform | ![Development](https://img.shields.io/badge/-development-blue) |
| `heroku` | Heroku Platform as a Service | ![Development](https://img.shields.io/badge/-development-blue) |
| `hetzner` | Hetzner | ![Development](https://img.shields.io/badge/-development-blue) |
| `ibm_cloud` | IBM Cloud | ![Development](https://img.shields.io/badge/-development-blue) |
| `oracle_cloud` | Oracle Cloud Infrastructure (OCI) | ![Development](https://img.shields.io/badge/-development-blue) |
| `scaleway_cloud` | Scaleway Cloud | ![Development](https://img.shields.io/badge/-development-blue) |
| `tencent_cloud` | Tencent Cloud | ![Development](https://img.shields.io/badge/-development-blue) |
| `vultr` | Vultr | ![Development](https://img.shields.io/badge/-development-blue) |
<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
<!-- endsemconv -->

