langfuse/langfuse-docs

๐Ÿชข Langfuse ๋ฌธ์„œ โ€” Langfuse๋Š” ์˜คํ”ˆ ์†Œ์Šค LLM ์—”์ง€๋‹ˆ์–ด๋ง ํ”Œ๋žซํผ์ž…๋‹ˆ๋‹ค. ๊ด€์ฐฐ ๊ฐ€๋Šฅ์„ฑ, ํ‰๊ฐ€, ํ”„๋กฌํ”„ํŠธ ๊ด€๋ฆฌ, ํ”Œ๋ ˆ์ด๊ทธ๋ผ์šด๋“œ ๋ฐ ๋ฉ”ํŠธ๋ฆญ์„ ํ†ตํ•ด LLM ์•ฑ์„ ๋””๋ฒ„๊น…ํ•˜๊ณ  ๊ฐœ์„ ํ•˜์„ธ์š”.

langfuse-docs๋ž€ ๋ฌด์—‡์ธ๊ฐ€์š”?

Langfuse ๋ฌธ์„œ ์Šคํ‚ฌ์€ ๊ฐœ๋ฐœ์ž์™€ AI ์—์ด์ „ํŠธ๊ฐ€ Langfuse ํ”Œ๋žซํผ์„ ํšจ๊ณผ์ ์œผ๋กœ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ๋„๋ก ์ง€์›ํ•˜๋Š” ๊ธฐ์ˆ  ๋ฌธ์„œ์ž…๋‹ˆ๋‹ค. Langfuse๋Š” LLM ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์˜ ๊ด€์ฐฐ ๊ฐ€๋Šฅ์„ฑ(observability), ํ‰๊ฐ€(evals), ํ”„๋กฌํ”„ํŠธ ๊ด€๋ฆฌ, ํ”Œ๋ ˆ์ด๊ทธ๋ผ์šด๋“œ, ๋ฉ”ํŠธ๋ฆญ์„ ์ œ๊ณตํ•˜๋Š” ์˜คํ”ˆ ์†Œ์Šค LLM ์—”์ง€๋‹ˆ์–ด๋ง ํ”Œ๋žซํผ์ž…๋‹ˆ๋‹ค. ์ด ์Šคํ‚ฌ์€ Claude Code, Cursor, Codex ๋“ฑ ๋‹ค์–‘ํ•œ AI ์—์ด์ „ํŠธ ํ™˜๊ฒฝ์—์„œ ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•˜๋ฉฐ, Langfuse API, SDK ์„ค์ •, ๋ฐ์ดํ„ฐ ์ˆ˜์ง‘ ๋ฐฉ๋ฒ•, ํ”„๋กฌํ”„ํŠธ ํ…œํ”Œ๋ฆฟ ๊ด€๋ฆฌ ๊ธฐ๋ฒ• ๋“ฑ์„ ์ƒ์„ธํžˆ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค. ํŠนํžˆ LLM ์•ฑ์˜ ๋””๋ฒ„๊น…๊ณผ ์„ฑ๋Šฅ ๊ฐœ์„ ์— ์ดˆ์ ์„ ๋งž์ถฐ, ์‹ค์‹œ๊ฐ„ ํŠธ๋ ˆ์ด์‹ฑ, ๋น„์šฉ ๋ถ„์„, ํ’ˆ์งˆ ํ‰๊ฐ€ ๋“ฑ์˜ ๊ธฐ๋Šฅ์„ ์ฝ”๋“œ ์˜ˆ์ œ์™€ ํ•จ๊ป˜ ์ œ๊ณตํ•˜์—ฌ ๊ฐœ๋ฐœ์ž๊ฐ€ ์ƒ์‚ฐ์„ฑ์„ ๊ทน๋Œ€ํ™”ํ•  ์ˆ˜ ์žˆ๋„๋ก ๋•์Šต๋‹ˆ๋‹ค.

์ง€์› ๋Œ€์ƒ~Claude Code~Codex CLI~Cursor
npx skills add langfuse/langfuse-docs

Installed? Explore more ์ฝ”๋”ฉ & ๊ฐœ๋ฐœ skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli ยท View all 6 โ†’

์ฆ๊ฒจ ์‚ฌ์šฉํ•˜๋Š” AI์—๊ฒŒ ๋ฌผ์–ด๋ณด๊ธฐ

์ด ์—์ด์ „ํŠธ ์Šคํ‚ฌ์ด ๋ฏธ๋ฆฌ ๋กœ๋“œ๋œ ์ƒˆ ์ฑ„ํŒ…์„ ์—ฝ๋‹ˆ๋‹ค.

๋ฌธ์„œ

langfuse-docs์€(๋Š”) ๋ฌด์—‡์„ ํ•˜๋‚˜์š”?

๐Ÿชข Langfuse ๋ฌธ์„œ โ€” Langfuse๋Š” ์˜คํ”ˆ ์†Œ์Šค LLM ์—”์ง€๋‹ˆ์–ด๋ง ํ”Œ๋žซํผ์ž…๋‹ˆ๋‹ค. ๊ด€์ฐฐ ๊ฐ€๋Šฅ์„ฑ, ํ‰๊ฐ€, ํ”„๋กฌํ”„ํŠธ ๊ด€๋ฆฌ, ํ”Œ๋ ˆ์ด๊ทธ๋ผ์šด๋“œ ๋ฐ ๋ฉ”ํŠธ๋ฆญ์„ ํ†ตํ•ด LLM ์•ฑ์„ ๋””๋ฒ„๊น…ํ•˜๊ณ  ๊ฐœ์„ ํ•˜์„ธ์š”.

๊ฐœ์š”

Langfuse๋Š” LLM ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜ ๊ฐœ๋ฐœ์„ ์œ„ํ•œ ์˜คํ”ˆ ์†Œ์Šค ํ”Œ๋žซํผ์ž…๋‹ˆ๋‹ค. ์ด ๋ฌธ์„œ๋Š” Langfuse์˜ ์ฃผ์š” ๊ธฐ๋Šฅ๊ณผ ์‚ฌ์šฉ ๋ฐฉ๋ฒ•์„ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค.

์ฃผ์š” ๊ธฐ๋Šฅ

  • ๊ด€์ฐฐ ๊ฐ€๋Šฅ์„ฑ (Observability): LLM ํ˜ธ์ถœ์˜ ์ถ”์ , ๋กœ๊น…, ๋ชจ๋‹ˆํ„ฐ๋ง
  • ํ‰๊ฐ€ (Evals): LLM ์ถœ๋ ฅ์˜ ํ’ˆ์งˆ ํ‰๊ฐ€ ๋ฐ ์ž๋™ํ™”๋œ ํ…Œ์ŠคํŠธ
  • ํ”„๋กฌํ”„ํŠธ ๊ด€๋ฆฌ (Prompt Management): ํ”„๋กฌํ”„ํŠธ ํ…œํ”Œ๋ฆฟ ๊ด€๋ฆฌ ๋ฐ ๋ฒ„์ „ ๊ด€๋ฆฌ
  • ํ”Œ๋ ˆ์ด๊ทธ๋ผ์šด๋“œ (Playground): ์‹ค์‹œ๊ฐ„ ํ”„๋กฌํ”„ํŠธ ์‹คํ—˜ ๋ฐ ๋น„๊ต
  • ๋ฉ”ํŠธ๋ฆญ (Metrics): ๋น„์šฉ, ์ง€์—ฐ ์‹œ๊ฐ„, ์ •ํ™•๋„ ๋“ฑ์˜ ์„ฑ๋Šฅ ์ง€ํ‘œ

์ง€์› ํ”Œ๋žซํผ

  • Claude Code
  • Cursor
  • Codex
  • ๊ธฐํƒ€ AI ์—์ด์ „ํŠธ ๋„๊ตฌ

์‚ฌ์šฉ ๋ฐฉ๋ฒ•

  1. ์„ค์น˜
npm install langfuse
  1. ์ดˆ๊ธฐํ™”
import Langfuse from 'langfuse';

const langfuse = new Langfuse({
  secretKey: 'YOUR_SECRET_KEY',
  publicKey: 'YOUR_PUBLIC_KEY',
  baseUrl: 'https://cloud.langfuse.com'
});
  1. ํŠธ๋ ˆ์ด์‹ฑ
const trace = langfuse.trace({ name: 'my-trace' });
const span = trace.span({ name: 'llm-call' });

// LLM ํ˜ธ์ถœ ๋กœ์ง

span.end();
trace.end();

์ฐธ๊ณ  ์ž๋ฃŒ

๊ด€๋ จ ์Šคํ‚ฌ