CodeTorch.Diagnostics SDK

CodeTorch.Diagnostics is a lightweight .NET diagnostics forwarding package used by CodeTorch-integrated applications to send session-scoped frontend/backend diagnostic payloads to a hosted receiver.

Purpose

• Create short-lived diagnostic sessions.
• Queue and forward diagnostic events to the receiver in a non-blocking way.
• Keep requests responsive by using fire-and-forget processing and bounded in-memory buffering.
• Keep retry policy and transport options centralized in configuration.

Usage

Add package references in your API project:

<PackageReference Include="CodeTorch.Diagnostics.SDK" Version="0.1.0" />

Register the client in Program.cs:

builder.Services.AddCodeTorchDiagnostics(builder.Configuration);

Then resolve IDiagnosticsForwarder where needed:

var sessionId = await forwarder.CreateSessionAsync(new DiagnosticSessionCreateRequest { SourceSystem = "MyApp", SourceEnvironment = "dev" }); forwarder.QueueEvent(sessionId.Value, new DiagnosticEvent { Source = "frontend", Type = "log", Level = "info", Message = "Button clicked" });

Configuration

"CodeTorchDiagnostics": { "Enabled": true, "ReceiverBaseUrl": "https://portal-api.my-org.com", "SessionsRoute": "api/diagnostics/sessions", "ApiKey": "...optional...", "ApiKeyHeaderName": "X-Codetorch-ApiKey" }

Set Enabled to false to keep all calls no-op.

Notes

• Transport is intentionally fire-and-forget and never throws to callers in regular log paths.
• The package forwards via HTTP/JSON to the diagnostics API endpoints.