ArcGIS Notebook Server 로그 사용

ArcGIS Notebook Server는 로그를 사용하여 사이트에 발생하는 모든 이벤트 및 이벤트와 연관된 모든 오류를 기록합니다. 이러한 로그는 사이트 관리자에게 제공됩니다.

로그는 ArcGIS Notebook Server 사이트의 문제를 모니터링하고 해결하는 중요한 도구입니다. 로그에서 제공되는 정보는 오류를 식별하는 데 도움이 되고 문제 및 오류를 해결하는 방법에 대한 정보를 제공합니다. 또한 로그는 사이트에서 발생하는 이벤트를 기록하는 용도로도 사용됩니다.

예를 들어 다음과 같은 유형의 이벤트가 로그에 기록됩니다.

• 소프트웨어 인증 및 사이트 생성 등 설치 및 업그레이드 이벤트
• ArcGIS Notebooks 열기 및 닫기
• 사이트에서 수행한 정리 작업
• Notebook 런타임 추가 또는 제거, 서버 디렉터리 생성, 보안 설정 구성 등 관리자가 수행한 사이트 관리 이벤트
• 사이트에 로그인하는 사용자 또는 SSL 인증서 가져오기/내보내기 등 보안 이벤트

일부 이벤트는 ArcGIS Notebook Server 로그에 기록되지 않습니다. 사이트와 포털의 페더레이션이 여기에 해당됩니다. 콘텐츠 추가, 셀 실행 등 ArcGIS Notebooks 내에서 발생하는 이벤트는 기록되지 않습니다. 머신의 Docker 컨테이너 내에서 발생하는 이벤트도 기록되지 않습니다. 컨테이너 관련 로그를 보려면 아래의 Docker 컨테이너 로그 확인을 참고하세요.

사용 가능한 로그 수준

각 로그에는 다음 중 하나의 로깅 세밀도에 따라 정보가 포함됩니다(가장 간단한 로깅 수준부터 가장 상세한 로깅 수준 순).

• 심각 — 즉시 주의가 필요한 심각한 문제입니다.
• 경고 — 주의가 필요한 보통 수준의 문제입니다.
• 정보 — 서비스 생성 및 시작에 대한 메시지를 비롯하여 Notebook Server 사이트에 대한 일반적인 관리 메시지입니다.
• 일반 — 수신된 작업 요청의 이름과 같은 서버 사용에 대한 일반적인 메시지입니다.
• 자세히 — 서버의 작업 수행 방식에 대한 자세한 메시지입니다.
• 디버그 — 문제를 해결할 때 서버의 상태에 대해 잘 파악하고자 하는 개발자와 지원 기술자를 위해 고안된 매우 자세한 메시지입니다. 생성되는 로그의 분량으로 인해 생산 시스템에는 사용하지 않는 것을 권장합니다.

ArcGIS Notebook Server 관리자 디렉터리에서 생성하려는 가장 자세한 로그 수준을 지정할 수 있습니다. 예를 들어 해당 수준을 일반으로 설정한 경우 서버 사이트에는 심각, 경고, 정보, 일반 세밀도로 메시지가 기록됩니다.

로그 코드

로그 코드 범위는 특정 메시지 유형과 관련됩니다. 다음 테이블에는 로그 코드 범위 및 해당 콘텐츠 유형에 대한 설명이 나와 있습니다.

로그 코드 범위	메시지 콘텐츠
1000~4999	핵심 ArcGIS Notebook Server 프레임워크
5000~6999	Docker SDK 및 컨테이너 관련
7000~7200	Notebook
7200~7299	Notebook 웹 도구
7300~7399	Notebook 스냅샷
7400~7499	Notebook 코드 조각

관리자의 쿼리 로그

10.8의 ArcGIS Notebook Server 관리자 앱에는 로그 페이지가 포함되어 있습니다. 이 페이지에서 ArcGIS Notebook Server 사이트에 대한 모든 로그를 쿼리할 수 있습니다.

1. 관리자로 ArcGIS Enterprise 포털에 로그인하여 ArcGIS Notebook Server 관리자를 엽니다.
2. 로그 페이지를 엽니다.
3. 쿼리 필터 매개변수가 페이지 상단에 있습니다. 해당 매개변수를 사용하여 검색을 제한하거나 확장합니다.

   • 로그 수준 — 쿼리할 최소 로그 수준입니다(위 섹션 참고). 로그 수준이 해당 수준 이상인 레코드만 반환됩니다. 기본 수준은 WARNING입니다.
   • 로그 시간 — 로그를 검색할 시간입니다. 쿼리를 최근 15분, 최근 1시간, 최근 6시간, 24시간, 지난 주, 지난 30일로 제한하거나 사이트 생성 이후의 모든 로그를 표시할 수 있습니다.

     팁:

     3일 전부터 2일 전까지의 로그와 같이 현재 이외의 종료 시간을 지정하려면 관리자 디렉터리를 사용하여 로그를 쿼리합니다.

   • 머신 — ArcGIS Notebook Server 머신 중 한 머신의 로그로 쿼리를 제한하거나 모든 머신의 로그를 표시할 수 있습니다.
   • 요청 ID — 하나 이상의 서버의 쉼표로 구분된 요청 ID는 쿼리하려는 사용자의 로그를 요청합니다. 일부 로그 메시지는 특정 요청과 관련됩니다.
   • 사용자 — 쿼리할 관련 로그를 가진 하나 이상 사용자의 사용자 이름입니다(쉼표로 구분됨). 일부 로그 메시지는 특정 사용자의 작업과 관련됩니다.
   • 로그 코드 — 로그 메시지에 할당된 하나 이상의 로그 코드입니다. 비워 둘 경우 모든 로그 코드가 표시됩니다.

4. 검색을 클릭하여 쿼리를 실행합니다. 쿼리 매개변수와 일치하는 모든 로그가 결과 테이블에 나타납니다.

관리자 앱의 로그 설정 변경

ArcGIS Notebook Server 관리자 앱을 통해서도 사이트의 로그 설정을 변경할 수 있습니다.

1. 관리자로 ArcGIS Enterprise 포털에 로그인하여 ArcGIS Notebook Server 관리자를 엽니다.
2. 설정 페이지를 열고 로그를 클릭합니다.
3. 다음 설정을 변경할 수 있습니다.

   • 로그 디렉터리 — 로그 디렉터리의 디스크 위치입니다. 사이트에 여러 머신이 있는 경우 이 경로는 UNC 공유여야 합니다.
   • 로그 수준 — 사이트에서 기록할 가장 자세한 로그 수준입니다. 예를 들어 FINE으로 설정한 경우 VERBOSE 또는 DEBUG 수준의 로그는 사이트에 보관되지 않습니다.
   • 로그 보관 기간(일) — 로그 메시지가 보관되는 기간(일)으로 이 기간이 지나면 로그 메시지가 삭제됩니다. 선택한 로그 수준 설정과 사이트의 활동 수준뿐 아니라 로그 디렉터리 드라이브의 사용 가능한 메모리 양도 고려해야 합니다. 예를 들어 더 자세한 수준으로 기록되도록 로그 수준을 변경한 경우에는 로그 보관 기간을 줄여야 할 수 있습니다.

4. 저장을 클릭하여 변경 내용을 확인합니다.

관리자 디렉터리의 서버 로그 쿼리

ArcGIS Notebook Server 관리자 디렉터리를 사용하여 서버 로그를 쿼리, 확인, 구성, 삭제합니다.

서버 로그에 접근하려면 다음 단계를 따르세요.

1. 관리자 디렉터리에 로그인합니다. URL의 형식은 https://notebookserver.domain.com:11443/arcgis/admin 또는 https://notebookserver.domain.com/<webadaptorname>/admin입니다.
2. 현재 로그를 쿼리하고 검토하려면 로그 > 쿼리를 클릭합니다. 페이지의 필터 컨트롤을 사용하여 기간이나 로깅 수준 등 범주별로 이벤트의 범위를 좁힐 수 있습니다.
3. 로그 > 설정을 클릭하면 기본 로깅 수준(위의 설명 참조), 디스크에 로그가 유지되는 기간, 로그가 작성된 위치 등 로그 설정을 관리할 수 있습니다.
4. ArcGIS Notebook Server 사이트에서 모든 로그 파일을 삭제하려면 로그 지우기를 클릭합니다.

ArcGIS Notebook Server Manager로 Docker 컨테이너 로그 보기

ArcGIS Notebook Server Manager를 사용하여 사이트의 Docker 컨테이너와 관련된 로그를 볼 수 있습니다.

1. 관리자로 포털의 ArcGIS Notebook Server Manager에 로그인합니다. URL의 형식은 https://webadaptorhost.domain.com/webadaptorname/home/notebook/manager.html입니다.
2. 컨테이너 탭으로 이동합니다.
3. 로그 보기 버튼을 클릭하여 선택한 머신의 컨테이너 로그를 확인합니다.

Docker 명령줄로 Docker 컨테이너 로그 보기

다음과 같이 Docker 명령줄 인터페이스를 사용하여 사이트의 Docker 컨테이너와 관련된 로그를 확인할 수 있습니다.

1. 관리자 디렉터리에 로그인합니다. URL의 형식은 https://notebookserver.domain.com:11443/arcgis/admin 또는 https://notebookserver.domain.com/<webadaptorname>/admin입니다.
2. 시스템 > 컨테이너로 이동합니다. 로그를 확인할 컨테이너를 찾은 다음 해당 ID를 클릭합니다.
3. https://notebookserver.arcgis.com/<webadaptorname>/admin/system/containers/<container>?f=pjson URL 형식이 되도록 ?f=pjson을(를) 해당 URL에 추가하여 컨테이너의 정보 페이지에 대한 JSON 뷰를 엽니다.
4. 컨테이너의 containerId을(를) 찾아 해당 값을 기록합니다.
5. Docker 권한이 있는 사용자로 터미널을 엽니다.
6. 기록해 둔 값을 사용하여 docker logs <containerId> 명령을 실행합니다. 그러면 해당 컨테이너에 대한 Docker 로그가 반환됩니다.