MIT · .NET 8 & .NET 10 · NuGet

Logs estruturados.
Sem vazar dados.

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

trace.json live
{
  "@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
}
Recursos

Observabilidade sem abrir a porta para vazamentos

O necessário para diagnosticar produção, sem devolver detalhes internos ao cliente.

Correlação ponta a ponta

X-Trace-Id em toda resposta, inclusive 2xx. Nos erros, o mesmo valor aparece no ProblemDetails e nos logs.

Cadeia recursiva

InnerException e AggregateException serializados como objetos, com MaxDepth configurável e proteção contra ciclos.

Sanitização em duas camadas

CPF, CNPJ, e-mail, bearer token e pares password=... são mascarados antes de chegar ao log ou à cadeia.

JSON compacto no stdout

Console com JSON compacto (sem @x cru), pronto para coleta automática por Grafana, Datadog ou outro agregador.

Sem @x cru

ILogger.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.

Middlewares prontos

TraceIdMiddleware, logging de exceções e log de requisição com status, duração e enriquecimentos declarativos ou programáticos (ex.: tenant).

Sem Dackel.Log

Mensagem crua na resposta e no log

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.

Com Dackel.Log

Cadeia sanitizada e consultável

"ExceptionChain": [
  { "Depth": 0, "Message": "Falha com CPF ***" },
  { "Depth": 1, "Message": "inner com CNPJ ***" }
]

Cliente recebe um erro seguro; suporte localiza pelo traceId.

Início rápido

Quatro linhas no pipeline

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.

  1. 1UseTraceId()
  2. 2UseRequestEnrichment()
  3. 3UseStructuredRequestLogging()
  4. 4UseExceptionHandler()
  5. 5UseExceptionLogging()
Configuração

Padrões seguros, ajustáveis quando necessário

O comportamento padrão já cobre a maioria dos cenários de produção.

ExceptionLogging:MaxDepth 10 níveis

Profundidade da cadeia de exceções. Ao exceder, o evento marca ExceptionTruncated: true. Faixa válida: 1–50.

Sink Console JSON

JSON compacto no stdout, sem o @x cru. Não adicione WriteTo no appsettings para evitar eventos duplicados.

StructuredLogging:Enrichments Declarativo ou por código

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.

Compatibilidade

Feito para o .NET atual

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.

Comece agora

Logs melhores em um comando.

dotnet add package Dackel.Log