Cloud

Status:

type: cloud

Description: A cloud environment (e.g. GCP, Azure, AWS)

Attribute	Type	Description	Examples	Requirement Level	Stability
cloud.account.id	string	The cloud account ID the resource is assigned to.	111111111111; opentelemetry	Recommended
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	Recommended
cloud.platform	string	The cloud platform in use. [2]	alibaba_cloud_ecs; alibaba_cloud_fc; alibaba_cloud_openshift	Recommended
cloud.provider	string	Name of the cloud provider.	alibaba_cloud; aws; azure	Recommended
cloud.region	string	The geographical region the resource is running. [3]	us-central1; us-east-1	Recommended
cloud.resource_id	string	Cloud provider-specific native identifier of the monitored cloud resource (e.g. an ARN on AWS, a fully qualified resource ID on Azure, a 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/<SUBSCRIPTION_GUID>/resourceGroups/<RG>/providers/Microsoft.Web/sites/<FUNCAPP>/functions/<FUNC>	Recommended

[1] cloud.availability_zone: Availability zones are called “zones” on Alibaba Cloud and Google Cloud.

[2] cloud.platform: The prefix of the service SHOULD match the one specified in cloud.provider.

[3] cloud.region: Refer to your provider’s docs to see the available regions, for example Alibaba Cloud regions, AWS regions, Azure regions, Google Cloud regions, or Tencent Cloud regions.

[4] cloud.resource_id: On some cloud providers, it may not be possible to determine the full ID at startup, so it may be necessary to set cloud.resource_id as a span attribute instead.

The exact value to use for cloud.resource_id depends on the cloud provider. The following well-known definitions MUST be used if you set this attribute and they apply:

• AWS Lambda: The function ARN. Take care not to use the “invoked ARN” directly but replace any alias suffix with the resolved function version, as the same runtime instance may be invocable with multiple different aliases.
• GCP: The URI of the resource
• Azure: The Fully Qualified Resource ID of the invoked function, not the function app, having the form /subscriptions/<SUBSCRIPTION_GUID>/resourceGroups/<RG>/providers/Microsoft.Web/sites/<FUNCAPP>/functions/<FUNC>. 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
oracle_cloud_compute	Compute on Oracle Cloud Infrastructure (OCI)
oracle_cloud_oke	Kubernetes Engine (OKE) on Oracle Cloud Infrastructure (OCI)
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
oracle_cloud	Oracle Cloud Infrastructure (OCI)
tencent_cloud	Tencent Cloud