Back to Details

langfuse-trace-list

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Langfuse Trace List

Langfuse Trace 列表

Display the latest traces with filtering options.
展示带有筛选选项的最新traces。

Setup

配置

Set the following environment variables before use:
VariableRequiredDescription
LANGFUSE_PUBLIC_KEY
YesLangfuse public key
LANGFUSE_SECRET_KEY
YesLangfuse secret key
LANGFUSE_HOST
or 
LANGFUSE_BASE_URL
NoLangfuse host URL (default: 
https://us.cloud.langfuse.com
)
使用前请设置以下环境变量：
变量是否必填说明
LANGFUSE_PUBLIC_KEY
是Langfuse公钥
LANGFUSE_SECRET_KEY
是Langfuse密钥
LANGFUSE_HOST
或 
LANGFUSE_BASE_URL
否Langfuse主机URL（默认值：
https://us.cloud.langfuse.com
）

When to Use

适用场景

  • Checking the trace list
  • Debugging LLM calls
  • "Show me recent traces"
  • "Check traces for a specific user"
  • 查看trace列表
  • 调试LLM调用
  • "展示我近期的traces"
  • "查看特定用户的traces"

Commands

命令

1. Get Trace List

1. 获取Trace列表

Get the latest 20 traces:
bash
npx tsx scripts/langfuse-trace-list.ts
Specify the number of traces:
bash
npx tsx scripts/langfuse-trace-list.ts --limit=50
获取最新20条traces：
bash
npx tsx scripts/langfuse-trace-list.ts
指定traces数量：
bash
npx tsx scripts/langfuse-trace-list.ts --limit=50

2. Filter Options

2. 筛选选项

bash
undefined
bash
undefined

Filter by trace name

按trace名称筛选

npx tsx scripts/langfuse-trace-list.ts --name=librarian/chat
npx tsx scripts/langfuse-trace-list.ts --name=librarian/chat

Filter by user ID

按用户ID筛选

npx tsx scripts/langfuse-trace-list.ts --user=user-123
npx tsx scripts/langfuse-trace-list.ts --user=user-123

Filter by session ID

按会话ID筛选

npx tsx scripts/langfuse-trace-list.ts --session=session-abc
npx tsx scripts/langfuse-trace-list.ts --session=session-abc

Filter by environment

按环境筛选

npx tsx scripts/langfuse-trace-list.ts --env=production
npx tsx scripts/langfuse-trace-list.ts --env=production

Combine multiple filters

组合多个筛选条件

npx tsx scripts/langfuse-trace-list.ts --name=chat --env=production --limit=100
undefined
npx tsx scripts/langfuse-trace-list.ts --name=chat --env=production --limit=100
undefined

Output Example

输出示例

Langfuse Traces
===============

Timestamp           Name                               User                Session        Cost      ID
----------------------------------------------------------------------------------------------------------------------------------
2025-01-15 10:30:45 librarian/chat                     user-123            session-abc    $0.0150   abc123...
2025-01-15 10:28:12 knowledge-builder/extract          user-456            session-def    $0.0080   def456...
2025-01-15 10:25:33 chat/respond                       user-789            -              $0.0045   ghi789...

Showing 3 of 1234 traces
Langfuse Traces
===============

时间戳           名称                               用户                会话        成本      ID
----------------------------------------------------------------------------------------------------------------------------------
2025-01-15 10:30:45 librarian/chat                     user-123            session-abc    $0.0150   abc123...
2025-01-15 10:28:12 knowledge-builder/extract          user-456            session-def    $0.0080   def456...
2025-01-15 10:25:33 chat/respond                       user-789            -              $0.0045   ghi789...

显示1234条中的3条traces

Fields

字段说明

FieldDescription
TimestampTrace creation timestamp
NameTrace name (feature/action format)
UserUser ID
SessionSession ID
CostEstimated cost
IDTrace ID (for viewing details)
字段说明
时间戳Trace创建时间戳
名称Trace名称（功能/操作格式）
用户用户ID
会话会话ID
成本估算成本
IDTrace ID（用于查看详情）