로그 보기, 검색 및 관리
이 페이지의 내용
- Cloud Manager 에 대한 프로그래밍 방식의 액세스 를 위한 OAuth 2.0 인증 은 Preview 기능 으로 제공됩니다.
- 기능 및 해당 설명서는 미리 보기 기간에 언제든지 변경될 수 있습니다. OAuth 2.0 인증 을 사용하려면 Cloud Manager 공개 API 에 대한 요청에 사용할서비스 계정을 만듭니다.
Cloud Manager는 MongoDB 프로세스와 해당 에이전트 모두에 대한 로그 정보를 수집합니다. MongoDB 프로세스의 경우, 실시간 로그와 온디스크 로그에 모두 액세스할 수 있습니다.
에이전트 로그는 Cloud Manager 에이전트의 동작에 대한 인사이트를 제공합니다.
MongoDB 실시간 로그
MongoDB Agent는 핑을 모니터링할 때마다 getLog
명령을 실행합니다. 이 명령은 각 MongoDB 프로세스의 RAM 캐시에서 로그 항목을 수집합니다.
Cloud Manager는 기본적으로 실시간 로그 컬렉션을 활성화합니다. Cloud Manager 프로젝트의 모든 MongoDB 배포 또는 개별 MongoDB 배포에 대해 로그 컬렉션을 비활성화할 수 있습니다. 로그 컬렉션을 비활성화하면 Cloud Manager는 이전에 수집된 로그 항목을 계속 표시합니다.
MongoDB 실시간 로그 보기
MongoDB Cloud ManagerGo MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 고 (Go) 합니다.
이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.
배포 페이지가 표시됩니다.
Processes 페이지로 이동하세요.
배포서버 의 Processes 탭 을 클릭합니다.
프로세스 페이지가 표시됩니다.
(선택 사항) 샤딩된 클러스터의 경우 나열되는 프로세스 유형을 필터링합니다.
4개의 버튼은 왼쪽에서 오른쪽으로 Shards, Configs, Mongos 및 BIs 순서로 나열됩니다.
프로세스 | 디스플레이 |
---|---|
Shards | 데이터를 호스팅하는 몽고 프로세스를 생성합니다. |
Configs | 구성 서버로 실행되어 샤딩된 클러스터의 메타데이터를 저장하는mongod 프로세스입니다. |
Mongos | 몽고 프로세스는 샤딩된 클러스터에서 데이터를 라우팅합니다. |
BIs | 샤딩된 클러스터의 데이터에 액세스하는 BI 프로세스입니다. |
배포에 대해 로그 컬렉션 활성화 또는 비활성화
MongoDB Cloud ManagerGo MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 고 (Go) 합니다.
이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.
배포 페이지가 표시됩니다.
Processes 페이지로 이동하세요.
배포서버 의 Processes 탭 을 클릭합니다.
프로세스 페이지가 표시됩니다.
프로세스 의... 줄에서 줄임표[] 아이콘을 Monitoring Settings클릭한 다음 을 클릭합니다.
프로젝트에 대해 로그 컬렉션 활성화 또는 비활성화
MongoDB Cloud ManagerGo MongoDB Cloud Manager 에서 Project Settings 페이지로 고 (Go) 합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
Projects 메뉴 옆에 있는 Options 메뉴를 펼친 다음 Project Settings 를 클릭합니다.
프로젝트 설정 페이지가 표시됩니다.
원하는 대로 Collect Logs For All Hosts 옵션을 Yes No또는 로 전환합니다.
MongoDB 온디스크 로그
Cloud Manager는 MongoDB 인스턴스가 실행 중이 아니더라도 디스크 로그를 수집합니다. MongoDB Agent는 MongoDB systemLog.path
구성 옵션 에 지정한 위치에서 로그를 수집합니다. MongoDB 온디스크 로그는 실시간 로그의 하위 집합이므로 덜 장황합니다.
참고
systemLog.destination 속성이 syslog
로 설정된 경우 배포된 MongoDB 프로세스에는 이 옵션을 사용할 수 없습니다.
온디스크 로그에 로그 로테이션을 구성할 수 있습니다. Cloud Manager는 기본적으로 로그를 로테이션합니다.
이 절차에서는 Cloud Manager에 대한 시스템 로그와 감사 로그를 모두 로테이션합니다.
로그 로테이션 구성
Cloud Manager는 MongoDB Agent가 관리하는 클러스터에 대한 로그를 로테이션하고 압축할 수 있습니다. MongoDB Agent가 클러스터만 모니터링하는 경우, 해당 클러스터의 로그는 무시됩니다.
중요
MongoDB Enterprise 버전 5.0 이상 및 MongoDB Agent 11.11.0.7355 이상을 실행하는 경우:
서버 로그와 감사 로그 로테이션에 대한 별도의 규칙을 설정합니다.
Cloud Manager를 사용하여 감사 로그를 압축하고 삭제합니다. 보안상의 이유로 Cloud Manager 외부에서 감사 로그의 압축 및 삭제 작업을 관리하는 것이 좋습니다.
이전 버전의 MongoDB Enterprise 또는 MongoDB Agent, Cloud Manager를 실행 중인 경우:
System Log Rotation 설정을 사용하여 서버 로그와 감사 로그를 모두 로테이션합니다.
감사 로그를 압축하거나 삭제하지 않습니다. 압축 및 삭제를 구성하면 Cloud Manager는 이러한 설정을 서버 로그에만 적용합니다.
MongoDB Community 사용자는 서버 로그만 로테이션, 압축, 삭제할 수 있습니다.
참고
이 기능을 사용할 때는 logrotate
와 같은 플랫폼 기반 로그 로테이션 서비스를 사용하지 않도록 설정합니다. 프로세스 구성 파일에서 reopen
및 rename
플래그를 제거합니다. MongoDB Agent가 클러스터만 모니터링하는 경우, 해당 클러스터는 플랫폼 기반 서비스를 사용할 수 있습니다.
MongoDB Cloud ManagerGo MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 고 (Go) 합니다.
이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.
배포 페이지가 표시됩니다.
로그 로테이션을 활성화합니다.
서버 로그를 로테이션하려면 System Log Rotation을 ON으로 토글합니다.
MongoDB Enterprise 버전 5.0 이상 및 MongoDB Agent 11.11.0.7355 이상을 실행하는 MongoDB Enterprise 사용자는 Audit Log Rotation을 ON으로 토글하여 감사 로그를 로테이션하고 감사 로그 로테이션을 개별적으로 구성할 수도 있습니다.
이전 버전의 MongoDB Enterprise 또는 MongoDB Agent를 실행 중인 경우 System Log Rotation을 ON으로 설정하면 감사 로그도 로테이션됩니다.
Cloud Manager가 로그를 로테이션하지 않도록 하려면 로그 로테이션을 OFF로 설정합니다. 로그 로테이션은 기본적으로 OFF로 설정되어 있습니다.
로그 로테이션을 활성화하면 Cloud Manager에 추가적인 로그 로테이션 설정이 표시됩니다.
로그 로테이션 설정을 구성합니다.
Cloud Manager는 다음 설정에 따라 MongoDB 호스트의 로그를 로테이션합니다.
필드 | 필요성 | 작업 | 기본값 |
---|---|---|---|
Size Threshold (MB) | 필수 사항 | Cloud Manager는 이 최대 로그 파일 크기를 초과하는 로그 파일을 로테이션합니다. | 1000 |
Time Threshold (Hours) | 필수 사항 | Cloud Manager는 이 기간을 초과하는 로그를 로테이션합니다. | 24 |
Max Uncompressed Files | 옵션 | 로그 파일은 이 파일 수를 초과할 때까지 압축되지 않은 상태로 유지될 수 있습니다. Cloud Manager는 가장 오래된 로그 파일을 먼저 압축합니다. 이 설정을 비워 두면 Cloud Manager는 기본값인 | 5 |
Max Percent of Disk | 옵션 | 로그 파일은 MongoDB 호스트의 로그 볼륨에서 디스크 공간의 이 비율까지 차지할 수 있습니다. 가장 오래된 로그 파일이 이 디스크 임계값을 초과하면 Cloud Manager가 해당 로그 파일을 삭제합니다. 이 설정을 비워 두면 Cloud Manager는 기본값인 | 2% |
Total Number of Files | 옵션 | 총 로그 파일 수입니다. 숫자를 지정하지 않으면 총 로그 파일 수의 기본값은 0 이며 다른 Rotate Logs 설정에 따라 결정됩니다. | 0 |
완료했으면 Save을 클릭하여 변경 사항을 검토합니다.
에이전트 로그
Cloud Manager는 모든 MongoDB Agent에 대한 로그를 수집합니다.
에이전트 로그 보기
MongoDB Cloud ManagerGo MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 고 (Go) 합니다.
이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.
배포 페이지가 표시됩니다.
Agents 페이지로 이동하세요.
배포서버 의 Agents 탭 을 클릭합니다.
Agents (에이전트) 페이지가 표시됩니다.
로그 항목을 필터링합니다.
다른 유형의 에이전트에 대한 로그를 표시하려면 View 드롭다운 목록을 사용하세요.
특정 호스트 또는 MongoDB 프로세스에 대한 로그를 표시하려면 톱니바퀴 아이콘을 클릭하고 항목을 선택합니다.
필터를 지우려면 톱니바퀴 아이콘을 클릭하고 Remove Filters를 클릭합니다.
선택한 로그를 다운로드하려면 톱니바퀴 아이콘을 클릭하고 Download as CSV File를 클릭합니다.
참고
특정 에이전트 에 대한 로그를 보려면 다음을 수행할 수도 있습니다.
MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 Go 합니다.
이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.
배포 페이지가 표시됩니다.
배포서버 의 Agents 탭 을 클릭합니다.
Agents (에이전트) 페이지가 표시됩니다.
All Agents를 클릭합니다.
에이전트 에 대해 view logs 을(를) 클릭합니다.
에이전트 로그 로테이션 구성
Automation을 사용하여 클러스터를 관리하는 경우에는 다음 절차에 따라 에이전트 로그 파일의 로테이션을 구성하세요.
참고
Automation을 활성화하지 않은 경우에는 다음 문서에서 에이전트 구성 파일의 로깅 설정을 수동으로 구성하는 방법에 대한 정보를 참조하세요.
MongoDB Cloud ManagerGo MongoDB Cloud Manager 에서 프로젝트 의 Deployment 페이지로 고 (Go) 합니다.
이미 표시되어 있지 않은 경우 탐색 모음의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.
아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.
Deployment 페이지가 아직 표시되지 않은 경우 사이드바에서 Deployment를 클릭합니다.
배포 페이지가 표시됩니다.
Agents 페이지로 이동하세요.
배포서버 의 Agents 탭 을 클릭합니다.
Agents (에이전트) 페이지가 표시됩니다.
섹션까지 아래로 Agent Log Settings 스크롤합니다.
로그 설정을 편집합니다.
모니터링 에이전트 또는 백업 에이전트 로그 설정을 편집하려면 pencil 아이콘을 클릭합니다.
이름 | 유형 | 설명 | |
---|---|---|---|
Linux Log File Path | 문자열 | 조건부: Linux 호스트에 로그. 에이전트가 Linux 호스트에서 로그를 기록하는 경로입니다. 제안 값은 다음과 같습니다.
| |
Windows Log File Path | 문자열 | 조건부: Windows 호스트에 로그. 에이전트가 Windows 호스트에 로그를 기록하는 경로입니다. 제안 값은 다음과 같습니다.
| |
Rotate Logs | 토글 | 로그를 로테이션할지 여부를 선택하는 토글입니다. | |
Size Threshold (MB) | integer | 로그가 자동으로 로테이션되는 크기입니다. 기본값은 1000 입니다. | |
Time Threshold (Hours) | integer | 로그가 자동으로 로테이션하는 기간입니다. 기본값은 24 입니다. | |
Max Uncompressed Files | integer | 선택 사항. 현재 로그 파일을 포함하여 압축되지 않은 상태로 유지되어야 하는 최대 로그 파일 수입니다. 제안 값은 5 입니다. | |
Max Percent of Disk | integer | 선택 사항. 로그가 소비해야 하는 MongoDB 호스트의 디스크 공간의 최대 비율입니다. 제안 값은 2% 입니다. | |
Total Number of Files | integer | 선택 사항. 총 로그 파일 수입니다. 숫자를 지정하지 않으면 총 로그 파일 수의 기본값은 0 이며 다른 Rotate Logs 설정에 따라 결정됩니다. |
완료했으면 Save을 클릭합니다.