Skip to content

Commit 47fe2c0

Browse files
michaelsafyanLiudmila Molkova
michaelsafyan
and
Liudmila Molkova
authored
Propose an update to the values of 'gen_ai.system' for Google. (open-telemetry#2050)
Co-authored-by: Liudmila Molkova <[email protected]>
1 parent a36a8e0 commit 47fe2c0

File tree

7 files changed

+146
-26
lines changed

7 files changed

+146
-26
lines changed

‎.chloggen/gcp_genai_system.yaml‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
change_type: breaking
2+
component: gen-ai
3+
note: Refine the values for `gen_ai.system` related to Google's AI endpoints.
4+
issues: [1950]
5+
subtext: Enable sharing of attributes between Vertex AI and Gemini through a common prefix.

‎docs/attributes-registry/gen-ai.md‎

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -104,15 +104,22 @@ Datastore: A tool used by the agent to access and query structured or unstructur
104104
| `az.ai.openai` | Azure OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
105105
| `cohere` | Cohere | ![Development](https://img.shields.io/badge/-development-blue) |
106106
| `deepseek` | DeepSeek | ![Development](https://img.shields.io/badge/-development-blue) |
107-
| `gemini` | Gemini | ![Development](https://img.shields.io/badge/-development-blue) |
107+
| `gcp.gemini` | Gemini [6] | ![Development](https://img.shields.io/badge/-development-blue) |
108+
| `gcp.gen_ai` | Any Google generative AI endpoint [7] | ![Development](https://img.shields.io/badge/-development-blue) |
109+
| `gcp.vertex_ai` | Vertex AI [8] | ![Development](https://img.shields.io/badge/-development-blue) |
108110
| `groq` | Groq | ![Development](https://img.shields.io/badge/-development-blue) |
109111
| `ibm.watsonx.ai` | IBM Watsonx AI | ![Development](https://img.shields.io/badge/-development-blue) |
110112
| `mistral_ai` | Mistral AI | ![Development](https://img.shields.io/badge/-development-blue) |
111113
| `openai` | OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
112114
| `perplexity` | Perplexity | ![Development](https://img.shields.io/badge/-development-blue) |
113-
| `vertex_ai` | Vertex AI | ![Development](https://img.shields.io/badge/-development-blue) |
114115
| `xai` | xAI | ![Development](https://img.shields.io/badge/-development-blue) |
115116

117+
**[6]:** This refers to the 'generativelanguage.googleapis.com' endpoint. Also known as the AI Studio API. May use common attributes prefixed with 'gcp.gen_ai.'.
118+
119+
**[7]:** May be used when specific backend is unknown. May use common attributes prefixed with 'gcp.gen_ai.'.
120+
121+
**[8]:** This refers to the 'aiplatform.googleapis.com' endpoint. May use common attributes prefixed with 'gcp.gen_ai.'.
122+
116123
---
117124

118125
`gen_ai.token.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.

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

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -128,15 +128,22 @@ Instrumentations SHOULD document the list of errors they report.
128128
| `az.ai.openai` | Azure OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
129129
| `cohere` | Cohere | ![Development](https://img.shields.io/badge/-development-blue) |
130130
| `deepseek` | DeepSeek | ![Development](https://img.shields.io/badge/-development-blue) |
131-
| `gemini` | Gemini | ![Development](https://img.shields.io/badge/-development-blue) |
131+
| `gcp.gemini` | Gemini [8] | ![Development](https://img.shields.io/badge/-development-blue) |
132+
| `gcp.gen_ai` | Any Google generative AI endpoint [9] | ![Development](https://img.shields.io/badge/-development-blue) |
133+
| `gcp.vertex_ai` | Vertex AI [10] | ![Development](https://img.shields.io/badge/-development-blue) |
132134
| `groq` | Groq | ![Development](https://img.shields.io/badge/-development-blue) |
133135
| `ibm.watsonx.ai` | IBM Watsonx AI | ![Development](https://img.shields.io/badge/-development-blue) |
134136
| `mistral_ai` | Mistral AI | ![Development](https://img.shields.io/badge/-development-blue) |
135137
| `openai` | OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
136138
| `perplexity` | Perplexity | ![Development](https://img.shields.io/badge/-development-blue) |
137-
| `vertex_ai` | Vertex AI | ![Development](https://img.shields.io/badge/-development-blue) |
138139
| `xai` | xAI | ![Development](https://img.shields.io/badge/-development-blue) |
139140

141+
**[8]:** This refers to the 'generativelanguage.googleapis.com' endpoint. Also known as the AI Studio API. May use common attributes prefixed with 'gcp.gen_ai.'.
142+
143+
**[9]:** May be used when specific backend is unknown. May use common attributes prefixed with 'gcp.gen_ai.'.
144+
145+
**[10]:** This refers to the 'aiplatform.googleapis.com' endpoint. May use common attributes prefixed with 'gcp.gen_ai.'.
146+
140147
<!-- markdownlint-restore -->
141148
<!-- prettier-ignore-end -->
142149
<!-- END AUTOGENERATED TEXT -->

‎docs/gen-ai/gen-ai-events.md‎

Lines changed: 45 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -87,15 +87,22 @@ If none of these options apply, the `gen_ai.system` SHOULD be set to `_OTHER`.
8787
| `az.ai.openai` | Azure OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
8888
| `cohere` | Cohere | ![Development](https://img.shields.io/badge/-development-blue) |
8989
| `deepseek` | DeepSeek | ![Development](https://img.shields.io/badge/-development-blue) |
90-
| `gemini` | Gemini | ![Development](https://img.shields.io/badge/-development-blue) |
90+
| `gcp.gemini` | Gemini [2] | ![Development](https://img.shields.io/badge/-development-blue) |
91+
| `gcp.gen_ai` | Any Google generative AI endpoint [3] | ![Development](https://img.shields.io/badge/-development-blue) |
92+
| `gcp.vertex_ai` | Vertex AI [4] | ![Development](https://img.shields.io/badge/-development-blue) |
9193
| `groq` | Groq | ![Development](https://img.shields.io/badge/-development-blue) |
9294
| `ibm.watsonx.ai` | IBM Watsonx AI | ![Development](https://img.shields.io/badge/-development-blue) |
9395
| `mistral_ai` | Mistral AI | ![Development](https://img.shields.io/badge/-development-blue) |
9496
| `openai` | OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
9597
| `perplexity` | Perplexity | ![Development](https://img.shields.io/badge/-development-blue) |
96-
| `vertex_ai` | Vertex AI | ![Development](https://img.shields.io/badge/-development-blue) |
9798
| `xai` | xAI | ![Development](https://img.shields.io/badge/-development-blue) |
9899

100+
**[2]:** This refers to the 'generativelanguage.googleapis.com' endpoint. Also known as the AI Studio API. May use common attributes prefixed with 'gcp.gen_ai.'.
101+
102+
**[3]:** May be used when specific backend is unknown. May use common attributes prefixed with 'gcp.gen_ai.'.
103+
104+
**[4]:** This refers to the 'aiplatform.googleapis.com' endpoint. May use common attributes prefixed with 'gcp.gen_ai.'.
105+
99106
**Body fields:**
100107

101108
:warning: Body fields will be moved to complex attributes once the
@@ -155,15 +162,22 @@ If none of these options apply, the `gen_ai.system` SHOULD be set to `_OTHER`.
155162
| `az.ai.openai` | Azure OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
156163
| `cohere` | Cohere | ![Development](https://img.shields.io/badge/-development-blue) |
157164
| `deepseek` | DeepSeek | ![Development](https://img.shields.io/badge/-development-blue) |
158-
| `gemini` | Gemini | ![Development](https://img.shields.io/badge/-development-blue) |
165+
| `gcp.gemini` | Gemini [2] | ![Development](https://img.shields.io/badge/-development-blue) |
166+
| `gcp.gen_ai` | Any Google generative AI endpoint [3] | ![Development](https://img.shields.io/badge/-development-blue) |
167+
| `gcp.vertex_ai` | Vertex AI [4] | ![Development](https://img.shields.io/badge/-development-blue) |
159168
| `groq` | Groq | ![Development](https://img.shields.io/badge/-development-blue) |
160169
| `ibm.watsonx.ai` | IBM Watsonx AI | ![Development](https://img.shields.io/badge/-development-blue) |
161170
| `mistral_ai` | Mistral AI | ![Development](https://img.shields.io/badge/-development-blue) |
162171
| `openai` | OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
163172
| `perplexity` | Perplexity | ![Development](https://img.shields.io/badge/-development-blue) |
164-
| `vertex_ai` | Vertex AI | ![Development](https://img.shields.io/badge/-development-blue) |
165173
| `xai` | xAI | ![Development](https://img.shields.io/badge/-development-blue) |
166174

175+
**[2]:** This refers to the 'generativelanguage.googleapis.com' endpoint. Also known as the AI Studio API. May use common attributes prefixed with 'gcp.gen_ai.'.
176+
177+
**[3]:** May be used when specific backend is unknown. May use common attributes prefixed with 'gcp.gen_ai.'.
178+
179+
**[4]:** This refers to the 'aiplatform.googleapis.com' endpoint. May use common attributes prefixed with 'gcp.gen_ai.'.
180+
167181
**Body fields:**
168182

169183
:warning: Body fields will be moved to complex attributes once the
@@ -223,15 +237,22 @@ If none of these options apply, the `gen_ai.system` SHOULD be set to `_OTHER`.
223237
| `az.ai.openai` | Azure OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
224238
| `cohere` | Cohere | ![Development](https://img.shields.io/badge/-development-blue) |
225239
| `deepseek` | DeepSeek | ![Development](https://img.shields.io/badge/-development-blue) |
226-
| `gemini` | Gemini | ![Development](https://img.shields.io/badge/-development-blue) |
240+
| `gcp.gemini` | Gemini [2] | ![Development](https://img.shields.io/badge/-development-blue) |
241+
| `gcp.gen_ai` | Any Google generative AI endpoint [3] | ![Development](https://img.shields.io/badge/-development-blue) |
242+
| `gcp.vertex_ai` | Vertex AI [4] | ![Development](https://img.shields.io/badge/-development-blue) |
227243
| `groq` | Groq | ![Development](https://img.shields.io/badge/-development-blue) |
228244
| `ibm.watsonx.ai` | IBM Watsonx AI | ![Development](https://img.shields.io/badge/-development-blue) |
229245
| `mistral_ai` | Mistral AI | ![Development](https://img.shields.io/badge/-development-blue) |
230246
| `openai` | OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
231247
| `perplexity` | Perplexity | ![Development](https://img.shields.io/badge/-development-blue) |
232-
| `vertex_ai` | Vertex AI | ![Development](https://img.shields.io/badge/-development-blue) |
233248
| `xai` | xAI | ![Development](https://img.shields.io/badge/-development-blue) |
234249

250+
**[2]:** This refers to the 'generativelanguage.googleapis.com' endpoint. Also known as the AI Studio API. May use common attributes prefixed with 'gcp.gen_ai.'.
251+
252+
**[3]:** May be used when specific backend is unknown. May use common attributes prefixed with 'gcp.gen_ai.'.
253+
254+
**[4]:** This refers to the 'aiplatform.googleapis.com' endpoint. May use common attributes prefixed with 'gcp.gen_ai.'.
255+
235256
**Body fields:**
236257

237258
:warning: Body fields will be moved to complex attributes once the
@@ -306,15 +327,22 @@ If none of these options apply, the `gen_ai.system` SHOULD be set to `_OTHER`.
306327
| `az.ai.openai` | Azure OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
307328
| `cohere` | Cohere | ![Development](https://img.shields.io/badge/-development-blue) |
308329
| `deepseek` | DeepSeek | ![Development](https://img.shields.io/badge/-development-blue) |
309-
| `gemini` | Gemini | ![Development](https://img.shields.io/badge/-development-blue) |
330+
| `gcp.gemini` | Gemini [2] | ![Development](https://img.shields.io/badge/-development-blue) |
331+
| `gcp.gen_ai` | Any Google generative AI endpoint [3] | ![Development](https://img.shields.io/badge/-development-blue) |
332+
| `gcp.vertex_ai` | Vertex AI [4] | ![Development](https://img.shields.io/badge/-development-blue) |
310333
| `groq` | Groq | ![Development](https://img.shields.io/badge/-development-blue) |
311334
| `ibm.watsonx.ai` | IBM Watsonx AI | ![Development](https://img.shields.io/badge/-development-blue) |
312335
| `mistral_ai` | Mistral AI | ![Development](https://img.shields.io/badge/-development-blue) |
313336
| `openai` | OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
314337
| `perplexity` | Perplexity | ![Development](https://img.shields.io/badge/-development-blue) |
315-
| `vertex_ai` | Vertex AI | ![Development](https://img.shields.io/badge/-development-blue) |
316338
| `xai` | xAI | ![Development](https://img.shields.io/badge/-development-blue) |
317339

340+
**[2]:** This refers to the 'generativelanguage.googleapis.com' endpoint. Also known as the AI Studio API. May use common attributes prefixed with 'gcp.gen_ai.'.
341+
342+
**[3]:** May be used when specific backend is unknown. May use common attributes prefixed with 'gcp.gen_ai.'.
343+
344+
**[4]:** This refers to the 'aiplatform.googleapis.com' endpoint. May use common attributes prefixed with 'gcp.gen_ai.'.
345+
318346
**Body fields:**
319347

320348
:warning: Body fields will be moved to complex attributes once the
@@ -375,15 +403,22 @@ If none of these options apply, the `gen_ai.system` SHOULD be set to `_OTHER`.
375403
| `az.ai.openai` | Azure OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
376404
| `cohere` | Cohere | ![Development](https://img.shields.io/badge/-development-blue) |
377405
| `deepseek` | DeepSeek | ![Development](https://img.shields.io/badge/-development-blue) |
378-
| `gemini` | Gemini | ![Development](https://img.shields.io/badge/-development-blue) |
406+
| `gcp.gemini` | Gemini [2] | ![Development](https://img.shields.io/badge/-development-blue) |
407+
| `gcp.gen_ai` | Any Google generative AI endpoint [3] | ![Development](https://img.shields.io/badge/-development-blue) |
408+
| `gcp.vertex_ai` | Vertex AI [4] | ![Development](https://img.shields.io/badge/-development-blue) |
379409
| `groq` | Groq | ![Development](https://img.shields.io/badge/-development-blue) |
380410
| `ibm.watsonx.ai` | IBM Watsonx AI | ![Development](https://img.shields.io/badge/-development-blue) |
381411
| `mistral_ai` | Mistral AI | ![Development](https://img.shields.io/badge/-development-blue) |
382412
| `openai` | OpenAI | ![Development](https://img.shields.io/badge/-development-blue) |
383413
| `perplexity` | Perplexity | ![Development](https://img.shields.io/badge/-development-blue) |
384-
| `vertex_ai` | Vertex AI | ![Development](https://img.shields.io/badge/-development-blue) |
385414
| `xai` | xAI | ![Development](https://img.shields.io/badge/-development-blue) |
386415

416+
**[2]:** This refers to the 'generativelanguage.googleapis.com' endpoint. Also known as the AI Studio API. May use common attributes prefixed with 'gcp.gen_ai.'.
417+
418+
**[3]:** May be used when specific backend is unknown. May use common attributes prefixed with 'gcp.gen_ai.'.
419+
420+
**[4]:** This refers to the 'aiplatform.googleapis.com' endpoint. May use common attributes prefixed with 'gcp.gen_ai.'.
421+
387422
**Body fields:**
388423

389424
:warning: Body fields will be moved to complex attributes once the

0 commit comments

Comments
 (0)