> ## Documentation Index
> Fetch the complete documentation index at: https://keyvalue.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Session Tracking

> Track user sessions and add custom context

Session tracking in Netra provides powerful capabilities for monitoring user interactions and application behavior. This section covers how to track sessions, add custom context, and record events within your application.

## Setting Up Session Tracking

Before you can start tracking sessions, initialize the Netra SDK:

```python python theme={null}
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}
)
```

## Session Identification

Set unique identifiers for your sessions:

```python python theme={null}
# Set session identification
Netra.set_session_id("unique-session-id")
Netra.set_user_id("user-123")
Netra.set_tenant_id("tenant-456")
```

## Custom Context Attributes

Add custom attributes to enrich your session data:

```python python theme={null}
# 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")
```

## Custom Events

Record important events in your application:

```python python theme={null}
# 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"
})
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.