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

# Langfuse

> Integrate Nebuly with Langfuse

Integrating Langfuse with Nebuly lets you stream conversation data from Langfuse into Nebuly in minutes—no code required.

## Prerequisites

Before you connect the two platforms, make sure the following conditions are met:

* In Nebuly, a Langfuse **Trace** maps to an **Interaction**.
* Each Langfuse Trace must contain **exactly one** user–assistant turn (the user question as the `input`, and the **final** agent answer as the `output`).
* Nebuly groups Interactions by the Langfuse `session_id`. If a Trace lacks a `session_id`, the conversation cannot be reconstructed correctly.
* Nebuly fetches only **newer** Traces based on their `timestamp`. If you back-fill Langfuse with older timestamps, Nebuly will not import them. Ensure timestamps increase monotonically.

Have the following information ready:

* **Langfuse public key**
* **Langfuse private key**
* **Langfuse URL** (only if you use a self-hosted instance)

## Enable the integration

1. **Open Settings**\
   Log in to Nebuly and click the **Settings** icon in the top-right corner.

2. **Choose Integrations**\
   Select the **Integrations** tab.

   ![Nebuly – Langfuse integration settings](https://mintcdn.com/nebulyai/a8n2CFtQ82w8GR6M/connectors/langfuse/images/platform_settings_page.png?fit=max\&auto=format\&n=a8n2CFtQ82w8GR6M\&q=85\&s=8755faeabefee2dadba9e60158ac79f3)

3. **Configure Langfuse**
   1. Toggle **Enable integration**.
   2. Enter your **Public key**, **Private key**, and (if self-hosted) **URL**.
   3. (Optional) Set a **Start date** to import only conversations created on or after that date. Leave blank to import all historical data.

4. **Save**\
   Click **Save settings**. Nebuly immediately begins syncing your Langfuse data.

You’re all set—the integration is now active!

## FAQ

**What should I expect to see after enabling the integration?**\
Your Nebuly project will start populating with Interactions fetched from Langfuse. They appear on the **Interactions** page in Nebuly.

**When will my data appear?**\
There can be a delay of **up to 30 minutes** between the moment data is available in Langfuse and when it becomes visible in Nebuly. Subsequent updates follow the same polling interval.


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