Environment Variables

export NETRA_APP_NAME="my-ai-service"
export NETRA_ENV="production"

# Production settings
export NETRA_TRACE_CONTENT="true"
export NETRA_DISABLE_BATCH="false"
export NETRA_DEBUG="false"
export BLOCKED_URL_PATTERNS="getnetra.ai"

# Development settings
export NETRA_TRACE_CONTENT="true"
export NETRA_DISABLE_BATCH="true"  # Immediate export for debugging
export NETRA_DEBUG="true"
export BLOCKED_URL_PATTERNS="dev.getnetra.ai"

# Increase limits for verbose applications
export NETRA_ATTRIBUTE_MAX_LEN="100000"
export NETRA_CONVERSATION_CONTENT_MAX_LEN="100000"

export NETRA_RESOURCE_ATTRS='{"deployment.version":"1.2.3","team":"ml-platform"}'

# These work as fallbacks (use endpoint matching your region)
export OTEL_SERVICE_NAME="my-ai-service"
export OTEL_EXPORTER_OTLP_ENDPOINT="https://api.getnetra.ai/telemetry"  # US region
# export OTEL_EXPORTER_OTLP_ENDPOINT="https://api.eu.getnetra.ai/telemetry"  # EU region
export OTEL_EXPORTER_OTLP_HEADERS="x-api-key=your-key"

# Environment
export NETRA_APP_NAME="env-app"
export OTEL_SERVICE_NAME="otel-app"

# Code
Netra.init(app_name="code-app")  # Uses "code-app"
Netra.init()                      # Uses "env-app" (NETRA_ takes precedence over OTEL_)

# .env.development
NETRA_API_KEY="dev-api-key"
NETRA_OTLP_ENDPOINT="https://api.getnetra.ai/telemetry"  # Use endpoint matching your region
NETRA_APP_NAME="my-app-dev"
NETRA_ENV="development"
NETRA_DEBUG="true"
NETRA_DISABLE_BATCH="true"
NETRA_TRACE_CONTENT="true"

# .env.staging
NETRA_API_KEY="staging-api-key"
NETRA_OTLP_ENDPOINT="https://api.getnetra.ai/telemetry"  # Use endpoint matching your region
NETRA_APP_NAME="my-app-staging"
NETRA_ENV="staging"
NETRA_DEBUG="false"
NETRA_DISABLE_BATCH="false"
NETRA_TRACE_CONTENT="true"

# .env.production
NETRA_API_KEY="prod-api-key"
NETRA_OTLP_ENDPOINT="https://api.getnetra.ai/telemetry"  # Use endpoint matching your region
NETRA_APP_NAME="my-app"
NETRA_ENV="production"
NETRA_DEBUG="false"
NETRA_DISABLE_BATCH="false"
NETRA_TRACE_CONTENT="true"
NETRA_ENABLE_SCRUBBING="true"  # Enable PII protection in production

# Using python-dotenv
from dotenv import load_dotenv
load_dotenv()  # Load from .env file

from netra import Netra
Netra.init()  # Automatically picks up environment variables

// Using dotenv
import "dotenv/config";

import { Netra } from "netra-sdk";
await Netra.init({
  appName: process.env.NETRA_APP_NAME || "my-app",
});

# Dockerfile
ENV NETRA_APP_NAME="my-app"
ENV NETRA_ENV="production"

# docker run
docker run -e NETRA_API_KEY="your-key" -e NETRA_ENV="production" my-app

# docker-compose.yml
services:
  app:
    image: my-app
    environment:
      - NETRA_API_KEY=${NETRA_API_KEY}
      - NETRA_OTLP_ENDPOINT=https://api.getnetra.ai/telemetry  # Use endpoint matching your region
      - NETRA_APP_NAME=my-app
      - NETRA_ENV=production

# deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  template:
    spec:
      containers:
        - name: my-app
          env:
            - name: NETRA_API_KEY
              valueFrom:
                secretKeyRef:
                  name: netra-secrets
                  key: api-key
            - name: NETRA_OTLP_ENDPOINT
              value: "https://api.getnetra.ai/telemetry"  # Use endpoint matching your region
            - name: NETRA_APP_NAME
              value: "my-app"
            - name: NETRA_ENV
              value: "production"

# secret.yaml
apiVersion: v1
kind: Secret
metadata:
  name: netra-secrets
type: Opaque
stringData:
  api-key: "your-netra-api-key"