O problema com logs não estruturados​

Imagine depurar um problema em produção com a seguinte linha:

User 42 failed to checkout after 3 retries

Quem é o usuário 42? Qual foi o erro? Em qual tentativa falhou? Sem campos separados, cada ferramenta de observabilidade precisa fazer parsing frágil de texto livre.

A abordagem estruturada​

Com structured_logger, você separa o template da mensagem das propriedades:

await logger.log(
  'User {userId} failed checkout after {retries} retries: {error}',
  level: LogLevel.error,
  data: {
    'userId': 42,
    'retries': 3,
    'error': 'payment_timeout',
  },
);

O template permanece estável para agrupamento; os dados ficam indexáveis em backends como Seq.

Sinks: um evento, vários destinos​

O diferencial do pacote é o modelo de sinks. O mesmo evento pode ir para:

• Terminal (SimpleLineSink) — leitura rápida durante o desenvolvimento
• DevTools (DefaultSink) — inspeção no log do desenvolvedor Dart
• Seq (SinkSeq) — centralização em produção

final logger = StructureLogger();
logger.addSink(SimpleLineSink());
logger.addSink(SinkSeq('https://seq.example.com', apiKey: apiKey));

Próximos passos​

• Leia a documentação de início rápido
• Explore a arquitetura de sinks
• Contribua no repositório GitHub

Por que Seq?​

Seq oferece busca poderosa em propriedades estruturadas, dashboards e alertas. Com CLEF, cada log é um documento JSON com campos @t, @mt, @l e propriedades arbitrárias — exatamente o que LogModel já produz.

Uso básico​

final seqSink = SinkSeq(
  'https://seq.example.com',
  apiKey: 'sua-api-key',
  deviceIdentifier: 'checkout-app',
);

logger.addSink(seqSink);

await logger.log(
  'Order {orderId} placed',
  level: LogLevel.info,
  data: {'orderId': 'ORD-991'},
);

Melhorias na 0.1.1 e 0.1.2​

As versões seguintes corrigiram detalhes importantes para uso em produção:

• Header Content-Type: application/vnd.serilog.clef no POST
• Campos CLEF reservados (@t, @mt, @l, DeviceIdentifier) protegidos contra sobrescrita por data
• SinkSeq.close() para liberar o pool HTTP interno
• Validação de URL em builds de release
• Normalização de URL com trailing slash

Testabilidade​

O construtor aceita um http.Client injetado — essencial para testes unitários sem rede:

SinkSeq(
  'https://seq.test',
  client: mockClient,
);

Saiba mais​

Confira o guia completo de integração com Seq na documentação.