Multi Agent

Overview

QueryPie Multi Agent is an enhanced Proxy Agent that allows you to use multiple QueryPie Hosts simultaneously.

In the Agent UI, you can view the available resources on each specific Host.

Simply installing the Agent and logging into each Host allows you to access resources through two or more QueryPie Proxies without any additional configuration.

지원 버전

Multi Agent supports only QueryPie Host version 10.2.5 or later. If you are using version 10.2.4 or earlier, please continue using the existing User Agent.

It is possible to install both the User Agent and Multi Agent on the same PC; however, they cannot run simultaneously as this may cause functionality issues.

The current support scope for Multi Agent in version 10.2.5 is as follows:

• Service: DAC, KAC

• Client OS: macOS, Windows

Support for SAC and Linux is planned for version 10.2.7.

Downloading and Initial Setup of the Agent App

1. After logging into QueryPie, click on the profile in the top-right corner, then select Download & Support and click the Multi-Agent button.

   

2. When the QueryPie Multi-Agent Downloads popup appears, download the installation file that matches your PC's operating system in Step 1. Then, copy the QueryPie URL found in Step 3.

   

3. Run the downloaded QueryPie Multi-Agent installer, then copy the .app file to the Applications folder to complete the installation.

   

4. When the installed QueryPie Agent is launched, the Host registration page will appear.
   Enter the QueryPie URL you copied earlier in the QueryPie Host field, then click Next to proceed to the login screen.

   

5. On the login page of the entered host, enter your authentication details and click the Continue button.

   

Connecting to the Database as an Agent

1. In the Database tab, you can view the list of database connections for the selected QueryPie Host that have granted permissions and support proxy usage.

   

2. Select the connection you want to access, right-click, and click the "Connection Information" menu to view the details for proxy connection.

   

The functionality for copying authentication information and integrating with 3rd-party tools will be supported in version 10.2.6 and above.

Managing Kubernetes Settings in the Agent

1. If you open the Kubernetes tab for the selected QueryPie Host for the first time, you will need to select a role. You can view and select from the list of roles assigned to you using the role selector at the top.

   

2. You can view the list of K8s clusters that have been granted permissions for the selected role.

   

3. To use the kubectl command through a proxy, an initial Kubeconfig setup is required. Click the gear icon in the top-right corner to access the Settings page, select the Kubernetes tab, where you can manage the Kubeconfig file save path and copy the Kubeconfig setup command.

   

4. Paste and execute the copied command in your terminal.

Using Multiple Hosts in the Agent

1. Click the + Add New Host button in Settings > Hosts, enter the domain of the new host, and save it.

   

2. If the new host registration is successful, a toast notification will be displayed. You can confirm that the new host has been added to the list, and then exit the settings page by clicking the X button in the top-right corner.

   

3. Click the profile to view the list of registered hosts. You can click to switch between hosts.

   

Host switching is required during login, but once the Proxy connection is established after login, all registered resources can be used without the need to switch hosts on the screen.

Resetting Multi Agent Settings

1. Click the gear icon in the top-right corner of the agent to access the settings page, then click the Reset All Settings button at the bottom of the Hosts tab.

   

2. Clicking the Reset button in the confirmation modal will reset all settings stored in the local folder.

   

3. You will be directed to the initial Multi Agent setup page (initial Host registration).

   

Extracting Multi Agent Logs

If an issue occurs while using Multi-agent, please follow the steps below to extract the logs.

1. Click the Multi-agent icon in the menu bar (MacOS) or system tray (Windows), then select Diagnostic Tools > Enable Tracing from the menu.

   1. Change the log level to Trace, and the option in the UI will change to Disable Tracing.

2. Recreate the issue.

3. Next, click the Multi-agent icon in the menu bar again, then select Diagnostic Tools > Export Log.

4. You can then send the extracted log file.

Restrictions for Administrators

Please refer to the separate Administrator Guide document for the Multi Agent restrictions.

Multi Agent Restrictions