Langfuse Session List

Display the latest sessions.

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 session list
• Analyzing conversation flows
• "Show me the recent sessions"
• "Check session activity"

Commands

1. Get Session List

Get the latest 20 sessions:

npx tsx scripts/langfuse-session-list.ts

Specify the number of sessions:

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

Output Example

Langfuse Sessions
=================

Created At          Session ID                                         Trace Count
-------------------------------------------------------------------------------------
2025-01-15 10:30:45 session-abc-123-456-789                            15
2025-01-15 10:28:12 session-def-234-567-890                            8
2025-01-15 10:25:33 session-ghi-345-678-901                            3

Showing 3 of 456 sessions

Fields

Field	Description
Created At	Session creation timestamp
Session ID	Session identifier
Trace Count	Number of traces in the session

What is a Session?

A session groups multiple traces together.

• 1 conversation thread = 1 session
• All traces within a session are associated
• You can filter traces by session ID