연계 프로젝트 관리

홈 화면 > 프로젝트 선택 > 관리 > 연계 프로젝트 관리

데이터베이스 모니터링(DPM) 프로젝트와 애플리케이션 모니터링(APM) 프로젝트를 생성한 경우, 두 프로젝트를 연계하여 DPM에서 수집한 모니터링 데이터를 APM 프로젝트에서 확인할 수 있습니다.

데이터베이스에서 활성화된 세션(액티브 세션)과 연동된 애플리케이션의 액티브 트랜잭션을 통해, 해당 트랜잭션의 상세 정보를 실시간으로 확인할 수 있습니다. 이러한 통합 모니터링을 통해 애플리케이션과 데이터베이스 간의 상호작용을 심층 분석하고 실시간으로 성능 병목 현상을 진단하고 해결할 수 있습니다.

연계 프로젝트 관리 기능을 사용하면 제품 또는 장비 중심의 모니터링을 넘어 여러 프로젝트 간의 모니터링 데이터를 통합해 확인할 수 있습니다. 이는 애플리케이션, 데이터베이스 등 다양한 시스템 구성 요소들이 어떻게 상호 작용하는지 분석하는 데 유용합니다. 특히, 성능 저하가 발생했을 때 장비 문제인지 개별 애플리케이션 문제인지 신속하게 파악할 수 있어, 문제 해결 시간을 크게 단축시킬 수 있습니다. 연계 프로젝트 관리를 통해 사용자 시스템 단위에서 성능 데이터를 종합적으로 분석하고, 보다 가시적인 인사이트를 확보할 수 있습니다.

다음 동영상을 통해 자세한 내용을 확인할 수 있습니다.

노트

시작하기 전 참고 사항

• 현재는 Java 플랫폼만 지원합니다. 추후 업데이트를 통해 지원 플랫폼을 확장하겠습니다.

• 연계 DB 세션 기능의 경우 Java 에이전트 2.2.33 버전 이상이 필요합니다.

• 애플리케이션 프로젝트에서 데이터베이스 프로젝트를 연계하는 방법에 대한 자세한 내용은 다음 문서를 참조하세요.

사전 준비

연계 분석을 사용하려면 데이터베이스 권한, APM 에이전트 옵션, 프로젝트 연계를 순서대로 준비합니다. 프로젝트를 연계해도 앞의 두 가지가 빠져 있으면 액티브 세션에 연계 아이콘이 나타나지 않습니다.

데이터베이스 권한

애플리케이션이 DB 접속에 사용하는 계정에 v$session 조회 권한을 부여하세요. 와탭 모니터링 계정이 아니라 애플리케이션 계정입니다.

SQL

grant select on sys.v_$session to {Application_service_account};

멀티테넌트(12c 이상) 환경의 구문을 포함한 자세한 내용은 에이전트 설치 문서를 참조하세요.

APM 에이전트 옵션

APM 프로젝트의 whatap.conf 파일에 다음 옵션을 설정하세요. 관리 > 에이전트 설정 메뉴에서도 설정할 수 있습니다.

whatap.conf

dbc_sid_enabled=true
hook_db_native_enabled=true

Option	Default	Setting	Required	Description
dbc_sid_enabled	false	true	필수	연계 분석의 키가 되는 SID 발급
hook_db_native_enabled	false	true	필수	트랜잭션이 사용하는 DB 종류 추출
debug_dbc_sid_enabled	false	true	선택	Java 에이전트 로그에 SID 정보 기록. 연계가 되지 않을 때 원인 확인용

두 옵션을 모두 설정한 다음 애플리케이션을 다시 시작하세요. 재기동이 필요한 옵션은 hook_db_native_enabled입니다. dbc_sid_enabled는 재기동 없이 적용됩니다.

요구 사항

Item	Condition
APM 에이전트	Java 에이전트 2.2.33 이상. 현재 Java 플랫폼만 지원
연계 프로젝트 지원 DB	PostgreSQL, Oracle, MySQL, SQL Server, CUBRID, Altibase, Redis, MongoDB
연계 DB 세션 지원 DB	PostgreSQL, Oracle, Oracle Pro, MySQL
콘솔 권한	프로젝트 수정 권한
조회 조건	실시간 조회 상태

연계 아이콘이 보이지 않을 때

프로젝트를 연계했는데도 액티브 세션에 연계 아이콘이 나타나지 않으면 다음을 확인하세요.

1. 애플리케이션 계정에 v$session 조회 권한이 있는지 확인하세요.

1. dbc_sid_enabled와 hook_db_native_enabled가 모두 true이고, 값을 바꾼 뒤 애플리케이션을 다시 시작했는지 확인하세요.

2. 연계한 APM 프로젝트의 Java 에이전트가 2.2.33 이상인지 확인하세요.

3. 사용 중인 데이터베이스가 연계 DB 세션 지원 목록에 있는지 확인하세요.

4. 실시간 조회 상태인지 확인하세요. 과거 시점을 조회하면 연계 아이콘이 나타나지 않습니다.

5. 액티브 세션 수집 필터 옵션으로 세션이 걸러지지 않았는지 확인하세요. limit_active_session으로 수집 개수가 제한되거나 skip_user, skip_sys_session으로 계정이 제외되면 연계 아이콘이 나타나지 않습니다.

6. debug_dbc_sid_enabled=true로 설정한 다음 Java 에이전트 로그에서 SID가 발급되는지 확인하세요.

연계 프로젝트 추가하기

1. 관리 > 연계 프로젝트 관리 메뉴로 이동하세요.

2. 연계 프로젝트 추가 섹션에서 프로젝트 선택 입력란을 선택하세요.

   

3. 선택할 수 있는 프로젝트 목록이 표시되면 연계할 프로젝트를 선택하세요. 문자열을 입력해 일치하는 프로젝트를 검색할 수도 있습니다.

4. 프로젝트를 하나 이상 선택한 다음 활성화된 추가 버튼을 선택하세요.

연계 프로젝트 목록에 선택한 프로젝트가 추가됩니다.

노트

연계 프로젝트를 추가하기 위해서는 프로젝트 수정 권한이 필요합니다. 수정 권한이 있는 경우 연계 프로젝트 관리 메뉴에서 추가 버튼이 활성화됩니다.

연계 프로젝트 확인하기

액티브 세션과 연동된 애플리케이션의 액티브 트랜잭션 정보를 실시간으로 확인할 수 있습니다. 트랜잭션 URL, 데이터베이스 연결 정보, DB 타입, HTTP 메서드, 실행 시간 같은 기본 정보와 트랜잭션 ID, 스레드 ID, 클라이언트 IP, CPU 사용 시간 같은 지표를 함께 봅니다. SQL 쿼리 실행 시간, 호출된 SQL 개수, DB 연결 시간도 확인할 수 있습니다.

콜 스택(Call stack) 정보와 SQL 쿼리를 함께 제공합니다. 문제가 생겼을 때 원인을 자세히 추적하고, 애플리케이션과 데이터베이스 사이에서 성능 병목이 어디인지 빠르게 진단할 수 있습니다.

액티브 트랜잭션 추적하기

대시보드 > 인스턴스 모니터링 메뉴로 이동하세요. 연계 분석 기능은 실시간 조회 상태에서만 확인할 수 있습니다.

1. 인스턴스 옵션에서 조회하길 원하는 인스턴스(에이전트)를 선택하세요.

2. 액티브 세션 테이블 목록에서 연계 분석하려는 액티브 세션 항목의 버튼을 선택하세요.

3. 선택한 액티브 세션과 연계된 트랜잭션 정보를 제공하는 연계 분석 창이 나타납니다.

연계 프로젝트 목록에서 원하는 프로젝트를 선택해 연계 분석 정보를 확인하세요.

노트

• 화면 오른쪽 상단의 프로젝트 이동 버튼을 선택하면 해당 프로젝트의 애플리케이션 대시보드 메뉴로 이동할 수 있습니다.

• 선택한 액티브 세션에 연계된 트랜잭션이 없다면 데이터 없음으로 화면에 표시됩니다.

연계 분석 화면 안내

연계 분석 창에서는 액티브 트랜잭션에 대한 상세 정보 및 Call Stack, SQL 문을 확인할 수 있습니다.

Active Transaction

연계된 액티브 트랜잭션의 상세 정보를 확인할 수 있습니다.

• DB Connection: 데이터베이스 연결 URL입니다.

• Thread ID: 해당 트랜잭션을 처리하는 데 사용된 스레드의 고유 식별자입니다.

• Sid: 선택한 액티브 세션의 ID입니다.

• Thread Stat: 스레드의 현재 상태입니다.

• DB Type: 연계된 데이터베이스 플랫폼의 종류입니다.

노트

• Java 에이전트 2.2.40 이전 버전에서는 ThreadStat 값이 숫자 형식으로 표시됩니다. 문자 형식으로 표시하려면 연계된 프로젝트에서 Java 에이전트 2.2.40 버전 이상을 설치하세요.

• 그 외 항목에 대한 자세한 내용은 다음 문서를 참조하세요.

Call Stack

메소드나 함수 호출의 순서를 추적하는 정보를 제공합니다.

SQL

연계된 액티브 트랜잭션을 통해 실행된 SQL 쿼리입니다.

연계 프로젝트 삭제하기

1. 관리 > 연계 프로젝트 관리 메뉴로 이동하세요.

2. 연계 프로젝트 목록 섹션에서 연계를 해제하려는 프로젝트를 삭제하려면 목록 가장 오른쪽의 버튼을 선택하세요.

3. 확인 메시지가 나타나면 삭제 버튼을 선택하세요.

연계 프로젝트 목록 섹션에서 삭제한 프로젝트가 제외됩니다.