feedback

semantic_conventions/resource/cloud_provider/gcp/cloud_run.yaml

@@ -8,9 +8,11 @@ groups:
       - id: job.execution
         type: string
         brief: >
-          The
+          The name of the Cloud Run
           [execution](https://cloud.google.com/run/docs/managing/job-executions)
-          of the job.
+          being run for the Job, as set by the
+          [`CLOUD_RUN_EXECUTION`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars)
+          environment variable.
         examples: ['job-name-xxxx', 'sample-job-mdw84']
       - id: job.task_index
         type: int

specification/resource/semantic_conventions/cloud_provider/gcp/cloud_run.md

@@ -1,12 +1,14 @@
 # Google Cloud Run
 
+These conventions are recommended for resources running on Cloud Run.
+
 **Type:** `gcp.cloud_run`
 
 **Description:** Resource attributes for GCE instances.
 
 <!-- semconv gcp.cloud_run -->
 | Attribute  | Type | Description  | Examples  | Requirement Level |
 |---|---|---|---|---|
-| `gcp.cloud_run.job.execution` | string | The [execution](https://cloud.google.com/run/docs/managing/job-executions) of the job. | `job-name-xxxx`; `sample-job-mdw84` | Recommended |
+| `gcp.cloud_run.job.execution` | string | The name of the Cloud Run [execution](https://cloud.google.com/run/docs/managing/job-executions) being run for the Job, as set by the [`CLOUD_RUN_EXECUTION`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `job-name-xxxx`; `sample-job-mdw84` | Recommended |
 | `gcp.cloud_run.job.task_index` | int | The index for a task within an execution as provided by the [`CLOUD_RUN_TASK_INDEX`](https://cloud.google.com/run/docs/container-contract#jobs-env-vars) environment variable. | `0`; `1` | Recommended |
 <!-- endsemconv -->