From d145880cc9cf3042364d421d417cab73c3a0b03a Mon Sep 17 00:00:00 2001 From: Ogi <86684834+obostjancic@users.noreply.github.com> Date: Mon, 22 Sep 2025 23:49:45 +0200 Subject: [PATCH 1/3] chore(mcp-insights): remove beta callout --- docs/product/insights/ai/mcp/index.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/product/insights/ai/mcp/index.mdx b/docs/product/insights/ai/mcp/index.mdx index f509aa396c92a9..786d293f2089cc 100644 --- a/docs/product/insights/ai/mcp/index.mdx +++ b/docs/product/insights/ai/mcp/index.mdx @@ -4,8 +4,6 @@ sidebar_order: 20 description: "Learn how to use Sentry's MCP monitoring tools to trace and debug your Model Context Protocol implementations, including server connections, resource access, and tool executions." --- - - Sentry's MCP (Model Context Protocol) monitoring tools help you understand what's happening in your MCP implementations. They automatically collect information about MCP server connections, resource access, tool executions, and errors across your entire MCP pipeline—from client requests to server responses. ## Example MCP Monitoring Use Cases From 676c15346138191b805e888472efb8728cdce9a7 Mon Sep 17 00:00:00 2001 From: Ogi <86684834+obostjancic@users.noreply.github.com> Date: Mon, 13 Oct 2025 17:20:00 +0200 Subject: [PATCH 2/3] feat(ai-insights): google genai sdk docs --- .../integrations/google-genai/index.mdx | 97 +++++++++++++++++++ docs/platforms/python/integrations/index.mdx | 1 + .../python/integrations/litellm/index.mdx | 4 +- .../ai-agents-module.mdx | 1 + 4 files changed, 101 insertions(+), 2 deletions(-) create mode 100644 docs/platforms/python/integrations/google-genai/index.mdx diff --git a/docs/platforms/python/integrations/google-genai/index.mdx b/docs/platforms/python/integrations/google-genai/index.mdx new file mode 100644 index 00000000000000..83e999a35c1839 --- /dev/null +++ b/docs/platforms/python/integrations/google-genai/index.mdx @@ -0,0 +1,97 @@ +--- +title: Google Gen AI +description: "Learn about using Sentry for Google Gen AI." +--- + +This integration connects Sentry with the [Google Gen AI Python SDK](https://github.com/googleapis/python-genai). + +Once you've installed this SDK, you can use the Sentry AI Agents Monitoring, a Sentry dashboard that helps you understand what's going on with your AI requests. + +Sentry AI Monitoring will automatically collect information about prompts, tools, tokens, and models. Learn more about the [AI Agents Dashboard](/product/insights/ai/agents). + +## Install + +Install `sentry-sdk` from PyPI with the `google-genai` extra: + +```bash {tabTitle:pip} +pip install "sentry-sdk[google-genai]" +``` + +```bash {tabTitle:uv} +uv add "sentry-sdk[google-genai]" +``` + +## Configure + +If you have the `google-genai` package in your dependencies, the Google Gen AI integration will be enabled automatically when you initialize the Sentry SDK. + + + +## Verify + +Verify that the integration works by making a chat request to Google Gen AI. + +```python +import sentry_sdk +from google.genai import Client + +sentry_sdk.init(...) # same as above + +client = Client(api_key="(your Google API key)") + +def my_llm_stuff(): + with sentry_sdk.start_transaction(name="The result of the AI inference"): + response = client.models.generate_content( + model="gemini-2.0-flash-exp", + contents="say hello" + ) + print(response.text) +``` + +After running this script, the resulting data should show up in the `"AI Spans"` tab on the `"Explore" > "Traces"` page on Sentry.io. + +If you manually created an Invoke Agent Span (not done in the example above) the data will also show up in the [AI Agents Dashboard](/product/insights/ai/agents). + +It may take a couple of moments for the data to appear in [sentry.io](https://sentry.io). + +## Behavior + +- The Google Gen AI integration will connect Sentry with the supported Google Gen AI methods automatically. + +- The supported function is currently `models.generate_content` (both sync and async). + +- Sentry considers LLM inputs/outputs as PII (Personally identifiable information) and doesn't include PII data by default. If you want to include the data, set `send_default_pii=True` in the `sentry_sdk.init()` call. To explicitly exclude prompts and outputs despite `send_default_pii=True`, configure the integration with `include_prompts=False` as shown in the [Options section](#options) below. + +## Options + +By adding `GoogleGenAIIntegration` to your `sentry_sdk.init()` call explicitly, you can set options for `GoogleGenAIIntegration` to change its behavior: + +```python +import sentry_sdk +from sentry_sdk.integrations.google_genai import GoogleGenAIIntegration + +sentry_sdk.init( + # ... + # Add data like inputs and responses; + # see https://docs.sentry.io/platforms/python/data-management/data-collected/ for more info + send_default_pii=True, + integrations=[ + GoogleGenAIIntegration( + include_prompts=False, # LLM inputs/outputs will be not sent to Sentry, despite send_default_pii=True + ), + ], +) +``` + +You can pass the following keyword arguments to `GoogleGenAIIntegration()`: + +- `include_prompts`: + + Whether LLM inputs and outputs should be sent to Sentry. Sentry considers this data personal identifiable data (PII) by default. If you want to include the data, set `send_default_pii=True` in the `sentry_sdk.init()` call. To explicitly exclude prompts and outputs despite `send_default_pii=True`, configure the integration with `include_prompts=False`. + + The default is `True`. + +## Supported Versions + +- google-genai: 1.4.0+ +- Python: 3.9+ diff --git a/docs/platforms/python/integrations/index.mdx b/docs/platforms/python/integrations/index.mdx index 4f709072ebd1ee..53fa1ec5ade180 100644 --- a/docs/platforms/python/integrations/index.mdx +++ b/docs/platforms/python/integrations/index.mdx @@ -41,6 +41,7 @@ The Sentry SDK uses integrations to hook into the functionality of popular libra | | **Auto-enabled** | | ---------------------------------------------------------------------------------------------------------------------------------- | :--------------: | | | ✓ | +| | ✓ | | | ✓ | | | ✓ | | | | diff --git a/docs/platforms/python/integrations/litellm/index.mdx b/docs/platforms/python/integrations/litellm/index.mdx index d0426902eaa189..6d46718583e64b 100644 --- a/docs/platforms/python/integrations/litellm/index.mdx +++ b/docs/platforms/python/integrations/litellm/index.mdx @@ -69,9 +69,9 @@ response = litellm.completion( print(response.choices[0].message.content) ``` -After running this script, the resulting data should show up in the `AI Spans` tab on the `Explore > Traces > Trace` page on Sentry.io. +After running this script, the resulting data should show up in the `"AI Spans"` tab on the `"Explore" > "Traces"` page on Sentry.io. -If you manually created an Invoke Agent Span (not done in the example above), the data will also show up in the [AI Agents Dashboard](/product/insights/ai/agents). +If you manually created an Invoke Agent Span (not done in the example above) the data will also show up in the [AI Agents Dashboard](/product/insights/ai/agents). It may take a couple of moments for the data to appear in [sentry.io](https://sentry.io). diff --git a/docs/platforms/python/tracing/instrumentation/custom-instrumentation/ai-agents-module.mdx b/docs/platforms/python/tracing/instrumentation/custom-instrumentation/ai-agents-module.mdx index 698643eb56f605..63b9a789bc5417 100644 --- a/docs/platforms/python/tracing/instrumentation/custom-instrumentation/ai-agents-module.mdx +++ b/docs/platforms/python/tracing/instrumentation/custom-instrumentation/ai-agents-module.mdx @@ -13,6 +13,7 @@ As a prerequisite to setting up AI Agent Monitoring with Python, you'll need to The Python SDK supports automatic instrumentation for some AI libraries. We recommend adding their integrations to your Sentry configuration to automatically capture spans for AI agents. - Anthropic +- Google Gen AI - OpenAI - OpenAI Agents SDK - LangChain From 705e63e4cf5a88ca7982eb9f68ea0d67989b7fcd Mon Sep 17 00:00:00 2001 From: Ogi <86684834+obostjancic@users.noreply.github.com> Date: Mon, 13 Oct 2025 17:29:56 +0200 Subject: [PATCH 3/3] gen ai not auto enabled --- .../integrations/google-genai/index.mdx | 23 ++++++++++++++++--- docs/platforms/python/integrations/index.mdx | 20 ++++++++-------- 2 files changed, 30 insertions(+), 13 deletions(-) diff --git a/docs/platforms/python/integrations/google-genai/index.mdx b/docs/platforms/python/integrations/google-genai/index.mdx index 83e999a35c1839..f8bf43dc4117f7 100644 --- a/docs/platforms/python/integrations/google-genai/index.mdx +++ b/docs/platforms/python/integrations/google-genai/index.mdx @@ -23,9 +23,25 @@ uv add "sentry-sdk[google-genai]" ## Configure -If you have the `google-genai` package in your dependencies, the Google Gen AI integration will be enabled automatically when you initialize the Sentry SDK. +Add `GoogleGenAIIntegration()` to your `integrations` list: - +```python +import sentry_sdk +from sentry_sdk.integrations.google_genai import GoogleGenAIIntegration + +sentry_sdk.init( + dsn="___PUBLIC_DSN___", + # Set traces_sample_rate to 1.0 to capture 100% + # of transactions for tracing. + traces_sample_rate=1.0, + # Add data like inputs and responses; + # see https://docs.sentry.io/platforms/python/data-management/data-collected/ for more info + send_default_pii=True, + integrations=[ + GoogleGenAIIntegration(), + ], +) +``` ## Verify @@ -33,6 +49,7 @@ Verify that the integration works by making a chat request to Google Gen AI. ```python import sentry_sdk +from sentry_sdk.integrations.google_genai import GoogleGenAIIntegration from google.genai import Client sentry_sdk.init(...) # same as above @@ -64,7 +81,7 @@ It may take a couple of moments for the data to appear in [sentry.io](https://se ## Options -By adding `GoogleGenAIIntegration` to your `sentry_sdk.init()` call explicitly, you can set options for `GoogleGenAIIntegration` to change its behavior: +You can set options for `GoogleGenAIIntegration` to change its behavior: ```python import sentry_sdk diff --git a/docs/platforms/python/integrations/index.mdx b/docs/platforms/python/integrations/index.mdx index 53fa1ec5ade180..f31c9b6db8d881 100644 --- a/docs/platforms/python/integrations/index.mdx +++ b/docs/platforms/python/integrations/index.mdx @@ -38,16 +38,16 @@ The Sentry SDK uses integrations to hook into the functionality of popular libra ### AI -| | **Auto-enabled** | -| ---------------------------------------------------------------------------------------------------------------------------------- | :--------------: | -| | ✓ | -| | ✓ | -| | ✓ | -| | ✓ | -| | | -| | ✓ | -| | ✓ | -| | | +| | **Auto-enabled** | +| --------------------------------------------------------------------------------------------------------------------------------- | :--------------: | +| | ✓ | +| | | +| | ✓ | +| | ✓ | +| | | +| | ✓ | +| | ✓ | +| | | ### Data Processing