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

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

로깅 구성을 확인하려면 다음 단계를 수행합니다.

  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.log 및 GatewayNetwork.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\온-프레미스 데이터 게이트웨이 디렉터리에 있습니다. 보존할 로그 파일 수를 설정하려면 파일 값의 initializeData 첫 번째 번호를 변경합니다. 각 로그 파일의 크기를 구성하려면 두 번째 숫자를 변경합니다.

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

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

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

게이트웨이 진단에 대한 관리자 동의는 관리자가 온-프레미스 데이터 게이트웨이의 진단 데이터가 수집되어 클라우드로 전송되는지 여부를 명시적으로 제어할 수 있는 기능입니다.

이 기능은 매시업 로그와 같은 잠재적으로 중요한 데이터가 관리 승인 후에만 전송되도록 하는 동의 기반 모델을 도입합니다. 또한 향후 모니터링 및 진단 기능을 사용할 수 있습니다.

사용하도록 설정된 경우:

  • 진단 데이터를 안전하게 수집 및 처리할 수 있습니다.
  • Fabric 작업 영역은 게이트웨이와 연결됩니다.
  • 작업 영역은 향후 모니터링 및 진단 환경을 위해 예약되어 있습니다.

작동 방식

게이트웨이 관리자는 게이트웨이 설정에서 진단을 사용하도록 설정하고 작업 영역 테넌트 관리자를 연결하면 언제든지 동의를 취소할 수 있으므로 테넌트에 있는 모든 게이트웨이가 진단에 참여하지 못하게 됩니다.

진단 데이터 흐름은 엄격하게 적용됩니다.

  • 동의 없으면 데이터 전송 안 됨

  • 액세스가 중지된 → 동의가 취소됨

    테넌트 관리자 진단 동의 옵션의 스크린샷.

    테넌트 관리자 진단 동의 스위치의 스크린샷.

    게이트웨이 관리자 진단 동의 스크린샷

즉시 적용하려면 온-프레미스 데이터 게이트웨이를 다시 시작하면 진행 중인 진단 업로드가 종료됩니다.

관련 콘텐츠

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

  • Last updated on