다음을 통해 공유

SharePoint Server 2016에서 관리 작업 로깅 사용

  • 아티클

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

관리 작업 로깅 기능은 SharePoint Server 2016용 2016년 11월 공개 업데이트(기능 팩 1)에 포함되어 있습니다. 이 기능을 사용하면 SharePoint Server 2016 관리 작업을 로깅할 수 있습니다.

개요

SharePoint Server 설정에 대한 관리 변경으로 인해 오류가 발생하거나 의도하지 않은 영향을 줄 수 있습니다. 관리 변경 문제를 해결하기 위해 주요 SharePoint 관리 작업에 대한 로깅은 기능 팩 1에서 사용할 수 있습니다. 로깅은 중앙 관리 및 Windows PowerShell 작업에 모두 사용할 수 있습니다.

관리 작업 로깅 켜기

SharePoint Server 2016 2016년 11월 SharePoint Server 2016 공개 업데이트(기능 팩 1)를 설치하면 관리 작업 로깅이 기본적으로 설정됩니다.

기능 팩 1을 설치한 후 관리 작업은 SharePoint 2016 중앙 관리의 사용량 및 상태 데이터 수집 구성 페이지의 "기록할 이벤트" 아래에 선택된 옵션으로 표시됩니다.

SharePoint 2016 중앙 관리의 관리 작업 로깅

관리 작업 로컬 로그 파일 위치를 찾는 방법

관리 작업 로그 파일은 서버에 저장됩니다. 이러한 로그의 로컬 위치를 보려면 다음을 수행합니다.

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

  2. 보고 섹션에서 Usage and Health Data Collection 구성을 클릭합니다.

  3. 사용량 현황 데이터 수집 설정 아래에 로그 파일 위치가 나열됩니다.

관리 작업 사용 데이터베이스 로그 파일을 찾는 방법

관리 작업 로그는 SharePoint 사용량 데이터베이스에 기록됩니다. 로깅 데이터베이스 서버를 찾으려면 다음을 수행합니다.

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

  2. 보고 섹션에서 Usage and Health Data Collection 구성을 클릭합니다.

  3. 로깅 데이터베이스 서버 및 데이터베이스 이름은 로 깅 데이터베이스 서버 설정에서 찾을 수 있습니다.

SharePoint 사용 데이터베이스에서 로그 검색

관리 작업 로그는 SharePoint 사용량 데이터베이스에 최대 31일 동안 유지됩니다.

  1. Microsoft SQL Server Management Studio 엽니다. ** 참고: ** 관리자 권한으로 로그인해야 합니다.

  2. 위의 로깅 데이터베이스 서버 설정에서 "데이터베이스 서버"로 표시된 서버 이름에 연결합니다.

  3. 해당 로깅 데이터베이스에 연결합니다. 일반적으로 WSS_Logging 로깅 데이터베이스 서버 설정에서 "데이터베이스 이름"으로 지정한 데이터베이스입니다.

  4. "AdministrativeActions" 파티션을 쿼리합니다.

    참고

    적용 가능한 "AdministrativeActions" 파티션 수를 선택합니다. 파티션은 32개, 파티션은 0~31개여야 합니다. WSS_logging 기본 로깅 데이터베이스 이름입니다. 로깅 데이터베이스 이름이 다른 경우 쿼리를 수정합니다.

샘플 쿼리

SELECT TOP 1000 [PartitionId]
      ,[RowId]
      ,[LogTime]
      ,[MachineName]
      ,[FarmId]
      ,[SiteSubscriptionId]
      ,[UserLogin]
      ,[CorrelationId]
      ,[Action]
      ,[Target]
      ,[Details]
      ,[RowCreatedTime]
  FROM (
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition0]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition1]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition2]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition3]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition4]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition5]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition6]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition7]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition8]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition9]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition10]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition11]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition12]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition13]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition14]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition15]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition16]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition17]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition18]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition19]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition20]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition21]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition22]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition23]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition24]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition25]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition26]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition27]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition28]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition29]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition30]
union
select * from [WSS_Logging].[dbo].[AdministrativeActions_Partition31]
) as A

Windows PowerShell 사용하여 로그 검색

Windows PowerShell cmdlet ** Merge-SPUsageLog **를 사용하여 관리 작업 로그를 검색할 수도 있습니다.

중요

Merge-SPUsageLog를 사용하려면 원격 cmdlet 실행을 사용하도록 설정해야 합니다. 원격 명령을 받도록 컴퓨터를 구성하려면 Enable-PSRemoting을 참조하세요.

Merge-SPUsageLog cmdlet은 지정된 조건에 따라 로그를 수집, 필터링 및 집계합니다. 이 cmdlet의 성능을 최적화하려면 StartTime 및 EndTime 매개 변수를 사용하여 필터링하는 것이 좋습니다.

Merge-SPUsageLog 는 조건을 충족하는 로그에서 PowerShell 파이프라인에 개체를 생성합니다. 적어도 사용 유형(예: "관리 작업")을 지정해야 합니다.

Merge-SPUsageLog -Identity <SPUsageDefinitionPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-DiagnosticLogPath <String>] [-EndTime <DateTime>] [-OverWrite <SwitchParameter>] [-Servers <String[]>] [-StartTime <DateTime>]
매개 변수 필수 종류 설명
ID
 필수
 Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind
 사용 현황 로그 파일의 이름을 지정합니다.
AssignmentCollection
 옵션
 Microsoft.SharePoint.PowerShell.SPAssignmentCollection
 올바른 삭제를 위해 개체를 관리합니다. SPWeb 또는 SPSite와 같은 개체를 사용하는 경우 많은 양의 메모리를 사용할 수 있으며, Windows PowerShell 스크립트에서 이러한 개체를 사용하려면 올바른 메모리 관리가 필요합니다. SPAssignment 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다.
> [! 참고]> Global 매개 변수를 사용하면 모든 개체가 전역 저장소에 포함됩니다. 개체가 즉시 사용되지 않거나 Stop-SPAssignment 명령을 사용하여 삭제되지 않는 경우 메모리 부족 시나리오가 발생할 수 있습니다.
DiagnosticLogPath
 옵션
 System.String
 진단 정보를 기록할 파일을 지정합니다. 상대 경로를 사용할 수 있습니다.
EndTime
 옵션
 System.DateTime
 반환되는 로그 항목의 종료 시간을 지정합니다. 형식은 관리 언어의 문화권에 따른 유효한 DateTime 형식(예: 영어(미국)의 경우 2/16/2007 12:15:12)이어야 합니다. 기본값은 현째 시간입니다.
UTC 시간을 지정하려면 "Z"를 매개 변수 끝에 추가해야 합니다. 예를 들면 "2016-06-15 03:29:18.199 Z"와 같습니다. "Z"를 지정하지 않으면 UTC 대신 로컬 컴퓨터 시간이 표시됩니다.
덮어쓸
 옵션
 System.Management.Automation.SwitchParameter
 지정한 경로에 진단 로그 파일이 이미 있는 경우 해당 파일을 덮어씁니다.
서버
 옵션
 System.String[]
 필터를 적용할 서버 주소 또는 주소입니다. 팜에서 유효한 주소 목록을 가져오려면 Get-SPServer
주소를 선택합니다.
StartTime
 옵션
 System.DateTime
 반환되는 로그 항목의 시작 시간을 지정합니다. 형식은 관리 언어의 문화권에 따른 유효한 DateTime 형식(예: 영어(미국)의 경우 "2/16/2007 12:15:12")이어야 합니다. 기본값은 로컬 컴퓨터의 현재 시간보다 1시간 전입니다.
UTC 시간을 지정하려면 "Z"를 매개 변수 끝에 추가해야 합니다. 예를 들면 "2016-06-15 03:29:18.199 Z"와 같습니다. "Z"를 지정하지 않으면 UTC 대신 로컬 컴퓨터 시간이 표시됩니다.

예제 1: 다음은 모든 팜 컴퓨터에서 "관리 작업" 사용 공급자에 대한 로그 데이터의 마지막 1시간을 병합하는 예제입니다.

Merge-SPUsageLog -Identity "Administrative Actions"

예제 2: 이 예제에서는 "A-0606" 및 "A-0505"라는 서버에서 지금까지 "06/09/2016 16:00"에서 "관리 작업" 사용 공급자에 대한 로그 항목을 병합합니다.

Merge-SPUsageLog -Identity "Administrative Actions" -Servers "A-0606","A-0505" -StartTime "06/09/2008 16:00"

예제 3: 이 예제에서는 8월 11일부터 관리 작업 로그를 검색한 다음 표시할 필드인 User, ActionName 및 TimeStamp를 선택합니다. 결과는 TimeStamp별로 정렬됩니다. 이 예제에서는 Windows PowerShell 파이프라인을 사용합니다. 파이프라인을 사용하는 방법에 대한 자세한 내용은 about_Pipelines을 참조하세요.

Get-SPUsageDefinition -Identity "Administrative Actions" | Merge-SPUsagelog  -StartTime "08/11/2016 3:50 AM" | Select User, ActionName, Timestamp | Sort Timestamp

기록된 관리 작업 유형

다음 표에서는 로그에 캡처된 관리 작업의 유형을 자세히 설명합니다.

작업 범주 작업 하위 범주 로그 작업 설명
계정 구성
 추가, 제거, 업데이트
 Administration.Security.User.Add Administration.Security.User.Remove Administration.Security.User.Update Administration.Security.User.Role.Update
 팜 및 사이트 모음 관리자의 추가, 제거 및 업데이트를 포함하여 관리 계정 구성 및 정보 변경 내용을 기록합니다. 또한 역할 업데이트를 기록합니다.
관리되는 계정 구성
 새로 만들기, 제거, 업데이트
 Administration.Security.ManagedAccount.New Administration.Security.ManagedAccount.Remove Administration.Security.ManagedAccount.Update
 관리되는 계정 구성의 변경 내용, 관리되는 계정 만들기 및 제거, 기존 관리 계정에 대한 업데이트를 기록합니다.
서비스 계정 구성
 업데이트
 Administration.Security.ServiceAccount.Update
 팜에서 지정된 서비스 계정에 대한 업데이트를 기록합니다.
암호 변경 설정 구성
 업데이트
 Administration.Security.AccountPasswordSetting.Update
 암호 관리 설정에 대한 업데이트를 기록합니다.
인증 공급자 지정
 업데이트
 Administration.Security.AuthenticationProviderSetting.Update
 인증 공급자 설정에 대한 업데이트를 기록합니다.
신뢰 관리
 편집, 제거, 업데이트
 Administration.Security.ManageTrust.SPTrustedRootAuthority.Edit Administration.Security.ManageTrust.SPTrustedRootAuthority.New Administration.Security.ManageTrustedRootAuthority.Remove Administration.Security.ManageTrust.SPTrustedSecurityTokenIssuer.Edit Administration.Security.ManageTrust.SPTrustedSecurityTokenIssuer.New Administration.Security.ManageTrust.SPTrustedSecurityTokenIssuer.Remove
 Administration.Security.ManageTrustedRootAuthority 로그는 팜의 트러스트 관계 설정을 편집하고 제거하고 새 트러스트 관계를 생성합니다. Administration.Security.ManageTrust.SPTrustedSecurityTokenIssuer는 토큰 발급자 설정의 편집 및 제거 및 새 토큰 발급자 트러스트 관계 만들기를 기록합니다.
웹 파트 보안 관리
 업데이트
 Administration.Security.WebPart.Update
 선택한 웹 애플리케이션에서 웹 파트 페이지 및 웹 파트에 업데이트를 기록합니다.
팜 백업 및 복원 작업
 백업, 복원, 업데이트
 Administration.Farm.BackupRestore.Backup Administration.Farm.BackupRestore.Restore Administration.Farm.BackupRestore.Settings.Update
 기본 백업 및 복원 설정에 대한 업데이트를 포함하여 팜 복원 및 백업 작업을 기록합니다.
서버 관리
 추가, 제거, 업데이트
 Administration.Farm.Server.Add Administration.Farm.Server.Remove Administration.Farm.Server.Role.Update
 팜 서버의 역할 업데이트를 포함하여 팜에 서버 제거 및 추가를 기록합니다.
구성 데이터베이스 변경 내용
 새로 만들기, 제거
 Administration.Farm.ConfigurationDatabase.New Administration.Farm.ConfigurationDatabase.Remove
 새 구성 데이터베이스의 추가 또는 기존 구성 데이터베이스 제거를 기록합니다.
사이트 모음 관리
 추가, 백업, 내보내기, 가져오기, 제거, 복원, 업데이트
 Administration.SiteCollection.Add Administration.SiteCollection.BackupRestore.Backup Administration.SiteCollection.BackupRestore.Restore Administration.SiteCollection.Owner.Update Administration.SiteCollection.SecondContact.Update Administration.SiteCollection.Quota.Update Administration.SiteCollection.ImportExport.Export Administration.SiteCollection.ImportExport.ImportExport.Import
 사이트 모음 추가 및 제거, 사이트 모음의 백업 및 복원 작업, 소유권 변경, 보조 연락처 및 할당량, 사이트 모음의 가져오기 및 내보내기 작업을 포함하여 사이트 모음 관리와 관련한 가장 일반적인 작업을 기록합니다.
사이트 모음 콘텐츠 데이터베이스
 추가, 새로 만들기, 제거, 설정
 Administration.ContentDatabase.Add Administration.ContentDatabase.New Administration.ContentDatabase.Remove Administration.ContentDatabase.Set
 팜에 콘텐츠 데이터베이스 추가, 새 콘텐츠 데이터베이스 만들기, 콘텐츠 데이터베이스 제거 및 콘텐츠 데이터베이스의 전역 속성 설정과 같은 일반적인 SharePoint 콘텐츠 데이터베이스 작업을 기록합니다.
할당량 변경
 새로 만들기, 제거, 업데이트
 Administration.Quota.New Administration.Quota.Remove Administration.Quota.Update
 사이트 새 컬렉션 할당량을 설정하고, 기존 사이트 모음 할당량을 업데이트하고, 사이트 모음 할당량을 제거하는 로그입니다.
기능 관리
 설치, 사용 안 함, 제거, 사용
 Administration.Feature.Disable Administration.Feature.Enable Administration.Feature.Install Administration.Feature.Uninstall
 기능을 사용하지 않도록 설정, 사용, 설치 및 제거하는 사이트 모음 기능 관리 작업을 기록합니다.
웹 애플리케이션 관리
 편집, 새로 만들기, 제거
 Administration.WebApplication.Edit Administration.WebApplication.New Administration.WebApplication.Remove
 기존 웹 애플리케이션에 대한 편집, 새 웹 애플리케이션 만들기 및 기존 웹 애플리케이션 제거를 비롯한 일반적인 웹 애플리케이션 관리 작업을 기록합니다.
웹 애플리케이션 관리 사용자 정책
 추가, 새로 만들기, 제거, 업데이트
 Administration.WebApplication.UserPolicy.Add Administration.WebApplication.UserPolicy.New Administration.WebApplication.UserPolicy.Remove Administration.WebApplication.UserPolicy.Update
 기존 웹 애플리케이션 사용자 정책에 사용자 추가, 새 사용자 정책 만들기, 기존 사용자 정책에서 사용자 제거, 사용자 권한 정책 업데이트 등 웹 애플리케이션의 사용자 권한 정책 관리와 관련된 작업을 기록합니다.
서비스 응용 프로그램
 편집, 새로 만들기, 제거
 Administration.ServiceApplication.Edit Administration.ServiceApplication.New Administration.ServiceApplication.Remove
 서비스 애플리케이션에 대한 편집, 새 서비스 애플리케이션 만들기 및 기존 서비스 애플리케이션 제거를 기록합니다.
양식 & 기능 템플릿 관리
 변환, 사용 안 함, 사용, 설치, 새로 만들기, 설정, 시작, 중지, 테스트, 업데이트, 업그레이드, 제거
 Administration.FormTemplate.Convert Administration.FormTemplate.Disable Administration.FormTemplate.Enable Administration.FormTemplate.Install Administration.FormTemplate.New Administration.FormTemplate.Set Administration.FormTemplate.. Administration.FormTemplate.Stop Administration.FormTemplate.Update Administration.FormTemplate.Test Administration.FormTemplate.Upgrade Administration.FormTemplate.Uninstall Administration.Feature.FormTemplate.Install을 시작합니다. Administration.Feature.FormTemplate.Uninstall
 템플릿 변환, 비활성화(비활성화), 활성화, 설치, 새 템플릿 만들기, 템플릿 설정, 템플릿 시작 및 중지, 템플릿, 업데이트, 테스트, 업그레이드 및 제거를 포함하여 사이트 모음에서 InfoPath 템플릿 관리와 관련된 작업을 기록합니다.
콘텐츠 데이터베이스
 추가, 새로 만들기, 제거, 설정
 Administration.ContentDatabase.Add Administration.ContentDatabase.New Administration.ContentDatabase.Remove Administration.ContentDatabase.Set
그룹 구성
 추가, 제거, 업데이트
 Administration.Security.Group.Add Administration.Security.Group.Remove Administration.Security.Group.Update
 그룹 만들기, 삭제 및 관리와 관련된 작업(예: 그룹 추가, 제거 및 업데이트)을 기록합니다.
사용자 & 그룹 마이그레이션
 이동
 Administration.Security.User.Move Administration.Security.Group.Move
 그룹 및 사용자 로그인 마이그레이션과 관련된 활동을 기록합니다.