.NET and Serilog Structured Event Analytics: 境界から検証された行まで
制御されたアプリケーション境界で .NET and Serilog Structured Event Analytics を使用し、イベント コントラクトを小さく保ち、集約ビューを構築する前に既知の結果を検証します。
- 1
結果を選択してください
ASP.NET API の監視
- 2
契約を定義する
route_template、メソッド、status_code、およびステータス
- 3
境界を計測する
制御された error_type を Telemetry に送信する際に、詳細な例外を Serilog に保持します。
- 4
証拠を検証する
Exercise a known fixture, then inspect api_request_completed for one correctly typed terminal row.
始める前に
前提条件と境界
- サーバー側 TELEMETRY_API_KEY
- 名前付き ASP.NET エンドポイント
- タイムアウトが短い HttpClient
配信設定
サーバー側のインストールと初期化
サーバー側キー、短いタイムアウト、およびホワイトリストに登録された小さなログ API ラッパーを備えた 1 つの共有 HttpClient を使用します。 ブラウザ バンドル、クライアントに表示される環境変数、ソース管理、ログ、および例外メッセージに取り込み資格情報が含まれないようにします。
- 1制限されたネットワーク動作を持つ再利用可能なサーバー側配信クライアントを 1 つ準備します。
- 2成功、失敗、再試行、またはタイムアウトの境界に結果イベントを追加します。
- 3アラートを有効にする前に、制御されたフィクスチャを送信し、保存されている行を検査します。
スニペット
1 つの構造化されたイベントから始める
ワークフローが完了、失敗、または再試行される場所にこの図形を追加します。次に、実際のフィールドからダッシュボードを構築します。
.NET and Serilog Structured Event Analyticsイベント
await telemetryClient.LogAsync("api_request_completed", new {
route_template = context.GetEndpoint()?.DisplayName ?? "unmatched",
method = context.Request.Method,
status_code = context.Response.StatusCode,
status = context.Response.StatusCode >= 500 ? "failed" : "success",
latency_ms = stopwatch.Elapsed.TotalMilliseconds,
trace_id = Activity.Current?.TraceId.ToString(),
release = configuration["APP_RELEASE"]
});イベント契約
route_template、メソッド、status_code、およびステータス
latency_ms、trace_id、error_type、および依存関係
環境、リリース、および安全なテナント識別子
実装のチェックポイント
チェックポイント 1
制御された error_type を Telemetry に送信する際に、詳細な例外を Serilog に保持します。
チェックポイント 2
Request.Path ではなく、一致したエンドポイント ルート パターンを読み取ります。
チェックポイント 3
スパンを複製せずに、アクティビティ トレース識別子を伝播して相関関係を確立します。
検証
イベントが到着したことを証明する
既知の成功例と失敗例を実行した後、これを実行します。最終的なイベント コントラクトがスニペットと異なる場合は、フォールバック テーブル名を置き換えます。
.NET and Serilog Structured Event Analytics 検証クエリ
SELECT *
FROM api_request_completed
ORDER BY timestamp_utc DESC
LIMIT 20;実装の参考資料
新しい運用パスを有効にする前に、イベント契約、データ安全性に関するガイダンス、上流の主要ドキュメントを確認してください。
生産境界
結果イベントを小さく、回復可能なものに保つ
このパターンが提供するのは、
- 上流のワークフローの横にある、制限付きの SQL 対応の結果。
- ダッシュボード、アラート、およびイベント間の相関関係の安定したフィールド。
- 成功、失敗、再試行、タイムアウトの動作を検証するためのフィクスチャ駆動のパス。
このパターンでは提供されません
- OTLP エクスポーター、自動収集パイプライン、または詳細なトレースと診断ログの代替。
- ペイロードにイベント ID が含まれているという理由だけで、1 回だけ配信されます。
- 生のプロバイダー ペイロード、ユーザー コンテンツ、資格情報、または規制されたデータを収集する許可。
イベントスキーマの開始点
このワークフローのイベント コントラクト
クエリまたはスニペットを運用環境に適用する前に、行粒度、出力境界、必要なタイプ、プライバシー クラス、サンプル ペイロード、および検証チェックリストを確認してください。
関連製品の機能
このワークフローを続行します アラート
レビューされた信頼性クエリを、所有するしきい値と応答のワークフローにプロモートします。
関連する SQL レシピ
SQL で次の質問に答えてください
このワークフローの構造化フィールドに対してクエリを実行し、結果の例を検査して、有用な回答をダッシュボードまたはアラートに変換します。
ルート別のAPIエラー率の計算
意味のある 5xx エラー率が最も高いのは、どの API ルートですか?
レシピを開く依存関係の比較 p95 レイテンシー
テール レイテンシーと失敗率が最も悪いダウンストリームの依存関係はどれですか?
レシピを開くSLO に対する API の可用性の測定
各サービスは 1 日あたりの可用性目標を達成しましたか?
レシピを開く実装ファミリーごとに参照する
関連する統合パターンを比較する
この統合と組み合わせるテンプレート
さらなる統合
Spring Boot 構造化イベント監視
安定したルート、レイテンシ、ステータス、トレース コンテキストを使用して、Telemetry の HTTP API を通じて Spring MVC とスケジュールされたワークフローの結果を記録します。
オープンガイドNode.js および Express 構造化ログ
安定したルート テンプレート、ステータス コード、リクエスト レイテンシ、および安全な相関フィールドを備えた Express ルート結果を計測します。
オープンガイドPython および FastAPI 構造化ロギング
非同期 Telemetry クライアントと正規化されたルート名を使用して、FastAPI リクエストの結果と待機時間をキャプチャします。
オープンガイド