Trace · Semantic Kernel
Semantic Kernel logo

Trace Semantic Kernel

Agent Frameworks

Auto-instrument Semantic Kernel with traceAI in under 3 minutes. Every LLM call, tool use, retrieval, and chain step becomes an OpenTelemetry span you can search, replay, and debug.

Prerequisites

Before you start

  • · A working Semantic Kernel app — local or already in production.
  • · A free Future AGI account with FI_API_KEY and FI_SECRET_KEY.
  • · Python 3.9+ / Node 18+ / Java 17+ depending on which SDK you're installing.

Install

<dependency>
  <groupId>ai.futureagi</groupId>
  <artifactId>traceai-java-semantic-kernel</artifactId>
  <version>LATEST</version>
</dependency>

Trace recipe

import ai.futureagi.fi.instrumentation.TraceProvider;
import ai.futureagi.traceai.semantic_kernel.SemanticKernelInstrumentor;

TraceProvider provider = TraceProvider.builder()
    .projectName("semantic_kernel_app")
    .projectType("observe")
    .build();

new SemanticKernelInstrumentor().instrument(provider);

// Your existing Semantic Kernel code runs unchanged.
// Every call is now an OpenTelemetry span in Future AGI.

What Future AGI captures

Trace fields you'll see in the dashboard

  • Spans for every Semantic Kernel call: input, output, latency, tokens, cost, model name, errors

  • Trace tree across LLM, tool, retrieval, embedding, and chain spans

  • Custom attributes via `using_attributes` (session_id, user_id, prompt_template, tags, custom dicts)

  • Streaming-safe — partial chunks aggregated into a single span

Common gotchas

Read these before you ship

  1. 01

    Set `FI_API_KEY` and `FI_SECRET_KEY` in env before calling `register()` — silent fallback otherwise.

  2. 02

    Async frameworks: instantiate the instrumentor *before* you create the client, not after.

  3. 03

    Streaming responses are aggregated into a single span only when you use the official SDK iterator.

Next: chain it with the other recipes

Trace is the first step. Most teams add an evaluator the same week, and start optimising or simulating once they have a baseline. Each recipe takes minutes to wire up.