Module: Agents::Instrumentation::Constants

Included in:

TracingCallbacks

Defined in:

lib/agents/instrumentation/constants.rb

Overview

OpenTelemetry attribute name constants for LLM observability. These follow the GenAI semantic conventions and Langfuse’s OTel attribute mapping.

See Also:

• https://langfuse.com/integrations/native/opentelemetry#property-mapping

Constant Summary

SPAN_RUN =

Span names

"agents.run"

SPAN_LLM_CALL =

"agents.llm_call"

SPAN_TOOL =

"agents.tool.%s"

EVENT_HANDOFF =

"agents.handoff"

ATTR_GEN_AI_REQUEST_MODEL =

GenAI semantic conventions (ONLY on generation spans)

"gen_ai.request.model"

ATTR_GEN_AI_PROVIDER =

"gen_ai.provider.name"

ATTR_GEN_AI_USAGE_INPUT =

"gen_ai.usage.input_tokens"

ATTR_GEN_AI_USAGE_OUTPUT =

"gen_ai.usage.output_tokens"

ATTR_LANGFUSE_USER_ID =

Langfuse trace-level attributes

"langfuse.user.id"

ATTR_LANGFUSE_SESSION_ID =

"langfuse.session.id"

ATTR_LANGFUSE_TRACE_TAGS =

"langfuse.trace.tags"

ATTR_LANGFUSE_TRACE_INPUT =

"langfuse.trace.input"

ATTR_LANGFUSE_TRACE_OUTPUT =

"langfuse.trace.output"

ATTR_LANGFUSE_OBS_TYPE =

Langfuse observation-level attributes

"langfuse.observation.type"

ATTR_LANGFUSE_OBS_INPUT =

"langfuse.observation.input"

ATTR_LANGFUSE_OBS_OUTPUT =

"langfuse.observation.output"