traceAI OTEL Tracing
Learn how to leverage traceAI OTEL tracing decorators and methods to instrument your functions, chains, agents, and tools with OpenTelemetry. These utilities complement or replace standard OpenTelemetry instrumentation code, making the process more straightforward and efficient.Installation
Ensure you have FI Instrumentation Library installed:Setting Up Tracing
Initialize your tracing environment with the following setup:Using your Tracer
The tracer object provides two main approaches for instrumentation:1. Function Decoration
Use decorators to trace complete functions:Python
2. Code Block Tracing
Utilize context managers to trace specific code segments:Python
FI Span Kinds
FI Span Kinds denote the possible types of spans you might capture, and will be rendered different in the Future AGI UI. The possible values are:Span Kind | Use |
---|---|
CHAIN | General logic operations, functions, or code blocks |
LLM | Making LLM calls |
TOOL | Completing tool calls |
RETRIEVER | Retrieving documents |
EMBEDDING | Generating embeddings |
AGENT | Agent invocations - typically a top level or near top level span |
RERANKER | Reranking retrieved context |
UNKNOWN | Unknown |
GUARDRAIL | Guardrail checks |
EVALUATOR | Evaluators |
Chains
Using Context Managers
Using Decorators
Python
Using JSON Output
Python
Overriding Span Name
Python
Agents
Using Context Managers
Using Decorators
Python
Tools
Using Context Managers
Using Decorators
Python
LLM
Using Context Managers
Using Decorators
Python
Retriever
Using Context Managers
Using Decorators
Python