How to use Custom Logging in C#

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");

IronPDF 로그는 사용자 지정 로거 객체로 전달됩니다. 메시지 내용은 IronPDF 로거에 있는 내용과 동일합니다. 해당 데이터는 사용자 지정 로거로 전달됩니다. 사용자 정의 로거 구현은 메시지를 처리하는 방법을 결정합니다. 다음은 사용자 정의 로거 클래스의 예입니다.

사용자 지정 로깅은 운영 환경에 여러 가지 이점을 제공합니다.

• 중앙 집중식 로그 관리 : IronPDF 로그를 기존 로깅 인프라와 통합합니다.
• 향상된 디버깅 : 문제 해결을 위해 PDF 작업에 대한 자세한 정보를 캡처합니다.
• 성능 모니터링 : 렌더링 시간 및 리소스 사용량을 추적합니다.
• 오류 추적 : PDF 생성 오류를 자동으로 감지하고 보고합니다.
• 규정 준수 : 규제 대상 산업 분야의 문서 생성에 대한 감사 추적 기록을 유지합니다.

비동기 처리가 필요한 애플리케이션의 경우, 사용자 지정 로깅을 통해 동시 PDF 작업량을 추적하고 잠재적인 병목 현상을 파악할 수 있습니다.

사용자 정의 로거 클래스는 어떤 모습일까요?

: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}");
    }
}

이 구현은 표준 Microsoft.Extensions.Logging.ILogger 인터페이스를 따르므로 .NET 로깅 생태계와 호환됩니다. 로거 클래스에는 다음이 포함됩니다.

• 범주 이름 : 로그 메시지의 출처를 식별하는 데 도움이 됩니다.
• 로그 레벨 필터링 : 어떤 심각도 레벨을 기록할지 제어합니다.
• 유연한 출력 : 로그를 원하는 대상(콘솔, 파일, 데이터베이스 등)으로 라우팅할 수 있습니다.
• 예외 처리 : 예외 발생 시 적절한 형식으로 세부 정보를 기록합니다.
• 상태 관리 : BeginScope를 사용한 구조화된 로깅 지원

고급 시나리오의 경우, 특히 복잡한 HTML 변환을 처리하거나 Chrome 렌더링 엔진을 사용할 때 로깅 출력에 영향을 미치는 렌더링 옵션을 살펴보세요.

사용자 지정 로깅 출력은 어떻게 표시되나요?

이 예시에서는 로그 메시지 앞에 추가 정보가 붙습니다.

콘솔 출력은 사용자 지정 로깅이 IronPDF의 내부 운영에 대한 자세한 정보를 제공하는 방법을 보여줍니다. 보시는 바는 다음과 같습니다.

• 크롬 클라이언트 초기화 단계
• 배포 후보 생성
• 네이티브 라이브러리 로딩 시퀀스
• 구성 요소 배포 성공 확인

이처럼 상세한 정보는 PDF 생성 문제를 디버깅 하거나 성능을 최적화할 때 매우 유용합니다. 구조화된 형식 덕분에 프로그램적으로 로그를 쉽게 구문 분석하거나 로그 분석 도구와 통합할 수 있습니다.