registry too

open-telemetry · May 10, 2024 · d4a50cf · d4a50cf
1 parent a97eb9c
commit d4a50cf
Show file tree

Hide file tree

Showing 3 changed files with 3 additions and 3 deletions.
diff --git a/docs/attributes-registry/db.md b/docs/attributes-registry/db.md
@@ -40,7 +40,7 @@ It is RECOMMENDED to capture the value as provided by the application without at
 **[4]:** Query parameters should only be captured when `db.query.text` is parameterized with placeholders.
 If a parameter has no name and instead is referenced only by index, then `<key>` SHOULD be the 0-based index.
 
-**[5]:** The actual DBMS may differ from the one known by the client. For example, when using PostgreSQL client library to connect to a CockroachDB, the `db.system` SHOULD be set to `postgresql`.
+**[5]:** The actual DBMS may differ from the one known by the client. For example, when using PostgreSQL client library to connect to a CockroachDB, the `db.system` is set to `postgresql` based on the instrumentation best knowledge.
 
 `db.client.connections.state` 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.
 

diff --git a/docs/attributes-registry/gen-ai.md b/docs/attributes-registry/gen-ai.md
@@ -27,7 +27,7 @@ This document defines the attributes used to describe telemetry in the context o
 
 **[1]:** It's RECOMMENDED to format completions as JSON string matching [OpenAI messages format](https://platform.openai.com/docs/guides/text-generation)
 **[2]:** It's RECOMMENDED to format prompts as JSON string matching [OpenAI messages format](https://platform.openai.com/docs/guides/text-generation)
-**[3]:** The actual GenAI product may differ from the one known by the client. For example, when using OpenAI client library to communicate with Mistral, the `gen_ai.system` SHOULD be set to `openai`.
+**[3]:** The actual GenAI product may differ from the one known by the client. For example, when using OpenAI client library to communicate with Mistral, the `gen_ai.system` is set to `openai` based on the instrumentation best knowledge.
 
 `gen_ai.system` 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.
 

diff --git a/docs/attributes-registry/messaging.md b/docs/attributes-registry/messaging.md
@@ -55,7 +55,7 @@ body size should be used.
 size should be used.
 
 **[7]:** If a custom value is used, it MUST be of low cardinality.
-**[8]:** The actual messaging system may differ from the one known by the client. For example, when using Kafka client library to connect to a Azure Event Hubs, the `messaging.system` SHOULD be set to `kafka`.
+**[8]:** The actual messaging system may differ from the one known by the client. For example, when using Kafka client library to communicate with Azure Event Hubs, the `messaging.system` is set to `kafka` based on the instrumentation best knowledge.
 
 `messaging.operation.type` 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.