Correlação ponta a ponta
X-Trace-Id em toda resposta, inclusive 2xx. Nos erros, o mesmo valor aparece no ProblemDetails e nos logs.
Um componente pronto para ASP.NET Core com traceId em toda resposta, ExceptionChain recursivo e sanitização de PII e segredos. O erro vira Problem Details; o diagnóstico fica no log.
dotnet add package Dackel.Log
Versão mais recente no NuGet: 1.0.4
{
"@l": "Error",
"TraceId": "9f1c2b3d4e5f60718293a4b5c6d7e8f9",
"Tenant": "acme company",
"ExceptionChain": [
{
"Depth": 0,
"Type": "InvalidOperationException",
"Message": "Falha com CPF ***"
},
{
"Depth": 1,
"Type": "ApplicationException",
"Message": "inner com CNPJ ***"
}
],
"ExceptionTruncated": false,
"ExceptionDepthLimit": 10
}
O necessário para diagnosticar produção, sem devolver detalhes internos ao cliente.
X-Trace-Id em toda resposta, inclusive 2xx. Nos erros, o mesmo valor aparece no ProblemDetails e nos logs.
InnerException e AggregateException serializados como objetos, com MaxDepth configurável e proteção contra ciclos.
CPF, CNPJ, e-mail, bearer token e pares password=... são mascarados antes de chegar ao log ou à cadeia.
Console com JSON compacto (sem @x cru), pronto para coleta automática por Grafana, Datadog ou outro agregador.
@x cruILogger.LogError(ex, ...) e Log.Error(ex, ...) geram a cadeia estruturada; tipo, mensagem sanitizada e stack trace ficam no JSON, sem o texto bruto do @x.
TraceIdMiddleware, logging de exceções e log de requisição com status, duração e enriquecimentos declarativos ou programáticos (ex.: tenant).
System.InvalidOperationException:
Falha com CPF 123.456.789-09
e password=Segredo123
---> inner com CNPJ 12.345.678/0001-90
PII, segredo e detalhes internos expostos.
"ExceptionChain": [
{ "Depth": 0, "Message": "Falha com CPF ***" },
{ "Depth": 1, "Message": "inner com CNPJ ***" }
]
Cliente recebe um erro seguro; suporte localiza pelo traceId.
Registre o componente e adicione os middlewares na ordem correta.
using Dackel.Log;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddProblemDetails();
builder.AddStructuredLogging("Minha.Api")
.EnrichStructuredLogging("Tenant", (context, services) =>
services.GetRequiredService<ITenantProvider>().GetTenant(context));
var app = builder.Build();
app.UseTraceId();
app.UseRequestEnrichment();
app.UseStructuredRequestLogging();
app.UseExceptionHandler();
app.UseExceptionLogging();
app.MapControllers();
app.Run();
A ordem importa: o trace id é o mais externo; o log de exceção fica dentro do handler.
logger.LogError(
exception,
"Falha não tratada ao processar {HttpMethod} {RequestPath}",
httpContext.Request.Method,
httpContext.Request.Path.Value);
Se o handler também logar, use ExceptionLoggingMiddleware.WasLogged(httpContext) para evitar duplicidade.
{
"ExceptionLogging": {
"MaxDepth": 10
},
"StructuredLogging": {
"Enrichments": {
"Usuario": "User:Name"
}
},
"Serilog": {
"MinimumLevel": {
"Default": "Information",
"Override": {
"Microsoft": "Warning",
"Microsoft.AspNetCore": "Warning"
}
}
}
}
Não declare Serilog:WriteTo: o sink de console JSON já é definido pelo pacote. O Tenant é obtido por código com EnrichStructuredLogging(), não pelo appsettings.
UseTraceId()UseRequestEnrichment()UseStructuredRequestLogging()UseExceptionHandler()UseExceptionLogging()O comportamento padrão já cobre a maioria dos cenários de produção.
Profundidade da cadeia de exceções. Ao exceder, o evento marca ExceptionTruncated: true. Faixa válida: 1–50.
JSON compacto no stdout, sem o @x cru. Não adicione WriteTo no appsettings para evitar eventos duplicados.
Usuário e unidade via Claim, Header, Item ou User:Name. Tenant e demais valores de serviço usam EnrichStructuredLogging(). Nomes e headers sensíveis são rejeitados no startup.
O pacote entrega assets específicos para cada target framework.
| TFM | Status | Asset |
|---|---|---|
net10.0 |
Suportado · LTS | lib/net10.0 |
net8.0 |
Compatibilidade · EOL | lib/net8.0 |
net6.0 / net7.0 |
Não suportado | — |
Requer ASP.NET Core 8 ou 10. net8.0 está fora de suporte desde 10/11/2026 (sem patches de segurança); prefira net10.0. Licença MIT. Dependências: Serilog.AspNetCore 8.0.3 (net8) / 11.0.0 (net10) e Serilog.Formatting.Compact 3.0.0.