Description
# OpenTelemetry VertexAI Instrumentation <a href="https://pypi.org/project/opentelemetry-instrumentation-vertexai/"> <img src="https://badge.fury.io/py/opentelemetry-instrumentation-vertexai.svg"> </a> This library allows tracing VertexAI prompts and completions sent with the official [VertexAI library](https://github.com/googleapis/python-aiplatform). ## Installation ```bash pip install opentelemetry-instrumentation-vertexai ``` ## Example usage ```python from opentelemetry.instrumentation.vertexai import VertexAIInstrumentor VertexAIInstrumentor().instrument() ``` ## Privacy **By default, this instrumentation logs prompts, completions, and embeddings to span attributes**. This gives you a clear visibility into how your LLM application is working, and can make it easy to debug and evaluate the quality of the outputs. However, you may want to disable this logging for privacy reasons, as they may contain highly sensitive data from your users. You may also simply want to reduce the size of your traces. To disable logging, set the `TRACELOOP_TRACE_CONTENT` environment variable to `false`. ```bash TRACELOOP_TRACE_CONTENT=false ```
Release History
| Version | Changes | Urgency | Date |
|---|---|---|---|
| 0.60.0 | Imported from PyPI (0.60.0) | Low | 4/21/2026 |
| 0.59.2 | ## v0.59.2 (2026-04-16) ### Fix - **traceloop-sdk**: avoid calling async json methods in JSONEncoder (#3968) [main a9f5e2d3] bump: version 0.59.1 → 0.59.2 64 files changed, 69 insertions(+), 63 deletions(-) | High | 4/16/2026 |
| 0.59.1 | ## v0.59.1 (2026-04-15) ### Fix - **langchain**: detach existing SpanHolder token before overwrite in _create_llm_span (#3958) [main 25189adc] bump: version 0.59.0 → 0.59.1 64 files changed, 69 insertions(+), 63 deletions(-) | High | 4/15/2026 |
| 0.59.0 | ## v0.59.0 (2026-04-13) ### Feat - **traceloop-sdk**: Add guardrails (#3649) [main b80f109b] bump: version 0.58.1 → 0.59.0 64 files changed, 69 insertions(+), 63 deletions(-) | Medium | 4/13/2026 |
| 0.58.1 | ## v0.58.1 (2026-04-12) ### Fix - **evaluators**: update route api (#3977) [main 21d89e4f] bump: version 0.58.0 → 0.58.1 64 files changed, 69 insertions(+), 63 deletions(-) | Medium | 4/12/2026 |
| 0.58.0 | ## v0.58.0 (2026-04-09) ### Feat - **gemini**: migrate google-generativeai to latest OTel GenAI semantic conventions (#3840) [main 786d49f9] bump: version 0.57.0 → 0.58.0 64 files changed, 69 insertions(+), 63 deletions(-) | Medium | 4/9/2026 |
| 0.57.0 | ## v0.57.0 (2026-03-30) ### Feat - **bedrock**: Instrumentation adjustment for Otel GenAI semconv support (#3845) [main 0a258034] bump: version 0.56.1 → 0.57.0 64 files changed, 69 insertions(+), 63 deletions(-) | Medium | 3/30/2026 |
| 0.56.1 | ## v0.56.1 (2026-03-30) ### Fix - **SDK + Agno**: set gen_ai.tool.name on @tool() decorator and Agno tool spans (#3904) [main bb95db9d] bump: version 0.56.0 → 0.56.1 64 files changed, 69 insertions(+), 63 deletions(-) | Medium | 3/30/2026 |
| 0.56.0 | ## v0.56.0 (2026-03-30) ### Feat - **crewai**: trigger version bump for GenAI semconv compliance (#3903) [main 78d364b9] bump: version 0.55.0 → 0.56.0 64 files changed, 69 insertions(+), 63 deletions(-) | Medium | 3/30/2026 |
| 0.55.0 | ## v0.55.0 (2026-03-29) ### Feat - **open-ai**: instrumentation to support OTel GenAI Semantic Conventions 0.5.0 (#3844) - **langchain**: new semnconv langchain (#3900) [main 1cd9f8e5] bump: version 0.54.0 → 0.55.0 64 files changed, 70 insertions(+), 63 deletions(-) | Medium | 3/29/2026 |
| 0.54.0 | ## v0.54.0 (2026-03-29) ### Feat - **anthropic**: conform instrumentation to OTel GenAI semantic conventions (#3835) [main 73bd236a] bump: version 0.53.4 → 0.54.0 64 files changed, 69 insertions(+), 63 deletions(-) | Medium | 3/29/2026 |
| 0.53.4 | ## v0.53.4 (2026-03-29) ### Fix - **release**: google_generativeai path in .cz.toml & trigger version bump in all instrumentations (#3896) - **llamaindex**: handle None content in StructuredLLM responses (#3513) (#3665) - **semconv**: migrating span attributes to OTel gen_ai convention (#3809) [main f58d3897] bump: version 0.53.3 → 0.53.4 64 files changed, 71 insertions(+), 63 deletions(-) | Medium | 3/29/2026 |
| 0.53.3 | ## v0.53.3 (2026-03-19) ### Fix - **langchain**: release and use semconv 0.4.16 version (#3829) [main ec78f27a] bump: version 0.53.2 → 0.53.3 64 files changed, 69 insertions(+), 63 deletions(-) | Low | 3/19/2026 |
| 0.53.2 | ## v0.53.2 (2026-03-18) ### Fix - use GITHUB_TOKEN for release creation to resolve 403 error (#3821) [main 9be7eea1] bump: version 0.53.1 → 0.53.2 64 files changed, 69 insertions(+), 63 deletions(-) | Low | 3/18/2026 |
| 0.53.0 | ## v0.53.0 (2026-03-04) ### Feat - **langchain**: add OpenTelemetry GenAI semantic conventions (#3673) ### Fix - **semconv**: revert deleted semconv attributes (#3750) - **pinecone**: instrument pinecone package instead of deprecated pinecone-client (#3733) - **langchain**: support non-ascii characters to support i18n (#3734) [main 0b9c603b] bump: version 0.52.6 → 0.53.0 64 files changed, 75 insertions(+), 63 deletions(-) | Low | 3/4/2026 |
| 0.52.6 | ## v0.52.6 (2026-02-26) ### Fix - **dataset**: Add versions to dataset metadata (#3732) - **qdrant**: support all versions of qdrant package (#3500) [main a78de643] bump: version 0.52.5 → 0.52.6 64 files changed, 70 insertions(+), 63 deletions(-) | Low | 2/26/2026 |
| 0.52.5 | ## v0.52.5 (2026-02-23) ### Fix - **traceloop-sdk**: Add evaluator config to the evaluator validator (#3706) - **anthropic**: restore accidentally lost cache tokens attributes (#3648) [main c2974c94] bump: version 0.52.4 → 0.52.5 64 files changed, 70 insertions(+), 63 deletions(-) | Low | 2/23/2026 |
| 0.52.4 | ## v0.52.4 (2026-02-19) ### Fix - **openai-agents**: fix realtime session event handling for prompts, completions, and usage (#3688) - preserve return values for RealtimeSession context manager methods (#3681) - **openai-agents**: add functools.wraps to dont_throw decorator (#3687) [main ae9c348b] bump: version 0.52.3 → 0.52.4 64 files changed, 71 insertions(+), 63 deletions(-) | Low | 2/19/2026 |
| 0.52.3 | ## v0.52.3 (2026-02-10) ### Fix - **openai-agents**: add clear flag to support two instrumentation modes (#3489) [main d4d4269a] bump: version 0.52.2 → 0.52.3 64 files changed, 69 insertions(+), 63 deletions(-) | Low | 2/10/2026 |
| 0.52.2 | ## v0.52.2 (2026-02-08) ### Fix - **traceloop-sdk**: Add conversation decorator (#3659) - **traceloop-sdk**: Add endpoint_is_traceloop attribute (#3650) [main 8830cd78] bump: version 0.52.1 → 0.52.2 64 files changed, 70 insertions(+), 63 deletions(-) | Low | 2/8/2026 |
| 0.52.1 | ## v0.52.1 (2026-02-02) ### Fix - **voyageai**: add to commitizen to bump on release (#3660) [main c8205f5c] bump: version 0.52.0 → 0.52.1 64 files changed, 69 insertions(+), 63 deletions(-) | Low | 2/2/2026 |
| 0.52.0 | ## v0.52.0 (2026-02-02) ### Feat - **voyage-ai**: add voyage-ai instrumentation (#3653) ### Fix - **openai-agents**: apply content tracing flag to content (#3487) - **traceloop-sdk**: Align evals output schema (#3643) [main 5f597c4b] bump: version 0.51.1 → 0.52.0 62 files changed, 72 insertions(+), 61 deletions(-) | Low | 2/2/2026 |
| 0.51.1 | ## v0.51.1 (2026-01-26) ### Fix - **openai-agents**: add support for realtime (#3533) [main ad330e3f] bump: version 0.51.0 → 0.51.1 62 files changed, 67 insertions(+), 61 deletions(-) | Low | 1/26/2026 |
| 0.51.0 | ## v0.51.0 (2026-01-20) ### Feat - **google-generativeai**: Add metrics support (#3506) ### Fix - **traceloop-sdk**: Add csv and json support to experiment (#3537) - **evals**: evals API supports input + config, generate mbt functions (#3534) - **langchain**: correct unknown role in completion spans (#3532) - **evals**: auto generate evals (#3529) - **tracing**: Add association property (#3524) - **openai-agents**: optional import of optional deps (#3488) [main 73913ea3] bump: version 0.50. | Low | 1/20/2026 |
| 0.50.1 | ## v0.50.1 (2025-12-16) ### Fix - **sample-app**: lint fix (#3522) [main 9a487362] bump: version 0.50.0 → 0.50.1 62 files changed, 67 insertions(+), 61 deletions(-) | Low | 12/16/2025 |
| 0.50.0 | ## v0.50.0 (2025-12-15) ### Feat - **guardrail**: Add guardrail decorator (#3521) [main edb2fb11] bump: version 0.49.8 → 0.50.0 62 files changed, 67 insertions(+), 61 deletions(-) | Low | 12/15/2025 |
| 0.49.8 | ## v0.49.8 (2025-12-11) ### Fix - **openai**: add support for realtime api (websockets) (#3511) - **ollama**: support Older Version Ollama (#3501) [main 9d8cef6b] bump: version 0.49.7 → 0.49.8 62 files changed, 68 insertions(+), 61 deletions(-) | Low | 12/11/2025 |
| 0.49.7 | ## v0.49.7 (2025-12-08) ### Fix - **exp**: Add a real agent example (#3507) - **evals**: Add agent evaluators to made by traceloop (#3505) - **exp**: Add made by traceloop evaluators (#3503) - **traceloop-sdk**: Fixes gRPC exporter initialisation with insecure OTLP (#3481) [main 53920e36] bump: version 0.49.6 → 0.49.7 62 files changed, 70 insertions(+), 61 deletions(-) | Low | 12/8/2025 |
| 0.49.6 | ## v0.49.6 (2025-12-01) ### Fix - **agno**: add streaming support for Agent.run() and Agent.arun() (#3483) [main c8c1553a] bump: version 0.49.5 → 0.49.6 62 files changed, 67 insertions(+), 61 deletions(-) | Low | 12/1/2025 |
| 0.49.5 | ## v0.49.5 (2025-11-27) ### Fix - **openai**: responses instrumentation broken traces for async streaming (#3475) - **mcp**: remove faulty logic of trying to deduce HTTP errors (#3477) [main bc97e56f] bump: version 0.49.4 → 0.49.5 62 files changed, 68 insertions(+), 61 deletions(-) | Low | 11/27/2025 |
| 0.49.4 | ## v0.49.4 (2025-11-27) ### Fix - **exp**: Add run in github experiment (#3459) [main a47c4e59] bump: version 0.49.3 → 0.49.4 62 files changed, 67 insertions(+), 61 deletions(-) | Low | 11/27/2025 |
| 0.49.3 | ## v0.49.3 (2025-11-26) ### Fix - **openai**: recognize NOT_GIVEN and Omit (#3473) - **dataset**: add support for file cells in datasets with upload and external URL linking capabilities (#3462) - **openai**: report request attributes in responses API instrumentation (#3471) - **sdk**: crewai tracing provider conflict (#3470) - **sdk**: watsonx warning on initialization (#3469) - **traceloop-sdk**: add type-checking support with mypy (#3463) [main e63ebe35] bump: version 0.49.2 → 0.49.3 62 f | Low | 11/26/2025 |
| 0.49.2 | ## v0.49.2 (2025-11-25) ### Fix - **sdk**: remove posthog (#3466) [main 120b562f] bump: version 0.49.1 → 0.49.2 62 files changed, 67 insertions(+), 61 deletions(-) | Low | 11/25/2025 |
| 0.49.1 | ## v0.49.1 (2025-11-24) ### Fix - **langchain**: allow configuration of metadata key prefix (#3367) - **openai**: record service_tier attribute (#3458) [main ba1aa4c6] bump: version 0.49.0 → 0.49.1 62 files changed, 68 insertions(+), 61 deletions(-) | Low | 11/24/2025 |
| 0.49.0 | ## v0.49.0 (2025-11-23) ### Feat - **agno**: add instrumentation for agno framework (#3452) [main f36e5a77] bump: version 0.48.2 → 0.49.0 62 files changed, 67 insertions(+), 61 deletions(-) | Low | 11/23/2025 |
| 0.48.2 | ## v0.48.2 (2025-11-23) ### Fix - add structured outputs schema logging for Anthropic and Gemini (#3454) - **openai**: use SpanAttributes instead of GenAIAttributes for cache token attributes (#3442) - migrate from events api to log records for otel 1.37.0+ compatibility (#3453) [main e97e49e3] bump: version 0.48.1 → 0.48.2 60 files changed, 67 insertions(+), 59 deletions(-) | Low | 11/23/2025 |
| 0.48.1 | ## v0.48.1 (2025-11-17) ### Fix - **openai**: safe handle None tools value in responses api (#3447) - **mcp**: move exporter dependency to dev and test environment (#3445) [main da7ec49b] bump: version 0.48.0 → 0.48.1 60 files changed, 66 insertions(+), 59 deletions(-) | Low | 11/17/2025 |
| 0.48.0 | ## v0.48.0 (2025-11-11) ### Feat - **instrumentation**: updated GenAI attributes to use OTel's (#3138) ### Fix - **openai**: add streaming support for responses.create() api (#3437) - **bedrock**: handle non-text contentBlockDelta events in converse_stream (#3404) - **openai-agents**: span attribute handling for tool calls and results (#3422) - **watson**: collect prompt content and set as span attribute (#3417) [main 8b91ed74] bump: version 0.47.5 → 0.48.0 60 files changed, 72 insertions( | Low | 11/11/2025 |
| 0.47.5 | ## v0.47.5 (2025-10-24) ### Fix - **google-genai**: make streaming responses work (again) (#3421) - **langchain**: changed dictionary access from spans[run_id] to spans.get(run_id) (#3403) [main a693d396] bump: version 0.47.4 → 0.47.5 60 files changed, 66 insertions(+), 59 deletions(-) | Low | 10/24/2025 |
| 0.47.4 | ## v0.47.4 (2025-10-22) ### Fix - **fastmcp**: Remote MCP instrumentation (#3419) [main c144774b] bump: version 0.47.3 → 0.47.4 60 files changed, 65 insertions(+), 59 deletions(-) | Low | 10/22/2025 |
| 0.47.3 | ## v0.47.3 (2025-09-21) ### Fix - **openai-agents**: propagate gen_ai.agent.name through an agent flow + set workflow name to fast mcp (#3388) [main 09cd046c] bump: version 0.47.2 → 0.47.3 60 files changed, 65 insertions(+), 59 deletions(-) | Low | 9/21/2025 |
| 0.47.2 | ## v0.47.2 (2025-09-17) ### Fix - **mcp**: add mcp.server parent span wrapper for FastMCP tool calls (#3382) [main fd9626b4] bump: version 0.47.1 → 0.47.2 60 files changed, 65 insertions(+), 59 deletions(-) | Low | 9/17/2025 |
| 0.47.1 | ## v0.47.1 (2025-09-14) ### Fix - **mcp**: better instrumentation for FastMCP (#3372) - **anthropic**: preserve streaming helper methods in instrumentation (#3377) - **cohere**: add v2 api instrumentation (#3378) - **mistralai**: instrumentation for version 1.9+ compatibility (#3376) - **sdk**: dual bearer send via httpx (#3373) [main 8287b306] bump: version 0.47.0 → 0.47.1 60 files changed, 69 insertions(+), 59 deletions(-) | Low | 9/14/2025 |
| 0.47.0 | ## v0.47.0 (2025-09-10) ### Feat - **writer**: initial implementation (#3209) ### Fix - **crewai**: Update CrewAI instrumentation name (#3363) - **sample-app**: Update google genai package (#3358) - **traceloop-sdk**: include telemetry SDK attributes in tracing (#3359) - **sdk**: get default span processor don't work without a base URL (#3360) [main 84f5ee34] bump: version 0.46.2 → 0.47.0 60 files changed, 72 insertions(+), 59 deletions(-) | Low | 9/10/2025 |
| 0.46.2 | ## v0.46.2 (2025-08-29) ### Fix - **vertexai**: add missing role attributes when handling images (#3347) - **sdk**: manual logging example + fix span ended error (#3352) - **sdk**: support disabling all instrumentations (#3353) - **openai-agents**: support json inputs (#3354) - **openai**: reasoning jsons weren't stored - **crewai**: fix unpack error when metrics are disabled (#3345) - **milvus**: Set default values when metrics are disabled (#3344) [main e6a0bacc] bump: version 0.46.1 → 0.46 | Low | 8/29/2025 |
| 0.46.1 | ## v0.46.1 (2025-08-24) ### Fix - **google-generativeai,vertexai**: image support for Gemini models (#3340) [main d71b7aa9] bump: version 0.46.0 → 0.46.1 58 files changed, 63 insertions(+), 57 deletions(-) | Low | 8/24/2025 |
| 0.46.0 | ## v0.46.0 (2025-08-24) ### Feat - **openai**: add reasoning attributes (#3336) - **semantic-conventions-ai**: Add reasoning attributes (#3330) - **experiment**: Add run experiment capabilities (#3331) ### Fix - **traceloop-sdk**: bump logging instrumentation to support newer otel versions (#3339) - **traceloop-sdk**: add @staticmethod decorator to set_association_properties (#3341) - **google-genai**: update logic for deciding whether to use awrap or wrap in the Google Generative AI Instrum | Low | 8/24/2025 |
| 0.45.6 | ## v0.45.6 (2025-08-18) ### Fix - **anthropic**: fix with_raw_response wrapper consistency and re-enable beta API instrumentation (#3297) - **langchain**: include content attribute when assistant messages have tool calls (#3287) - **google-genai**: migrate Google Generative AI instrumentation to googleapis/python-genai (#3282) [main af487056] bump: version 0.45.5 → 0.45.6 58 files changed, 65 insertions(+), 57 deletions(-) | Low | 8/18/2025 |
| 0.45.5 | ## v0.45.5 (2025-08-15) ### Fix - **openai-agents**: switch to hook-based instrumentation (#3283) [main 738b649b] bump: version 0.45.4 → 0.45.5 58 files changed, 63 insertions(+), 57 deletions(-) | Low | 8/15/2025 |
| 0.45.4 | ## v0.45.4 (2025-08-14) ### Fix - relax opentelemetry-semantic-conventions-ai deps (#3259) [main 50be41d3] bump: version 0.45.3 → 0.45.4 58 files changed, 63 insertions(+), 57 deletions(-) | Low | 8/14/2025 |
Dependencies & License Audit
Loading dependencies...