Google Gen AI

Automatic Instrumentation

Import name: Sentry.googleGenAIIntegration

The googleGenAIIntegration adds instrumentation for the @google/genai SDK to capture spans by wrapping Google Gen AI SDK calls and recording LLM interactions.

In Node.js runtimes, this integration is enabled by default and automatically captures spans for Google Gen AI SDK calls (requires Sentry SDK version 10.28.0 or higher).

To customize what data is captured (such as inputs and outputs), see the Options in the Configuration section.

Manual Instrumentation

Import name: Sentry.instrumentGoogleGenAIClient

The instrumentGoogleGenAIClient helper adds instrumentation for the @google/genai SDK to capture spans by wrapping Google Gen AI SDK calls and recording LLM interactions with configurable input/output recording. You need to manually wrap your Google Gen AI client instance with this helper.

See example below:

import { GoogleGenAI } from "@google/genai";

const genAI = new GoogleGenAI({
  apiKey: "your-api-key", // Warning: API key will be exposed in browser!
});

const client = Sentry.instrumentGoogleGenAIClient(genAI, {
  recordInputs: true,
  recordOutputs: true,
});

// Use the wrapped client instead of the original genAI instance
const result = await client.models.generateContent("Hello!");

To customize what data is captured (such as inputs and outputs), see the Options in the Configuration section.

Using the googleGenAIIntegration integration for automatic instrumentation:

Sentry.init({
  dsn: "____PUBLIC_DSN____",
  // Tracing must be enabled for agent monitoring to work
  tracesSampleRate: 1.0,
  integrations: [
    Sentry.googleGenAIIntegration({
      // your options here
    }),
  ],
});

Using the instrumentGoogleGenAIClient wrapper for manual instrumentation:

const client = Sentry.instrumentGoogleGenAIClient(genAI, {
  // your options here
});