Sessions

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

# Initialize with default settings
Netra.init(app_name="Your application name")

# Or with custom configuration
api_key = "Your API key"
headers = f"x-api-key={api_key}"
Netra.init(
    app_name="Your application name",
    headers=headers,
    trace_content=True,
    environment="Your Application environment",
    instruments={InstrumentSet.OPENAI}
)

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

// Initialize with default settings
await Netra.init({ appName: "Your application name" });

// Or with custom configuration
const apiKey = process.env.NETRA_API_KEY;
const headers = `x-api-key=${apiKey}`;

await Netra.init({
  appName: "Your application name",
  headers: headers,
  traceContent: true,
  environment: "Your Application environment",
  instruments: new Set([NetraInstruments.OPENAI]),
});

# Set session identification
Netra.set_session_id("unique-session-id")
Netra.set_user_id("user-123")
Netra.set_tenant_id("tenant-456")

// Set session identification
Netra.setSessionId("unique-session-id");
Netra.setUserId("user-123");
Netra.setTenantId("tenant-456");

# Add custom context attributes
Netra.set_custom_attributes(key="customer_tier", value="premium")
Netra.set_custom_attributes(key="region", value="us-east")
Netra.set_custom_attributes(key="plan_type", value="enterprise")

// Add custom context attributes
Netra.setCustomAttributes({ key: "customer_tier", value: "premium" });
Netra.setCustomAttributes({ key: "region", value: "us-east" });
Netra.setCustomAttributes({ key: "plan_type", value: "enterprise" });

# Record user feedback event
Netra.set_custom_event(event_name="user_feedback", attributes={
    "rating": 5,
    "comment": "Great response!",
    "timestamp": "2024-01-15T10:30:00Z",
    "category": "positive"
})

# Record conversion event
Netra.set_custom_event(event_name="conversion", attributes={
    "type": "subscription",
    "plan": "premium",
    "value": 99.99,
    "currency": "USD",
    "source": "website",
    "campaign": "spring_sale"
})

# Record error event
Netra.set_custom_event(event_name="error_occurred", attributes={
    "error_type": "authentication",
    "error_message": "Invalid credentials",
    "severity": "high",
    "user_action": "login"
})

// Record user feedback event
Netra.setCustomEvent({
  event_name: "user_feedback",
  attributes: {
    rating: 5,
    comment: "Great response!",
    timestamp: "2024-01-15T10:30:00Z",
    category: "positive",
  },
});

// Record conversion event
Netra.setCustomEvent({
  event_name: "conversion",
  attributes: {
    type: "subscription",
    plan: "premium",
    value: 99.99,
    currency: "USD",
    source: "website",
    campaign: "spring_sale",
  },
});

// Record error event
Netra.setCustomEvent({
  event_name: "error_occurred",
  attributes: {
    error_type: "authentication",
    error_message: "Invalid credentials",
    severity: "high",
    user_action: "login",
  },
});