(10.3.0-ko) Multi Agent
- Regan Park
Overview
QueryPie Multi Agent는 여러 개의 QueryPie Host를 동시에 사용할 수 있도록 개선된 Proxy Agent입니다.
Agent UI에서는 특정 Host에서 사용 가능한 리소스들을 확인할 수 있습니다.
Agent 설치 및 Host 별 로그인 수행만으로 추가 설정 없이 둘 이상의 QueryPie Proxy를 통한 리소스 접속이 가능합니다.
지원 버전
Multi Agent는 10.2.5 버전 또는 이후 버전의 QueryPie Host만을 지원합니다. 10.2.4 이하 버전을 사용하는 경우 기존의 User Agent를 사용하시기 바랍니다.
동일한 PC에 기존의 User Agent와 Multi Agent 둘 다 설치하는 것은 가능합니다. 단, 동시에 실행되어 있으면 정상적으로 동작하지 않습니다.
QueryPie Host 버전이 10.2.5 ~ 10.2.7 버전인 경우 지원 범위:
Service: DAC, KAC
Client OS: MacOS, Windows
QueryPie Host 버전이 10.2.8 이상 버전인 경우 지원 범위:
Service: DAC, KAC, SAC
Client OS: MacOS, Windows, Linux
에이전트 앱 다운로드 및 초기 설정
QueryPie 로그인 후 우측 상단 프로필을 클릭한 뒤 Download & Support >
Multi-Agent버튼을 클릭합니다.QueryPie Web > 프로필 메뉴QueryPie Multi-Agent Downloads 팝업창이 실행되면 Step 1에서 사용 중인 PC 운영체제에 맞는 설치 파일을 다운로드한 후 Step 3에 있는 QueryPie URL을 복사해 둡니다.
QueryPie Web > QueryPie Multi-Agent Download다운로드받은 QueryPie Multi-Agent 설치 프로그램을 실행한 뒤 .app 파일을 Applications 폴더에 복사하여 설치를 완료합니다.
Mac OS 설치 프로그램설치 완료된 QueryPie Agent를 실행하면 Host 최초 등록 페이지가 열립니다.
QueryPie Host 입력란에 미리 복사해뒀던 QueryPie URL을 입력하고Next버튼을 클릭하면 로그인 화면으로 진입하게 됩니다.Multi-Agent > Host Setting입력한 호스트의 로그인 페이지에서 인증정보를 입력하고 Continue 버튼을 클릭합니다.
Multi-Agent > 로그인
DAC
에이전트로 데이터베이스 접속하기
Database 탭에서 선택된 QueryPie Host 에 대해 권한이 부여되어 있고 Proxy 사용이 가능한 Database Connection 목록을 확인할 수 있습니다.
Multi-Agent > Databases접속하고자 하는 커넥션을 선택하고 마우스 오른쪽 버튼을 클릭하면 컨텍스트 메뉴가 오픈됩니다.
Multi-Agent > Databases > Context-menuConnection Information: Proxy 접속을 위한 정보를 확인할 수 있습니다.
Open Connection With 10.2.6~: 3rd Party 툴로 커넥션에 접속할 수 있습니다.
DBeaver: DBeaver 를 열고 커넥션의 정보를 삽입해줍니다.
(최초 1회의 DBeaver 경로 인식 과정이 필요합니다. DBeaver가 실행 중인 상태에서 본 기능을 실행하시기를 권장합니다.)DataGrip: DataGrip에 붙여넣을 수 있는 커넥션 정보가 복사됩니다.
SQLGate for Oracle (Windows만 지원): SQLGate for Oracle 을 열고 커넥션 정보를 삽입해줍니다.
Copy as JDBC URL 10.2.6~: 선택한 커넥션의 JDBC URL을 복사해줍니다.
Open Connection With, Copy as JDBC URL 기능은 10.2.6 또는 그 이후 버전에서 지원합니다.
에이전트에서 3rd Party Database Tool 설정 관리하기
Settings > Databases 에서 3rd Party 툴 관련 설정을 관리할 수 있습니다.
Database Tool Path: 지원하는 3rd Party 툴의 경로를 설정할 수 있습니다.
Auto Detected : Open Connection With 로 툴을 선택할 때마다 툴의 경로를 자동으로 찾습니다.
툴이 제대로 열리지 않는 경우 Manual Configuration 으로 경로를 수동 지정하시기를 바랍니다.
Manual Configuration : 수동으로 툴이 설치된 경로를 지정합니다.
Do not user the tool : 툴 사용을 비활성화 합니다. 커넥션 목록의 컨텍스트 메뉴에서 툴이 숨겨집니다.
DataGrip Connection Guide: DataGrip으로 커넥션을 열 때 노출되는 가이드 모달을 계속 볼지 설정합니다.
에이전트에서 default privilege 선택하기
쿼리파이 DB 접근제어에서 한 사용자가 두개이상의 privilege를 부여받을 수 있습니다. 특정 커넥션에 접근권한을 부여받은 사용자가 여러 그룹에 포함되어 있고 그룹에 다른 접근 권한을 부여한 경우 이 사용자는 여러개의 privilege가 할당될 수 있습니다. 이 때 proxy를 통해 접속할 때 사용할 Privilege를 agent 화면에서 선택할 수 있습니다. (10.3.0 부터 지원)
다중 privilege를 부여받은 후 사용자가 특정 privilege를 default로 설정하지 않으면 접속할 수 없기 때문에 만약 default privilege가 설정되어 있지 않은 경우 아래 그림과 같은 경고 아이콘이 표시됩니다.
다중 Privilege가 할당된 커넥션에 대해 마우스 오른쪽 버튼을 누르고 메뉴를 호출합니다.
메뉴에서 Connection Information을 선택합니다.
Connection InformationOriginal Information 의 Privilege에서 편집 (연필모양 아이콘) 버튼을 클릭합니다.
Previlege Name 의 항목중 하나를 선택하고 저장합니다.
경고 아이콘이 사라지고 할당된 privilege 이름이 해당 커넥션에 보이는지 확인합니다.
KAC
에이전트에서 Role별 쿠버네티스 클러스터 목록 조회하기
Role 셀렉터에서 본인에게 부여된 Role 중 하나를 선택하면, 선택된 Role에 권한이 부여되어 있는 K8s Cluster 목록을 확인할 수 있습니다.
에이전트에서 Kubeconfig 설정 가이드 확인하기
Proxy를 통해 kubectl 명령을 사용하려면 최초 1회의 Kubeconfig 설정이 필요합니다.
에이전트 우상단의 톱니바퀴 버튼을 클릭하여 Setting 페이지로 진입, Kubernetes 탭을 선택하면 Kubeconfig File 저장 경로를 관리하고, Kubeconfig 설정 커맨드를 복사할 수 있습니다.
이후 사용하시는 터미널에서 복사한 커맨드를 붙여넣고 실행합니다.
SAC 10.2.8~
에이전트에서 서버 접속하기
Role 드롭다운에서 Role을 선택하면, 선택한 Role로 접근할 수 있는 서버 목록을 확인할 수 있습니다.
Multi-Agent > Servers서버를 선택하고 우클릭하여 컨텍스트 메뉴를 열고, Open Connection With > 터미널 Tool을 선택합니다.
Multi-Agent > Servers필요 시 Account 정보를 입력하고
Open버튼을 누릅니다.선택한 터미널 툴로 서버에 접속할 수 있습니다.
OS 권한 모달
최초 1회에 한하여, 선택한 터미널 툴에 대한 OS 권한을 요구합니다.
허용하지 않으면 터미널 툴을 열 수 없습니다.최초 1회에 한하여 System Event에 대한 OS 권한을 요구합니다. 허용할 경우 세션 끊김 등에 대한 이벤트를 알림 영역에서 받을 수 있습니다.
에이전트에서 3rd Party Terminal Tool 설정 관리하기
Setting > Servers 에서 터미널 툴 관련 설정을 관리할 수 있습니다.
Terminal Tool Path: 지원하는 3rd Party 툴의 경로를 설정할 수 있습니다.
Auto Detected : Open Connection With 로 툴을 선택할 때마다 툴의 경로를 자동으로 찾습니다.
툴이 제대로 열리지 않는 경우 Manual Configuration 으로 경로를 수동 지정하시기를 바랍니다.
Manual Configuration : 수동으로 툴이 설치된 경로를 지정합니다.
Do not user the tool : 툴 사용을 비활성화 합니다. 서버 목록의 컨텍스트 메뉴에서 툴이 숨겨집니다.
에이전트에서 둘 이상의 Host 사용하기
Settings > Hosts 에서
+ Add New Host버튼을 클릭한 뒤 새로운 Host의 도메인을 입력하고 저장합니다.Multi-Agent > Setting > General > Add New Host새로운 Host 등록이 성공한 경우 Toast로 안내됩니다. 목록에서 새로운 Host가 추가된 것을 확인하고, 우상단의
X버튼을 눌러 설정 페이지를 나갑니다.Host 목록에서 원하는 Host를 클릭하여 바로 전환할 수 있습니다.
Multi-Agent > Setting > General
프로필 버튼을 클릭하면 등록된 Host 목록을 확인할 수 있습니다. 클릭하여 Host 간 전환이 가능합니다.
Multi-Agent > Profile 메뉴 선택
Host 전환은 로그인 시에는 필수이나, 로그인 후 Proxy 연결이 되었다면 화면 상 Host 전환 없이 등록된 모든 리소스를 사용할 수 있습니다.
Multi Agent 설정 초기화하기
시스템 트레이 또는 메뉴 바에서 Multi Agent 아이콘(또는 항목)을 클릭한 뒤, 표시되는 메뉴에서 'Reset All Settings'를 선택합니다.
또는 에이전트 우상단의 톱니바퀴 버튼을 클릭하여 설정 페이지로 진입하고, Hosts 탭 하단의 Reset All Settings 버튼을 클릭합니다.
Multi-Agent > Setting > Hosts확인 모달에서 Reset 버튼을 클릭하면 로컬 폴더에 저장된 모든 설정이 초기화됩니다.
Multi-Agent > Setting > Hosts > Reset All SettingsMulti Agent 최초 설정 (최초 Host 등록) 페이지로 진입됩니다.
Multi-Agent > Host Setting
Multi Agent 로그 추출하기
Multi-agent 사용 중 문제 발생시 다음의 절차를 따라서 로그를 추출해주세요.
GUI
메뉴바(MacOS) 또는 시스템 트레이(Windows)에서 Multi-agent 아이콘을 클릭하고, 메뉴에서 Diagnostic Tools > Enable Tracing 을 클릭합니다.
로그 레벨을 Trace로 변경하며, UI에서는 Disable Tracing 으로 항목이 변경됩니다.
문제를 재현합니다.
다시 메뉴바에서 Multi-agent 아이콘 > Diagnostic Tools > Export Log를 클릭합니다.
추출된 로그 파일을 전달해 주시면 됩니다.
macOS
에이전트 종료 후 터미널에서 다음 커맨드를 실행합니다.
QPMA_TRACE=1 open -a QueryPieMultiAgent문제를 재현합니다.
아래의 폴더를 압축하여 전달해주세요.
~/.querypie-multi-agentWindows
에이전트 종료 후 터미널에서 다음 커맨드를 실행합니다.
set QPMA_TRACE=1 "%ProgramFiles%\QueryPie Multi Agent\QueryPieMultiAgent.exe"문제를 재현합니다.
아래의 폴더를 압축하여 전달해주세요.
%USERPROFILE%\.querypie-multi-agent
관리자를 위한 제약사항 문서
관리자를 위한 Multi Agent 제약사항 문서는 별도의 관리자 가이드 문서를 참고해 주세요.
https://docs.querypie.com/ko/querypie-manual/10.2.0/multi-agent-1