langfuse-debug-bundle

name	langfuse-debug-bundle
description	Collect Langfuse debug evidence for support tickets and troubleshooting. Use when encountering persistent issues, preparing support tickets, or collecting diagnostic information for Langfuse problems. Trigger with phrases like "langfuse debug", "langfuse support bundle", "collect langfuse logs", "langfuse diagnostic", "langfuse troubleshoot".
allowed-tools	Read, Bash(grep:*), Bash(curl:*), Bash(tar:*), Grep
version	1.12.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","langfuse","debugging"]
compatibility	Designed for Claude Code

Langfuse Debug Bundle

Current State

!node --version 2>/dev/null || echo 'N/A' !python3 --version 2>/dev/null || echo 'N/A' !npm list langfuse @langfuse/client @langfuse/tracing 2>/dev/null | head -5 || echo 'No langfuse packages'

Overview

Collect all diagnostic information needed for Langfuse support tickets: environment versions, SDK config, API connectivity, redacted logs, and a reproduction template.

Prerequisites

• Langfuse SDK installed
• Access to application logs
• Bash shell available

Instructions

Step 1: Run the Full Debug Bundle Script

Save this as langfuse-debug.sh and run it:

#!/bin/bash
set -euo pipefail

BUNDLE_DIR="langfuse-debug-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BUNDLE_DIR"

echo "=== Langfuse Debug Bundle ===" | tee "$BUNDLE_DIR/summary.txt"
echo "Generated: $(date)" | tee -a "$BUNDLE_DIR/summary.txt"

# --- Environment ---
{
  echo ""
  echo "--- Environment ---"
  echo "Node.js: $(node --version 2>/dev/null || echo 'not installed')"
  echo "Python: $(python3 --version 2>/dev/null || echo 'not installed')"
  echo "npm: $(npm --version 2>/dev/null || echo 'not installed')"
  echo "OS: $(uname -srm)"
} >> 


{
   
   
  npm list langfuse @langfuse/client @langfuse/tracing @langfuse/otel @langfuse/openai @langfuse/langchain 2>/dev/null ||  
  pip show langfuse 2>/dev/null | grep -E  ||  
} >> 


{
   
   
   
   
   
   
} >> 


{
   
   
  HOST=
   
   -n 
  curl -s -o /dev/null -w   2>/dev/null ||  
   

   [ -n  ] && [ -n  ]; 
    AUTH=$( -n  | )
     -n 
    curl -s -o /dev/null -w  \
      -H  \
       2>/dev/null ||  
     
  
} >> 


 [ -d  ]; 
  grep -i  logs/*. 2>/dev/null | \
     -100 | \
    sed  | \
    sed  \
    >  2>/dev/null || 



 [ -f  ]; 
  grep -A 100  package.json |  -60 >  2>/dev/null || 



 >  << 



- Node.js version:
- Langfuse SDK version:
- Langfuse host: Cloud / Self-hosted (version: )


1.
2.
3.