Netra SDK - What is Netra? | Technical documentation

Netra provides official SDKs for Python and TypeScript/JavaScript, enabling you to instrument your AI applications with minimal code changes. Both SDKs share the same core capabilities built on OpenTelemetry.

Choose Your SDK

Python SDK

Full-featured SDK for Python applications with support for decorators, auto-instrumentation, and context managers.

TypeScript SDK

Native TypeScript/JavaScript SDK for Node.js applications with full type support and async patterns.

Installation

pip install netra-sdk

poetry add netra-sdk

npm install netra-sdk

yarn add netra-sdk

Quick Start

from netra import Netra
from netra.instrumentation.instruments import InstrumentSet

Netra.init(
    app_name="my-ai-app",
    headers=f"x-api-key={os.getenv('NETRA_API_KEY')}",
    environment="production",
    instruments={InstrumentSet.OPENAI, InstrumentSet.LANGCHAIN},
)

import { Netra, NetraInstruments } from "netra-sdk";

await Netra.init({
  appName: "my-ai-app",
  headers: `x-api-key=${process.env.NETRA_API_KEY}`,
  environment: "production",
  instruments: new Set([NetraInstruments.OPENAI, NetraInstruments.LANGCHAIN]),
});

What You Can Do

Observability

Auto-instrument LLM providers, frameworks, and databases. Create manual spans with decorators or context managers.

Usage & Traces

Query token usage, costs, and trace data programmatically. Drill into spans for detailed analysis.

Dashboard Query

Build custom analytics queries with flexible metrics, dimensions, and filters. Fetch session summaries and stats.

Evaluation

Manage datasets, run test suites, and score AI outputs using built-in or custom evaluators.

Simulation

Run multi-turn conversation simulations to test your AI agents at scale.

Integrations

Connect with LangChain, LlamaIndex, CrewAI, OpenAI, Anthropic, and many more.

Core Capabilities

Capability	Description
Auto-Instrumentation	Automatic tracing for LLM providers, frameworks, and databases
Manual Tracing	Create custom spans with full control over attributes and events
Decorators	Simple function decoration with `@agent`, `@task`, and `@workflow`
Context Tracking	Set user, session, and tenant IDs for filtering and analysis
Usage Tracking	Record token usage, costs, and custom metrics
Dashboard Queries	Programmatic access to analytics and session data
Evaluation	Run test suites with datasets and evaluators
Simulation	Multi-turn conversation testing against your agents

Environment Variables

Configure the SDK via environment variables:

Variable	Description
`NETRA_API_KEY`	API key for authentication
`NETRA_APP_NAME`	Application name
`NETRA_ENV`	Environment (production, staging, etc.)
`NETRA_OTLP_ENDPOINT`	Custom OTLP endpoint URL
`NETRA_TRACE_CONTENT`	Enable/disable content tracing
`NETRA_DEBUG`	Enable debug logging

Next Steps

Quick Start Guide

Follow the step-by-step guide to instrument your first application with Netra.

Auto-Instrumentation

See all supported libraries and frameworks for automatic tracing.

Manual Tracing

Learn how to create custom spans for fine-grained control over your traces.

Decorators

Use @agent, @task, and @workflow decorators to instrument functions with zero boilerplate.

​Choose Your SDK