Skip to content

Commit 8f58a7d

Browse files
push
1 parent 6eaf127 commit 8f58a7d

File tree

1 file changed

+46
-51
lines changed

1 file changed

+46
-51
lines changed

docs/cloud/features/09_AI_ML/langfuse.md

Lines changed: 46 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -13,28 +13,35 @@ import TabItem from '@theme/TabItem';
1313

1414
## What is Langfuse? {#what-is-langfuse}
1515

16-
Langfuse is an open-source LLM engineering platform that helps teams collaboratively debug, analyze, and iterate on their LLM applications. It is part of the ClickHouse ecosystem and relies on **ClickHouse** at its core to provide a scalable, high-performance observability backend.
16+
[Langfuse](https://langfuse.com) is an open-source LLM engineering platform that helps teams collaboratively debug, analyze, and iterate on their LLM applications. It is part of the ClickHouse ecosystem and relies on **ClickHouse** at its core to provide a scalable, high-performance observability backend.
1717

1818
By leveraging ClickHouse's columnar storage and fast analytical capabilities, Langfuse can handle billions of traces and events with low latency, making it suitable for high-throughput production workloads.
1919

20+
## Why Langfuse? {#why-langfuse}
21+
22+
- **Open source:** Fully open source with public API for custom integrations
23+
- **Production optimized:** Designed with minimal performance overhead
24+
- **Best-in-class SDKs:** Native SDKs for Python and JavaScript
25+
- **Framework support:** Integrated with popular frameworks like OpenAI SDK, LangChain, and LlamaIndex
26+
- **Multi-modal:** Support for tracing text, images and other modalities
27+
- **Full platform:** Suite of tools for the complete LLM application development lifecycle
28+
2029
## Deployment Options {#deployment-options}
2130

22-
Langfuse offers flexible deployment options to meet different security and infrastructure needs:
31+
Langfuse offers flexible deployment options to meet different security and infrastructure needs.
2332

24-
### Langfuse Cloud
25-
* **Managed Service**: Fully managed by the Langfuse team.
26-
* **Powered by ClickHouse**: Runs on a managed ClickHouse cluster for optimal performance.
27-
* **Security & Compliance**: SOC 2 Type II and ISO 27001 certified. GDPR compliant.
28-
* **Data Regions**: Available in US (AWS us-west-2) and EU (AWS eu-west-1).
33+
**[Langfuse Cloud](https://cloud.langfuse.com)** is a fully managed service powered by a managed ClickHouse cluster for optimal performance. It is SOC 2 Type II and ISO 27001 certified, GDPR compliant, and available in US (AWS us-west-2) and EU (AWS eu-west-1) data regions.
2934

30-
### Self-Hosted
31-
* **Open Source**: Fully open-source (MIT license) and free to use.
32-
* **Infrastructure**: Deploy on your own infrastructure using Docker or Kubernetes.
33-
* **ClickHouse Integration**: You run your own ClickHouse instance (or use ClickHouse Cloud) to store observability data, ensuring complete control over your data.
35+
**[Self-hosted](https://langfuse.com/self-hosting)** Langfuse is fully open-source (MIT license) and free to deploy on your own infrastructure using Docker or Kubernetes. You run your own ClickHouse instance (or use ClickHouse Cloud) to store observability data, ensuring complete control over your data.
3436

3537
## Architecture {#architecture}
3638

37-
Langfuse uses a decoupled architecture to ensure scalability and reliability.
39+
Langfuse only depends on open source components and can be deployed locally, on cloud infrastructure, or on-premises:
40+
41+
* **ClickHouse**: Stores high-volume observability data (traces, spans, generations, scores). It enables fast aggregation and analytics for dashboards.
42+
* **Postgres**: Stores transactional data like user accounts, project configurations, and prompt definitions.
43+
* **Redis**: Handles event queuing and caching.
44+
* **S3/Blob Storage**: Stores large payloads and raw event data.
3845

3946
```mermaid
4047
flowchart TB
@@ -63,164 +70,158 @@ flowchart TB
6370
Worker -..->|"optional for evals"| LLM
6471
```
6572

66-
* **ClickHouse**: Stores high-volume observability data (traces, spans, generations, scores). It enables fast aggregation and analytics for dashboards.
67-
* **Postgres**: Stores transactional data like user accounts, project configurations, and prompt definitions.
68-
* **Redis**: Handles event queuing and caching.
69-
* **S3/Blob Storage**: Stores large payloads and raw event data.
70-
7173
## Features {#features}
7274

7375
### Observability {#observability}
7476

7577
[Observability](/docs/observability/overview) is essential for understanding and debugging LLM applications. Unlike traditional software, LLM applications involve complex, non-deterministic interactions that can be challenging to monitor and debug. Langfuse provides comprehensive tracing capabilities that help you understand exactly what's happening in your application.
7678

79+
_📹 Want to learn more? [**Watch end-to-end walkthrough**](https://langfuse.com/watch-demo?tab=observability) of Langfuse Observability and how to integrate it with your application._
80+
7781
<Tabs groupId="observability">
7882
<TabItem value="trace-details" label="Trace Details">
7983

8084
Traces allow you to track every LLM call and other relevant logic in your app.
8185

82-
<video src="https://static.langfuse.com/docs-videos/trace-new-ui.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
86+
<video src="https://static.langfuse.com/docs-videos/trace-new-ui.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
8387

8488
</TabItem>
8589
<TabItem value="sessions" label="Sessions">
8690

8791
Sessions allow you to track multi-step conversations or agentic workflows.
8892

89-
<video src="https://static.langfuse.com/docs-videos/sessions-new-ui.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
93+
<video src="https://static.langfuse.com/docs-videos/sessions-new-ui.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
9094

9195
</TabItem>
9296
<TabItem value="timeline" label="Timeline">
9397

9498
Debug latency issues by inspecting the timeline view.
9599

96-
<video src="https://static.langfuse.com/docs-videos/timeline-new-ui.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
100+
<video src="https://static.langfuse.com/docs-videos/timeline-new-ui.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
97101

98102
</TabItem>
99103
<TabItem value="users" label="Users">
100104

101105
Add your own `userId` to monitor costs and usage for each user. Optionally, create a deep link to this view in your systems.
102106

103-
<video src="https://static.langfuse.com/docs-videos/users-new-ui.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
107+
<video src="https://static.langfuse.com/docs-videos/users-new-ui.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
104108

105109
</TabItem>
106110
<TabItem value="agent-graphs" label="Agent Graphs">
107111

108112
LLM agents can be visualized as a graph to illustrate the flow of complex agentic workflows.
109113

110-
<video src="https://static.langfuse.com/docs-videos/langgraph-new-ui.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
114+
<video src="https://static.langfuse.com/docs-videos/langgraph-new-ui.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
111115

112116
</TabItem>
113117
<TabItem value="dashboard" label="Dashboard">
114118

115119
See quality, cost, and latency metrics in the dashboard to monitor your LLM application.
116120

117-
<video src="https://static.langfuse.com/docs-videos/dashboard.mp4%20MOVED%20TO%20R2.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
121+
<video src="https://static.langfuse.com/docs-videos/dashboard.mp4%20MOVED%20TO%20R2.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
118122

119123
</TabItem>
120124
</Tabs>
121125

122-
:::info
123-
Want to learn more? [**Watch end-to-end walkthrough**](https://langfuse.com/watch-demo?tab=observability) of Langfuse Observability and how to integrate it with your application.
124-
:::
125126

126127
### Prompt Management {#prompt-management}
127128

128129
[Prompt Management](/docs/prompt-management/overview) is critical in building effective LLM applications. Langfuse provides tools to help you manage, version, and optimize your prompts throughout the development lifecycle.
129130

131+
_📹 Want to learn more? [**Watch end-to-end walkthrough**](https://langfuse.com/watch-demo?tab=prompt) of Langfuse Prompt Management and how to integrate it with your application._
132+
130133
<Tabs groupId="prompt-management">
131134
<TabItem value="create" label="Create">
132135

133136
Create a new prompt via UI, SDKs, or API.
134137

135-
<video src="https://static.langfuse.com/docs-videos/create-update-prompts.mp4%20MOVED%20TO%20R2.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
138+
<video src="https://static.langfuse.com/docs-videos/create-update-prompts.mp4%20MOVED%20TO%20R2.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
136139

137140
</TabItem>
138141
<TabItem value="version-control" label="Version Control">
139142

140143
Collaboratively version and edit prompts via UI, API, or SDKs.
141144

142-
<video src="https://static.langfuse.com/docs-videos/create-prompt-version.mp4%20MOVED%20TO%20R2.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
145+
<video src="https://static.langfuse.com/docs-videos/create-prompt-version.mp4%20MOVED%20TO%20R2.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
143146

144147
</TabItem>
145148
<TabItem value="deploy" label="Deploy">
146149

147150
Deploy prompts to production or any environment via labels - without any code changes.
148151

149-
<video src="https://static.langfuse.com/docs-videos/deploy-prompt.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
152+
<video src="https://static.langfuse.com/docs-videos/deploy-prompt.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
150153

151154
</TabItem>
152155
<TabItem value="metrics" label="Metrics">
153156

154157
Compare latency, cost, and evaluation metrics across different versions of your prompts.
155158

156-
<video src="https://static.langfuse.com/docs-videos/prompt-metrics.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
159+
<video src="https://static.langfuse.com/docs-videos/prompt-metrics.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
157160

158161
</TabItem>
159162
<TabItem value="test-in-playground" label="Test in Playground">
160163

161164
Instantly test your prompts in the playground.
162165

163-
<video src="https://static.langfuse.com/docs-videos/prompt-to-playground.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
166+
<video src="https://static.langfuse.com/docs-videos/prompt-to-playground.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
164167

165168
</TabItem>
166169
<TabItem value="link-with-traces" label="Link with Traces">
167170

168171
Link prompts with traces to understand how they perform in the context of your LLM application.
169172

170-
<video src="https://static.langfuse.com/docs-videos/linked-generations.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
173+
<video src="https://static.langfuse.com/docs-videos/linked-generations.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
171174

172175
</TabItem>
173176
<TabItem value="track-changes" label="Track Changes">
174177

175178
Track changes to your prompts to understand how they evolve over time.
176179

177-
<video src="https://static.langfuse.com/docs-videos/track-changes.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
180+
<video src="https://static.langfuse.com/docs-videos/track-changes.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
178181

179182
</TabItem>
180183
</Tabs>
181184

182-
:::info
183-
Want to learn more? [**Watch end-to-end walkthrough**](https://langfuse.com/watch-demo?tab=prompt) of Langfuse Prompt Management and how to integrate it with your application.
184-
:::
185-
186185
### Evaluation & Datasets {#evaluation}
187186

188187
[Evaluation](/docs/evaluation/overview) is crucial for ensuring the quality and reliability of your LLM applications. Langfuse provides flexible evaluation tools that adapt to your specific needs, whether you're testing in development or monitoring production performance.
189188

189+
_📹 Want to learn more? [**Watch end-to-end walkthrough**](https://langfuse.com/watch-demo?tab=evaluation) of Langfuse Evaluation and how to use it to improve your LLM application._
190+
190191
<Tabs groupId="evaluation">
191192
<TabItem value="analytics" label="Analytics">
192193

193194
Plot evaluation results in the Langfuse Dashboard.
194195

195-
<video src="https://static.langfuse.com/docs-videos/scores-dashboard.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
196+
<video src="https://static.langfuse.com/docs-videos/scores-dashboard.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
196197

197198
</TabItem>
198199
<TabItem value="user-feedback" label="User Feedback">
199200

200201
Collect feedback from your users. Can be captured in the frontend via our Browser SDK, server-side via the SDKs or API. Video includes example application.
201202

202-
<video src="https://static.langfuse.com/docs-videos/scores-user-feedback.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
203+
<video src="https://static.langfuse.com/docs-videos/scores-user-feedback.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
203204

204205
</TabItem>
205206
<TabItem value="llm-as-a-judge" label="LLM-as-a-Judge">
206207

207208
Run fully managed LLM-as-a-judge evaluations on production or development traces. Can be applied to any step within your application for step-wise evaluations.
208209

209-
<video src="https://static.langfuse.com/docs-videos/scores-llm-as-a-judge.mp4%20MOVED%20TO%20R2.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
210+
<video src="https://static.langfuse.com/docs-videos/scores-llm-as-a-judge.mp4%20MOVED%20TO%20R2.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
210211

211212
</TabItem>
212213
<TabItem value="experiments" label="Experiments">
213214

214215
Evaluate prompts and models on datasets directly in the user interface. No custom code is needed.
215216

216-
<video src="https://static.langfuse.com/docs-videos/prompt-experiments.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
217+
<video src="https://static.langfuse.com/docs-videos/prompt-experiments.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
217218

218219
</TabItem>
219220
<TabItem value="annotation-queue" label="Annotation Queue">
220221

221222
Baseline your evaluation workflow with human annotations via Annotation Queues.
222223

223-
<video src="https://static.langfuse.com/docs-videos/scores-annotation-queue.mp4" autoPlay loop muted playsInline width="70%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
224+
<video src="https://static.langfuse.com/docs-videos/scores-annotation-queue.mp4" autoPlay loop muted playsInline width="100%" style={{boxShadow: "0px 1px 8px -1px rgba(21, 21, 21, 0.20)", borderRadius: "4px"}} />
224225

225226
</TabItem>
226227
<TabItem value="custom-evals" label="Custom Evals">
@@ -245,12 +246,6 @@ langfuse.score(
245246
</Tabs>
246247

247248

248-
249-
:::info
250-
Want to learn more? [**Watch end-to-end walkthrough**](https://langfuse.com/watch-demo?tab=evaluation) of Langfuse Evaluation and how to use it to improve your LLM application.
251-
:::
252-
253-
254249
## Quickstarts {#quickstarts}
255250

256251
Get up and running with Langfuse in minutes. Choose the path that best fits your current needs:
@@ -261,6 +256,6 @@ Get up and running with Langfuse in minutes. Choose the path that best fits your
261256

262257
## Learn more {#learn-more}
263258

264-
* [Langfuse Documentation](https://langfuse.com/docs)
265-
* [Langfuse GitHub Repository](https://github.com/langfuse/langfuse)
266-
* [Watch the Demo Video](https://langfuse.com/watch-demo)
259+
- [Langfuse Documentation](https://langfuse.com/docs)
260+
- [Langfuse GitHub Repository](https://github.com/langfuse/langfuse)
261+
- [Watch the Demo Video](https://langfuse.com/watch-demo)

0 commit comments

Comments
 (0)