Prerequisites
-
Install LangWatch SDK:
-
Install Google ADK and OpenInference instrumentor:
-
Set up Google Cloud authentication:
You’ll need to authenticate with Google Cloud. You can either:
- Set the
GOOGLE_API_KEY
environment variable for Gemini API access - Use Application Default Credentials (ADC) if running on Google Cloud
- Use service account keys for production deployments
- Set the
Instrumentation with OpenInference
LangWatch supports seamless observability for Google ADK agents using the OpenInference Google ADK instrumentor. This approach automatically captures traces from your ADK agents and sends them to LangWatch.Basic Setup (Automatic Tracing)
Here’s the simplest way to instrument your application:Optional: Using Decorators for Additional Context
If you want to add additional context or metadata to your traces, you can optionally use the@langwatch.trace()
decorator:
How it Works
-
langwatch.setup()
: Initializes the LangWatch SDK, which includes setting up an OpenTelemetry trace exporter. This exporter is ready to receive spans from any OpenTelemetry-instrumented library in your application. -
GoogleADKInstrumentor()
: The OpenInference instrumentor automatically patches Google ADK components to create OpenTelemetry spans for their operations, including:- Agent initialization
- Tool calls
- Model completions
- Session management
-
Optional Decorators: You can optionally use
@langwatch.trace()
to add additional context and metadata to your traces, but it’s not required for basic functionality.
Notes
- You do not need to set any OpenTelemetry environment variables or configure exporters manually—
langwatch.setup()
handles everything. - You can combine Google ADK instrumentation with other instrumentors (e.g., OpenAI, LangChain) by adding them to the
instrumentors
list. - The
@langwatch.trace()
decorator is optional - the OpenInference instrumentor will capture all ADK activity automatically. - For advanced configuration (custom attributes, endpoint, etc.), see the Python integration guide.
Troubleshooting
- Make sure your
LANGWATCH_API_KEY
is set in the environment. - If you see no traces in LangWatch, check that the instrumentor is included in
langwatch.setup()
and that your agent code is being executed. - Ensure you have the correct Google API key set for Gemini access.