Y
Langfuse接続キーの一致性を自動診断する
by yewton
settings.jsonとフックログのLangfuse APIキーが一致しているかを自動診断できます。 「teardown後からフックが動かない」という典型的な問題の原因を特定できます。 キー不一致・未設定・古いログなど複数パターンの判定を表示できます。 Langfuse UIで見るべきプロジェクトキーの確認や、フック動作状況を一目で把握できます。 Langfuse導入者:キーのずれによるトラブルを素早く解決したい方 開発チーム:observability(観測可能性)スタックの動作確認を自動化したい方 システム管理者:Langfuse接続状況を定期確認したい方 フックが動かないトラブルシューティングが必要な方 o11y-check-keysスキルは、設定ファイル(~/.claude/settings.json)と実行ログ(langfuse_hook.log)から、LANGFUSE_PUBLIC_KEY・TRACE_TO_LANGFUSE・LANGFUSE_BASE_URLを抽出して比較検証します。判定は「キー一致(正常)」「キー不一致(新キーで動作中)」「ログに記録なし(初期状態)」「TRACE_TO_LANGFUSE未設定(フック無効)」「Processedログが古い(長期未動作)」の5パターンを示します。キー不一致は必ずしも問題ではなく、langfuse_hook.pyが毎回settings.jsonを読むため自動的に新キーで接続することを前提に、Langfuse UI上で新キー対応プロジェクトを参照しているか確認する手順を提示します。
PR