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

# Overview

> Get started with Netra in minutes. Learn to instrument your AI app, view traces, run automated evaluations, and configure AI performance alerts.

Let us get started by signing up to your Netra account.

<AccordionGroup>
  <Accordion title="To create an account" defaultOpen={true}>
    * Go to the [Netra Sign Up page](https://app.eu.getnetra.ai/signup)
    * Select your **Data Region** (USA or Europe)
    * Enter your **Email address** or click on **Sign up with Google** and continue
    * A verification code will be sent to your **Email address**
    * Once verified, enter your **First Name** and **Last Name**
    * Create a password and click **Create Account** — you will be redirected to the Netra dashboard
  </Accordion>

  <Accordion title="Already a user?">
    * Go to the [Netra Login page](https://app.eu.getnetra.ai/login)
    * Select your **Data Region** (USA or Europe)
    * Login using **Email address** and **Password** or login using your **Google account**
  </Accordion>
</AccordionGroup>

***

## Data Regions

Netra is available in two data regions:

| Region | Location                 | API Endpoint                           |
| ------ | ------------------------ | -------------------------------------- |
| **US** | N. Virginia (us-east-1)  | `https://api.getnetra.ai/telemetry`    |
| **EU** | Frankfurt (eu-central-1) | `https://api.eu.getnetra.ai/telemetry` |

<Note>
  Regions are strictly separated, and no data is shared across regions. Choosing a region close to you can help improve speed and comply with local data residency laws and privacy regulations. You can have accounts in multiple regions, but each region requires a separate subscription.
</Note>

***

## You're all set to begin

Once you sign up and log in, you're automatically part of a **default organization** with a **default project** ready to go. You can start instrumenting your AI application right away, or take a moment to organize your workspace first.

<Tip>
  **Want to keep things organized?** Create separate projects to organize your work however makes sense for you — by environment, application, team, or any other structure. Or jump straight in with the default project — you can always restructure later.
</Tip>

### Step 1: Choose your project (optional)

You can use the default project to get started immediately, or create a dedicated project for your application:

<Accordion title="Create a new project">
  Projects are workspaces that help you organize observability data across different environments or applications.

  1. Go to **Settings** on the bottom left side of the screen
  2. Click on **Projects** under **Organisation**
  3. Click **Create Project** on the top right
  4. Give your project a name and click create

  You can always switch between projects or create more as your needs evolve.
</Accordion>

### Step 2: Create your API key

Every request to Netra needs to be authenticated. Let's generate your API key:

1. Go to **Settings** → **Project** → **API keys**
2. Click **Create Secret Key**
3. Give your key a name and click **Create Key**

<Warning>Copy and store this token securely — you won't be able to see it again. This key authenticates all your API requests.</Warning>

### Step 3: Configure Netra Credentials as your Environment Variables

Add your API key and endpoint to your environment variables. Use the endpoint that matches your selected data region:

<CodeGroup>
  ```bash US Region theme={null}
  export NETRA_OTLP_ENDPOINT="https://api.getnetra.ai/telemetry"
  export NETRA_API_KEY="your-api-key-here"
  ```

  ```bash EU Region theme={null}
  export NETRA_OTLP_ENDPOINT="https://api.eu.getnetra.ai/telemetry"
  export NETRA_API_KEY="your-api-key-here"
  ```
</CodeGroup>

### Step 4: Install the SDK

Install Netra in your environment with a single command:

<CodeGroup>
  ```bash pip theme={null}
  pip install netra-sdk
  ```

  ```bash poetry theme={null}
  poetry add netra-sdk
  ```

  ```bash npm theme={null}
  npm install netra-sdk
  ```

  ```bash yarn theme={null}
  yarn add netra-sdk
  ```
</CodeGroup>

### Step 5: Initialize Netra in your application

Add two lines to your application to start capturing traces:

<CodeGroup>
  ```python Python theme={null}
  from netra import Netra

  Netra.init(app_name="Your application name")
  ```

  ```typescript TypeScript theme={null}
  import { Netra } from 'netra-sdk';

  Netra.init({ appName: 'Your application name' });
  ```
</CodeGroup>

That's it! Netra automatically uses your environment variables for authentication.

#### Custom Configuration

If you prefer to configure credentials directly in code or need additional options:

<CodeGroup>
  ```python Python theme={null}
  from netra import Netra

  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="production"
  )
  ```

  ```typescript TypeScript theme={null}
  import { Netra } from 'netra-sdk';

  Netra.init({
      appName: 'Your application name',
      apiKey: 'Your API key',
      traceContent: true,
      environment: 'production'
  });
  ```
</CodeGroup>

***

## What's next?

You're now ready to explore Netra's capabilities. Choose where to start based on what matters most to your team:

<CardGroup cols={2}>
  <Card title="Run Simulations" icon="flask" href="/quick-start/QuickStart_Simulation">
    Test your agents with realistic, multi-turn conversations using configurable personas and goals
  </Card>

  <Card title="Run Evaluations" icon="clipboard-check" href="/quick-start/QuickStart_Evals">
    Measure quality, accuracy, and reliability with LLM-as-Judge and code evaluators
  </Card>

  <Card title="Set Up Tracing" icon="route" href="/quick-start/QuickStart_Tracing">
    Capture every LLM call, tool invocation, and decision your agent makes
  </Card>

  <Card title="Configure Alerts" icon="bell" href="/quick-start/QuickStart_Alerts">
    Get notified about anomalies, cost spikes, and performance issues
  </Card>
</CardGroup>