본문으로 건너뛰기

멀티 인스턴스 모니터링

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

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

멀티 인스턴스 모니터링

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

과거 데이터 조회하기

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

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

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

    시간 수동 설정

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

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

에이전트 확인하기

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

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

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

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

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

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

에이전트별 모니터링

에이전트 선택하기

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

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

노트

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

대시보드 위젯 편집하기

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

위젯 크기 조절하기

위젯 크기 조절하기

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

위젯 이동하기

위젯 이동하기

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

위젯 삭제하기

위젯 삭제하기

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

위젯 추가하기

위젯 추가하기

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

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

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

위젯 옵션 이용하기

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

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

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

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

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

노트

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

프리셋

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

프리셋

  • Default: XOS 지표와 AWS RDS CloudWatch 지표, 주요 DB 지표로 구성된 프리셋입니다.

  • Default(xos): XOS 지표와 주요 DB 지표로 구성된 프리셋입니다.

  • Default(rds): AWS RDS CloudWatch 지표와 주요 DB 지표로 구성된 프리셋입니다.

새로운 프리셋 만들기

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

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

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

    프리셋 저장하기

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

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

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

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

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

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

프리셋 삭제하기

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

주요 위젯 알아보기

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

XOS 위젯

  • [XOS] CPU

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

  • [XOS] Memory

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

  • [XOS] Disk Usage

    에이전트별 디스크 사용률과 사용 가능 크기, 전체 크기 정보를 표시합니다.

    • 상세 아이콘 : 디스크 사용량 상세 팝업창이 나타납니다. 시간대별 디스크 사용량을 표시한 차트를 확인할 수 있습니다. 인스턴스별로 확인할 수 있으며, Size, Free, Used 버튼을 선택하면 전체 크기, 남은 크기, 사용 중인 크기를 확인할 수 있습니다.

    • 확대 아이콘 : 위젯에 표시된 테이블을 더 넓은 화면으로 펼쳐볼 수 있습니다.

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

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

AWS RDS CloudWatch 위젯

  • [RDS] CPUUtilization

    RDS 데이터베이스의 인스턴스별 CPU 사용률을 실시간으로 확인할 수 있습니다.

  • [RDS] FreeableMemory

    RDS 데이터베이스의 인스턴스별 메모리 사용률을 실시간으로 확인할 수 있습니다.

  • [RDS] FreeStorageSpace

    RDS 데이터베이스의 사용 가능한 저장 공간의 양을 실시간으로 확인할 수 있습니다.

노트

AWS CloudWatch 지표 조회를 위한 에이전트 설정 방법은 다음 문서를 참조하세요.

Database 위젯

  • Active Sessions

    쿼리를 실행 중인 세션 수를 실시간 차트로 표시합니다.

  • DML Tuples

    DML(Data Manipulation Language) 문법(statement)이 수행된 횟수를 실시간 차트로 표시합니다.

  • Slow Query

    시간대별 슬로우 쿼리를 실시간 차트로 표시합니다. 차트의 특정 영역을 드래그하면 Slow Query List 목록을 확인할 수 있습니다. 위 방향 아이콘 또는 아래 방향 아이콘 버튼을 선택해 세로축의 범위를 확대 또는 축소할 수 있습니다.

  • Logical I/O

    blks_hit 지표로, 디스크 블록이 이미 버퍼 캐시에서 발견되어 읽기가 필요하지 않은 총 횟수를 실시간 차트로 표시합니다.

  • Long Active Session Count

    데이터베이스에서 실행되는 활성 세션의 장기 실행에 관한 정보를 제공합니다. 세션의 실행 시간에 따라 그룹화되어 시간 단위로 집계된 정보를 차트로 표시합니다. 오랜 시간 실행되는 세션을 식별하여 데이터베이스의 성능 문제나 리소스 누수를 조기에 감지하거나, 세션 실행 시간에 따른 분류를 통해 어떤 세션이 장기간 활성 상태로 유지되고 있는지 시각적으로 파악할 수 있습니다.

    3초 미만은 파란색, 3초 이상 10초 미만은 녹색, 10초 이상 15초 미만은 주황색, 15초 이상은 빨간색으로 표시합니다.

  • Long Waiting Session Count

    데이터베이스에서 락을 보유하거나 대기하는 세션의 장기 대기 시간에 대한 정보를 제공합니다. 락 정보와 활성 세션 정보를 결합하여 대기 중인 세션의 장기 대기 시간을 추적할 수 있습니다. 오랜 시간 동안 락을 보유하거나 대기하는 세션을 모니터링합니다. 어떤 세션이 오랜 시간 동안 락을 보유하거나 대기하고 있는지 시각적으로 파악할 수 있습니다.

    5초 미만은 파란색, 5초 이상 10초 미만은 녹색, 10초 이상 60초 미만은 주황색, 60초 이상은 빨간색으로 표시합니다.

  • SQL Elapse Map

    실행 중인 쿼리의 경과 시간을 실시간 차트로 표시합니다. 차트의 특정 영역을 드래그하면 Query List 목록을 확인할 수 있습니다. 위 방향 아이콘 또는 아래 방향 아이콘 버튼을 선택해 세로축의 범위를 확대 또는 축소할 수 있습니다.

    노트

    쿼리의 실행 시간은 액티브 세션을 수집하여 계산합니다. 따라서 액티브 세션 수집 주기에 따라 오차 범위가 발생할 수 있습니다. 다음 그림을 참고하세요. 수집 주기 사이에 종료된 SQL 수행 시간은 계산되지 않습니다. 수집 주기가 짧을 수록 오차 범위는 줄어들 수 있지만 DB 부하를 고려해 일반적으로 5초로 셋팅했습니다. 장시간 수행되는 쿼리 모니터링에 유용합니다. SQL 통계 메뉴의 데이터도 동일합니다.

  • Lock Wait Sessions

    row lock을 획득하기 위해 대기 중인 수를 실시간 차트로 표시합니다.

  • Commit Count

    커밋된 트랜잭션의 수를 실시간 차트로 표시합니다.

  • Replication Delay

    Replication 구조일 경우 replication DB에 반영되는 지연 시간을 실시간 차트로 표시합니다.

  • Physical I/O

    물리적인 disk에서 데이터를 읽은 횟수를 실시간 차트로 표시합니다.

  • Wait Event

    해당 백엔드 프로세스가 현재 대기 중인 경우 대기 이벤트 이름과 수를 확인할 수 있습니다. 차트 위로 마우스를 오버하면 툴팁을 통해 정보를 표시합니다.

Session Table 위젯

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

  • 액티브 세션: 실시간 수행 중인 세션과 쿼리 내용을 조회할 수 있습니다.

    • 실행 중인 세션 항목을 선택하면 세션 상세 정보 창이 나타납니다. 선택한 세션에 대한 자세한 내용을 확인할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.

    • 테이블의 가장 오른쪽에 query 컬럼의 항목을 선택하면 SQL 상세 창이 나타납니다. 선택한 쿼리(Query)에 대한 Full Text 및 Plan 정보를 확인할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.

  • 락 트리

    락 세션에 대한 정보와 Holder, Waiter 정보를 실시간으로 조회할 수 있습니다. 테이블의 컬럼에 대한 자세한 내용은 다음 문서를 참조하세요.

노트

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

세션 상세 정보 확인하기

액티브 세션 탭에서 세션 항목을 선택하면 세션 상세 정보 창이 나타납니다. 선택한 세션에 대한 자세한 내용을 확인할 수 있습니다.

세션 상세 정보

  • 세션에 대한 정보는 기본값으로 실시간 조회되고 있습니다. 시간 선택자에서 정지 아이콘 버튼을 선택하면 실시간 조회를 중지하고, 중지한 시간 기준의 데이터를 확인할 수 있습니다. 실시간 조회를 중지한 상태에서 데이터를 갱신하려면 새로고침 아이콘 버튼을 선택하세요.

  • Kill Session: 선택한 세션을 중지할 수 있습니다. 세션 킬 창이 나타나면 비밀번호(Parameter Key) 값을 입력한 다음 적용 버튼을 선택하세요.

    노트

    실시간 조회 모드에서만 이 기능을 이용할 수 있습니다.

  • 세션 히스토리: 선택한 세션 기록을 확인할 수 있는 세션 히스토리 메뉴로 이동할 수 있습니다.

    노트

    세션 히스토리 메뉴에 대한 자세한 내용은 다음 문서를 참조하세요.

  • Session Info: 선택한 세션에 대한 세부 정보를 확인할 수 있습니다.

  • Wait Info: 해당 백엔드 프로세스가 현재 대기 중인 경우 대기 이벤트 이름(wait_event)과 이벤트 유형(wait_event_type) 정보를 확인할 수 있습니다.

  • Process_Info: 선택한 세션에 대한 프로세스 정보를 확인할 수 있습니다.

  • SQL Text / Plan: 선택한 세션의 SQL 쿼리 문과 Plan 정보를 확인할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.

쿼리 자세히 보기

현재 수행 중인 세션의 SQL 쿼리 정보를 확인하려면 액티브 세션 섹션의 query 컬럼 항목을 선택하세요. SQL 상세 창이 나타납니다. SQL 쿼리문과 Plan 정보를 확인할 수 있습니다.

SQL 상세

  • SQL 통계 보기: 해당 SQL 쿼리문과 관련한 통계 정보를 확인할 수 있는 SQL 통계 메뉴로 이동할 수 있습니다.

  • Default Bind: 쿼리 문장에서 변수로 설정된 부분을 기본값으로 바인딩할 수 있습니다.

  • Reset Bind: 바인딩된 기본값을 해제하고 변수를 확인할 수 있습니다.

  • Formatting: SQL 쿼리문에 들여쓰기 및 포맷팅을 적용해 가독성을 높일 수 있습니다.

  • Plan: Plan 정보를 확인하려면 DB Name, User Name, Password를 입력한 다음 검색 아이콘 버튼을 선택하세요.

    • Text: 텍스트 형식으로 플랜 정보를 확인할 수 있습니다.

    • JSON: Json 형식으로 플랜 정보를 조회하면 병목이 발생하는 지점을 빠르게 확인할 수 있습니다.

    노트

    JSON 형식으로 플랜 정보를 조회하는 기능은 DBX 에이전트 1.6.12 버전 이상에서만 지원합니다.

JSON 형식으로 플랜 정보를 조회한 상태에서 table 또는 index 항목을 선택하면 테이블의 column, index 구성을 확인할 수 있는 Object detail 창이 나타납니다.

Object detail

이 기능은 DBX 에이전트 1.6.15 버전 이상에서 지원합니다. 데이터베이스 권한과 관련한 설정은 다음 문서를 참조하세요.

테이블 데이터 필터링하기

Filter

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

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

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

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

테이블 컬럼 설정하기

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

컬럼 설정

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

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

컬럼 추가하기

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

컬럼 삭제하기

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

컬럼 순서 변경하기

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

설정 사항 초기화하기

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

컬럼 정보 안내

항목설명
pid프로세스 ID
db데이터베이스 이름
userSQL 수행 계정
application클라이언트 애플리케이션 이름
client_host연결된 클라이언트의 호스트 이름(client_addr의 역방향 DNS 조회로 보고됨)
client_addr클라이언트의 IP 주소
client_port클라이언트의 포트 번호(유닉스 소켓을 사용하는 경우 -1)
query_hash쿼리의 해시값(와탭 내부 관리 값)
query_start현재 활성 상태인 쿼리가 시작된 시간(상태가 활성 상태가 아닌 경우 마지막 쿼리가 시작된 시간)
state백엔드 프로세스의 현재 상태(active/idle 등)
state_changestate가 변경된 최근 시간
xact_start해당 프로세스의 현재 트랜잭션이 시작된 시간(활성 트랜잭션이 없는 경우 null)
backend_start해당 백엔드 프로세스가 시작된 시간
backend_xmin해당 백엔드 프로세스가 처리 중인 xid의 최소값
backend_type해당 백엔드 프로세스의 유형, autovacuum worker, logical replication launcher, client backend, checkpointer
backend_xid해당 백엔드가 사용 중인 xid
wait_event_type해당 백엔드 프로세스가 대기 중인 이벤트 type
wait_event해당 백엔드 프로세스가 현재 대기 중인 경우 대기 이벤트 이름
노트

와탭은 클라이언트와 관련한 정보를 기본 저장합니다.

조회 목록 다운로드하기

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

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

  • 액티브 세션: activeSession_HH_MM_SS.csv

  • 락 트리: lockTree_HH_MM_SS.csv

새창으로 보기

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