OpenAI.Agents.Telemetry (openai_agents v0.1.2)

Telemetry integration for OpenAI Agents.

Emits telemetry events for agent execution, tool calls, and API requests.

Events

  • [:openai_agents, :run, :start] - Emitted when an agent run starts
  • [:openai_agents, :run, :stop] - Emitted when an agent run completes
  • [:openai_agents, :agent, :start] - Emitted when an agent starts processing
  • [:openai_agents, :agent, :stop] - Emitted when an agent completes processing
  • [:openai_agents, :tool, :start] - Emitted when a tool execution starts
  • [:openai_agents, :tool, :stop] - Emitted when a tool execution completes
  • [:openai_agents, :handoff, :start] - Emitted when a handoff starts
  • [:openai_agents, :api, :request, :start] - Emitted when an API request starts
  • [:openai_agents, :api, :request, :stop] - Emitted when an API request completes

Measurements

All :stop events include a :duration measurement in native time units.

Metadata

Events include relevant metadata such as:

  • :agent_module - The agent module
  • :trace_id - The trace ID for the run
  • :tool_name - The name of the tool being executed
  • :status - :ok or :error

Summary

Functions

Sets up default telemetry handlers.

Emits an agent start event.

Emits an API request start event.

Emits a run start event.

Emits a tool start event.

Emits a run stop event.

Emits a tool stop event.

Functions

handoff(from_agent, to_agent, trace_id)

Emits a handoff event.

setup()

Sets up default telemetry handlers.

start_agent(agent_module, trace_id)

Emits an agent start event.

start_api_request(method, endpoint, trace_id)

Emits an API request start event.

start_run(state)

Emits a run start event.

start_tool(tool_name, call_id)

Emits a tool start event.

stop_agent(agent_module, trace_id, start_time, status)

Emits an agent stop event.

stop_api_request(method, endpoint, trace_id, start_time, status, response_data \\ nil)

Emits an API request stop event.

stop_run(state, status)

Emits a run stop event.

stop_tool(tool_name, call_id, result)

Emits a tool stop event.