Loretta
3b45de6de3
Modernize benchmarks, simplify attributes, doc cleanup - Benchmark output now reports per-op µs and KB/op; added helpers for unit conversion and updated all output formats and headers. - Split SetupAllocBytes into SetupSerializeAllocBytes and SetupDeserializeAllocBytes for finer allocation reporting. - Simplified [AcBinarySerializable] usage in test models to single-argument form. - Edited documentation for clarity, brevity, and consistency; improved navigation, updated technical details, and harmonized terminology across .md files. |
||
|---|---|---|
| .. | ||
| README.md | ||
README.md
Remote Log Writers
Client-side log writers sending log data to remote endpoints. Source: Loggers/. Core logging framework: AyCode.Core/AyCode.Core/docs/LOGGING/README.md | Server-side GlobalLogger: AyCode.Core.Server/docs/LOGGING/README.md.
AcBrowserConsoleLogWriter
Blazor browser console writer. Extends AcTextLogWriterBase (text branch, not structured). Uses IJSRuntime to invoke browser console methods:
| LogLevel | JS method |
|---|---|
| Detail – Suggest | console.info |
| Warning | console.warn |
| Error | console.error |
Implements IAcLogWriterClientBase (client-side marker).
AcHttpClientLogItemWriter<TLogItem>
HTTP POST writer. Extends AcLogItemWriterBase<TLogItem> (structured branch). Manages its own HttpClient + HttpClientHandler. Sends log items as JSON:
_httpClient.PostAsJsonAsync(_url, logItem).Forget();
Note: Forget() — fire-and-forget, no await on the HTTP response. HTTP/2 by default.
AcSignaRClientLogItemWriter
SignalR log transport writer. Extends AcLogItemWriterBase<AcLogItemClient>. Sends items to a dedicated logger hub. Manages its own HubConnection:
_hubConnection.SendAsync("AddLogItem", logItem).Forget();
UTC conversion note: SignalR doesn't transmit DateTime.Kind. The writer calls logItem.TimeStampUtc.ToUniversalTime() before sending to ensure the server receives actual UTC.
Connection lifecycle: StartConnection() waits up to 10s for Connected state. StopConnection() stops and disposes the hub.
Remote Logging Flow
Client applications can send log items to a server via SignalR:
Client App Server
────────── ──────
AcSignaRClientLogItemWriter AcLoggerSignalRHub<TLogger>
│ │
│ logItem.ToUniversalTime() │
│ StartConnection() │
├──SendAsync("AddLogItem", item)──► │
│ ├─ logItem.TimeStampUtc = UtcNow
│ ├─ _logger.Write(logItem)
│ │ ├─ Console writer
│ │ ├─ DB writer
│ │ └─ ... (all server writers)
Note: AcLoggerSignalRHub overrides client's TimeStampUtc with DateTime.UtcNow server-side for authoritative timestamps. The hub is a simple Hub (not AcWebSignalRHubBase) — does NOT use tag-based dispatch.
Key Source Files
| Component | Path |
|---|---|
| Browser writer | Loggers/AcBrowserConsoleLogWriter.cs |
| HTTP writer | Loggers/AcHttpClientLogItemWriter.cs |
| SignalR writer | Loggers/AcSignaRClientLogItemWriter.cs |
| Structured writer base | AyCode.Entities/AcLogItemWriterBase.cs |
| DB writer | AyCode.Database/AcDbLogItemWriter.cs |
| Logger hub (server) | AyCode.Services.Server/SignalRs/AcLoggerSignalRHub.cs |