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

# User Tracking

Identify your users, track their cost, conversations and more.

<img src="https://mintcdn.com/lunary/vczTtzy07XKKcaZn/media/docs/features/users.png?fit=max&auto=format&n=vczTtzy07XKKcaZn&q=85&s=d933944893652c32975b66fa049e19dd" alt="User tracking" width="1364" height="404" data-path="media/docs/features/users.png" />

The strict minimum to enable user tracking is to report a `userId`, however you can report any property you'd like such as an email or name using an `userProps` object.

## Tracking users with the backend SDK

<CardGroup cols={2}>
  <Card title="Python" icon="python" href="/integrations/python/installation">
    Learn how to install the Python SDK.
  </Card>

  <Card title="JavaScript" icon="js" href="/integrations/javascript/installation">
    Learn how to install the JS SDK.
  </Card>
</CardGroup>

### Identify OpenAI calls

The easiest way to get started tracking users is to send user data with your OpenAI API call.

<Tabs>
  <Tab title="Javascript">
    ```js theme={null}
    const res = await openai.chat.completions.create({
      model: "gpt-4o",
      messages: [{ role: "user", content: "Hello" }],
      user: "user123",
      userProps: { name: "John" },
    })
    ```
  </Tab>

  <Tab title="Python">
    ```py theme={null}
    chat_completion = client.chat.completions.create(
      model="gpt-4o", 
      messages=[{"role": "user", "content": "Hello"}],
      user_id="user123",
      user_props={ "name": "John" }
    )
    ```
  </Tab>
</Tabs>

If you're using LangChain, you can similarly pass user data as metadata.

<Tabs>
  <Tab title="Javascript">
    ```js theme={null}
    const chat = new ChatOpenAI({
      callbacks: [new LunaryHandler()],
    });

    const res = await chat.call([new HumanMessage("Hello!")], {
    metadata: {
    userId: "123",
    userProps: { name: "John" },
    },
    });

    ```
  </Tab>

  <Tab title="Python">
    ```py theme={null}
    handler = LunaryCallbackHandler()

    chat = ChatOpenAI(
      callbacks=[handler],
      metadata={
        "user_id": "user123"
      },  # Assigning user ids to models in the metadata
    )
    ```
  </Tab>
</Tabs>

### Advanced: Inject user into context

When tracking traces, you can inject user data into the context using the `identify` methods. This will cascade down to all the child runs.

<Tabs>
  <Tab title="Javascript">
    ```js theme={null}
    async function TranslatorAgent(input) {
      // Some AI queries
      // Everything done in this context will be tracked with the user
    }

    // Wrap the agent with the monitor
    const translate = lunary.wrapAgent(TranslatorAgent)

    // Using identify to inject the user into the context
    const res = await translate(`Hello, what's your name?`)
    .identify("user123", { email: "email@example.org" })

    ```
  </Tab>

  <Tab title="Python">
    ```py theme={null}
    import lunary

    def my_agent():
      # Some AI queries
      # Everything done in this context will be tracked with the user

    def main():
      # Using identify to inject the user into the context
      with lunary.identify('user123', user_props={"email": "email@example.org"}):
        my_agent()
    ```
  </Tab>
</Tabs>

## Identifying users on the frontend

If you are [tracking chat messages](/features/chats) or [feedback](/features/feedback) on the frontend, you can use the `identify` method to identify the user there.

```js theme={null}
lunary.identify("user123", {
  email: "test@example.org",
});
```

## Identifying Threads

If you are using [threads](/features/threads) to track conversations, you can pass `userId` and `userProps` to the `openThread` method.

```js theme={null}
const thread = await lunary.openThread({
  userId: "user123",
  userProps: { name: "John" },
});
```

## User Properties

While you can track any property you'd like, we recommend using the following ones:

| Property | Description                             |
| -------- | --------------------------------------- |
| `name`   | Name of the user                        |
| `email`  | Email of the user                       |
| `avatar` | URL to an avatar                        |
| `group`  | Group or company ID the user belongs to |