同期実行と非同期実行を一致させる
通常のワーカーには同期クライアントを使用し、非同期リクエストまたはエージェント パスには非同期クライアントを使用して、テレメトリがイベント ループをブロックしないようにします。
選考枠組み
結果がわかる境界を選択してください
トランザクション境界の後で発行する
ハンドラーが成功しても、データベースのコミット、キューに入れられたタスク、またはモデルのワークフローが永続的な境界に達するまでは、ビジネスの成果は成功しません。
ログを記録する前に例外を分類する
制御されたエラーのタイプと失敗したステップを記録します。 SQL パラメータ、プロンプト、シークレット、または顧客コンテンツが含まれる可能性がある場合は、生の例外テキストを避けてください。
共有イベント契約
最初のスキーマを相互運用可能に保つ
- 操作、ステータス、duration_ms、リリース、および環境
- request_id、task_id、run_id、account_id、および制御対象の error_type
- 関連する場合、試行、モデル、プロバイダー、tool_name、およびデータベース操作
これらのフィールドをワークフローに適応させますが、複数のサービスが同じテーブルに依存する前に、ユニット、ステータス カテゴリ、識別子、および所有権を明示的に保ちます。
検証
アラートの前に障害パスを実行する
- 1アプリケーションが同期パスと非同期パスの両方を使用する場合は、1 つの同期パスと 1 つの非同期パスを実行します。
- 2コミットまたはターミナルタスクのステータス後にイベントが発行されることを確認します。
- 3キャンセル、タイムアウト、再試行、プロセスのシャットダウン動作をテストします。
- 4最初のクエリを作成する前に、推論されたフィールド タイプを検査します。
実装ガイド
フレームワーク、プロバイダー、またはランタイムを一致させる
出典リンク付きの設定ガイド
Python および FastAPI 構造化ロギング
Telemetry の非同期クライアントと正規化したルート名を使い、FastAPI の応答ステータスとヘッダー受信までの遅延を記録します。
オープンガイド出典リンク付きの設定ガイド
Django と Celery の構造化イベント監視
Celery タスクの各試行の状態を記録し、再試行を最終的な失敗と混同せず、タスクの結果を変更しません。
オープンガイド出典リンク付きの設定ガイド
Flask と SQLAlchemy Telemetry
制限された Python イベント、安定したルート テンプレート、および安全なエラー カテゴリを使用して、Flask リクエストの結果と SQLAlchemy トランザクションの動作を測定します。
オープンガイド出典リンク付きの設定ガイド
ピダンティック AI エージェント Telemetry
Pydantic AI の実行結果、検証された出力、再試行、ツールのアクティビティ、レイテンシ、使用状況、製品の受け入れ状況を、安全な構造化イベントで測定します。
オープンガイド出典リンク付きの設定ガイド
CrewAI ワークフロー Telemetry
入力や出力を保存せず、非ストリーミングのCrewAI同期kickoff呼び出しを観測します。戻り、失敗、中断を別々にクエリします。
オープンガイド出典リンク付きの設定ガイド
LlamaIndex エージェント Telemetry
LlamaIndex エージェントとワークフローの結果、ツールのアクティビティ、レイテンシー、取得バージョン、コスト、構造化イベントによるレビューされた品質を追跡します。
オープンガイド出典リンク付きの設定ガイド
DSPy プログラムの評価 Telemetry
SQL 対応イベントを使用して、DSPy プログラムのレイテンシー、障害、メトリック スコア、オプティマイザーのバージョン、モデルのコスト、リリース全体で受け入れられた結果を測定します。
オープンガイド出典リンク付きの設定ガイド
AutoGen タスク フロー、状態、タイムアウトの監視
AutoGen タスクフローの状態、タイムアウト、チームとエージェントの結果、ツールのアクティビティ、ハンドオフ、遅延、障害、コスト、リリースをコンパクトな構造化イベントで追跡します。
オープンガイド出典リンク付きの設定ガイド
LiteLLM ゲートウェイおよび SDK Telemetry
制御されたモデルのゲートウェイ全体で、LiteLLM プロバイダーのルーティング、再試行、フォールバック、トークンの使用状況、レイテンシ、コスト見積もり、および受け入れられた結果を追跡します。
オープンガイド最初に 1 つのエンドツーエンドのワークフローを確認します
無料の API キーを作成し、最も近いランタイム ガイドを選択し、カバレッジを拡大する前に既知の成功と失敗を 1 つ送信します。