ArcGIS Enterprise는 발생하는 이벤트 및 이벤트와 연관된 모든 오류를 로그에 기록합니다. 로그는 기관의 문제를 모니터링하고 해결하는 중요한 도구입니다. 로그의 정보는 오류를 식별하는 데 도움이 되고 문제를 해결하는 방법에 대한 정보를 제공합니다. 또한 로그는 시간이 지남에 따라 발생하는 이벤트의 히스토리를 구성합니다.
예를 들어 다음과 같은 이벤트가 로그에 기록됩니다.
- 설치 및 업그레이드 이벤트(예시: 소프트웨어 인증 및 포털 생성)
- 서비스 및 항목 발행(예: 호스팅 서비스, 웹 맵, 데이터 항목)
- 콘텐츠 관리 이벤트(예: 항목 공유, 항목 소유권 변경, 항목 추가/업데이트/이동/삭제)
- 보안 이벤트(예시: 기관에 사용자 로그인, 사용자 생성/삭제/비활성화, 사용자 역할 생성/변경, HTTP 및 HTTPS 설정 업데이트, 보안 인증서 가져오기/내보내기, 포털의 ID 스토어 업데이트)
- 기관 관리 이벤트(예시: 그룹 추가/구성, 그룹에 사용자 추가/그룹에서 사용자 제거, 갤러리 구성, 베이스맵, 유틸리티 서비스, 페더레이션된 서버, 로그 설정 구성, 로그 삭제)
- 일반 이벤트(예: 포털의 검색 색인 업데이트, 포털 다시 시작)
다음과 같은 이벤트는 로그에 기록되지 않습니다.
- 기관에서 사용자 로그아웃
- ArcGIS Server 사이트를 포털과 페더레이션 및 페더레이션 해제
- 항목 편집 및 쿼리를 위한 REST 요청
포털 관리자 디렉터리에서 ArcGIS Enterprise 컴포넌트의 로그를 쿼리할 수 있지만 모든 이벤트 필터를 서버 로그에 사용할 수 있는 것은 아닙니다. 더 많은 필터링 옵션은 ArcGIS Server Manager에서 서버 로그를 쿼리하세요.
설치 및 업그레이드 로깅 동작
ArcGIS Enterprise를 설치하거나 업그레이드할 때 각 컴포넌트의 로그 레벨은 자세히로 설정됩니다. 즉, 설치 또는 업그레이드 프로세스 중에 메시지가 매우 자세하게 기록됩니다.
Portal for ArcGIS를 설치하거나 업그레이드할 때 오류가 발생했으며 로그를 검토하여 문제를 해결하려면 포털 관리자 디렉터리에 접근할 수 있는지 확인하세요. 접근할 수 있으면 로그를 쿼리하고 메시지를 검토합니다. 접근할 수 없는 경우에는 디스크에 있는 로그 메시지를 검토합니다. 디스크의 로그에 접근하려면 로그 디렉터리로 이동하여 가장 최근의 로그 파일(예시: C:\arcgisportal\logs\<machine name>\portal\portal-20150101.095803-8596-0.0.log)을 엽니다. 필요한 경우 이 정보를 Esri Support와 공유합니다.
설치 또는 업그레이드 프로세스를 완료한 후에는 기본 설정에 따라 각 컴포넌트의 로그 레벨이 경고로 설정됩니다. 즉, 보통의 문제부터 심각한 문제만 기록됩니다. 사용자가 문제를 보고하면 특정 문제에 대해 더 세밀한 메시지를 캡처하기 위해 로그 레벨을 변경해야 할 수도 있습니다. 로깅 레벨을 수정하는 방법을 알아보려면 포털 로그 설정 지정 및 서버 로그 설정 지정을 참고하세요.
로그 이해
모든 이벤트 특정 설명한 정보, 예를 들어 로그 수준 유형, 이벤트가 발생한 시간, 이벤트를 로깅한 원본 컴포넌트, 이벤트가 발생한 머신, 이벤트와 관련된 사용자, 로그 코드, 프로세스 ID 등을 기록합니다. 이 모든 정보를 통해 문제를 더 효과적으로 해결할 수 있습니다. 다음 섹션에서는 이 정보에 대해 자세히 설명합니다.
로그 유형
즉시 주의가 필요한 문제를 나타내는 심각부터 기관의 일상적인 사용을 통해 생성되는 자세한 정보 메시지인 자세히까지 기록된 이벤트의 세밀도가 다를 수 있습니다.
다음은 로그 수준 유형입니다.
레벨 | 설명 | 샘플 메시지 |
---|---|---|
심각 | 즉시 주의가 필요한 심각한 문제입니다. 이 수준은 심각한 메시지만 포함합니다. | The 'System/GPServer/PublishingTools' service is stopped or ArcGIS Server is not started. Verify these components are started and try again. |
경고 | 주의가 필요한 보통의 문제입니다. 이 수준은 심각한 메시지도 포함합니다. | Organization updated: HTTP access disabled. The portal can only be accessed through HTTPS. |
정보 | 기관 설정 업데이트에 대한 메시지를 비롯하여 일반적인 관리 메시지입니다. 이 수준은 심각 및 경고 메시지도 포함합니다. | User 'asmith' signed in to the portal. |
일반 | 작업 이름 및 받은 요청과 같은 기관 사용에 대한 일반적인 메시지입니다. 이 수준은 심각, 경고, 정보 메시지를 포함합니다. | Account settings updated. |
자세한 정보 | 기관에서 어떻게 작업 및 요청을 수행하는지에 대한 자세한 메시지입니다. 이 수준은 심각, 경고, 정보, 일반 메시지를 포함합니다. | Setting log level to VERBOSE before creating new site. |
디버그 | 문제 해결 시 기관의 상태에 대해 잘 파악하고자 하는 개발자와 지원 기술자를 위해 고안된 매우 자세한 메시지입니다. 프로덕션 환경에서는 이 수준을 사용하지 마세요. 성능 저하가 발생할 수 있습니다. 문제 해결 중이 아닌 경우에는 대신 경고를 사용하세요. | Failed to update index for item '44b37137e1f64de2bec832ab82043b86'. |
끄기 | 로깅이 꺼집니다. 이벤트가 기관에 기록되지 않습니다. | N/A |
메시지
기록된 이벤트와 관련된 메시지입니다. 로그 수준 유형에 따라 메시지의 자세한 정도가 다릅니다.
시간
기록된 이벤트가 발생한 시간입니다. 이벤트는 시간 순으로 구성되며 가장 최근 이벤트가 먼저 나타납니다. 시간 형식은 yyyy-mm-ddThh:mm:ss입니다.
원본
포털에 기록된 이벤트는 다음 소스 중 하나입니다.
- 공유 — 발행 및 사용자와 관련된 이벤트입니다.
- 포털 관리자 — 보안 및 색인과 관련된 이벤트입니다.
- 포털 — 소프트웨어 설치와 관련된 이벤트입니다.
서버에 기록된 이벤트의 소스는 서비스 또는 서버일 수 있습니다. 서비스와 관련된 이벤트는 소스 등록정보로 이름 및 서비스 유형을 표시합니다. 서버와 관련된 이벤트는 소스 등록정보로 메시지를 기록한 프레임워크 컴포넌트 이름을 표시합니다.
예를 들면 다음과 같습니다.
- SampleWorldCities 맵 서비스와 관련된 이벤트는 SampleWorldCities.MapServer로 표시됩니다.
- 사이트에서 서버 클러스터를 생성한 후에 관리자가 메시지를 기록한 컴포넌트로 표시됩니다.
머신
이벤트가 발생한 머신입니다.
User
로그 메시지를 발생시킨 요청을 제출한 사용자의 이름입니다. 이 등록정보는 보안이 활성화되었을 때 개별 사용자 활동을 추적하는 데 유용합니다.
코드
메시지와 관련된 로그 코드입니다. 코드는 특정 범위 및 콘텐츠와 함께 여러 범주로 구성됩니다.
다음 테이블에는 포털 로그 코드가 포함되어 있습니다. 서버 로그 코드를 검토하려면 로그 코드를 참고하세요.
범주 | 범위 | 메시지 콘텐츠 |
---|---|---|
발행 | 200000–201999 | 호스팅 서비스 발행 및 삭제. |
콘텐츠 관리 | 202000–203999 | 항목 추가, 제거, 업데이트, 이동. 항목 소유권 변경. 모든 사람, 기관, 그룹과 항목 공유. |
보안 | 204000–205999 | 빌트인 또는 기관별 사용자 로그인. 포털 토큰 생성 및 구성. 계정 로그인 활성화 및 비활성화. ArcGIS Portal Directory 활성화 및 비활성화. 보안 인증서 가져오기 또는 내보내기. 사용자 생성, 삭제, 비활성화. 사용자 역할 권한 변경. 사용자 정의 역할 생성 및 삭제. HTTPS 및 익명 접근 활성화 및 비활성화. ID 저장소 업데이트. |
기관 관리 | 206000–207999 | 기관 홈페이지 사용자 정의. 갤러리, 베이스맵, 디스플레이 단위, 유틸리티 서비스, 페더레이션된 서버 구성. 그룹 생성 및 삭제. 그룹에 사용자 추가 및 그룹에서 사용자 제거. 사용자를 그룹으로 초대 또는 그룹 초대 수락. ArcGIS Pro 라이선스 구성. ArcGIS Web Adaptor 구성. 포털 콘텐츠 디렉터리의 위치 변경. 정방향 및 역방향 프록시 서버 구성. 포털에 대해 인증된 기명 사용자 수 초과. 로그 설정 편집 및 로그 삭제. |
설치 및 업그레이드 | 208000–209999 | 소프트웨어 설치 및 업그레이드, 포털 웹사이트 생성 및 소프트웨어 인증. |
검색 색인 | 210000–211999 | 포털의 항목 검색 색인 생성. |
일반 | 212000–219999 | 포털 다시 시작. 고가용성 포털 구성. 포털의 일상적인 사용에서 생성되는 기타 일반 메시지. |
프로세스
이벤트를 기록한 머신 프로세스 ID.
요청 ID
제출 시 모든 요청에 첨부되는 Unique ID 문자열로, 시스템에서 요청의 수명 주기 전반에 걸쳐 전달됩니다.