AGENT SKILL

langfuse-incident-runbook

Troubleshoot and respond to Langfuse-related incidents and outages. Use when experiencing Langfuse outages, debugging production issues, or responding to LLM observability incidents. Trigger with phrases like "langfuse incident", "langfuse outage", "langfuse down", "langfuse production issue", "langfuse troubleshoot".

License 许可
MIT
最近更新
2026-05-26
Stars
★ 0
Forks
0

01 前言 Front Matter

name
langfuse-incident-runbook
author
Jeremy Longshore <jeremy@intentsolutions.io>
license
MIT
version
1.0.0
description
Troubleshoot and respond to Langfuse-related incidents and outages. Use when experiencing Langfuse outages, debugging production issues, or responding to LLM observability incidents. Trigger with phrases like "langfuse incident", "langfuse outage", "langfuse down", "langfuse production issue", "langfuse troubleshoot".
allowed-tools
Read, Write, Edit, Bash(curl:*)
compatible-with
claude-code, codex, openclaw

02 资源文件 1

03 SKILL.md 正文

Langfuse Incident Runbook

Contents

Overview

Step-by-step procedures for responding to Langfuse-related incidents, from initial triage through resolution and post-incident review.

Prerequisites

  • Access to Langfuse dashboard
  • Application logs access
  • Metrics/monitoring dashboards
  • Escalation contacts

Instructions

Step 1: Initial Assessment (2 minutes)

Run the quick diagnosis script: check Langfuse status page, API connectivity, auth test, and application metrics.

Step 2: Determine Incident Type

Symptom Likely Cause Action
No traces appearing SDK not flushing Check shutdown handlers, reduce batch size
401/403 errors Auth issue Verify keys match project, check rotation
High latency Rate limits Increase batching, implement circuit breaker
Missing data Partial failures Ensure spans end in finally blocks
Complete outage Langfuse service Enable fallback, queue locally

Step 3: Apply Resolution

Follow the section-specific resolution steps. For outages, activate graceful degradation mode.

Step 4: Post-Incident Review

Verify traces appearing, check error rates normalized, schedule post-mortem for P1/P2.

See detailed implementation for advanced patterns.

Output

  • Incident severity classified
  • Root cause identified
  • Resolution applied
  • Post-incident checklist completed

Error Handling

Severity Description Response Time
P1 Complete outage 15 min
P2 Degraded, partial loss 1 hour
P3 Slow/delayed traces 4 hours
P4 Minor issues 24 hours

Examples

Escalation Contacts

Level Contact When
L1 On-call engineer All incidents
L2 Platform team lead P1/P2 unresolved 30min
L3 Langfuse support Service-side issues

Resources

04 同仓库更多 Skills

SamuelChien
SamuelChien/mega-skills-collection

zustand-store-ts

Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state/action separation. Use when building React state management, creating global stores, or implementing reactive state patterns with Zustand.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zustand-store-creator

Zustand Store Creator - Auto-activating skill for Frontend Development. Triggers on: zustand store creator, zustand store creator Part of the Frontend Development skill category.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zero-trust-config-helper

Zero Trust Config Helper - Auto-activating skill for Security Advanced. Triggers on: zero trust config helper, zero trust config helper Part of the Security Advanced skill category.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zapier-integration-helper

Zapier Integration Helper - Auto-activating skill for Business Automation. Triggers on: zapier integration helper, zapier integration helper Part of the Business Automation skill category.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

zai-cli

Execute z.AI CLI providing vision, search, reader, and GitHub exploration via CLI and MCP. Use when user needs image/video analysis, OCR, UI-to-code conversion, error diagnosis, real-time web search, web page to markdown extraction, or GitHub code exploration. Trigger with phrases like "analyze this image", "search the web for", "read this page", "explore this repo", or "use zai". Requires Z_AI_API_KEY.

★ 0
SamuelChien
SamuelChien/mega-skills-collection

yt-research

Research competitor YouTube channels, niches, and trending topics for your content strategy. Use this skill whenever the user says "research channels", "analyze competitors", "find trending topics", "niche analysis", "competitive research", "what are other creators doing", "scrape YouTube channels", or wants to understand the competitive landscape for a specific tool or topic area. Use when working with yt research. Trigger with 'yt', 'research'.

★ 0