Projects

What is a Project?

A Project is a dedicated workspace that keeps all related traces, evaluations, and sessions neatly organized in one place. In Arize, a Space can hold multiple projects.

Why are Projects Important?

Projects provide an organized way to structure your work. They help you:

Isolate use cases: Create dedicated spaces for each product or model to ensure traces and evals stays independent.
Create Dedicated Evals: Build and re-use evaluations specific to your project to assess performance of your spans, traces, and sessions.
Visualize Agent Graphs and Paths: Explore detailed agent graphs and execution paths within each project making it easier to understand how your agents reason and where bottlenecks occur.

Send Traces to a Project

The code below shows how to setup tracing to export spans to a Project. To see how to use our auto instrumentations see Integrations.

Python
JS/TS

# Import open-telemetry dependencies
from arize.otel import register

# Setup OTel via our convenience function
tracer_provider = register(
    space_id = "your-space-id", # in app space settings page
    api_key = "your-api-key", # in app space settings page
    project_name = "your-project-name", # name this to whatever you would like
)

Install dependencies:

npm install @opentelemetry/exporter-trace-otlp-grpc @grpc/grpc-js @opentelemetry/sdk-trace @opentelemetry/context-async-hooks @opentelemetry/resources @opentelemetry/api @opentelemetry/instrumentation

Create an instrumentation.ts file. That file should look like this:

import { registerInstrumentations } from "@opentelemetry/instrumentation";
import {
  ConsoleSpanExporter,
  SimpleSpanProcessor,
  TracerProvider,
} from "@opentelemetry/sdk-trace";
import { resourceFromAttributes } from "@opentelemetry/resources";
import {
  AsyncLocalStorageContextManager,
} from "@opentelemetry/context-async-hooks";
import {
  OTLPTraceExporter as GrpcOTLPTraceExporter
} from "@opentelemetry/exporter-trace-otlp-grpc"; // Arize specific
import {
  context,
  diag,
  DiagConsoleLogger,
  DiagLogLevel,
  trace,
} from "@opentelemetry/api";
import { Metadata } from "@grpc/grpc-js"

// For troubleshooting, set the log level to DiagLogLevel.DEBUG
diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);

// Arize specific - Create metadata and add your headers
const metadata = new Metadata();

// Your Arize Space and API Keys, which can be found in the UI, see below
metadata.set('arize-space-id', 'your-space-id');
metadata.set('arize-api-key', 'your-api-key');

const provider = new TracerProvider({
  resource: resourceFromAttributes({
    // Arize specific - The name of a new or preexisting project you
    // want to export spans to
    "openinference.project.name": "your-project-name",
  }),
  spanProcessors: [
    new SimpleSpanProcessor({ exporter: new ConsoleSpanExporter() }),
    new SimpleSpanProcessor({
      exporter: new GrpcOTLPTraceExporter({
        url: "https://otlp.arize.com/v1",
        metadata,
      }),
    }),
  ],
});

// Add auto instrumentations here

trace.setGlobalTracerProvider(provider);
context.setGlobalContextManager(
  new AsyncLocalStorageContextManager().enable(),
);

This file needs to run at the entry point of your application, before any other code on your server runs. You can do this by importing it at the top of your entry point for example in something like server/app.ts:

import "./instrumentation"
// server startup

Or you can import it via a node command when you run your server as outline in the OpenTelemetry documentation using import or require:

# require
npx ts-node --require ./instrumentation.ts app.ts
# import
npx ts-node --import ./instrumentation.ts app.ts
# Or without ts-node something like
node --import ./dist/instrumentation.cjs ./dist/index.cjs

Quickstart

Instrument

Observe

Agents

Evaluate

Experimentation

Settings

Security

Machine Learning

What is a Project?

Why are Projects Important?

Send Traces to a Project

​What is a Project?

​Why are Projects Important?

​Send Traces to a Project

What is a Project?

Why are Projects Important?

Send Traces to a Project