Makes all span/metric/event/resource groups id meaningful (#1512)

docs/azure/events.md

@@ -7,7 +7,7 @@ Resource Log events.
 
 ## Azure Resource Log
 
-<!-- semconv az.resource.log -->
+<!-- semconv event.az.resource.log -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/cloud-providers/aws-sdk.md

@@ -24,7 +24,7 @@ The span name MUST be of the format `Service.Operation` as per the AWS HTTP API,
 with the naming guidelines for RPC client spans.
 
 <!-- prettier-ignore-start -->
-<!-- semconv aws -->
+<!-- semconv span.aws.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/cassandra.md

@@ -12,7 +12,7 @@ The Semantic Conventions for [Cassandra](https://cassandra.apache.org/) extend a
 
 ## Attributes
 
-<!-- semconv db.cassandra -->
+<!-- semconv span.db.cassandra.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/cosmosdb.md

@@ -30,7 +30,7 @@ extend and override the [Database Semantic Conventions](database-spans.md).
 
 Cosmos DB instrumentation includes call-level (public API) surface spans and network spans. Depending on the connection mode (Gateway or Direct), network-level spans may also be created.
 
-<!-- semconv db.cosmosdb -->
+<!-- semconv span.db.cosmosdb.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/couchdb.md

@@ -12,7 +12,7 @@ The Semantic Conventions for [CouchDB](https://couchdb.apache.org/) extend and o
 
 ## Attributes
 
-<!-- semconv db.couchdb -->
+<!-- semconv span.db.couchdb.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/database-spans.md

@@ -89,7 +89,7 @@ For example, for an operation describing SQL query on an anonymous table like `S
 
 These attributes will usually be the same for all operations performed over the same database connection.
 
-<!-- semconv db -->
+<!-- semconv span.db.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/dynamodb.md

@@ -13,7 +13,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.BatchGetItem
 
-<!-- semconv dynamodb.batchgetitem -->
+<!-- semconv span.dynamodb.batchgetitem.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -50,7 +50,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.BatchWriteItem
 
-<!-- semconv dynamodb.batchwriteitem -->
+<!-- semconv span.dynamodb.batchwriteitem.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -88,7 +88,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.CreateTable
 
-<!-- semconv dynamodb.createtable -->
+<!-- semconv span.dynamodb.createtable.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -130,7 +130,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.DeleteItem
 
-<!-- semconv dynamodb.deleteitem -->
+<!-- semconv span.dynamodb.deleteitem.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -168,7 +168,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.DeleteTable
 
-<!-- semconv dynamodb.deletetable -->
+<!-- semconv span.dynamodb.deletetable.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -204,7 +204,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.DescribeTable
 
-<!-- semconv dynamodb.describetable -->
+<!-- semconv span.dynamodb.describetable.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -240,7 +240,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.GetItem
 
-<!-- semconv dynamodb.getitem -->
+<!-- semconv span.dynamodb.getitem.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -279,7 +279,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.ListTables
 
-<!-- semconv dynamodb.listtables -->
+<!-- semconv span.dynamodb.listtables.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -317,7 +317,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.PutItem
 
-<!-- semconv dynamodb.putitem -->
+<!-- semconv span.dynamodb.putitem.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -355,7 +355,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.Query
 
-<!-- semconv dynamodb.query -->
+<!-- semconv span.dynamodb.query.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -399,7 +399,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.Scan
 
-<!-- semconv dynamodb.scan -->
+<!-- semconv span.dynamodb.scan.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -446,7 +446,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.UpdateItem
 
-<!-- semconv dynamodb.updateitem -->
+<!-- semconv span.dynamodb.updateitem.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -484,7 +484,7 @@ The Semantic Conventions for [AWS DynamoDB](https://aws.amazon.com/dynamodb/) ex
 
 ## DynamoDB.UpdateTable
 
-<!-- semconv dynamodb.updatetable -->
+<!-- semconv span.dynamodb.updatetable.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/elasticsearch.md

@@ -16,7 +16,7 @@ The **span name** follows the [general database span name guidelines](database-s
 
 ## Attributes
 
-<!-- semconv db.elasticsearch -->
+<!-- semconv span.db.elasticsearch.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/hbase.md

@@ -12,7 +12,7 @@ The Semantic Conventions for [HBase](https://hbase.apache.org/) extend and overr
 
 ## Attributes
 
-<!-- semconv db.hbase -->
+<!-- semconv span.db.hbase.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/mariadb.md

@@ -12,7 +12,7 @@ The Semantic Conventions for *MariaDB* extend and override the [Database Semanti
 
 ## Attributes
 
-<!-- semconv db.mariadb -->
+<!-- semconv span.db.mariadb.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/mongodb.md

@@ -12,7 +12,7 @@ The Semantic Conventions for [MongoDB](https://www.mongodb.com/) extend and over
 
 ## Attributes
 
-<!-- semconv db.mongodb -->
+<!-- semconv span.db.mongodb.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/mssql.md

@@ -12,7 +12,7 @@ The Semantic Conventions for the *Microsoft SQL Server* extend and override the
 
 ## Attributes
 
-<!-- semconv db.mssql -->
+<!-- semconv span.db.mssql.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/mysql.md

@@ -12,7 +12,7 @@ The Semantic Conventions for *MySQL* extend and override the [Database Semantic
 
 ## Attributes
 
-<!-- semconv db.mysql -->
+<!-- semconv span.db.mysql.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/postgresql.md

@@ -12,7 +12,7 @@ The Semantic Conventions for *PostgreSQL* extend and override the [Database Sema
 
 ## Attributes
 
-<!-- semconv db.postgresql -->
+<!-- semconv span.db.postgresql.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/redis.md

@@ -12,7 +12,7 @@ The Semantic Conventions for [Redis](https://redis.com/) extend and override the
 
 ## Attributes
 
-<!-- semconv db.redis -->
+<!-- semconv span.db.redis.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/database/sql.md

@@ -36,7 +36,7 @@ Instrumentations applied to generic SQL drivers SHOULD adhere to SQL semantic co
 
 ## Attributes
 
-<!-- semconv db.sql -->
+<!-- semconv span.db.sql.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/exceptions/exceptions-spans.md

@@ -40,7 +40,7 @@ try {
 
 ## Exception event
 
-<!-- semconv trace-exception -->
+<!-- semconv event.exception -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/faas/aws-lambda.md

@@ -44,7 +44,7 @@ The following attributes SHOULD be set:
 Also consider setting other attributes of the [`faas` resource][faasres] and [trace][faas] conventions
 and the [cloud resource conventions][cloud]. The following AWS Lambda-specific attribute MAY also be set:
 
-<!-- semconv aws.lambda -->
+<!-- semconv span.aws.lambda -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/faas/faas-spans.md

@@ -38,7 +38,7 @@ Span `name` should be set to the function name being executed. Depending on the
 
 If Spans following this convention are produced, a Resource of type `faas` MUST exist following the [Resource semantic convention](../resource/faas.md).
 
-<!-- semconv faas_span -->
+<!-- semconv span.faas -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -129,7 +129,7 @@ For incoming FaaS spans, the span kind SHOULD be `SERVER`.
 
 ### Incoming FaaS Span attributes
 
-<!-- semconv faas_span.in -->
+<!-- semconv span.faas.server -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -188,7 +188,7 @@ The values reported by the client for the attributes listed below SHOULD be equa
 the corresponding [FaaS resource attributes][] and [Cloud resource attributes][],
 which the invoked FaaS instance reports about itself, if it's instrumented.
 
-<!-- semconv faas_span.out -->
+<!-- semconv span.faas.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -236,7 +236,7 @@ This section describes how to handle the span creation and additional attributes
 A datasource function is triggered as a response to some data source operation such as a database or filesystem read/write.
 FaaS instrumentations that produce `faas` spans with trigger `datasource`, SHOULD use the following set of attributes.
 
-<!-- semconv faas_span.datasource -->
+<!-- semconv span.faas.datasource -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -279,7 +279,7 @@ This way, it is possible to correlate each individual message with its invocatio
 
 A function is scheduled to be executed regularly. The following additional attributes are recommended.
 
-<!-- semconv faas_span.timer -->
+<!-- semconv span.faas.timer -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/feature-flags/feature-flags-logs.md

@@ -37,7 +37,7 @@ context.
 The table below indicates which attributes should be added to the
 [LogRecord](https://github.com/open-telemetry/opentelemetry-specification/tree/v1.37.0/specification/logs/data-model.md#log-and-event-record-definition) and their types.
 
-<!-- semconv log-feature_flag -->
+<!-- semconv event.feature_flag -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -48,11 +48,11 @@ The table below indicates which attributes should be added to the
 
 The event name MUST be `feature_flag`.
 
-This event describes feature flag evaluation representation on a Log Record.
+This event describes feature flag evaluation.
 
 | Attribute  | Type | Description  | Examples  | [Requirement Level](https://opentelemetry.io/docs/specs/semconv/general/attribute-requirement-level/) | Stability |
 |---|---|---|---|---|---|
-| [`feature_flag.key`](/docs/attributes-registry/feature-flag.md) | string | The unique identifier of the feature flag. | `logo-color` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
+| [`feature_flag.key`](/docs/attributes-registry/feature-flag.md) | string | The unique identifier of the feature flag. | `logo-color` | `Required` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 | [`feature_flag.provider_name`](/docs/attributes-registry/feature-flag.md) | string | The name of the service provider that performs the flag evaluation. | `Flag Manager` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 | [`feature_flag.variant`](/docs/attributes-registry/feature-flag.md) | string | SHOULD be a semantic identifier for a value. If one is unavailable, a stringified version of the value can be used. [1] | `red`; `true`; `on` | `Recommended` | ![Experimental](https://img.shields.io/badge/-experimental-blue) |
 

docs/feature-flags/feature-flags-spans.md

@@ -44,7 +44,7 @@ A flag evaluation SHOULD be recorded as an Event on the span during which it occ
 
 ### Evaluation event
 
-<!-- semconv feature_flag -->
+<!-- semconv event.feature_flag -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/gen-ai/gen-ai-spans.md

@@ -34,7 +34,7 @@ Semantic conventions for individual GenAI systems and frameworks MAY specify dif
 
 These attributes track input data and metadata for a request to an GenAI model. Each attribute represents a concept that is common to most Generative AI clients.
 
-<!-- semconv trace.gen_ai.client.span -->
+<!-- semconv span.gen_ai.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/gen-ai/openai.md

@@ -27,7 +27,7 @@ for [Gen AI Spans](gen-ai-spans.md) and [Gen AI Metrics](gen-ai-metrics.md).
 These attributes track input data and metadata for a request to an OpenAI model. The attributes include general Generative AI
 attributes and ones specific the OpenAI.
 
-<!-- semconv trace.gen_ai.openai.client -->
+<!-- semconv span.gen_ai.openai.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/graphql/graphql-spans.md

@@ -22,7 +22,7 @@ the span SHOULD be named `GraphQL Operation`.
 > span name following `{graphql.operation.type} {graphql.operation.name}` format
 > when `graphql.operation.name` is available.
 
-<!-- semconv graphql -->
+<!-- semconv span.graphql.server -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->

docs/http/http-spans.md

@@ -131,7 +131,7 @@ This span type represents an outbound HTTP request. There are two ways this can
 
 For an HTTP client span, `SpanKind` MUST be `CLIENT`.
 
-<!-- semconv trace.http.client -->
+<!-- semconv span.http.client -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->
@@ -369,7 +369,7 @@ This span type represents an inbound HTTP request.
 
 For an HTTP server span, `SpanKind` MUST be `SERVER`.
 
-<!-- semconv trace.http.server -->
+<!-- semconv span.http.server -->
 <!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
 <!-- see templates/registry/markdown/snippet.md.j2 -->
 <!-- prettier-ignore-start -->