AI GUIDE

Langfuse
セルフホストの手順とLangSmithとの違いを解説

公開日 2026.05.21 / 更新日 2026.06.13 / テック比較ジャーナル編集部

LLMを使ったアプリを作ると、必ずぶつかるのが「中で何が起きているか分からない」問題です。ユーザーの質問にAIがどう答えたか、いくらコストがかかったか、なぜ変な回答をしたのか──。これらを記録・可視化するのが観測性(オブザーバビリティ)ツールで、その代表的なオープンソースがLangfuse(ラングフューズ)です。2026年1月にデータベース大手ClickHouseが関連投資を行ったことでも注目が集まりました。本記事では、Langfuseの機能、Dockerでのセルフホスト手順、LangSmithとの違い、料金体系までを初心者向けに解説します。

Langfuseとは何か

Langfuseは、LLMアプリの動作を記録・可視化するオープンソースの観測性ツールです。AIへの入力(プロンプト)、出力(回答)、使ったトークン数とコスト、処理にかかった時間などを「トレース」として時系列で残します。これにより、開発者は「どの質問でAIが失敗したか」「コストが跳ね上がったのはどこか」をログから追跡できます。

主な機能は次の通りです。

なぜセルフホストが選ばれるのか

Langfuse最大の特徴は、MITライセンスのコア機能を無料・無制限で自社サーバーにセルフホストできる点です。クラウド版(Langfuse Cloud)もありますが、あえて自分で運用する理由があります。

セルフホストの理由内容
データ主権プロンプトや顧客データを外部に出さず自社内に保持できる
コスト大量トレースでもサーバー代のみ。従量課金を避けられる
コンプライアンス金融・医療など外部送信が制限される業界に対応
カスタマイズOSSなので必要に応じて改変できる

Dockerでのセルフホスト手順

Langfuseのセルフホストは想像より簡単です。Docker Composeを使えば、必要なデータベース(PostgreSQL・ClickHouse・Redis)も含めて一括で立ち上がります。

# 1. リポジトリを取得
git clone https://github.com/langfuse/langfuse.git
cd langfuse

# 2. Docker Compose で起動
docker compose up

# 3. ブラウザでアクセス
# http://localhost:3000 を開く
# 初回はアカウント(組織・プロジェクト)を作成

起動後、表示されるAPIキー(public key / secret key)を自分のアプリに設定すれば、トレースが送られ始めます。Python・TypeScript向けの公式SDKがあり、数行のコードで連携できます。本番運用ではこれに加えて、データの永続化(ボリューム設定)とバックアップ、HTTPS化を設計します。

LangSmithとの違い

観測性ツールでよく比較されるのが、LangChain社のLangSmithです。両者の違いを整理します。

項目LangfuseLangSmith
ライセンスOSS(MIT)+商用機能クローズド(商用)
セルフホスト◎ コア機能を無料・無制限△ エンタープライズ契約が必要
フレームワーク依存非依存(どのLLMでも可)LangChainと親和性が高い
無料枠クラウド版に小さな無料枠個人向け無料枠あり(上限あり)
向く人データを自社管理したい人すぐ使い始めたい・LangChain利用者

ざっくり言えば、「データ主権・コスト管理を重視するならLangfuse」「手軽さとLangChain統合を重視するならLangSmith」という棲み分けです。

料金体系

Langfuseには2つの選択肢があります。セルフホストはコア機能が無料(サーバー代のみ)。一部の高度な機能(SSO強制やデータ保持期間の細かい制御など)は有料のエンタープライズ版です。クラウド版は無料枠+トレース量に応じた従量課金で、まず試すなら無料枠から始められます。「まず無料枠で評価 → 本格運用でセルフホストに移行」という流れが王道です。

実例:RAGチャットボットが誤回答した時に見る場所

Langfuseの価値は、インストールできることではなく、AIが失敗した時に原因を追えることです。たとえば社内FAQチャットボットが「古い料金表」を根拠に回答してしまった場合、見るべきポイントは次のように分かれます。

確認する場所見るべき内容分かること
Inputユーザーが実際に聞いた質問質問が曖昧だったのか、検索しやすい聞き方だったのか
Retrieved ContextRAGで取得された文書チャンク正しい資料を検索できたか、古い資料を拾ったか
Promptモデルに渡した最終プロンプト不要な情報や矛盾した指示が混ざっていないか
OutputAIの回答根拠に沿っているか、勝手に補完していないか
Cost / Latencyトークン数、処理時間、モデル名高い・遅い原因がどこにあるか

セルフホストで事前に決めるべき運用項目

Docker Composeで起動するだけなら簡単ですが、本番運用では「起動できた」だけでは足りません。次の項目は先に決めておくべきです。

LangfuseとLangSmithの選び分けを実務で考える

状況選びやすい方理由
まず数時間で試したいLangSmith / Langfuse Cloudクラウドで始める方が速い
顧客データを外に出せないLangfuse self-hostデータを自社環境に置ける
LangChain中心の開発LangSmith統合が自然で導入が軽い
フレームワーク非依存にしたいLangfuse複数のLLMや実装方式で使いやすい
大量トレースを長期保存したいLangfuse self-hostクラウド従量課金を抑えやすい

導入後に見るべきKPI

観測性ツールは、入れて満足すると意味がありません。最低限、次の数字は定期的に見るべきです。

本番投入前チェックリスト

Langfuseを入れても改善しないケース

Langfuseは便利ですが、入れただけでAIアプリが良くなるわけではありません。観測性ツールは、あくまで「問題を見えるようにする道具」です。次のような状態だと、導入しても効果が薄くなります。

本当に必要なのは、「ログを残す」ことではなく、ログを見て改善する運用です。毎週10件の失敗トレースを見るだけでも、プロンプトや検索設計の弱点はかなり見えてきます。

小さく始める導入プラン

段階やること目的
1週目ローカルまたはCloudでトレースを送る入力・出力・モデル名が見える状態にする
2週目高コスト・低評価・エラーのトレースを分類失敗パターンを見つける
3週目プロンプトをバージョン管理する改善前後を比較できるようにする
4週目評価データセットを作る変更の良し悪しを定量化する

ログに残さない方がよい情報

セルフホストでも、何でも記録してよいわけではありません。むしろ、ログは長く残るので慎重に扱う必要があります。

情報扱い理由
APIキー原則として残さない漏洩時の影響が大きい
個人名・メールアドレスマスキング推奨問い合わせログに混ざりやすい
顧客の機密文書保存範囲を限定権限管理が必要
プロンプト全文用途次第システム指示に秘密情報が含まれる場合がある

チームで使う時の権限設計

Langfuseをチームで使う場合、誰でも全トレースを見られる状態は危険です。AIアプリのトレースには、ユーザーの質問、社内情報、顧客データ、プロンプトの内部指示が含まれることがあります。開発者、CS、営業、管理者で見せる範囲を分ける設計が必要です。

役割見せたい情報注意点
開発者プロンプト、エラー、レイテンシ、モデル設定顧客個人情報はマスクする
CS担当ユーザー質問、回答、評価結果システムプロンプトや秘密情報は見せない
マネージャー失敗率、コスト、改善推移個別ログより集計ビュー中心
外部委託先必要最小限の匿名化ログ原文データの持ち出しは禁止

Langfuseを入れた後の改善サイクル

理想は、Langfuseを「見るだけの管理画面」にしないことです。週1回でもよいので、次のサイクルを回すとAIアプリの品質は上がります。

  1. 低評価またはエラーのトレースを10件見る
  2. 原因を「検索ミス」「プロンプトミス」「モデル選定」「ユーザー質問の曖昧さ」に分類する
  3. 一番多い原因から直す
  4. プロンプトやRAG設定を変えたらバージョンを残す
  5. 翌週に同じ指標で改善したかを見る

このサイクルを作ると、Langfuseは単なるログ保管庫ではなく、AIアプリ改善の運用基盤になります。

小規模チームならどこまでやれば十分か

最初から大企業並みの監視体制を作る必要はありません。小規模チームなら、まずは「入力」「出力」「モデル名」「コスト」「エラー」「ユーザー評価」が見えるだけで十分です。重要なのは、完璧な監視基盤ではなく、失敗した時に原因をたどれる最低限の記録を残すことです。

逆に、最初から複雑なダッシュボードを作り込むと、誰も見なくなります。週に一度、失敗トレースを10件だけ見る。そこから改善する。Langfuseは、この小さな改善サイクルを作れるかどうかで価値が決まります。

まとめ

Langfuseは、LLMアプリの「中で何が起きているか分からない」という根本課題を解決する観測性ツールの定番です。最大の強みは、MITライセンスのコア機能を無料・無制限でセルフホストでき、プロンプトや顧客データを自社内に保持できること。Docker Composeで数コマンドで立ち上がる手軽さも魅力です。まずはクラウド版の無料枠か、ローカルのDocker環境で触ってみて、トレースとコスト可視化の便利さを体感するのがおすすめです。データ主権が重要な業務なら、本番はセルフホストへ移行する価値が十分にあります。

導入前によくある疑問

Langfuseとは何ですか?

LLMアプリの動作を記録・可視化するオープンソースの観測性ツールです。AIへの入力・出力・コスト・処理時間を追跡でき、品質評価やデバッグに使われます。クラウド版とセルフホスト版があります。

LangfuseとLangSmithの違いは?

LangfuseはオープンソースでMITライセンスのコア機能を無料・無制限にセルフホストできます。LangSmithはLangChain社の商用サービスで、機能は手厚いですが基本クラウド利用です。データを自社管理したい場合はLangfuseが有力です。

Langfuseのセルフホストは難しいですか?

Docker Composeを使えば数コマンドで起動できます。公式リポジトリをクローンして docker compose up を実行するだけで構成が一括で立ち上がります。本番運用ではストレージとバックアップの設計が追加で必要です。

LangSmith・Langfuse・Phoenix・Galileoを横断で比較した記事はAIエージェント観測ツール比較2026にまとめています。Langfuseが自分に合うか迷う場合はあわせてご覧ください。

← JOURNALに戻るAIツール一覧を見る →