온-프레미스 데이터 게이트웨이에 대한 로그 파일 구성

  • 아티클

온-프레미스 데이터 게이트웨이에 대한 서비스 로그는 정보, 오류 및 네트워크의 세 가지 범주가 있습니다. 이 분류 방식은 오류 또는 문제에 대한 특정 영역에 초점을 맞출 수 있게 해주는 문제 해결 환경을 제공합니다.

로깅 구성을 검사 위해 다음 단계를 수행합니다.

  1. 게이트웨이 구성 파일 Microsoft.PowerBI.EnterpriseGateway.exe.config를 엽니다. 이 파일은 기본적으로 \Program Files\온-프레미스 데이터 게이트웨이 아래에 있어야 합니다.
  2. 계속하기 전에 나중에 복원해야 하는 경우에 대비하여 이 파일의 복사본을 만듭니다.
  3. 아래에 있는 수신기 ApplicationFileTraceListener 를 찾습니다 system.diagnostics.

다음 섹션에서는 게이트웨이 버전에 따라 보존 유형별로 구성 세부 정보를 제공합니다.

연령 기반 보존

2023년 2월부터 게이트웨이 내의 새로운 연령 기반 보존 개념이 도입되었습니다. 이 개념은 새 게이트웨이 설치의 기본 보존 유형입니다.

이 보존 유형의 경우 두 가지 기본 측면을 고려해야 합니다(우선 순위순).

  • 게이트웨이 로그(GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log)에서 사용할 최대 디스크 공간(기본값은 5GB)입니다.
  • 기본값이 30일인 보존 기간(일)입니다.

이 새 논리에서는 새 날마다 새 로그 파일이 프로비전되도록 합니다. 이 프로비전은 지정된 날짜에 대한 정보가 파일 이름이 로그 항목 날짜와 일치하는 로그 파일에 있는지 확인합니다. 또한 최대 개별 파일 크기(기본값: 100MB)에 도달하면 하루 내의 파일 파티션이 수행됩니다.

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener" type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.AgeBasedRetentionRotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common" initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,30,5120,100" />
      </listeners>
    </trace>
  </system.diagnostics>

보존 기본 매개 변수 값을 변경하려면 값으로 initializeData 조정해야 합니다. 다음 목록에서는 각 매개 변수에 대해 설명합니다.

  • 보존 기간(1일에서 365일 사이의 값)입니다.
  • 세 가지 로그 파일 형식에서 사용할 수 있는 최대 총 크기(MB)입니다.
  • 각 로그 파일에 개별적으로 포함할 수 있는 최대 크기(MB)입니다. 제한에 도달할 때마다 순차 번호가 추가된 새 파일이 만들어집니다.

참고 항목

게이트웨이 로그는 UTC 기반 타임스탬프를 사용하며, 일일 로그 파일 회전은 00:00 UTC에 발생합니다.

파일 수 기반 보존

이는 2022년 12월 이전 버전의 게이트웨이 내에서 기본 로그 보존 논리였습니다. 이 논리에는 두 가지 기본 개념이 있습니다.

  • 로그 유형별로 보존할 파일 수입니다(GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log).
  • 로그 유형당 사용할 최대 디스크 공간(GatewayInfo*.log, GatewayError*.log, GatewayNetwork*.log)입니다.

파일은 이전에 나열된 기준에 따라 적절하게 분할되므로 최대 파일 수에 도달할 때마다 일반적으로 최대 디스크 공간 또는 최대 디스크 공간에 가깝습니다.

게이트웨이 구성 파일 Microsoft.PowerBI.EnterpriseGateway.exe.config에서 발췌한 다음 세 가지 범주GatewayInfo.log는 다음과 GatewayErrors.logGatewayNetwork.log같습니다.

  <system.diagnostics>
    <trace autoflush="true" indentsize="4">
      <listeners>
        <remove name="Default" />
        <add name="ApplicationFileTraceListener"
             type="Microsoft.PowerBI.DataMovement.Pipeline.Common.Diagnostics.RotatableFilesManagerTraceListener, Microsoft.PowerBI.DataMovement.Pipeline.Common"
             initializeData="%LOCALAPPDATA%\Microsoft\On-premises data gateway\,GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50" />
      </listeners>
    </trace>
  </system.diagnostics>

기본적으로 게이트웨이 구성 파일은 \Program Files\On-premises data gateway 디렉토리에 있습니다. 보존할 로그 파일 수를 설정하려면 파일 값의 initializeData 첫 번째 번호를 변경합니다. 각 로그 파일의 크기를 구성하려면 두 번째 숫자를 변경합니다.

다음 예제에서는 각 범주에 있는 모든 파일의 총 크기가 50MB 이하인 총 20개의 로그 파일이 유지되도록 지정합니다. GatewayInfo.log,GatewayErrors.log,GatewayNetwork.log,20,50

기존 온-프레미스 데이터 게이트웨이 설치에 새 연령 기반 보존 논리가 기본적으로 적용될까요?

아니요. 현재 이 보존 논리는 완전히 새로운 게이트웨이 설치에 적용됩니다. 2023년 2월 이상으로 업그레이드하는 동안 기존 게이트웨이는 현재 로그 보존 논리(파일 수 기반 보존)를 유지해야 합니다.

다음 단계

문제 해결을 위해 게이트웨이 로그를 내보내는 방법에 대한 자세한 내용은 문제 해결 도구로 이동하세요.