Package com.google.adk.telemetry

Class Instrumentation.ToolExecution

java.lang.Object

com.google.adk.telemetry.Instrumentation.ClosableTelemetryScope

com.google.adk.telemetry.Instrumentation.ToolExecution

All Implemented Interfaces:

AutoCloseable

Enclosing class:

Instrumentation

public static final class Instrumentation.ToolExecution
extends Instrumentation.ClosableTelemetryScope

AutoCloseable telemetry tracking scope for tool executions.

Field Summary

Fields inherited from class com.google.adk.telemetry.Instrumentation.ClosableTelemetryScope

caughtError, closed, span, startTimeNanos, telemetryContext

Constructor Summary

Constructors

Constructor	Description
ToolExecution(BaseTool tool, BaseAgent agent, Map<String,Object> functionArgs, io.opentelemetry.context.Context parentContext)	Constructs a new ToolExecution telemetry scope.

Method Summary

Modifier and Type	Method	Description
protected void	beforeSpanEnd()	Traces the tool execution attributes on the span before it ends.
protected void	handleMetricsError(RuntimeException e)	Handles errors that occur while recording metrics for the tool execution.
protected void	recordMetrics(Duration elapsed, @Nullable Throwable error)	Records metrics for the tool execution including duration, request size, and response size.

Methods inherited from class com.google.adk.telemetry.Instrumentation.ClosableTelemetryScope

close, context, setError

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ToolExecution

public ToolExecution(BaseTool tool,
 BaseAgent agent,
 Map<String,Object> functionArgs,
 io.opentelemetry.context.Context parentContext)

Constructs a new ToolExecution telemetry scope.

Parameters:

tool - The tool being executed.

agent - The agent invoking the tool.

functionArgs - The arguments passed to the tool.

parentContext - The OpenTelemetry parent context.

Method Details

beforeSpanEnd

protected void beforeSpanEnd()

Traces the tool execution attributes on the span before it ends.

Overrides:

beforeSpanEnd in class Instrumentation.ClosableTelemetryScope

recordMetrics

protected void recordMetrics(Duration elapsed,
 @Nullable Throwable error)

Records metrics for the tool execution including duration, request size, and response size.

Specified by:

recordMetrics in class Instrumentation.ClosableTelemetryScope

Parameters:

elapsed - The total execution duration.

error - The exception thrown during execution, if any.

handleMetricsError

protected void handleMetricsError(RuntimeException e)

Handles errors that occur while recording metrics for the tool execution.

Specified by:

handleMetricsError in class Instrumentation.ClosableTelemetryScope

Parameters:

e - The runtime exception encountered during metrics recording.