다음을 통해 공유

SharePoint Server에서 진단 로깅 구성

  • 아티클

적용 대상:yes-img-132013 yes-img-162016 yes-img-192019 yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

필수 조건

중앙 관리의 절차를 수행하는 사용자 계정은 Farm Administrators SharePoint 그룹 구성원이어야 합니다.

진단 로깅 설정 모범 사례

SharePoint Server 환경에서는 초기 배포 후, 업그레이드 후 및 환경이 변경된 경우(예: 서버 추가 또는 제거) 진단 로깅 설정을 구성해야 할 수 있습니다. 다음 목록의 지침에 따라 특정 환경에 대한 모범 사례를 작성할 수 있습니다.

  • 서버가 로그를 작성할 드라이브를 변경합니다.

    기본적으로 SharePoint Server에서는 제품이 설치된 동일 드라이브 및 파티션에 진단 로그를 작성합니다. 진단 로깅은 상당한 드라이브 공간을 사용하고 드라이브 성능을 저하시킬 수 있으므로 SharePoint Server가 설치되지 않은 다른 드라이브에 진단 로그를 작성하도록 SharePoint Server를 구성해야 합니다. 또한 SharePoint Server가 로그를 작성하는 드라이브에 대한 연결 속도도 고려해야 합니다. 자세한 정보 표시 수준 로깅이 구성된 경우 서버는 대량의 데이터를 기록합니다. 따라서 연결 속도가 느리면 로그 성능이 저하될 수 있습니다.

  • 로그 디스크 공간 사용량을 제한합니다.

    기본적으로 진단 로깅이 사용할 수 있는 디스크 공간은 제한되어 있습니다. 따라서 특히 자세한 정보 표시 수준 이벤트를 작성하도록 로깅을 구성할 경우에는 로깅에 사용되는 디스크 공간을 제한해야 합니다. 디스크가 한도에 도달하면 SharePoint Server가 가장 오래된 로그를 제거한 후 새 로깅 데이터를 기록합니다.

  • 자세한 정보 표시 설정은 신중하게 사용합니다.

    자세한 정보 표시 수준의 이벤트를 기록하도록 진단 로깅을 구성할 수 있습니다. 이렇게 하면 SharePoint Server가 수행하는 모든 작업을 기록합니다. 자세한 정보 표시 수준 로깅을 사용하면 드라이브 공간이 빠르게 소진될 수 있으며, 드라이브 및 서버 성능에 영향을 줄 수 있습니다. 자세한 정보 표시 수준 로깅을 사용하여 중요한 사항을 변경할 때 관련 정보를 보다 상세하게 기록하고, 변경 후에는 보다 높은 수준의 이벤트만 기록하도록 로깅을 다시 구성할 수 있습니다.

  • 정기적으로 로그를 백업합니다.

    진단 로그에는 중요한 데이터가 포함됩니다. 따라서 이 데이터를 보존할 수 있도록 정기적으로 로그를 백업해야 합니다. 로그 드라이브 공간 사용을 제한하거나 로그를 며칠 동안만 보관하려는 경우, 임계값에 도달하면 SharePoint Server가 오래된 파일부터 순서대로 로그 파일을 자동으로 삭제합니다.

  • 이벤트 로그 도배 방지를 사용하도록 설정합니다.

    이 설정을 사용하도록 설정하면 SharePoint Server가 Windows 이벤트 로그에서 반복되는 이벤트를 감지하고 조건이 일반 상태로 돌아올 때까지 이를 표시하지 않습니다.

이벤트 로그 및 추적 로그에 대한 진단 로깅 수준을 설정할 수 있습니다. 이 설정을 통해 각 로그에 로깅할 정보의 유형과 양이 제한됩니다. 다음 표에는 이벤트 로그 및 추적 로그에 대해 사용 가능한 로깅 수준이 정의되어 있습니다.

이벤트 로그 수준

수준 정의
없음
 로깅되지 않습니다.
위험
 이 메시지 형식은 솔루션의 중대한 실패를 유발한 심각한 오류를 나타냅니다.
오류
 이 메시지 유형은 긴급 상황을 나타냅니다. 모든 오류 이벤트를 조사해야 합니다.
경고
 이 메시지 유형은 주의할 필요가 있는 잠재적 문제를 나타냅니다. 경고 메시지에서 시간에 따른 패턴을 검토 및 추적해야 합니다.
정보
 정보 메시지에는 아무 작업도 필요하지 않습니다. 그러나 솔루션 상태를 모니터링하는 데 중요한 데이터를 제공할 수 있습니다.
자세한 정보
 이 이벤트 로그 수준은 긴 이벤트 또는 메시지에 해당합니다.

추적 로그 수준

수준 정의
없음
 추적 로그가 기록되지 않습니다.
예기치 않음
 이 수준은 솔루션 처리를 중지하는 이벤트에 대한 메시지를 기록합니다. 이 수준으로 설정하면 로그에 Unexpected, Exception, Assert 및 Critical 수준의 이벤트가 포함됩니다.
Monitorable
 이 수준은 솔루션 기능을 제한하지만 응용 프로그램을 중지시키지 않는 모든 복구할 수 없는 이벤트에 대한 메시지를 기록합니다. 이 수준으로 설정하면 로그에 Unexpected 설정으로 기록되는 이벤트도 포함됩니다.
높음
 이 수준은 예기치 않았지만 솔루션 처리를 중지시키지는 않는 모든 이벤트를 기록합니다. 이 수준으로 로깅하도록 설정된 경우 로그에는 Monitorable 설정으로 기록되는 모든 이벤트도 포함됩니다.
보통
 이 수준으로 설정하면 추적 로그에 Verbose 및 VerboseEx 메시지를 제외한 모든 메시지가 포함됩니다. 이 수준은 수행된 작업에 대한 모든 상위 수준 정보를 기록합니다. 이 수준은 데이터 흐름 및 작업 순서를 생성하는 데 충분한 세부 정보를 제공합니다. 관리자 또는 지원 전문가는 이 수준의 로깅을 사용해서 문제를 해결할 수 있습니다. 이 수준으로 설정된 경우 로그에는 High 설정으로 기록되는 모든 이벤트도 포함됩니다.
자세한 정보
 이 수준으로 설정된 경우 로그에 대부분의 작업이 포함됩니다. Verbose 추적은 여러 개의 로그 메시지를 생성합니다. 이 수준은 일반적으로 개발 환경의 디버깅용으로만 사용됩니다. 이 수준으로 로그를 설정하면 로그에 Medium 설정으로 기록되는 모든 이벤트도 포함됩니다.
VerboseEx
 이 수준은 Set-SPLogLevel PowerShell cmdlet에서만 지원되며 매우 세부적인 진단 데이터를 포함합니다. 이 수준은 개발 환경에서만 사용할 수 있습니다. 이 수준으로 설정하면 로그에 Verbose 설정으로 기록되는 모든 이벤트가 포함됩니다.

중앙 관리를 사용하여 진단 로깅 구성

SharePoint 중앙 관리 웹 사이트를 사용하여 진단 로깅을 구성할 수 있습니다.

중앙 관리를 사용하여 진단 로깅을 구성하려면

  1. 중앙 관리 홈페이지에서 모니터링을 클릭합니다.

  2. 모니터링 페이지의 보고 섹션에서 진단 로깅 구성을 클릭합니다.

  3. 진단 로깅 페이지의 이벤트 제한 섹션에서 다음과 같이 이벤트 제한을 구성합니다.

    모든 범주에 대해 이벤트 제한을 구성하려면 다음을 수행합니다.

  4. 모든 범주 확인란을 선택합니다.

  5. 이벤트 로그에 보고할 최소 중요 이벤트 목록에서 이벤트 로그 수준을 선택합니다.

  6. 추적 로그에 보고할 최소 중요 이벤트 목록에서 추적 로그 수준을 선택합니다.

    하나 이상의 범주에 대해 이벤트 제한을 구성하려면 다음을 수행합니다.

  7. 원하는 범주의 확인란을 선택합니다.

  8. 이벤트 로그에 보고할 최소 중요 이벤트 목록에서 이벤트 로그 수준을 선택합니다.

  9. 추적 로그에 보고할 최소 중요 이벤트 목록에서 추적 로그 수준을 선택합니다.

    하나 이상의 하위 범주에 대한 이벤트 제한을 구성하려면(하나 이상의 범주를 확장하고 하위 범주를 선택할 수 있음)

  10. 범주 옆의 더하기(+)를 클릭하여 범주를 확장합니다.

  11. 하위 범주의 확인란을 선택합니다.

  12. 이벤트 로그에 보고할 최소 중요 이벤트 목록에서 이벤트 로그 수준을 선택합니다.

  13. 추적 로그에 보고할 최소 중요 이벤트 목록에서 추적 로그 수준을 선택합니다.

    모든 범주에 대한 이벤트 제한을 기본 설정으로 되돌리려면

  14. 모든 범주 확인란을 선택합니다.

  15. 이벤트 로그에 사용할 최소 중요 이벤트 목록에서 기본값으로 설정을 선택합니다.

  16. 추적 로그에 사용할 최소 중요 이벤트 목록에서 기본값으로 설정을 선택합니다.

  17. 이벤트 로그 도배 방지 섹션에서 이벤트 로그 도배 방지 사용 확인란을 선택합니다.

  18. 추적 로그 섹션의 경로 상자에 로그를 쓸 폴더의 경로를 입력합니다.

  19. 로그 파일을 저장할 일 수 상자에 로그를 보관할 일 수(1일~366일)를 입력합니다. 이 기간이 경과하면 로그는 자동으로 삭제됩니다.

  20. 로그가 사용할 수 있는 디스크 공간을 제한하려면 추적 로그 디스크 공간 사용량 제한 확인란을 선택하고 로그 파일에 대해 제한할 공간을 GB 단위로 입력합니다. 로그가 이 값에 도달하면 오래된 로그가 자동으로 삭제됩니다.

  21. 진단 로깅 페이지에서 원하는 항목을 변경한 후에 확인을 클릭합니다.

PowerShell을 사용하여 진단 로깅 구성

PowerShell을 사용하여 진단 로깅을 구성할 수 있습니다.

PowerShell을 사용하여 진단 로깅을 구성하려면

  1. 다음 멤버 자격이 있는지 확인합니다.

    • SQL Server 인스턴스에 대한 securityadmin 고정 서버 역할

    • 업데이트하려는 모든 데이터베이스에 대한 db_owner 고정 데이터베이스 역할

    • PowerShell cmdlet을 실행 중인 서버의 Administrators 그룹

    관리자는 Add-SPShellAdmin cmdlet을 사용하여 PowerShell cmdlet 사용 권한을 부여할 수 있습니다.

    참고

    권한이 없는 경우 설치 관리자 또는 SQL Server 관리자에게 문의하여 권한을 요청하십시오. PowerShell 권한에 대한 자세한 내용은 Add-SPShellAdmin을 참조하십시오.

  2. SharePoint 관리 셸에서 서버가 로그를 기록하는 드라이브를 변경합니다.

  3. PowerShell 명령 프롬프트에 다음 명령을 입력합니다.

    Set-SPDiagnosticConfig -LogLocation D:\DiagnosticLogs

  4. 로그 디스크 공간 사용을 제한하려면 PowerShell 명령 프롬프트에 다음 명령을 입력합니다.

    Set-SPDiagnosticConfig -LogMaxDiskSpaceUsageEnabled

또는 로그에 대한 최대 디스크 크기를 지정합니다.

Set-SPDiagnosticConfig -LogDiskSpaceUsageGB 500

  1. 현재 로깅 수준을 보려면 PowerShell 명령 프롬프트에서 다음 명령을 입력합니다.

    Get-SPLogLevel

  2. 로깅 수준을 변경하려면 PowerShell 명령 프롬프트에 다음 명령을 입력합니다.

    Set-SPLogLevel -TraceSeverity Monitorable

모든 범주를 기본 수준으로 설정하려면 PowerShell 명령 프롬프트에 다음 명령을 입력한 후 Enter 키를 누릅니다.

Clear-SPLogLevel

  1. 이벤트 로그 도배 방지를 위해서는 PowerShell 명령 프롬프트에 다음 명령을 입력합니다.

    Set-SPDiagnosticConfig -EventLogFloodProtectionEnabled

자세한 내용은 Set-SPDiagnosticConfig, Set-SPLogLevel 및 Get-SPLogLevel을 참조하세요.

참고 항목

개념

SharePoint Server 2016의 모니터링 개요