querypie · jk-kim0 · Jul 15, 2026 · Jul 15, 2026
@@ -43,6 +43,7 @@ Custom Data Source 접속하기 | Connecting to Custom Data Source
 
 # Kubernetes Access Control
 접근 권한 목록 확인하기 | Checking Access Permission List
+Web Client로 쿠버네티스 클러스터 접속하기 | Connecting to Kubernetes Clusters with Web Client
 
 # Web Access Control
 Root CA 인증서 및 Extension 설치하기 | Installing Root CA Certificate and Extension

@@ -457,6 +457,21 @@
   - "user-manual"
   - "kubernetes-access-control"
   - "checking-access-permission-list"
+- "page_id": "2262630428"
+  "title": "Web Client로 쿠버네티스 클러스터 접속하기"
+  "title_orig": "Web Client로 쿠버네티스 클러스터 접속하기"
+  "breadcrumbs":
+  - "사용자 매뉴얼"
+  - "Kubernetes Access Control"
+  - "Web Client로 쿠버네티스 클러스터 접속하기"
+  "breadcrumbs_en":
+  - "User Manual"
+  - "Kubernetes Access Control"
+  - "Web Client로 쿠버네티스 클러스터 접속하기"
+  "path":
+  - "user-manual"
+  - "kubernetes-access-control"
+  - "web-client"
 - "page_id": "1064829218"
   "title": "Web Access Control"
   "title_orig": "Web Access Control"

@@ -21,28 +21,28 @@ Customers contracted through a partner should contact their partner representati
 * QueryPie Customer Portal: [Go to Portal](https://help.support.querypie.com/)
 
 <figure data-layout="center" data-align="center">
-<img src="/support/premium-support/image-20240801-023748.png" alt="image-20240801-023748.png" width="760" />
+<img src="/support/premium-support/image-20260715-083938.png" alt="image-20260715-083938.png" width="760" />
 </figure>
 
-You can submit tickets for product inquiries, bug reports, and more, and track the progress of your tickets in real-time.
 
-* Critical Outage - When immediate response is required, such as service interruption
-* Defect Report - Bug and error reports
-* PoC Installation Request - New environment setup requests
-* General Inquiry - Questions about usage and configuration
-* Feature Request - New feature suggestions
+You can submit tickets for bug reports and urgent issues, and track ticket progress in real time.
+
+* Critical Issue Report - When immediate response is required, such as service interruption
+* Bug Report - Bug and error reports
+
+<Callout type="info">
+For feature additions and improvement requests, please contact us by email. [ai_connection@querypie.com](mailto:ai_connection@querypie.com)
+</Callout>
 
 #### Upgrades and Regular Maintenance
 
 When a new version of QueryPie is released, we announce the latest updates in the [Release Notes](../release-notes).
 Based on the annual subscription agreement, we support upgrades for major version releases.
 Minor version releases are limited to bug fixes only.
-For upgrade and regular maintenance inquiries, please contact us through the [QueryPie Customer Portal](https://help.support.querypie.com/).
 
 #### Customer Portal Access Request
 
 Access is available for QueryPie Enterprise Edition customers.
 If you would like to participate, please fill out the application form through the link below, and we will send you a portal invitation link.
 
 * Access Request Link: [https://forms.gle/JKUtKR4ARbcy8XuDA](https://forms.gle/JKUtKR4ARbcy8XuDA)
-
@@ -1,3 +1,4 @@
 export default {
   'checking-access-permission-list': 'Checking Access Permission List',
+  'web-client': 'Connecting to Kubernetes Clusters with Web Client',
 };
@@ -0,0 +1,206 @@
+---
+title: 'Connecting to Kubernetes Clusters with Web Client'
+confluenceUrl: 'https://querypie.atlassian.net/wiki/spaces/QM/pages/2262630428/Web+Client'
+---
+
+import { Callout } from 'nextra/components'
+
+# Connecting to Kubernetes Clusters with Web Client
+
+### Overview
+
+<Callout type="info">
+KAC Web Client is currently provided as `Beta`.
+</Callout>
+
+With KAC Web Client, you can access Kubernetes clusters directly from your browser without installing a separate Agent, and explore and manage resources.
+
+You can enter from the cluster detail screen in the Kubernetes menu using the Connect button, or if you have already selected a Role and a specific cluster, you can go directly to Web Client from the top menu on the user page.
+
+<figure data-layout="center" data-align="center">
+<img src="/user-manual/kubernetes-access-control/web-client/image-20260714-095819.png" alt="Move to the Web Client screen by selecting a specific cluster on the cluster detail screen and clicking the `Connect` button" width="760" />
+<figcaption>
+Move to the Web Client screen by selecting a specific cluster on the cluster detail screen and clicking the `Connect` button
+</figcaption>
+</figure>
+
+#### Web Client Screen Layout
+
+<figure data-layout="center" data-align="center">
+<img src="/user-manual/kubernetes-access-control/web-client/image-20260714-100251.png" alt="The Web Client `Cluster Overview` displayed after connecting to a Role and a specific cluster " width="760" />
+<figcaption>
+The Web Client `Cluster Overview` displayed after connecting to a Role and a specific cluster
+</figcaption>
+</figure>
+
+When you connect, the **Cluster Overview** screen appears, where you can check the overall status of the cluster.
+
+* Left sidebar (**Resource Browser**): Browse resources in the cluster by category.
+* Right main area: Displays the list or details of the selected resource.
+* Bottom panel: Displays Pod logs and Shell terminal in tab format. It appears when you click the `Logs` or `Shell` button on the detail screen displayed after clicking a specific target in the list.
+  <figure data-layout="center" data-align="center">
+  <img src="/user-manual/kubernetes-access-control/web-client/image-20260714-101427.png" alt="Bottom panel exposed as tabs when the `Logs` or `Shell` button is clicked" width="736" />
+  <figcaption>
+  Bottom panel exposed as tabs when the `Logs` or `Shell` button is clicked
+  </figcaption>
+  </figure>
+
+### Connecting to a Cluster
+
+#### Selecting a Role
+
+<figure data-layout="center" data-align="center">
+<img src="/user-manual/kubernetes-access-control/web-client/image-20260714-101804.png" alt="QueryPie Web &gt; Kubernetes &gt; Kubernetes &gt; Select a Role" width="760" />
+<figcaption>
+QueryPie Web &gt; Kubernetes &gt; Kubernetes &gt; Select a Role
+</figcaption>
+</figure>
+
+
+* Click **Kubernetes** in the top menu.
+* In the **Select a Role** popup dialog, select the Role to use for access and click **Select**.
+    * The list of accessible clusters varies depending on the Role.
+    * If you do not have any granted Roles, the list on the left is not displayed. Request the appropriate permission through the Access Role Request form in the Workflow menu.
+
+#### Connecting with Web Client
+
+<figure data-layout="center" data-align="center">
+<img src="/user-manual/kubernetes-access-control/web-client/image-20260714-102425.png" alt="image-20260714-102425.png" width="760" />
+</figure>
+
+
+* Click the cluster you want to access in the left panel.
+* Click the `Connect` button on the detail screen on the right to connect with Web Client.
+
+<Callout type="info">
+You can also connect using the existing Agent method by clicking the `Open Agent` button.
+Refer to the Agent manual for Agent installation and usage.
+</Callout>
+
+### Checking Resource Lists
+
+<figure data-layout="center" data-align="center">
+<img src="/user-manual/kubernetes-access-control/web-client/web-client-resource-list.png" alt="*QueryPie Web &gt; Web Client &gt; Resource List*" width="760" />
+<figcaption>
+*QueryPie Web &gt; Web Client &gt; Resource List*
+</figcaption>
+</figure>
+
+When you select a resource type in the left sidebar, the list of corresponding resources is displayed.
+
+* You can select a specific Namespace from the **All Namespaces** dropdown to filter the list.
+* You can search resources by entering part of a name in the **Filter by name** search field.
+* You can create a new resource using the `+ Create` button.
+
+The resource categories that can be browsed are as follows.
+
+| Category             | Included Resources                                               |
+| -------------------- | ---------------------------------------------------------------- |
+| **Cluster**          | Namespace, Node, PersistentVolume, ClusterRole, ClusterRoleBinding |
+| **Workloads**        | Pod, Deployment, StatefulSet, DaemonSet, ReplicaSet, Job, CronJob |
+| **Config & Storage** | ConfigMap, Secret, PersistentVolumeClaim, StorageClass            |
+| **Network**          | Service, Ingress, NetworkPolicy, Endpoints                       |
+| **RBAC**             | Role, RoleBinding, ServiceAccount                                |
+| **Custom Resources** | CRD resources defined in the cluster                             |
+
+### Checking Resource Details
+
+Click an item in the resource list to open the detail panel on the right.
+The detail panel consists of four tabs.
+
+#### Overview Tab
+
+<figure data-layout="center" data-align="center">
+<img src="/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-overview.png" alt="*QueryPie Web &gt; Web Client &gt; Resource Detail &gt; Overview*" width="760" />
+<figcaption>
+*QueryPie Web &gt; Web Client &gt; Resource Detail &gt; Overview*
+</figcaption>
+</figure>
+
+You can check the resource metadata and status.
+
+* **Metadata**: Name, Namespace, UID, creation time, Status, Resource Version
+* **Controlled By**: The parent resource that manages the resource (for example, Pod → DaemonSet) - click the name to move to the parent resource detail screen.
+* **Containers**: For Pods, you can check the image, Ready status, and number of Restarts by container.
+* **Labels / Annotations**: Labels and annotations configured on the resource
+
+#### YAML Tab
+
+<figure data-layout="center" data-align="center">
+<img src="/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-yaml.png" alt="*QueryPie Web &gt; Web Client &gt; Resource Detail &gt; YAML*" width="760" />
+<figcaption>
+*QueryPie Web &gt; Web Client &gt; Resource Detail &gt; YAML*
+</figcaption>
+</figure>
+
+You can check the full YAML definition of the resource and edit it directly. Click the **Edit** button to switch to edit mode, and when you save after making changes, they are immediately applied to the cluster.
+
+#### Events Tab
+
+<figure data-layout="center" data-align="center">
+<img src="/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-events.png" alt="*QueryPie Web &gt; Web Client &gt; Resource Detail &gt; Events*" width="760" />
+<figcaption>
+*QueryPie Web &gt; Web Client &gt; Resource Detail &gt; Events*
+</figcaption>
+</figure>
+
+You can check Kubernetes events related to the resource.
+Events are recorded when status changes, scheduling, or errors occur.
+If a Pod is running normally, there may be no events.
+
+#### Relations Tab
+
+<figure data-layout="center" data-align="center">
+<img src="/user-manual/kubernetes-access-control/web-client/web-client-resource-detail-relations.png" alt="*QueryPie Web &gt; Web Client &gt; Resource Detail &gt; Relations*" width="760" />
+<figcaption>
+*QueryPie Web &gt; Web Client &gt; Resource Detail &gt; Relations*
+</figcaption>
+</figure>
+
+Visualizes the hierarchy of resources related to the current resource in a tree format.
+You can understand parent and child resource relationships at a glance, and click an item to move directly to the detail information of the related resource.
+
+### Checking Pod Logs
+
+<figure data-layout="center" data-align="center">
+<img src="/user-manual/kubernetes-access-control/web-client/web-client-log-viewer.png" alt="*QueryPie Web &gt; Web Client &gt; Log Viewer*" width="760" />
+<figcaption>
+*QueryPie Web &gt; Web Client &gt; Log Viewer*
+</figcaption>
+</figure>
+
+1. Select **Pod** in the sidebar, and then click the Pod you want to check in the list.
+2. Click the **Logs** button in the upper right of the detail panel.
+3. The real-time logs of the corresponding Pod are streamed in the bottom panel.
+    1. You can search logs by entering a keyword in the **Search logs** input field.
+    2. Select the **Follow** checkbox to automatically follow the latest logs.
+
+### Connecting to a Pod Shell Terminal
+
+<figure data-layout="center" data-align="center">
+<img src="/user-manual/kubernetes-access-control/web-client/web-client-shell-terminal.png" alt="*QueryPie Web &gt; Web Client &gt; Shell Terminal*" width="760" />
+<figcaption>
+*QueryPie Web &gt; Web Client &gt; Shell Terminal*
+</figcaption>
+</figure>
+
+1. Select **Pod** in the sidebar, and then click the Pod you want to connect to in the list.
+2. Click the **Shell** button in the upper right of the detail panel.
+3. An interactive terminal opens in the bottom panel, where you can run commands directly in the Pod container.
+
+<Callout type="info">
+Logs and Shell can be opened in multiple tabs at the same time.
+Each tab displays the Pod name, so you can compare and work with logs and terminals for multiple Pods together.
+</Callout>
+
+<Callout type="info">
+**Difference between Web Client and the existing Agent method**
+
+Q. What is the difference between Web Client and the existing Agent method?
+
+A. Web Client lets you browse Kubernetes resources, check logs, and access Shell using only a browser.
+The Agent method enables a wider range of work by integrating with local tools, including kubectl.
+Both methods operate under the same permission system (Role, Policy).
+</Callout>
+
+>
@@ -21,28 +21,28 @@ Customer Portalは、QueryPieと直接契約しているお客様のみご利用
 * QueryPie Customer Portal：[こちら](https://help.support.querypie.com/)
 
 <figure data-layout="center" data-align="center">
-<img src="/support/premium-support/image-20240801-023748.png" alt="image-20240801-023748.png" width="760" />
+<img src="/support/premium-support/image-20260715-083938.png" alt="image-20260715-083938.png" width="760" />
 </figure>
 
-製品に関するお問い合わせやバグ報告などをチケットとして登録でき、チケットの進捗状況をリアルタイムで確認できます。
 
-* 緊急障害発生 - サービス停止など即時対応が必要な場合
-* 不具合報告 - バグおよびエラーの報告
-* PoCインストール依頼 - 新規環境構築の依頼
-* 一般的なお問い合わせ - 使用方法や設定に関する質問
-* 製品機能のご提案 - 新機能のリクエスト
+バグ報告や緊急の問題をチケットとして登録でき、チケットの進捗状況をリアルタイムで確認できます。
+
+* 緊急問題レポート - サービス停止など即時対応が必要な場合
+* バグレポート - バグおよびエラーの報告
+
+<Callout type="info">
+機能追加や改善に関するお問い合わせは、メールでご依頼ください。[ai_connection@querypie.com](mailto:ai_connection@querypie.com)
+</Callout>
 
 #### アップグレードおよび定期メンテナンス
 
 QueryPieの新バージョンがリリースされると、[Release Notes](../release-notes)で最新アップデート情報をお知らせいたします。
 年間サブスクリプション契約に基づき、メジャーバージョンリリース時にはアップグレードをサポートいたします。
 マイナーバージョンリリースはバグフィックスのみが対象となります。
-アップグレードおよび定期メンテナンスに関するお問い合わせは、[QueryPie Customer Portal](https://help.support.querypie.com/)よりご連絡ください。
 
 #### Customer Portalへの参加リクエスト
 
 QueryPie Enterprise Editionをご購入のお客様が対象となります。
 参加をご希望の場合は、以下のリンクから申請書にご記入いただければ、ポータルへの招待リンクをお送りいたします。
 
 * 参加リクエストリンク：[https://forms.gle/JKUtKR4ARbcy8XuDA](https://forms.gle/JKUtKR4ARbcy8XuDA)
-
@@ -1,3 +1,4 @@
 export default {
   'checking-access-permission-list': 'アクセス権限一覧の確認',
-};
+  'web-client': 'Web ClientでKubernetesクラスターに接続する',
+};