Auto-instrumentation covers supported frameworks. For everything else — custom logic, tool execution, unsupported frameworks, or fine-grained control — you create spans explicitly using the OpenTelemetry API with OpenInference Semantic Conventions.

Set Up with Skills or Code

By Arize Skills
By Code

Three steps to add manual spans with your AI coding agent:Install skill

npx skills add Arize-ai/arize-skills --skill "arize-instrumentation" --yes

Set up authentication

export ARIZE_API_KEY="YOUR_API_KEY"
export ARIZE_SPACE_ID="YOUR_SPACE_ID"

Ask it to add manual spans

# Ask your AI coding agent:
"Wrap my custom tool functions with manual spans using OpenInference conventions"

Works with Cursor, Claude Code, Codex, and more. The skill picks the right span kinds, sets the right OpenInference attributes, and handles context propagation for you:

Arize instrumentation skill output showing manual CHAIN and TOOL spans added with OpenInference span kinds, plus the resulting trace tree

Set up the OpenTelemetry SDK, register a tracer provider with your Arize credentials, and create spans with OpenInference attributes.

Install dependencies

Python
JS/TS
Go

pip install openinference-instrumentation opentelemetry-api opentelemetry-sdk arize-otel

npm install @opentelemetry/api @opentelemetry/exporter-trace-otlp-proto @opentelemetry/resources @opentelemetry/sdk-trace-base @opentelemetry/sdk-trace-node @opentelemetry/semantic-conventions @arizeai/openinference-semantic-conventions openai

go get \
  go.opentelemetry.io/otel \
  go.opentelemetry.io/otel/sdk \
  go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp

Get API Key & Space ID

Go to Settings > API keys to create your API key and to get the Space ID of your current space.

Set up tracer provider

Python
JS/TS
Go

from arize.otel import register

tracer_provider = register(
    space_id="YOUR_SPACE_ID",
    api_key="YOUR_API_KEY",
    project_name="YOUR_PROJECT_NAME",
)

tracer = tracer_provider.get_tracer(__name__)

You can also use environment variables ARIZE_SPACE_ID, ARIZE_API_KEY, and ARIZE_PROJECT_NAME instead of passing them directly.

import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
import { resourceFromAttributes } from "@opentelemetry/resources";
import { SimpleSpanProcessor } from "@opentelemetry/sdk-trace-base";
import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
import { SEMRESATTRS_PROJECT_NAME } from "@arizeai/openinference-semantic-conventions";

const COLLECTOR_ENDPOINT = "https://otlp.arize.com";
const SERVICE_NAME = "manual-js-app";

const provider = new NodeTracerProvider({
  resource: resourceFromAttributes({
    [ATTR_SERVICE_NAME]: SERVICE_NAME,
    [SEMRESATTRS_PROJECT_NAME]: SERVICE_NAME,
  }),
  spanProcessors: [
    new SimpleSpanProcessor(
      new OTLPTraceExporter({
        url: `${COLLECTOR_ENDPOINT}/v1/traces`,
        headers: {
            'arize-space-id': 'your-arize-space-id',
            'arize-api-key': 'your-arize-api-key',
        },
      })
    ),
  ],
});

provider.register();

package main

import (
    "context"
    "log"
    "os"

    "go.opentelemetry.io/otel"
    "go.opentelemetry.io/otel/attribute"
    "go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp"
    "go.opentelemetry.io/otel/sdk/resource"
    sdktrace "go.opentelemetry.io/otel/sdk/trace"
)

func initTracer(ctx context.Context) (*sdktrace.TracerProvider, error) {
    exporter, err := otlptracehttp.New(ctx,
        otlptracehttp.WithEndpoint("otlp.arize.com"),
        otlptracehttp.WithHeaders(map[string]string{
            "arize-space-id": os.Getenv("ARIZE_SPACE_ID"),
            "arize-api-key":  os.Getenv("ARIZE_API_KEY"),
        }),
    )
    if err != nil {
        return nil, err
    }

    res, err := resource.New(ctx,
        resource.WithAttributes(
            attribute.String("service.name", "manual-go-app"),
            attribute.String("openinference.project.name", "manual-go-app"),
        ),
    )
    if err != nil {
        return nil, err
    }

    tp := sdktrace.NewTracerProvider(
        sdktrace.WithBatcher(exporter),
        sdktrace.WithResource(res),
    )
    otel.SetTracerProvider(tp)
    return tp, nil
}

// Call initTracer at startup, then defer tp.Shutdown(ctx) so batched
// spans flush to Arize before the process exits.
func main() {
    ctx := context.Background()
    tp, err := initTracer(ctx)
    if err != nil {
        log.Fatalf("init tracer: %v", err)
    }
    defer tp.Shutdown(ctx)

    // ... your app ...
}

For EU-region spaces, swap the endpoint to otlp.eu-west-1a.arize.com. Set ARIZE_SPACE_ID and ARIZE_API_KEY as environment variables — never embed credentials in source.

Create spans

Use your tracer to create spans — either as a context manager (to trace a specific block) or inline.

Python
JS/TS
Go

import openai
from opentelemetry.trace import Status, StatusCode

client = openai.OpenAI()

def run_agent(user_input: str) -> str:
    with tracer.start_as_current_span("run-agent") as span:
        span.set_attribute("openinference.span.kind", "CHAIN")
        span.set_attribute("input.value", user_input)

        response = call_llm(user_input)

        span.set_attribute("output.value", response)
        span.set_status(Status(StatusCode.OK))
        return response

def call_llm(prompt: str) -> str:
    with tracer.start_as_current_span("llm-completion") as span:
        span.set_attribute("openinference.span.kind", "LLM")
        span.set_attribute("input.value", prompt)
        span.set_attribute("llm.model_name", "gpt-4o")

        completion = client.chat.completions.create(
            model="gpt-4o",
            messages=[{"role": "user", "content": prompt}],
        )
        result = completion.choices[0].message.content or ""

        span.set_attribute("output.value", result)
        span.set_status(Status(StatusCode.OK))
        return result

import { trace, SpanStatusCode } from "@opentelemetry/api";
import { INPUT_VALUE, OUTPUT_VALUE, LLM_MODEL_NAME, SemanticConventions,
  OpenInferenceSpanKind
} from "@arizeai/openinference-semantic-conventions";

const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
const tracer = trace.getTracer(SERVICE_NAME);

async function callLLM(prompt: string): Promise<string> {
  return tracer.startActiveSpan("call-llm", async (span) => {
    span.setAttribute(SemanticConventions.OPENINFERENCE_SPAN_KIND, OpenInferenceSpanKind.LLM);
    span.setAttribute(INPUT_VALUE, prompt);
    span.setAttribute(LLM_MODEL_NAME, "gpt-4o");

    const response = await openai.chat.completions.create({
      model: "gpt-4o",
      messages: [{ role: "user", content: prompt }]
    });

    const result = response.choices[0].message.content || "";
    span.setAttribute(OUTPUT_VALUE, result);
    span.setStatus({ code: SpanStatusCode.OK });
    span.end();

    return result;
  });
}

package main

import (
    "context"
    "os"

    "github.com/sashabaranov/go-openai"
    "go.opentelemetry.io/otel"
    "go.opentelemetry.io/otel/attribute"
    "go.opentelemetry.io/otel/codes"
)

var tracer = otel.Tracer("manual-go-app")

func runAgent(ctx context.Context, userInput string) (string, error) {
    ctx, span := tracer.Start(ctx, "run-agent")
    defer span.End()

    span.SetAttributes(
        attribute.String("openinference.span.kind", "CHAIN"),
        attribute.String("input.value", userInput),
    )

    response, err := callLLM(ctx, userInput)
    if err != nil {
        span.SetStatus(codes.Error, err.Error())
        return "", err
    }

    span.SetAttributes(attribute.String("output.value", response))
    span.SetStatus(codes.Ok, "")
    return response, nil
}

func callLLM(ctx context.Context, prompt string) (string, error) {
    ctx, span := tracer.Start(ctx, "llm-completion")
    defer span.End()

    span.SetAttributes(
        attribute.String("openinference.span.kind", "LLM"),
        attribute.String("input.value", prompt),
        attribute.String("llm.model_name", "gpt-4o"),
    )

    client := openai.NewClient(os.Getenv("OPENAI_API_KEY"))
    completion, err := client.CreateChatCompletion(ctx, openai.ChatCompletionRequest{
        Model:    openai.GPT4o,
        Messages: []openai.ChatCompletionMessage{{Role: "user", Content: prompt}},
    })
    if err != nil {
        span.SetStatus(codes.Error, err.Error())
        return "", err
    }

    result := completion.Choices[0].Message.Content
    span.SetAttributes(attribute.String("output.value", result))
    span.SetStatus(codes.Ok, "")
    return result, nil
}

Go has no first-party OpenInference helper package today, so set the attribute keys (openinference.span.kind, input.value, output.value, llm.model_name) as raw strings on the span.

Learn More

Group traces into conversations — attach session.id and user.id to your manual spans to follow multi-turn interactions. See Set up sessions.
Mix auto + manual — let auto-instrumentors handle LLM calls while you keep manual CHAIN and TOOL spans for custom logic. See Combine auto + manual.
Visualize agent execution — set graph.node.id and graph.node.parent_id to render agent graphs in the UI. See Agent trajectory.
Track costs — turn token counts on your LLM spans into per-span and per-trace cost. See Track costs.
Configure for production — switch to BatchSpanProcessor, add resource attributes, route to multiple projects. See Configure your tracer.
Mask sensitive data — hide PII in inputs/outputs before spans leave your app. See Mask and redact data.
Scale with OTEL Collector — centralize routing, handle async context, sample at volume. See Advanced patterns.

FAQs

Q: Do I have to use an SDK that supports OpenInference? A: No; you can use any OpenTelemetry-compatible tracer. But if you instrument using the OpenInference schema (span kinds + attributes) you’ll get better integration (analytics, visualization) in Arize AX. Q: What if I’m capturing sensitive data (PII) in spans or attributes? A: When using manual instrumentation, you must handle masking, redaction, or encryption as appropriate. See Mask and redact data.

Next step

Customize your spans with attributes, events, prompt templates, and more:

How to Use Arize AX

Quickstart

Instrument

Observe

Evaluate

Improve

Machine Learning

Settings

Security

Manual Instrumentation

Set Up with Skills or Code

Learn More

FAQs

Next step

Next: Customize Your Traces

How to Use Arize AX

Quickstart

Instrument

Observe

Evaluate

Improve

Machine Learning

Settings

Security

Documentation Index

​Set Up with Skills or Code

​Learn More

​FAQs

​Next step

Next: Customize Your Traces

Set Up with Skills or Code

Learn More

FAQs

Next step