> ## 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.

   <img src="https://mintcdn.com/nebulyai/lp4-QBkfRC1qixQc/integrations/langfuse/images/platform_settings_page.png?fit=max&auto=format&n=lp4-QBkfRC1qixQc&q=85&s=50d5f35d87bd7ce538e86a8de1746878" alt="Nebuly – Langfuse integration settings" style={{ maxWidth: '100%', border: '1px solid #ddd', borderRadius: '8px', margin: '20px 0' }} width="2056" height="996" data-path="integrations/langfuse/images/platform_settings_page.png" />

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.