TCIS.Logging.Hosting 1.0.5

TCIS.Logging.Hosting

Composition package for application logging: real TCIS writers, ECS Serilog defaults, Autofac interception, exception classification, request context, lifecycle logging, and original failing service propagation over internal HTTP/gRPC calls.

Targets: net6.0, net8.0, net48, and net472. The ASP.NET Core entrypoints below work on both .NET 6 and .NET 8; Framework applications use RunFramework.

using TCIS.Logging.Hosting.Extensions;

var builder = WebApplication.CreateBuilder(args);
builder.AddTLoggingHost();
var app = builder.Build();
app.MapControllers();
await app.RunAsync();

To capture builder/configuration/build failures as well, use the lifecycle wrapper:

using TCIS.Logging.Hosting;

await TLoggingHost.RunAsync(args,
    builder => builder.Services.AddScoped<IOrderService, OrderService>(),
    app => app.MapControllers());

Only this package needs to be referenced. Business registrations and endpoints remain application responsibilities. No logging endpoint is exposed by default.

An A → B → C failure records service.name = a, custom.error.origin_service = c, and custom.error.propagation_path = [a,b,c] at A (these fields are outside the OPS v1.4 field catalog; they are written by default and omitted when TLogSettings:EmitExtensionFields=false). All participating applications must adopt the new package, using TCIS internal client extensions. Without peer metadata, only the immediate dependency can be identified.

Ngữ cảnh truy vết tự điền trên mọi bản ghi, kể cả log của framework (Wolverine, EF Core, Kestrel...) và consumer không có request HTTP: trace.id/span.id lấy từ Activity.Current; transaction.id lấy từ WorkContext (correlation id), không có thì dùng span gốc cục bộ của tiến trình, không có Activity thì sinh Guid; user.name là anonymous khi chưa có người dùng. Giá trị caller đã đặt không bị ghi đè.

application.site_code lấy từ WorkContext.Tenant.SiteCode (kể cả accessor tự dựng ngữ cảnh lúc đọc), không có thì dùng TLogSettings:SiteCode. Log của framework cũng đi theo thứ tự này.

message luôn là một dòng, tối đa 512 ký tự (OPS mục 5): xuống dòng/tab gộp thành dấu cách, quá dài thì cắt và thêm .... Nội dung lỗi đầy đủ vẫn nằm ở error.message và error.stack_trace.

Log của framework mức ERROR/FATAL không kèm exception (driver Oracle, EF Core...) vẫn là bản ghi lỗi: custom.log_type=error, error.code=SYS-UNK-9999 (chưa phân loại), error.type=UnclassifiedError. Bản ghi framework có custom.code.namespace/class lấy từ tên logger. log.origin.function của log lỗi framework lấy từ stack tại nơi ghi log (frame đầu tiên ngoài hạ tầng logging, đã gỡ tên <Run>d__5.MoveNext của async/lambda); chỉ chụp stack cho mức ERROR/FATAL. Mã tenant ghi ở user.tenant_id (danh mục OPS v1.4), song song với organization.id (tên cũ, dashboard OPS và log eBerth đang đọc). Thời gian xử lý ghi ở event.duration_ms (mili giây, tên trường OPS), kèm event.duration (nano giây) và custom.duration_ms. Các trường mở rộng này (cùng custom.tcis_logging_version, custom.error.owner/origin_*) mặc định bật; đặt TLogSettings:EmitExtensionFields=false để bản ghi chỉ còn đúng trường của danh mục.

See the configuration and migration guide.