본문으로 건너뛰기

멀티 인스턴스 모니터링

홈 화면 > 프로젝트 선택 > 대시보드 > 멀티 인스턴스 모니터링

인스턴스 모니터링 메뉴에서는 하나의 에이전트(인스턴스)만 모니터링한다면, 멀티 인스턴스 모니터링은 여러 인스턴스의 지표를 한 화면에서 확인하고 비교할 수 있습니다. 동작 중인 에이전트 수, 액티브 세션의 총합, 트랜잭션 정보 등의 지표를 그룹핑한 값을 통해 인스턴스들의 현황을 파악할 수 있습니다. 그래프 차트로 인스턴스의 지표 값 추이와 어떤 인스턴스의 지표 값이 높은지 쉽게 확인할 수 있습니다. 가장 오래 지속하는 액티브 세션 정보를 제공합니다.

멀티 인스턴스 모니터링

대시보드 > 인스턴스 목록 메뉴에서 비교하려는 에이전트를 선택한 다음 멀티 뷰 버튼을 선택하면 멀티 인스턴스 모니터링 메뉴로 진입할 수 있습니다.

과거 데이터 조회하기

대시보드에서는 실시간 모니터링 기능을 기본 제공하지만 과거 시간의 데이터를 조회할 수도 있습니다.

실시간 모드비실시간 모드
실시간 모드비실시간 모드
  1. 화면 왼쪽 위에 시간 선택자에서 멈춤 아이콘 버튼을 선택하세요.

  2. 날짜 및 시간 영역을 클릭해 원하는 시간대를 설정하세요.

    시간 수동 설정

  3. 적용 버튼을 선택하세요.

사용자가 설정한 시간을 기준으로 대시보드에 배치한 위젯의 데이터를 갱신합니다. 실시간 모드로 전환하려면 재생 아이콘 버튼을 선택하세요.

에이전트 확인하기

에이전트 연결 상태 확인하기

화면 왼쪽 위, 시간 선택자의 오른쪽에서는 해당 프로젝트와 연결된 에이전트의 상태를 확인할 수 있는 정보를 제공합니다. 이를 통해 모니터링 대상 서버의 동작 여부를 바로 확인할 수 있습니다.

  • Total: 프로젝트와 연결된 모든 에이전트의 수

  • Active: 활성화된 에이전트의 수

  • Inactive: 비활성화된 에이전트의 수

  • 에이전트 표시 아이콘: 비활성화된 에이전트를 표시하거나 감출 수 있습니다.

에이전트별 모니터링

에이전트 선택하기

기본적으로 대시보드에는 모든 에이전트로부터 수집한 지표들을 차트에 표시하지만 에이전트별로 데이터를 조회할 수도 있습니다. 시간 선택자 아래에 위치한 에이전트를 하나 또는 둘 이상을 선택하세요. 선택한 에이전트의 지표들로 대시보드에 배치된 위젯의 데이터를 갱신합니다.

에이전트를 하나 또는 둘 이상을 선택한 상태에서 다시 모든 에이전트를 선택하려면 선택을 해제하거나 Total을 선택하세요.

노트

프로젝트에 연결된 에이전트의 수가 많을 경우 에이전트의 이름을 짧게 설정하는 것이 효율적입니다. 에이전트 이름 설정에 대한 자세한 내용은 다음 문서를 참조하세요.

분류별 에이전트 모니터링

분류별 에이전트 선택하기

에이전트 설정을 통해 분류한 그룹 단위로 에이전트를 선택해 모니터링할 수 있습니다.

  • 에이전트: 개별 에이전트를 선택하거나 모두 선택할 수 있습니다.

  • 클러스터별 에이전트: 클러스터로 구성된 데이터베이스의 경우 클러스터별 단위로 에이전트를 에이전트를 모니터링할 수 있습니다.

노트

클러스터별 에이전트 항목을 이용하려면 DBX 에이전트(whatap.conf)의 다음 옵션을 설정해야 합니다. 자세한 내용은 다음 문서를 참조하세요.

whatap.conf
cluster_name={cluster_name}

대시보드 위젯 편집하기

대시보드에 배치한 위젯은 사용자가 원하는 크기로 조절할 수 있고, 원하는 위치에 배치할 수 있습니다. 불필요하다고 생각되는 위젯은 삭제하고 다시 추가할 수도 있습니다.

위젯 크기 조절하기

위젯 크기 조절하기

위젯의 오른쪽 아래에 크기 조절 아이콘 요소를 마우스로 클릭한 상태에서 원하는 크기로 드래그하세요. 균일한 가로, 세로 비율의 격자가 표시되고, 격자 단위로 위젯의 크기를 조절할 수 있습니다.

위젯 이동하기

위젯 이동하기

위젯의 윗 부분으로 마우스 커서를 이동하면 커서 모양이 이동 아이콘 모양으로 변경됩니다. 이때 마우스 왼쪽 버튼을 클릭한 상태로 원하는 위치로 드래그하여 위젯을 이동할 수 있습니다.

위젯 삭제하기

위젯 삭제하기

삭제하길 원하는 위젯에서 마우스 오른쪽 버튼을 클릭하세요. 삭제 버튼을 선택하면 해당 위젯이 대시보드에서 삭제됩니다.

위젯 추가하기

위젯 추가하기

대시보드에서 빈 공간으로 마우스 커서를 이동한 다음 마우스 오른쪽 버튼을 클릭하세요. 팝업 메뉴에서 추가하려는 위젯을 선택하세요. 원하는 위치로 위젯을 배치하고 크기를 조절하세요.

노트
  • 대시보드에 배치할 수 있는 위젯에 대한 자세한 내용은 다음 문서를 참조하세요.

  • 현재 추가할 수 있는 위젯은 고정적이지만 향후 업데이트를 통해 위젯 지원을 늘려갈 계획입니다.

위젯 옵션 이용하기

위젯에 표시된 아이콘 버튼의 기능은 다음과 같습니다.

  • 정보 아이콘 : 주요 위젯에 대한 기능 및 정보를 확인할 수 있습니다. (다국어 지원 예정)

  • 위 방향 아이콘 / 아래 방향 아이콘 : 차트의 세로축 범위를 확대 또는 축소할 수 있습니다.

  • 확대보기 아이콘 : 해당 위젯의 데이터를 넓은 화면으로 펼쳐볼 수 있습니다.

  • 상세 아이콘 : 해당 위젯 항목의 데이터를 에이전트별로 구분해 조회할 수 있는 상세 창이 나타납니다.

노트

위젯에 따라 제공되는 옵션은 다를 수 있습니다.

프리셋

프리셋

대시보드에서 사용자가 설정한 위젯의 설정과 레이아웃 상태를 저장하고 불러올 수 있습니다. 기본 프리셋(Default)은 변경할 수 없으며, 원하는 형식으로 위젯의 크기를 조절하고, 배치해 새로운 프리셋을 만들 수 있습니다.

새로운 프리셋 만들기

  1. 대시보드에서 원하는 형식으로 위젯을 배치해 보세요. 크기를 조절하고 자주 확인하는 위젯만 배치할 수도 있습니다.

  2. 화면 오른쪽 위에 저장 아이콘 버튼을 선택하세요.

  3. 새로운 프리셋 이름을 입력하세요.

    프리셋 저장하기

    에이전트 선택 내역을 같이 저장하려면 에이전트 선택 내역 포함을 선택하세요.

  4. 저장 버튼을 선택하세요.

프리셋 목록에서 새로 저장한 프리셋을 확인할 수 있습니다.

노트
  • 새로 만든 프리셋에 변경 사항이 생겼다면 다시 프리셋을 저장해야 합니다. 저장 아이콘 버튼을 선택한 다음 같은 이름으로 프리셋을 저장하세요. 기존의 프리셋에 변경 사항을 덮어쓰기합니다.

  • 대시보드의 변경 사항을 저장하지 않고 다른 메뉴로 이동하면 변경 사항은 저장되지 않습니다.

  • 프리셋은 사용자 계정으로 저장되며 현재는 다른 사용자와 공유할 수 없습니다. 더 나은 기능을 제공하도록 업데이트 예정입니다.

프리셋 삭제하기

사용하지 않는 프리셋이 있다면 프리셋 목록에서 삭제할 수 있습니다. 프리셋 목록에서 삭제하려는 항목의 오른쪽에 삭제 아이콘 버튼을 선택하세요.

주요 위젯 알아보기

대시보드에 배치할 수 있는 위젯의 종류는 다음과 같습니다.

  • DB Status

    프로젝트에 포함된 에이전트(인스턴스)의 상태를 확인할 수 있습니다. 개별 에이전트를 육각형 모양으로 표시하며, 마우스를 오버하면 현재 상태와 IP 주소를 확인할 수 있습니다.

    DB Status

    에이전트의 상태는 다음과 같이 구분할 수 있습니다.

    • 정상: 정상 상태의 에이전트 수입니다.

    • 비활성화된 에이전트: 연결이 해제된 에이전트의 수입니다.

  • [XOS] CPU

    에이전트별 CPU 사용률을 실시간으로 확인할 수 있습니다.

  • [XOS] Memory

    에이전트별 메모리 사용률을 실시간으로 확인할 수 있습니다.

  • XOS Disk Usage

    에이전트별 디스크 사용률과 사용 가능 크기, 전체 크기 정보를 표시합니다. 위젯의 오른쪽 위에 아이콘 버튼을 선택하면 더 넓은 화면으로 펼쳐볼 수 있습니다.

    데이터가 표시되지 않는다면 xos.conf 파일에 다음 설정을 추가하세요.

    xos.conf
    # disk usage 0 이면 off, 단위: 초
    disk_usage_interval=60
  • Read requests

    초당 읽기 요청 수를 측정한 위젯입니다. 읽기 요청은 데이터베이스에서 데이터를 조회하거나 검색하는 쿼리, 집계 작업, 인덱스 스캔 등과 관련한 작업입니다. 데이터베이스의 사용 패턴의 변화를 감지하는데 유용합니다.

    산출 방식: query$opcounters + getmore$opcounters

  • Write requests

    초당 쓰기 요청 수를 측정한 위젯입니다. 쓰기 요청은 데이터베이스에 새로운 데이터를 추가하거나 업데이트, 삭제와 관련한 작업입니다. 데이터베이스의 사용 패턴의 변화를 감지하는데 유용합니다.

    산출 방식: insert$opcounters + update$opcounters + delete$opcounters

  • Read Latency (latency$reads$opLatencies)

    읽기 작업의 지연 시간(microsecond)을 측정한 위젯으로, 클라이언트가 읽기 작업을 요청하고 데이터베이스에서 해당 작업을 수행하는 데 걸린 시간입니다. 읽기 작업의 지연 시간이 긴 경우 인덱스를 최적화하거나 쿼리를 개선해 성능을 향상시키는 방법을 검토하세요.

  • Write Latency (latency$writes$opLatencies)

    쓰기 작업의 지연 시간(microsecond)을 측정한 위젯으로, 클라이언트가 쓰기 작업을 요청하고 데이터베이스에서 해당 작업을 수행하는 데 걸린 시간입니다. 쓰기 작업의 지연 시간이 긴 경우 인덱스를 최적화하거나 쓰기 작업을 배치 처리해 성능을 향상시키는 방법을 검토하세요.

  • Page Faults (page_faults$extra_info)

    페이지 폴트(page faults) 현상이 발생한 횟수를 측정한 위젯입니다. 페이지 폴트는 메모리 관리에서 발생하는 현상으로, 프로세스가 요청한 메모리 페이지가 물리적인 메모리에 없어서 디스크로부터 해당 페이지를 읽어와야 할 때 발생합니다. 이때 디스크 I/O가 발생해 작업이 지연될 수 있습니다. 일반적으로 시스템의 메모리 부족 상태를 의미합니다.

    데이터베이스의 읽기 및 쓰기 작업이 디스크 I/O에 의존하는지를 확인하고 메모리 부족 상태가 성능 문제의 원인이 되는지 파악할 수 있습니다.

    노트

    Page faults에 대한 자세한 내용은 다음 링크를 참조하세요.

  • Active Connections (active$connections)

    현재 작업 중인 클라이언트의 연결 수를 측정한 위젯입니다. 데이터베이스 서버에서 동시에 처리할 수 있는 클라이언트의 연결 수를 모니터링할 수 있습니다. 높은 연결 수는 서버 용량을 증설할 필요가 있음을 의미합니다. 반대의 경우 문제가 발생했을 가능성이 있으므로 시스템 상태를 신속히 파악해 보는 것이 좋습니다.

  • Read Clients (readers$activeClients$globalLock)

    MongoDB의 전역 잠금(global lock)에서 현재 읽기 작업을 수행 중인 클라이언트의 수를 측정한 위젯입니다. 데이터베이스 서버가 읽기 작업을 위해 얼마나 많은 수의 클라이언트를 처리하는지 파악할 수 있습니다. 데이터베이스의 성능을 모니터링하고 응답 시간을 추적하는데 유용한 지표입니다. 과도한 읽기 작업이 발생할 경우 성능 저하의 원인이 될 수 있습니다.

  • Write Clients (writers$activeClients$globalLock)

    현재 MongoDB의 전역 잠금(global lock)에서 쓰기 작업을 수행 중인 클라이언트의 수를 측정한 위젯입니다. 데이터베이스 서버가 쓰기 작업을 위해 얼마나 많은 수의 클라이언트를 처리하는지 파악할 수 있습니다. 데이터베이스의 성능을 모니터링하고 응답 시간을 추적하는데 유용한 지표입니다. 과도한 쓰기 작업이 발생할 경우 성능 저하의 원인이 될 수 있습니다.

  • Queued Read Requests (readers$currentQueue$globalLock)

    현재 시스템에서 대기 중인 읽기 작업을 처리하기 위해 전역 잠금(global lock)을 대기 중인 클라이언트의 수를 측정한 위젯입니다. 데이터베이스의 성능 및 확장성을 평가할 수 있는 정보를 제공합니다. 대기 중인 읽기 요청 작업이 많을 수록 클라이언트의 요청에 대한 응답 시간이 늘어날 수 있으며, 처리량이 한계에 도달할 수 있습니다.

    대기 중인 읽기 작업이 급격하게 증가할 경우 서버의 리소스 증설을 검토하거나, 대기 중인 읽기 작업의 원인을 분석하고 쿼리 최적화 및 인덱스 튜닝 등의 조치를 통해 병목 현상을 해결할 수 있습니다.

  • Queued Write Requests (writers$currentQueue$globalLock)

    현재 시스템에서 대기 중인 쓰기 작업을 처리하기 위해 전역 잠금(global lock)을 대기 중인 클라이언트의 수를 측정한 위젯입니다. 데이터베이스의 성능을 평가하고 최적화하기 위한 필수 지표입니다. 대기 중인 쓰기 작업이 늘어나면 시스템 성능이 저하되거나 응답 시간이 증가할 수 있습니다.

    리소스 증설을 검토하거나 어떤 작업이 병목 현상을 유발하는지 파악해볼 필요가 있습니다.

  • Resident Memory (resident$mem)

    현재 시스템에서 프로세스가 사용하는 메모리 사이즈(MB)입니다. 얼마나 많은 메모리를 사용하는지 파악할 수 있습니다. 메모리 사용량 추적을 통해 메모리 사용량을 최적화하여 성능을 향상시키고, 메모리 리소스를 효율적으로 활용하는데 중요한 지표가 됩니다. 또한 더 많은 메모리가 필요한지, 쌰드를 추가해야 하는지를 결정하는데 도움이 됩니다.

  • Virtual Memory (virtual$mem)

    현재 시스템에서 프로세스가 사용하는 가상 메모리 사이즈(MB)입니다. 현재 실행 중인 환경에서 얼마나 많은 메모리 리소스를 요구하는지를 파악할 수 있습니다. 가상 메모리의 사이즈를 파악하면 더 많은 물리 메모리가 필요할지, 가상 메모리 사용량을 줄이기 위한 조치를 결정하는데 도움이 됩니다.

  • Network Out (bytesOut$network)

    클라이언트나 기타 인스턴스의 연결을 통해 서버가 보낸 총 바이트 수입니다. 데이터베이스 서버가 외부로부터 요청을 받고 응답을 반환할 때 전송한 데이터의 총량을 의미합니다. 데이터베이스 서버에서 발생하는 네트워크 트래픽을 파악할 수 있으며, 이를 통해 네크워크 대역폭이나 서버 리소스 사용에 대한 최적화를 진행할 수 있습니다. 또한 높은 네트워크 트래픽은 응답 시간의 증가와 같은 성능 문제와 연관되어 있습니다.

  • Network In (bytesIn$network)

    클라이언트나 기타 인스턴스의 연결을 통해 서버가 수신한 총 바이트 수입니다. 데이터베이스 서버가 외부로부터 수신한 요청 및 데이터의 총량을 의미하며, 클라이언트가 데이터베이스 서버로부터 요청을 보내고 응답을 받을 때 발생하는 데이터 전송량을 포함합니다. 특정 애플리케이션 또는 작업에서 데이터베이스와 어떻게 통신을 사용하는지 파악할 수 있습니다. 또한 네트워크 트래픽의 추이를 파악하여 시스템의 용량을 게획하고 확정성을 평가할 수 있습니다.

노트

전역 잠금(globl lock)은 MongoDB에서 데이터의 일관성을 유지하기 위해 사용되는 메커니즘입니다. 읽기와 쓰기 작업 모두에 적용되며, 작업을 수행하려는 클라이언트는 전역 잠금을 획득해야 합니다.

Session Table 위젯

화면 하단의 Session Table 위젯에서는 실시간 수행 중인 액티브 세션을 조회할 수 있습니다.

노트

테이블 목록에 글자 색상은 검정색 → 주황색빨간색 순으로 세션의 수행 속도가 느린 것을 의미합니다.

테이블 데이터 필터링하기

Filter

  1. 테이블의 오른쪽 위에 필터 아이콘 버튼을 선택하세요.

  2. 테이블의 컬럼 헤더 항목과 조건을 선택하세요.

  3. 조건 입력 텍스트 상자에 원하는 값을 입력하세요.

  4. 저장 버튼을 선택하세요.

테이블 컬럼 설정하기

테이블 헤더 컬럼을 감추거나 원하는 항목을 추가할 수 있습니다. 컬럼 순서를 변경할 수도 있습니다. 컬럼 아이콘 버튼을 선택하세요.

컬럼 설정

노트
  • 설정을 완료한 다음에는 확인 버튼을 선택해야 설정 사항이 테이블에 반영됩니다.

  • 숫자 3 검색란에 텍스트를 입력해 원하는 컬럼 항목을 검색할 수 있습니다. 입력한 텍스트와 매칭되는 컬럼 항목만 표시됩니다.

컬럼 추가하기

숫자 1 목록에서 테이블 헤더 컬럼으로 추가할 항목을 선택하세요. 모든 항목을 추가하려면 전체 선택을 선택하세요.

컬럼 삭제하기

숫자 1 목록에서 삭제할 컬럼 항목의 체크 박스를 선택 해제하세요. 또는 숫자 2 목록에서 삭제할 항목의 오른쪽에 삭제 아이콘 버튼을 선택하세요.

컬럼 순서 변경하기

숫자 2 목록에 순서를 변경할 항목을 드래그해서 원하는 위치로 이동할 수 있습니다.

설정 사항 초기화하기

변경 사항은 모두 취소하고 초기화하려면 초기화 아이콘 초기화 버튼을 선택하세요.

컬럼 정보 안내

다음은 액티브 세션 섹션의 테이블에 표시되는 컬럼 정보입니다. currentOp 명령으로 수집된 데이터입니다.

항목설명
opidoperation의 고유 식별자(identifier)
type값이 op인 경우 op 필드에서 작업 유형 확인 가능
host서버 이름
descconnectionId를 포함한 클라이언트 설명
active작업이 시작되면 true, idle이면 false
currentOpTimeoperation의 시작 시간
opoperation 유형(none, update, insert, query, command, getmore, remove 등)
ns네임스페이스 이름으로 Database.Collection 으로 표시
numYields작업이 수행된 수
waitingForLock락(lock)을 대기하고 있으면 true, 락(lock)을 획득하였으면 false
waitingForFlowControlflowcontrol을 대기하고 있으면 true

조회 목록 다운로드하기

현재 조회 중 인 Session Table 목록을 CSV 파일 형식으로 다운로드할 수 있습니다. Session Table 섹션의 오른쪽 위에 다운로드 아이콘 버튼을 선택하세요.

다운로드한 파일의 이름 형식은 다음과 같습니다.

  • 액티브 세션: activeSession_HH_MM_SS.csv

  • 락 트리: lockTree_HH_MM_SS.csv

새창으로 보기

Session Table 목록을 새창으로 열어 더 넓은 화면으로 펼쳐볼 수 있습니다. Session Table 섹션의 오른쪽 위에 새창 아이콘 버튼을 선택하세요.