langfuse-traces

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Langfuse Traces Skill

Query and analyze Langfuse trace data directly from Claude Code.

直接通过Claude Code查询和分析Langfuse追踪数据。

Usage

使用方法

Invoke the query script using the base directory shown above:

bash

bash <base_directory>/scripts/query.sh <command> [options]

使用上方所示的基础目录调用查询脚本：

bash

bash <base_directory>/scripts/query.sh <command> [options]

Commands

命令

Command	Args	Description
`traces`	[limit] [session_id] [name]	List recent traces
`trace`	trace_id	Get full trace with observations
`observations`	[limit] [trace_id]	List spans/generations
`sessions`	[limit]	List sessions
`summary`	[limit]	Compact one-line-per-trace view

命令	参数	描述
`traces`	[limit] [session_id] [name]	列出最近的追踪数据
`trace`	trace_id	获取包含观测数据的完整追踪记录
`observations`	[limit] [trace_id]	列出跨度/生成记录
`sessions`	[limit]	列出会话
`summary`	[limit]	紧凑的每行一条追踪记录视图

Examples

示例

bash

undefined

bash

undefined

List last 20 traces

列出最近20条追踪数据

bash <base_directory>/scripts/query.sh traces 20

Get specific trace detail

获取特定追踪记录详情

bash <base_directory>/scripts/query.sh trace tr-abc123

List observations for a trace

列出某条追踪记录的观测数据

bash <base_directory>/scripts/query.sh observations 50 tr-abc123

Quick summary of recent activity

快速查看近期活动摘要

bash <base_directory>/scripts/query.sh summary 10

undefined

bash <base_directory>/scripts/query.sh summary 10

undefined

Credentials

凭据

The script reads credentials from

.env.local

.env

, or environment variables:

LANGFUSE_PUBLIC_KEY=pk-lf-...
LANGFUSE_SECRET_KEY=sk-lf-...
LANGFUSE_BASE_URL=https://cloud.langfuse.com  # optional, default

脚本从

.env.local

、

.env

或环境变量中读取凭据：

LANGFUSE_PUBLIC_KEY=pk-lf-...
LANGFUSE_SECRET_KEY=sk-lf-...
LANGFUSE_BASE_URL=https://cloud.langfuse.com  # 可选，默认值

Requirements

要求

```
curl
```
(standard on macOS/Linux)
```
jq
```
for JSON parsing

```
curl
```
（macOS/Linux系统默认自带）
```
jq
```
用于JSON解析

Output

输出

All commands return JSON (piped through jq). Use jq filters for specific fields:

bash

bash <base_directory>/scripts/query.sh traces 5 | jq '.data[].name'

所有命令均返回JSON（通过jq管道处理）。可使用jq过滤器提取特定字段：

bash

bash <base_directory>/scripts/query.sh traces 5 | jq '.data[].name'