Como usar registro personalizado (Custom Logging) em C

Por que devo usar o registro personalizado com o IronPDF?

:path=/static-assets/pdf/content-code-examples/how-to/custom-logging-custom-logging.cs

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.Custom;
IronSoftware.Logger.CustomLogger = new CustomLoggerClass("logging");

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.Custom
IronSoftware.Logger.CustomLogger = New CustomLoggerClass("logging")

Os registros do IronPDF serão direcionados para o objeto de registro personalizado. As mensagens permanecem idênticas às do registrador IronPDF ; Eles são retransmitidos para o registrador personalizado. A implementação personalizada do registrador de logs determina como lidar com as mensagens. Considere o seguinte exemplo de classe de logger personalizada.

O registro personalizado oferece diversas vantagens para aplicações de produção:

• Gerenciamento centralizado de logs : Integre os logs do IronPDF à sua infraestrutura de registro existente.
• Depuração aprimorada : Capture informações detalhadas sobre as operações de PDF para solucionar problemas.
• Monitoramento de desempenho : acompanhe os tempos de renderização e o uso de recursos.
• Rastreamento de erros : Captura e reporta automaticamente falhas na geração de PDFs.
• Conformidade : Manter trilhas de auditoria para a geração de documentos em setores regulamentados.

Para aplicações que exigem processamento assíncrono , o registro personalizado ajuda a monitorar operações simultâneas em PDF e a identificar possíveis gargalos.

Qual é a aparência de uma classe de registro personalizada?

:path=/static-assets/pdf/content-code-examples/how-to/custom-logging-custom-logging-class.cs

public class CustomLoggerClass : ILogger
{
    private readonly string categoryName;

    public CustomLoggerClass(string categoryName)
    {
        this.categoryName = categoryName;
    }

    public IDisposable BeginScope<TState>(TState state)
    {
        return null;
    }

    public bool IsEnabled(LogLevel logLevel)
    {
        return true;
    }

    public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception exception, Func<TState, Exception, string> formatter)
    {
        if (!IsEnabled(logLevel))
        {
            return;
        }

        // Implement your custom logging logic here.
        string logMessage = formatter(state, exception);

        // You can use 'logLevel', 'eventId', 'categoryName', and 'logMessage' to log the message as needed.
        // For example, you can write it to a file, console, or another destination.

        // Example: Writing to the console
        Console.WriteLine($"[{logLevel}] [{categoryName}] - {logMessage}");
    }
}

Public Class CustomLoggerClass
	Implements ILogger

	Private ReadOnly categoryName As String

	Public Sub New(ByVal categoryName As String)
		Me.categoryName = categoryName
	End Sub

	Public Function BeginScope(Of TState)(ByVal state As TState) As IDisposable
		Return Nothing
	End Function

	Public Function IsEnabled(ByVal logLevel As LogLevel) As Boolean
		Return True
	End Function

	Public Sub Log(Of TState)(ByVal logLevel As LogLevel, ByVal eventId As EventId, ByVal state As TState, ByVal exception As Exception, ByVal formatter As Func(Of TState, Exception, String))
		If Not IsEnabled(logLevel) Then
			Return
		End If

		' Implement your custom logging logic here.
		Dim logMessage As String = formatter(state, exception)

		' You can use 'logLevel', 'eventId', 'categoryName', and 'logMessage' to log the message as needed.
		' For example, you can write it to a file, console, or another destination.

		' Example: Writing to the console
		Console.WriteLine($"[{logLevel}] [{categoryName}] - {logMessage}")
	End Sub
End Class

Esta implementação segue a interface padrão Microsoft.Extensions.Logging.ILogger, tornando-a compatível com o ecossistema de registro de logs do .NET . A classe logger inclui:

• Nome da categoria : Ajuda a identificar a origem das mensagens de log.
• Filtragem por nível de log : Controle quais níveis de severidade capturar.
• Saída flexível : Direcione os logs para qualquer destino (console, arquivo, banco de dados, etc.)
• Tratamento de Exceções : Formate e registre corretamente os detalhes da exceção.
• Gerenciamento de estado : Suporte para registro estruturado com BeginScope

Para cenários avançados, explore as opções de renderização que afetam a saída de registro, especialmente ao lidar com conversões HTML complexas ou ao trabalhar com o mecanismo de renderização do Chrome .

Como é a aparência da saída de registro personalizada?

Neste exemplo, as mensagens de registro são precedidas por informações adicionais.

A saída do console demonstra como o registro personalizado fornece informações detalhadas sobre as operações internas do IronPDF. Você pode ver:

• Etapas de inicialização do cliente Chrome
• Criação de candidatos à implantação
• Sequências de carregamento de biblioteca nativa
• Confirmações de implantação bem-sucedida de componentes

Esse nível de detalhe é inestimável ao depurar problemas de geração de PDFs ou otimizar o desempenho. O formato estruturado facilita a análise programática dos registros ou a integração com ferramentas de análise de registros.