langfuse-common-errors

Featured

Diagnose and fix common Langfuse errors and exceptions. Use when encountering Langfuse errors, debugging missing traces, or troubleshooting integration issues. Trigger with phrases like "langfuse error", "fix langfuse", "langfuse not working", "debug langfuse", "traces not appearing".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Langfuse Common Errors ## Overview Diagnostic reference for the 10 most common Langfuse integration errors, with real error messages, root causes, and tested solutions. ## Prerequisites - Langfuse SDK installed - API credentials configured - Access to application logs or console output ## Error Reference ### 1. Authentication Failed (401) **Error:** ``` Langfuse: Unauthorized - Invalid API key Error: 401 Unauthorized ``` **Cause:** API key missing, expired, revoked, or keys from wrong project. **Fix:** ```bash set -euo pipefail # Verify env vars are set echo "Public: ${LANGFUSE_PUBLIC_KEY:0:15}..." echo "Secret: ${LANGFUSE_SECRET_KEY:0:10}..." # Test auth against API HOST="${LANGFUSE_BASE_URL:-https://cloud.langfuse.com}" curl -s -o /dev/null -w "HTTP %{http_code}" \ "$HOST/api/public/health" # Auth test curl -s -o /dev/null -w "HTTP %{http_code}" \ -H "Authorization: Basic $(echo -n "$LANGFUSE_PUBLIC_KEY:$LANGFUSE_SECRET_KEY" | base64)" \ "$HOST/api/public/traces?limit=1" ``` ### 2. Traces Not Appearing in Dashboard **Symptom:** Code runs without errors but no traces show in UI. **Root causes (in order of likelihood):** 1. Data not flushed before process exits 2. Wrong project keys (traces going to different project) 3. Dashboard filter hiding traces **Fix:** ```typescript // v4+: Ensure OTel SDK is shut down properly const sdk = new NodeSDK({ spanProcessors: [new LangfuseSpanProcessor()] }); sdk.start(); // ... your code ... await sdk.shutdown(); // MUS...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

langfuse-install-auth

Install and configure Langfuse SDK authentication for LLM observability. Use when setting up a new Langfuse integration, configuring API keys, or initializing Langfuse tracing in your project. Trigger with phrases like "install langfuse", "setup langfuse", "langfuse auth", "configure langfuse API key", "langfuse tracing setup".

2,926 Updated yesterday
jeremylongshore
AI & Automation Featured

langfuse-observability

Set up comprehensive observability for Langfuse with metrics, dashboards, and alerts. Use when implementing monitoring for LLM operations, setting up dashboards, or configuring alerting for Langfuse integration health. Trigger with phrases like "langfuse monitoring", "langfuse metrics", "langfuse observability", "monitor langfuse", "langfuse alerts", "langfuse dashboard".

2,926 Updated yesterday
jeremylongshore
AI & Automation Listed

langfuse

Interact with Langfuse and access its documentation: tracing, monitoring, creating datasets, running experiments, and evaluating AI applications. Use when needing to (1) query or modify Langfuse data, (2) look up Langfuse documentation, concepts, integration guides, a feature or SDK usage, or (3) do any AI engineering task (AI observability, prompt engineering/management, evaluation and evaluator management, experimentation, dataset management, evaluation-driven CI/CD, feedback collection). Invoke it for tasks in this scope even when Langfuse is not configured or explicitly mentioned.

0 Updated yesterday
VectorInstitute