Langfuse Trace List

Display the latest traces with filtering options.

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)

When to Use

• Checking the trace list
• Debugging LLM calls
• "Show me recent traces"
• "Check traces for a specific user"

Commands

1. Get Trace List

Get the latest 20 traces:

npx tsx scripts/langfuse-trace-list.ts

Specify the number of traces:

npx tsx scripts/langfuse-trace-list.ts --limit=50

2. Filter Options

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

# Filter by user ID
npx tsx scripts/langfuse-trace-list.ts --user=user-123

# Filter by session ID
npx tsx scripts/langfuse-trace-list.ts --session=session-abc

# Filter by environment
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

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

Fields

Field	Description
Timestamp	Trace creation timestamp
Name	Trace name (feature/action format)
User	User ID
Session	Session ID
Cost	Estimated cost
ID	Trace ID (for viewing details)