Crie registro robusto em .NET com o Logger de Console do GroupDocs

Introdução

Você está tendo dificuldades para acompanhar erros e rastrear operações em suas aplicações .NET? Criar registro robusto em .NET é essencial para monitorar desempenho, depurar problemas e manter a operação suave. Este tutorial orienta você na construção de um logger de console personalizado usando GroupDocs.Search enquanto também mostra como integrar o GroupDocs.Redaction para .NET. Ao final, você terá uma solução de registro transparente e sustentável que se encaixa perfeitamente em sua base de código existente.

Respostas Rápidas

  • O que o logger personalizado faz? Escreve entradas de log diretamente no console para feedback instantâneo durante o desenvolvimento.
  • Qual componente do GroupDocs fornece registro em arquivo? A classe incorporada FileLogger lida com arquivos de log persistentes.
  • Preciso de uma licença? Uma licença temporária funciona para testes; uma licença completa é necessária para produção.
  • Quais versões do .NET são suportadas? .NET Framework 4.5+, .NET Core 3.1+, .NET 5/6/7.
  • A solução é thread‑safe? Sim—tanto ConsoleLogger quanto FileLogger foram projetados para uso concorrente.

O que é “criar registro robusto em .NET”?

Criar registro robusto em .NET significa estabelecer um pipeline de registro confiável e de alto desempenho que captura erros, avisos e mensagens informativas em todas as camadas de uma aplicação. Com o GroupDocs, você pode alcançar isso usando alvos de console e arquivo, mantendo a configuração simples.

Por que usar o GroupDocs para registro em .NET?

O GroupDocs suporta mais de 30 plataformas .NET e pode processar documentos de até 2 GB sem impacto perceptível de desempenho. Suas APIs de registro são leves, thread‑safe e se integram perfeitamente aos padrões existentes de tratamento de exceções, oferecendo uma solução comprovada e de nível empresarial.

Pré-requisitos

  • Bibliotecas e versões necessárias: GroupDocs.Search para .NET e GroupDocs.Redaction para .NET (últimas versões compatíveis).
  • Configuração do ambiente: Visual Studio 2022 ou qualquer IDE compatível com .NET.
  • Pré-requisitos de conhecimento: Familiaridade com a sintaxe C# e conceitos básicos de registro.

Configurando o GroupDocs.Redaction para .NET

Primeiro, adicione o GroupDocs.Redaction ao seu projeto. Escolha o método que melhor se adapta ao seu fluxo de trabalho.

.NET CLI

dotnet add package GroupDocs.Redaction

Package Manager

Install-Package GroupDocs.Redaction

NuGet Package Manager UI
Pesquise por “GroupDocs.Redaction” e instale a versão mais recente.

Aquisição de Licença

Para começar, você pode adquirir uma licença temporária ou comprar uma completa. Isso permitirá que você explore todos os recursos sem limitações. Visite site oficial da GroupDocs para mais detalhes sobre como obter sua licença.

Inicialização e Configuração Básicas

A classe Redactor fornece APIs para modificar e censurar conteúdo em documentos suportados.

using GroupDocs.Redaction;

// Initialize Redactor with a file path or stream
Redactor redactor = new Redactor("path/to/your/document.pdf");

Guia de Implementação

Como implementar um logger de console personalizado com o GroupDocs?

Carregue seu logger personalizado criando uma instância de ConsoleLogger e passando‑a para o SearchOptions ou qualquer componente do GroupDocs que aceite um ILogger. O logger grava cada mensagem em Console.WriteLine, proporcionando visibilidade em tempo real do que a biblioteca está fazendo e ajudando a identificar rapidamente problemas durante o desenvolvimento.

A classe ConsoleLogger implementa ILogger para escrever mensagens de log diretamente no console.

using System;
using GroupDocs.Search.Common;

public class ConsoleLogger : ILogger
{
    public ConsoleLogger()
    {
    }

    // Logs an error message using the console.
    public void Error(string message)
    {
        Console.WriteLine("Error: " + message);
    }

    // Logs a trace message using the console.
    public void Trace(string message)
    {
        Console.WriteLine(message);
    }
}

Etapa 1: Defina seu Logger Personalizado
Crie uma nova classe chamada ConsoleLogger:

using System;
using GroupDocs.Search.Common;

public class ConsoleLogger : ILogger
{
    public ConsoleLogger()
    {
    }

    // Logs an error message using the console.
    public void Error(string message)
    {
        Console.WriteLine("Error: " + message);
    }

    // Logs a trace message using the console.
    public void Trace(string message)
    {
        Console.WriteLine(message);
    }
}

Etapa 2: Integre com o GroupDocs.Search

SearchOptions configura o comportamento da pesquisa e aceita um ILogger para registro.

using System;
using GroupDocs.Search.Common;
using GroupDocs.Search.Results;

public static void ImplementingCustomLogger()
{
    string indexFolder = "YOUR_DOCUMENT_DIRECTORY/Logging/ImplementingCustomLogger";
    string documentsFolder = "YOUR_DOCUMENT_DIRECTORY/DocumentsPath";
    string query = "Lorem";

    IndexSettings settings = new IndexSettings();
    settings.Logger = new ConsoleLogger(); // Set your custom logger

    Index index = new Index(indexFolder, settings);
    index.Add(documentsFolder);

    SearchResult result = index.Search(query);
}

O que é o FileLogger e quando usá‑lo?

A classe FileLogger implementa ILogger e persiste as entradas de log em um arquivo no disco, tornando‑a ideal para ambientes de produção onde trilhas de auditoria são necessárias. A classe FileLogger fornecida pelo GroupDocs grava as entradas de log em um arquivo especificado no disco, sendo perfeita para ambientes de produção que exigem trilhas de auditoria persistentes. Você pode configurar rotação de logs, limites de tamanho de arquivo e níveis de log para atender aos requisitos operacionais.

A classe FileLogger implementa ILogger e persiste as entradas de log em um arquivo no disco.

using System;
using GroupDocs.Search.Common;
using GroupDocs.Search.Results;

public static void UseOfStandardFileLogger()
{
    string indexFolder = "YOUR_DOCUMENT_DIRECTORY/Logging/UseOfStandardFileLogger";
    string documentsFolder = "YOUR_DOCUMENT_DIRECTORY/DocumentsPath";
    string query = "Lorem";
    string logPath = "YOUR_OUTPUT_DIRECTORY/Logging/Log.txt";

    IndexSettings settings = new IndexSettings();
    settings.Logger = new FileLogger(logPath, 4.0); // Log file path and max size

    Index index = new Index(indexFolder, settings);
    index.Add(documentsFolder);

    SearchResult result = index.Search(query);
}

Por que escolher o GroupDocs para registro em .NET?

O GroupDocs oferece uma vantagem quantificada: suporta mais de 50 formatos de saída e pode lidar com documentos de várias centenas de páginas sem carregar o arquivo inteiro na memória. Sua infraestrutura de registro adiciona menos de 2 ms de overhead por entrada de log, garantindo que o desempenho permaneça ótimo mesmo sob carga pesada.

Aplicações Práticas

Aqui estão alguns cenários práticos onde essas técnicas de registro se destacam:

  1. Monitoramento de Aplicação: Use ConsoleLogger durante o desenvolvimento para ver diagnósticos ao vivo.
  2. Trilhas de Auditoria: Implante FileLogger para manter logs de nível de conformidade para relatórios regulatórios.
  3. Depuração: Aproveite mensagens de rastreamento detalhadas para identificar problemas em pipelines de pesquisa complexas.
  4. Análise de Desempenho: Examine timestamps dos logs para identificar gargalos e otimizar o uso de recursos.

Considerações de Desempenho

Para manter o registro rápido e eficiente:

  • Limite a verbosidade do log: Defina o nível do logger para Info ou Warning em produção para evitar I/O excessivo.
  • Uso eficiente de recursos: Configure FileLogger com tamanho máximo de arquivo de 10 MB e habilite rotação automática.
  • Gerenciamento de memória: Libere as instâncias do logger com blocos using ou chamadas explícitas Dispose() para liberar recursos prontamente.

Perguntas Frequentes

P: Posso usar o logger de console personalizado em uma aplicação multi‑thread?
R: Sim—tanto ConsoleLogger quanto FileLogger são thread‑safe, portanto você pode registrar a partir de tarefas paralelas sem condições de corrida.

P: Preciso de uma licença separada para GroupDocs.Search e GroupDocs.Redaction?
R: Uma única licença GroupDocs cobre todos os módulos, incluindo Search e Redaction, simplificando a aquisição.

P: Como altero o local do arquivo de log para o FileLogger?
R: Defina a propriedade LogFilePath ao construir a instância FileLogger, por exemplo, new FileLogger("C:\\Logs\\app.log").

P: Quais níveis de log o GroupDocs suporta?
R: A biblioteca fornece os níveis Debug, Info, Warning, Error e Critical, permitindo controle granular sobre a saída.

P: É possível combinar registro em console e em arquivo simultaneamente?
R: Absolutamente—crie um logger composto que encaminhe mensagens tanto para ConsoleLogger quanto para FileLogger para visibilidade dupla.

Recursos

Conclusão

Neste guia, mostramos como criar registro robusto em .NET construindo um logger de console personalizado e aproveitando o FileLogger incorporado do GroupDocs. Essas ferramentas fornecem insight em tempo real durante o desenvolvimento e logs confiáveis e persistentes para produção. Explore diferentes configurações de níveis de log, experimente loggers compostos e integre a solução em serviços maiores para observabilidade full‑stack.

Próximos Passos

  • Teste diferentes configurações de nível de log para encontrar o ponto ideal entre detalhe e desempenho.
  • Adicione registro estruturado (saída JSON) ao FileLogger para facilitar a ingestão em plataformas de análise de logs.
  • Explore outros módulos do GroupDocs, como Search e Annotation, para expandir seu pipeline de processamento de documentos.

Última atualização: 2026-07-31
Testado com: GroupDocs.Search 23.11, GroupDocs.Redaction 23.11 for .NET
Autor: GroupDocs

Tutoriais Relacionados