
TraceLLM
TraceLLMは、セッション、スパン、プロンプト/出力(オプション)、トークン、レイテンシ、およびAIワークフロー全体のエラーをトレースするローカルファーストのLLMオブザーバビリティプラットフォームであり、ポリシー制御とOpenTelemetry(OTLP)エクスポートをサポートしています。
https://tracellm.in/?ref=producthunt&utm_source=aipure

製品情報
更新日:2026年08月07日
TraceLLMとは
TraceLLMは、本番LLMアプリケーション向けのオブザーバビリティおよびデバッグ製品であり、モデル呼び出しと周辺のアプリ活動を単一のクエリ可能なトレースに統合します。これは、チャットボット、エージェントワークフロー、RAGサービスといった最新のAIシステム向けに設計されており、単一のユーザーリクエストが複数のモデル呼び出し、ツール呼び出し、および事後検査が困難な中間ステップをトリガーする可能性があります。TraceLLMは、「AIワークフローごとに1つのタイムライン」という体験を提供し、主要な運用シグナル(レイテンシ、トークン使用量、エラー、メタデータ)をキャプチャし、有効になっている場合はプロンプトとモデル出力をキャプチャするため、チームは問題のある実行中に何が起こったかを正確に理解できます。
TraceLLMの主な機能
TraceLLMは、LLMの可視化および追跡製品であり、セッション、スパン、ライフサイクルイベント、トークン使用量、レイテンシー、プロバイダー/モデル呼び出し、エラーをカバーするエンドツーエンドのAIワークフロー実行を、単一のクエリ可能なタイムラインとしてキャプチャします。設定可能なキャプチャ/編集ポリシーと、既存の監視スタック(例:SigNoz)へのオプションのOpenTelemetry(OTLP)エクスポート機能を備えています。これは、多段階のLLMアプリケーション(チャットボット、エージェント、RAG、ツール使用ワークフロー、ルーター/ゲートウェイ)をデバッグ可能にするように設計されており、誤った回答、パフォーマンスの低下、トークンの急増、プロバイダーやフレームワーク間の障害を調査するために必要なコンテキストを保持します。
セッション + スパンタイムライン(「1つのトレース、1つのストーリー」): 各AIワークフローをセッション、スパン、イベントを含む統合されたトレースとして記録するため、ベンダーのダッシュボードや散在するログを結合することなく、リクエストの開始からモデルの完了まで、何が起こったかを正確に確認できます。
使用量、レイテンシー、エラーの可視化: トークン数、タイミング/レイテンシー、リクエストステータス、例外を同じトレースに添付してキャプチャし、本番環境でのボトルネック、コストの急増、障害モードを迅速に診断します。
ポリシー制御によるプロンプト/出力のキャプチャ: オプションのプロンプトとモデル出力のキャプチャをサポートし、プロジェクトレベルの制御(キャプチャのオン/オフ、メタデータのみのモード、編集、サンプリング)によって管理され、デバッグの価値とプライバシー/コンプライアンスのニーズのバランスを取ります。
ドロップインSDKインストルメンテーション(Node): リクエストの実行場所を変更せずに実際のモデル呼び出しをラップする軽量SDKを提供し、エージェント、RAG、ツール、ゲートウェイなどの一般的なLLMアプリパターンをサポートします。
プロバイダーおよびフレームワークに依存しないワークフロー追跡: 異種スタックおよびモデルプロバイダー(例:OpenAI/Claude/Geminiパターン)全体で追跡するように設計されており、チームが複数のモデルとランタイムを使用している場合でも、統合された運用ビューを可能にします。
OpenTelemetry(OTLP)エクスポートパイプライン: 同じ製品レベルのトレースをOTLP(例:SigNoz)を介して外部の可視化システムにエクスポートし、チームがLLMワークフローテレメトリを既存の監視およびアラートパイプラインに統合できるようにします。
TraceLLMのユースケース
カスタマーサポートチャットボットのデバッグ: ユーザーが誤った回答や安全でない回答を報告した場合、エンジニアは正確なセッションを開き、モデルスパン(プロバイダー/モデル/トークン/レイテンシー)を検査し、周辺イベントをレビューして、グラウンディング/検索/ツール関連の問題を特定できます。
エージェントワークフローの信頼性(ツール + 多段階計画): モデル呼び出しとツール呼び出しのチェーンを追跡することで、チームはエージェントがループした場所、間違ったツールを選択した場所、サイレントに失敗した場所、または「健全な」レイテンシー/トークンにもかかわらず自信を持って間違った応答を生成した場所を特定できます。
RAGの品質とグラウンディング調査: 検索/ツールイベントと最終応答を関連付けることで、検索応答の失敗を診断するのに役立ち、適切なコンテキストが取得されたかどうか、それがどのように出力に影響したかを簡単に確認できます。
本番AIのコストとパフォーマンスの最適化: スパンごとのトークン使用量とレイテンシーを使用して、高価なプロンプト、リグレッション、ホットスポットを見つけ、コストやテールレイテンシーがユーザーに影響を与える前に、ターゲットを絞ったプロンプト/ルート/モデルの変更を可能にします。
マルチプロバイダーモデルルーティングとA/B操作: 複数のプロバイダー/モデルを使用する環境では、TraceLLMはルート全体の動作を単一のビューで提供し、デプロイメント間の信頼性、コスト、レイテンシーを比較しやすくします。
メリット
モデル呼び出し、アプリイベント、使用量、エラーにわたる統合されたトレースタイムラインにより、異なるログやベンダーダッシュボードを関連付けるのに費やす時間を削減します。
ポリシー駆動型キャプチャ(サンプリング/編集/メタデータのみ)とOTLPエクスポートにより、プライバシーのニーズと既存の可視化スタックとの統合の両方をサポートします。
実際のLLMアプリパターン(エージェント、RAG、ツール、ゲートウェイ)およびマルチプロバイダー設定向けに設計されています。
デメリット
ポリシーが誤って設定されている場合、プロンプト/出力のキャプチャはプライバシー/コンプライアンスのリスクを引き起こす可能性があります。慎重な編集とサンプリングが必要です。
提供されたソースではSDKのカバー範囲は主にNodeであり、他のランタイムを使用するチームは追加のサポートまたはカスタムインストルメンテーションが必要になる場合があります。
可視化は、特にトレース量が多い場合、運用上のオーバーヘッド(インストルメンテーション、ストレージ、レビューワークフロー)を追加します。
TraceLLMの使い方
1) どの「TraceLLM」を意味するかを選択します(オブザーバビリティ vs. 研究フレームワーク): 「TraceLLM」という名前は、ソース内で複数のプロジェクトで使用されています。(A) プロンプト/スパン/トークン/エラーをトレースし、OTLP経由でエクスポートするためのTraceLLMオブザーバビリティ製品(tracellm.in)。(B) log_action/get_logs/get_summaryなどのツールを公開するMCPサーバーベースのロガー。(C) TraceLLMと名付けられた研究コードベース(例:マイクロサービストレース生成、要件トレーサビリティ)。以下の手順は、エンドユーザー向けの「使用方法」ドキュメントとSDKスニペットをソースで提供しているため、TraceLLMオブザーバビリティ製品に焦点を当てています。
2) TraceLLMプロジェクトを作成し、APIキーを取得します: TraceLLMウェブアプリ(tracellm.in/appからリンク)でプロジェクトを作成します。プロジェクトAPIキー(trllm_live_••••••••••••••のように表示されます)をコピーします。このキーは所有権と、キャプチャポリシー、編集、サンプリングなどのSDKの動作を制御します。
3) Node SDKをインストールします: サイトに示されているように、SDKをNodeプロジェクトに追加します: `pnpm add @use-tracellm/sdk-node`。
4) 実際のモデル呼び出しをTraceLLMスパンでラップします(ドロップイントレーシング): リクエストが実行される場所を変更せずに、実際のプロバイダー呼び出しの周りにスパンを作成するためにSDKを使用します。サイトからの例パターン: LLMリクエストを実行するコードの周りに`trace.span({ provider: "openai", model: "gpt-4.1-mini" })`。これにより、スパン、ライフサイクルイベント、レイテンシ、トークン使用量(OpenAI互換の応答から利用可能な場合)を含む単一のワークフローレコードがキャプチャされます。
5) 完全なワークフローコンテキストをキャプチャします(セッション、スパン、イベント、エラー、トークン、メタデータ): 1つのユーザーワークフローが1つのデバッグレコードになるようにトレースを整理します。セッション名(例:chatbot.request)を使用し、モデルスパン(例:openai.chat.complete)を記録し、ライフサイクルイベント(provider.request.started、provider.response、ツール/取得イベント)を追加します。エラーが同じトレースに記録されるようにして、障害がセッションタイムラインに紐付けられたままになるようにします。
6) 実行中にカスタム属性とイベントを追加します(オプション): SDKがアクティブスパンアクセスをサポートしている場合(ソースに示されているように)、ランタイム属性とイベントを追加します。アクティブスパンを取得し、`custom.metric`のような属性を設定し、構造化されたフィールド(例:`{ key: "user_context" }`)を持つ`cache_hit`のようなイベントを追加します。これは、アプリレベルのシグナルとモデルの動作を関連付けるのに役立ちます。
7) ネストされたスパンで多段階ワークフロー(チェーン)をトレースします: エージェント/RAG/ツールパイプラインの場合、親ワークフロースパン(「チェーン」)を作成し、LLM呼び出し、取得、およびツールのための子スパンをネストします。ソースは、ネストされたスパンが自動的に親の子になり、ワークフロー全体の単一の一貫したタイムラインを生成するパターンを示しています。
8) キャプチャポリシー、編集、サンプリングを設定します: TraceLLM UI(またはAPIキーに紐付けられたプロジェクト設定経由)で、何がキャプチャされるかを設定します。コンテンツキャプチャのオン/オフ、メタデータのオン/オフ、編集のオン、サンプリング(例:70%)。これにより、プロンプト/出力が保存されるかどうか、および機密データがどのように処理されるかが制御されます。
9) トレースエクスプローラーでトレースを表示します(セッションとライブトレース): TraceLLMアプリを開き、セッション/ライブトレースを使用して、セッション名、ステータス(ok/error)、またはタイムスタンプでワークフローを検索します。モデルスパンを検査して、プロバイダー/モデル、レイテンシ、トークン使用量、およびリクエストステータスを確認します。イベントのタイムラインと添付されているエラーを確認します。
10) TraceLLMを使用して報告された誤った回答をデバッグします(推奨ワークフロー): サイトに記載されている調査パスに従います。(1) ユーザーセッションを開きます。(2) レイテンシ/トークン/ステータスのモデルスパンを検査します。(3) ツール/取得/プロバイダー呼び出しに関するキャプチャされたイベントを読み取ります。(4) 障害を追跡します—エラーはメッセージ/タイプ/スタック/メタデータとともに添付されたままです。
11) OpenTelemetry(OTLP)経由でSigNozにトレースをエクスポートします(オプション): OTLPエクスポートを有効にすると、同じワークフロートレースをSigNozのようなOTLP宛先に転送できます。サイトでは、エクスポートパイプラインについて説明しています。TraceLLM API → OTLP Collector → SigNoz。これにより、製品レベルのトレースをTraceLLMに保持しながら、オブザーバビリティスタックにも送信できます。
12) (代替)MCPサーバーの「Tracellm」ロガーを意味する場合は、それを実行してそのツールを呼び出します: 一部のソースでは、3つのツール(`log_action`、`get_logs`、`get_summary`)を公開する純粋なMCPサーバーについて説明しており、SSE-over-HTTPトランスポート(ポート8001)を使用します。この設定では、アプリ/エージェントは意味のあるインタラクション(ユーザーメッセージ、LLM応答、ツール呼び出し、エラー)の後に`log_action`を呼び出します。ロギングは非ブロッキングになるように設計されています。サーバーが利用できない場合でも、主要なLLMフローは中断なく続行されます。
13) (代替)研究用のTraceLLMリポジトリを意味する場合は、環境をセットアップして前処理を実行します: 他のソースでは、研究コードベース(例:マイクロサービスコールグラフ生成)について説明しており、セットアップは次のとおりです。conda環境を作成し(python=3.8)、poetryをインストールし、`poetry install`を実行し、`trace_gen`の下に追加の要件をインストールします。また、トレースをコールグラフに変換し、統計を計算する前処理スクリプト(例:`trace_to_cg_stats.py`、`merge_cg_stats.py`)や、task_typeを適切に設定してコールグラフをテキスト表現に変換する方法についても説明しています。
TraceLLMのよくある質問
TraceLLMは、プロンプト、スパン、トークン、エラー、モデル呼び出しなどのAIワークフロー活動を記録するLLM可観測性およびトレース製品であり、単一のエンドツーエンドトレースで何が起こったかをデバッグおよび理解できます。











