langfuse-session-view

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Langfuse Session View

Langfuse 会话查看工具

Display detailed information and all traces for a specific session.

展示特定会话的详细信息及所有追踪记录。

Setup

配置步骤

Set the following environment variables before use:

Variable	Required	Description
`LANGFUSE_PUBLIC_KEY`	Yes	Langfuse public key
`LANGFUSE_SECRET_KEY`	Yes	Langfuse secret key
`LANGFUSE_HOST` or `LANGFUSE_BASE_URL`	No	Langfuse host URL (default: `https://us.cloud.langfuse.com` )

使用前请配置以下环境变量：

Variable	Required	Description
`LANGFUSE_PUBLIC_KEY`	是	Langfuse公钥
`LANGFUSE_SECRET_KEY`	是	Langfuse密钥
`LANGFUSE_HOST` or `LANGFUSE_BASE_URL`	否	Langfuse服务地址（默认值： `https://us.cloud.langfuse.com` ）

When to Use

适用场景

Checking specific session details
Analyzing conversation flows
"Show me all traces for this session"
Investigating by session ID

查看特定会话详情
分析对话流程
查询“展示该会话的所有追踪记录”
通过会话ID进行问题排查

Commands

命令说明

1. Get Session Details

1. 获取会话详情

bash

npx tsx scripts/langfuse-session-view.ts <sessionId>

bash

npx tsx scripts/langfuse-session-view.ts <sessionId>

2. Specify Trace Count

2. 指定追踪记录数量

bash

npx tsx scripts/langfuse-session-view.ts <sessionId> --limit=100

bash

npx tsx scripts/langfuse-session-view.ts <sessionId> --limit=100

3. JSON Output

3. 输出JSON格式

bash

npx tsx scripts/langfuse-session-view.ts <sessionId> --json

bash

npx tsx scripts/langfuse-session-view.ts <sessionId> --json

Output Example

输出示例

Langfuse Session Detail
=======================

Session ID: se:9ed69537-5952-40ee-9d98-5e1197fc5726
Created:    2025-01-15 10:30:45
Project:    project-123

Summary:
  Total Traces: 74
  Total Cost:   $0.1234
  Avg Latency:  856ms

Trace Types:
  chunk-extraction: 70
  chunking: 3
  source-parse: 1

Traces (50 of 74):
----------------------------------------------------------------------------------------------------
Timestamp           Name                                    Latency     Cost        ID
----------------------------------------------------------------------------------------------------
2025-01-15 10:30:45 chunk-extraction:abc123                 1234ms      $0.0150     abc123...
2025-01-15 10:30:46 chunk-extraction:def456                 856ms       $0.0080     def456...

Langfuse Session Detail
=======================

Session ID: se:9ed69537-5952-40ee-9d98-5e1197fc5726
Created:    2025-01-15 10:30:45
Project:    project-123

Summary:
  Total Traces: 74
  Total Cost:   $0.1234
  Avg Latency:  856ms

Trace Types:
  chunk-extraction: 70
  chunking: 3
  source-parse: 1

Traces (50 of 74):
----------------------------------------------------------------------------------------------------
Timestamp           Name                                    Latency     Cost        ID
----------------------------------------------------------------------------------------------------
2025-01-15 10:30:45 chunk-extraction:abc123                 1234ms      $0.0150     abc123...
2025-01-15 10:30:46 chunk-extraction:def456                 856ms       $0.0080     def456...

Fields

字段说明

Field	Description
Session ID	Session identifier
Created	Creation timestamp
Project	Project ID
Total Traces	Total number of traces in the session
Total Cost	Estimated total cost for the session
Avg Latency	Average processing time
Trace Types	Trace count by name

Field	Description
Session ID	会话ID
Created	创建时间戳
Project	项目ID
Total Traces	会话中的总追踪记录数
Total Cost	会话的预估总成本
Avg Latency	平均处理时长
Trace Types	按类型统计的追踪记录数