Azure.AI.AgentServer.Core_1.0.0-beta.22

Azure OpenAI .NET Releases / 2026/4/19

📰 ニュースDeveloper Stack & InfrastructureModels & Research

共有:

要点

Azure.AI.AgentServer.Core 1.0.0-beta.22（2026-04-17）では、OTLPのみのテレメトリ経路でも外向きHTTPの計測（トレース/メトリクス）を有効化し、下流サービスまでの分散トレース相関を可能にします。
受信HTTPリクエストを記録するミドルウェアが追加され、メソッド/パス/ステータス/所要時間/相関ヘッダー（x-request-id, x-ms-client-request-id）/OTelのTrace IDを出力します（成功はInformation、4xx/5xxはWarning）。
Tier 3向けに、inboundリクエストロギングを独立して有効化できる AddAgentServerLogging() / UseAgentServerLogging() などの拡張が追加されました。
今バージョンでは複数のAPI名変更（UserAgentRegistry→VersionRegistry等）や、バージョンミドルウェアが受信ロギング登録を同梱しない変更、AgentHostTelemetryがinternal化されるなどのブレイキング変更があります。

トレースとメトリクスの両方のために、OTLPのみのテレメトリ経路に対して HttpClient のインストルメンテーション（AddHttpClientInstrumentation）を追加しました
。これによりアウトバウンドのHTTPクライアントスパンをエクスポートし、Foundryストレージおよびその他の下流サービスを通じてエンドツーエンドの
分散トレース相関を可能にします。
受信したすべてのHTTPリクエストをメソッド、パス、
ステータスコード、所要時間、相関ヘッダー（x-request-id、x-ms-client-request-id）、および
OpenTelemetryのトレースIDとともに記録する、受信リクエストログ記録ミドルウェアを追加しました。成功したリクエストはInformationレベルでログされます。4xx/5xxのレスポンスは
Warningレベルでログされます。リクエスト開始はInformationレベルでログされます。
Tier 3 のセットアップ向けに、受信リクエストログ記録ミドルウェアを
独立して有効化できるように、AddAgentServerLogging() と UseAgentServerLogging() の拡張を追加しました。
起動構成のログ記録を追加しました。プラットフォーム環境、接続性、ホストオプション、および
登録済みプロトコルは、ホスト起動時にInformationレベルでログされます。

ServerUserAgentRegistry を ServerVersionRegistry にリネームしました。
AgentHostBuilder.UserAgentRegistry プロパティを VersionRegistry にリネームしました。
AddAgentServerUserAgent() を AddAgentServerVersion() に、
UseAgentServerUserAgent() を UseAgentServerVersion() にリネームしました。バージョンのミドルウェアは
受信リクエストのログ記録登録を同梱しなくなりました。代わりに、新しい
AddAgentServerLogging() / UseAgentServerLogging() のペアを個別に使用してください。
AgentHostTelemetry を internal にしました。テレメトリのソースおよびメータ名の定数は実装の詳細です。必要に応じて、OTelのフィルタリングには文字列値を直接使用してください。