cloud.json•5.38 kB
{
"namespace": "cloud",
"description": "A cloud environment (e.g. GCP, Azure, AWS).\n",
"attributes": {
"cloud.provider": {
"description": "Name of the cloud provider.\n",
"type": "string",
"stability": "development",
"examples": [
"alibaba_cloud",
"aws",
"azure",
"gcp",
"heroku",
"ibm_cloud",
"oracle_cloud",
"tencent_cloud"
]
},
"cloud.account.id": {
"description": "The cloud account ID the resource is assigned to.\n",
"type": "string",
"stability": "development",
"examples": ["111111111111", "opentelemetry"]
},
"cloud.region": {
"description": "The geographical region within a cloud provider. When associated with a resource, this attribute specifies the region where the resource operates. When calling services or APIs deployed on a cloud, this attribute identifies the region where the called destination is deployed.\n",
"type": "string",
"note": "Refer to your provider's docs to see the available regions, for example [Alibaba Cloud regions](https://www.alibabacloud.com/help/doc-detail/40654.htm), [AWS regions](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/), [Azure regions](https://azure.microsoft.com/global-infrastructure/geographies/), [Google Cloud regions](https://cloud.google.com/about/locations), or [Tencent Cloud regions](https://www.tencentcloud.com/document/product/213/6091).\n",
"stability": "development",
"examples": ["us-central1", "us-east-1"]
},
"cloud.resource_id": {
"description": "Cloud provider-specific native identifier of the monitored cloud resource (e.g. an [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html) on AWS, a [fully qualified resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) on Azure, a [full resource name](https://google.aip.dev/122#full-resource-names) on GCP)\n",
"type": "string",
"note": "On some cloud providers, it may not be possible to determine the full ID at startup,\nso it may be necessary to set `cloud.resource_id` as a span attribute instead.\n\nThe exact value to use for `cloud.resource_id` depends on the cloud provider.\nThe following well-known definitions MUST be used if you set this attribute and they apply:\n\n- **AWS Lambda:** The function [ARN](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html).\n Take care not to use the \"invoked ARN\" directly but replace any\n [alias suffix](https://docs.aws.amazon.com/lambda/latest/dg/configuration-aliases.html)\n with the resolved function version, as the same runtime instance may be invocable with\n multiple different aliases.\n- **GCP:** The [URI of the resource](https://cloud.google.com/iam/docs/full-resource-names)\n- **Azure:** The [Fully Qualified Resource ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id) of the invoked function,\n *not* the function app, having the form\n `/subscriptions/<SUBSCRIPTION_GUID>/resourceGroups/<RG>/providers/Microsoft.Web/sites/<FUNCAPP>/functions/<FUNC>`.\n This means that a span attribute MUST be used, as an Azure function app can host multiple functions that would usually share\n a TracerProvider.\n",
"stability": "development",
"examples": [
"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>"
]
},
"cloud.availability_zone": {
"description": "Cloud regions often have multiple, isolated locations known as zones to increase availability. Availability zone represents the zone where the resource is running.\n",
"type": "string",
"note": "Availability zones are called \"zones\" on Alibaba Cloud and Google Cloud.\n",
"stability": "development",
"examples": ["us-east-1c"]
},
"cloud.platform": {
"description": "The cloud platform in use.\n",
"type": "string",
"note": "The prefix of the service SHOULD match the one specified in `cloud.provider`.\n",
"stability": "development",
"examples": [
"alibaba_cloud_ecs",
"alibaba_cloud_fc",
"alibaba_cloud_openshift",
"aws_ec2",
"aws_ecs",
"aws_eks",
"aws_lambda",
"aws_elastic_beanstalk",
"aws_app_runner",
"aws_openshift",
"azure.vm",
"azure.container_apps",
"azure.container_instances",
"azure.aks",
"azure.functions",
"azure.app_service",
"azure.openshift",
"azure_vm",
"azure_container_apps",
"azure_container_instances",
"azure_aks",
"azure_functions",
"azure_app_service",
"azure_openshift",
"gcp_bare_metal_solution",
"gcp_compute_engine",
"gcp_cloud_run",
"gcp_kubernetes_engine",
"gcp_cloud_functions",
"gcp_app_engine",
"gcp_openshift",
"ibm_cloud_openshift",
"oracle_cloud_compute",
"oracle_cloud_oke",
"tencent_cloud_cvm",
"tencent_cloud_eks",
"tencent_cloud_scf"
]
}
}
}